runtime.onStartup
Вызывается, когда профиль, в котором установлен этот расширение, запускается впервые. Это событие не вызывается при запуске профиля с частным просмотром (инкогнито), даже если это расширение работает в режиме «разделенного» инкогнито.
Примечание: При использовании страницы событий или фонового веб-работника, расширение должно добавить обработчик в runtime.onStartup на странице событий, чтобы страница событий выполнялась как минимум один раз в сеансе браузера.
Синтаксис
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, используемый для любой из вышеперечисленных функций.
listener-
Функция, которая вызывается при наступлении этого события.
Примеры
Открыть https://giphy.com/explore/cat при запуске браузера:
function handleStartup() { browser.tabs.create({ url: "https://giphy.com/explore/cat" }); } browser.runtime.onStartup.addListener(handleStartup);
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
onStartup |
23 | 79 | 52 | ? | 15 | 14 | ? | ? | 52 | ? | 15 | ? |
Примечание: Этот API основан на API chrome.runtime от Chromium. Эта документация взята из runtime.json кода Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onStartup