sessions.removeWindowValue()

Удаляет значение, ранее сохраненное с помощью вызова sessions.setWindowValue.

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

Синтаксис

let removing = browser.sessions.removeWindowValue(
  windowId,    // integer
  key          // string
)

Параметры

windowId: integer. Идентификатор окна, данные которого необходимо удалить. Если идентификатор недействителен, будет выброшено исключение.
key: string. Ключ, идентифицирующий удаляемое значение. Он должен совпадать с ключом, предоставленным ранее в sessions.setWindowValue.

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

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

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

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

Примеры

Этот код добавляет два пункта контекстного меню: один сохраняет значение, связанное с текущим окном, а другой его удаляет:

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

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

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

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

browser.menus.onClicked.addListener((info) => {
  if (info.menuItemId === "add-my-item") {
    setOnActiveWindow();
  } else {
    removeFromActiveWindow();
  }
});

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