sessions.setTabValue()

Сохраняет пару «ключ/значение» для ассоциации с заданным вкладом. После этого вы можете получить это значение с помощью sessions.getTabValue.

Обратите внимание, что эти данные будут видны только расширению, которое их установило, а не другим расширениям.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let storing = browser.sessions.setTabValue(
  tabId,    // integer
  key,      // string
  value     // string or object
)

Параметры

tabId: integer. Идентификатор вкладки, с которой вы хотите связать данные. Если идентификатор неверный, будет выброшено исключение.
key: string. Ключ, который вы можете позже использовать для получения этого конкретного значения данных.
value: string или object. Если это объект, он сериализуется в строку с помощью stringified, поэтому методы объекта, например, будут пропущены. Если здесь задана функция, она будет сохранена как значение null.

Возвращаемое значение

A Promise, который будет разрешён без аргументов, если вызов выполнился успешно. Если вызов завершился неудачно (например, из-за того, что вкладку с данным ID не удалось найти), то промис будет отклонен с сообщением об ошибке.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`setTabValue`	Нет	Нет	57	?	Нет	Нет	?	?	Нет	?	Нет	?

Примеры

Установите значение на активной вкладке, когда пользователь выбирает элемент меню. Обратите внимание, что для выполнения этого примера вам понадобится разрешение «menus» разрешение:

async function setOnActiveTab() {
  let tabArray = await browser.tabs.query({currentWindow: true, active: true});
  let tabId = tabArray[0].id;
  await browser.sessions.setTabValue(tabId, "my-key", "my-value");
}

browser.menus.create({
  id: "my-item",
  title: "my item",
  contexts: ["all"]
});

browser.menus.onClicked.addListener(setOnActiveTab);

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

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/setTabValue