sessions.removeTabValue()

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

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

Синтаксис

let removing = browser.sessions.removeTabValue(
  tabId,    // integer
  key       // string
)

Параметры

tabId: integer. ID вкладки, данные которой нужно удалить. Бросает ошибку, если ID недействителен.
key: string. Ключ, идентифицирующий конкретное значение для удаления. Он должен совпадать с ключом, ранее предоставленным в sessions.setTabValue.

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

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

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

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

Примеры

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

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

async function removeFromActiveTab() {
  let tabArray = await browser.tabs.query({currentWindow: true, active: true});
  let tabId = tabArray[0].id;
  await browser.sessions.removeTabValue(tabId, "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") {
    setOnActiveTab();
  } else {
    removeFromActiveTab();
  }
});

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