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 语法

参数

监听器

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

tab

tabs.Tab。已创建标签的详细信息。

示例

记录新创建标签的 ID

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

browser.tabs.onCreated.addListener(handleCreated);

扩展程序示例

浏览器兼容性

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