Spec-Zone.ru › Web Extensions

sessions.getWindowValue()

Возвращает значение, ранее сохраненное вызовом sessions.setWindowValue.

Вы можете получить значение из окна даже после цикла закрытия/восстановления: если вы установили значение, а затем пользователь закрыл окно, а затем восстановил его с помощью функции «восстановить окно» браузера (например, нажав Ctrl+Shift+N), вы сможете получить значение из восстановленного окна. Однако обратите внимание, что восстановленное окно не получает тот же идентификатор, что и исходное, поэтому идентификатор, который вы передаёте в getWindowValue(), будет отличаться от идентификатора, который вы передали в setWindowValue(), даже если они оба ссылаются на одно и то же окно.

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

Синтаксис

let retrieving = browser.sessions.getWindowValue(
  windowId,    // integer
  key          // string
)

Параметры

windowId

integer. Идентификатор окна, данные которого вы пытаетесь получить. Если идентификатор недействителен, выбросится ошибка.

key

string. Ключ, идентифицирующий конкретное значение для извлечения. Он должен совпадать с ключом, ранее указанным в sessions.setWindowValue.

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

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

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

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

Примеры

Вывести значение «my-key» для всех новых окон (включая окна, которые были восстановлены):

function onGetResolved(r) {
  console.log(`success: ${r}`);
}

function onGetRejected(e) {
  console.log(`error: ${e}`);
}

browser.windows.onCreated.addListener((window) => {
  browser.sessions.getWindowValue(window.id, "my-key").then(onGetResolved, onGetRejected);
});

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

Spec-Zone.ru

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