Spec-Zone.ru › Web Extensions

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);
});

Примеры расширений

  • session-state

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API