tabs.onCreated

当创建选项卡时触发。

请注意,在此事件触发时,选项卡的 URL 可能尚未获得其最终值。特别是,Firefox 会先打开一个 URL 为“about:blank”的新选项卡,然后再将新页面加载到其中。您可以监听 tabs.onUpdated 事件以在设置 URL 时收到通知。

语法

js
browser.tabs.onCreated.addListener(listener)
browser.tabs.onCreated.removeListener(listener)
browser.tabs.onCreated.hasListener(listener)

事件有三个函数

addListener(listener)

为该事件添加监听器。

removeListener(listener)

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

hasListener(listener)

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

addListener 语法

参数

listener

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

tab

tabs.Tab。已创建选项卡的详细信息。

示例

记录新创建选项卡的 ID

js
function handleCreated(tab) {
  console.log(tab.id);
}

browser.tabs.onCreated.addListener(handleCreated);

扩展示例

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

注意:此 API 基于 Chromium 的 chrome.tabs API。本文档源自 Chromium 代码中的 tabs.json