sessions.setWindowValue()

Сохраняет пару «ключ/значение», связанную с заданным окном. Впоследствии вы можете извлечь это значение, используя sessions.getWindowValue.

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

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

Синтаксис

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

Параметры

windowId: integer. Идентификатор окна, с которым вы хотите связать данные. Если ID некорректен, будет выброшено исключение.
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
`setWindowValue`	Нет	Нет	57	?	Нет	Нет	?	?	Нет	?	Нет	?

Примеры

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

async function setOnActiveWindow() {
  let currentWindow = await browser.windows.getLastFocused();
  await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value");
}

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

browser.menus.onClicked.addListener(setOnActiveWindow);

© 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/setWindowValue