webNavigation.onDOMContentLoaded

browser.webNavigation.onDOMContentLoaded.addListener(
  listener,                   // function
  filter                      // optional object
)
browser.webNavigation.onDOMContentLoaded.removeListener(listener)
browser.webNavigation.onDOMContentLoaded.hasListener(listener)

事件具有三个函数

addListener(listener)

向此事件添加监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查 listener 是否已为此事件注册。如果正在监听，则返回 true，否则返回 false。

listener

当此事件发生时调用的函数。该函数将传递此参数

details

object。有关导航事件的详细信息。有关更多信息，请参阅 details 部分。

filter 可选

object。一个包含单个属性 url 的对象，该属性是 Array 的 events.UrlFilter 对象。如果您包含此参数，则事件仅针对与数组中至少一个 UrlFilter 匹配的 URL 的转换触发。如果您省略此参数，则事件将针对所有转换触发。

tabId

integer。发生导航的选项卡的 ID。

url

string。给定框架已导航到的 URL。

processId 可选 已弃用

integer。此值在现代浏览器中未设置。当它被设置时，它表示运行此选项卡的渲染器的进程的 ID。

frameId

integer。发生导航的框架。0 表示导航发生在选项卡的顶级浏览上下文中，而不是嵌套的 <iframe> 中。正值表示导航发生在嵌套的 iframe 中。框架 ID 对给定的选项卡和进程是唯一的。

timeStamp

number。触发 DOMContentLoaded 的时间，以 自纪元以来的毫秒数 为单位。

记录 onDOMContentLoaded 的目标 URL，如果目标 URL 的主机名包含“example.com”或以“developer”开头。

const filter = {
  url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};

function logOnDOMContentLoaded(details) {
  console.log(`onDOMContentLoaded: ${details.url}`);
}

browser.webNavigation.onDOMContentLoaded.addListener(
  logOnDOMContentLoaded,
  filter,
);