webNavigation.onDOMContentLoaded

语法

browser.webNavigation.onDOMContentLoaded.addListener( listener, // 函数 filter // 可选对象 ) browser.webNavigation.onDOMContentLoaded.removeListener(listener) browser.webNavigation.onDOMContentLoaded.hasListener(listener) 

事件包含三个函数：

addListener(callback)

为此事件添加监听方法。

removeListener(listener)

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

hasListener(listener)

检测是否有 listener 被注册在事件上。如有则返回 true，否则返回false。

addListener 语法

参数

callback

为当此事件发生时需要被调用的函数。该函数将传递以下参数：

details

object。有关导航事件的详细信息。参见 details 一节以获取更多信息。

filter可选

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

额外对象

details

tabId

integer。发生导航事件的标签页 ID。

url

string。指定框架导航到的 URL。

processId

integer。渲染此选项卡的进程的 ID。

frameId

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

timeStamp

number。启动 DOMContentLoaded 的时间，单位为自纪元起的毫秒数。

浏览器兼容性

示例

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

const filter = { url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }], }; function logOnDOMContentLoaded(details) { console.log(`onDOMContentLoaded: ${details.url}`); } browser.webNavigation.onDOMContentLoaded.addListener( logOnDOMContentLoaded, filter, );