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