sessions.getTabValue()
Возвращает значение, ранее сохранённое с помощью вызова sessions.setTabValue.
Вы можете получить значение вкладки даже после её закрытия и восстановления: если вы установили значение, а затем пользователь закрыл вкладку, а потом восстановил её с помощью функции «Восстановить вкладку» браузера (например, нажав Control+Shift+T), вы сможете получить значение из восстановленной вкладки. Однако обратите внимание, что восстановленная вкладка не получает тот же идентификатор, что и исходная, поэтому идентификатор, который вы передаёте в getTabValue(), будет отличаться от идентификатора, который вы передали в setTabValue(), даже если они оба ссылаются на одну и ту же вкладку.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
let retrieving = browser.sessions.getTabValue( tabId, // integer key // string )
Параметры
tabId-
integer. Идентификатор вкладки, данные которой вы пытаетесь получить. Если идентификатор недействителен, будет выброшено исключение. key-
string. Ключ, определяющий конкретное значение для получения. Он должен совпадать с ключом, ранее предоставленным вsessions.setTabValue.
Возвращаемое значение
A Promise, который будет разрешён со значением, если оно существует, или undefined если оно не существует. Если вызов завершился ошибкой (например, из-за того, что идентификатор вкладки не был найден), обещание будет отклонено с сообщением об ошибке.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
getTabValue |
Нет | Нет | 57 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры
Выведите значение «my-key» для всех вновь созданных вкладок (включая восстановленные):
function onGetResolved(r) { console.log(`success: ${r}`); } function onGetRejected(e) { console.log(`error: ${e}`); } browser.tabs.onCreated.addListener((tab) => { browser.sessions.getTabValue(tab.id, "my-key").then(onGetResolved, onGetRejected); });
Примеры расширений
© 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/sessions/getTabValue