runtime.onStartup

当安装了此扩展的配置文件首次启动时触发。此事件在启动私有浏览(隐身)配置文件时不会触发,即使此扩展程序在“拆分”隐身模式下运行。

注意:在使用事件页面或后台服务工作线程时,扩展程序必须在事件页面上为 runtime.onStartup 添加监听器,以便每个浏览器会话至少执行一次事件页面。

语法

js
browser.runtime.onStartup.addListener(listener)
browser.runtime.onStartup.removeListener(listener)
browser.runtime.onStartup.hasListener(listener)

事件函数

所有事件都有三个函数

addListener(listener)

为调用事件添加 listener

removeListener(listener)

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

hasListener(listener)

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

参数

唯一的参数是 listener,用于上述任何函数。

监听器

当此事件发生时调用的函数。

示例

浏览器启动时打开 https://giphy.com/explore/cat

js
function handleStartup() {
  browser.tabs.create({
    url: "https://giphy.com/explore/cat",
  });
}

browser.runtime.onStartup.addListener(handleStartup);

浏览器兼容性

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