tabs.hide()
Скрывает одну или несколько вкладок.
Скрытые вкладки больше не отображаются в строке вкладок браузера. Скрытые вкладки не закрываются автоматически: код, выполняемый в них, продолжает выполняться. Вы можете явно закрыть вкладки всякий раз, когда скрываете их: хотя это не всегда уместно, это поможет уменьшить ресурсы, используемые браузером.
Это асинхронная функция, которая возвращает Promise.
Не все вкладки подходят для скрытия:
- Вкладки, которые закреплены, скрыть нельзя.
- Вкладки, которые используют экран, микрофон или камеру, скрыть нельзя.
- Текущую активную вкладку скрыть нельзя.
- Вкладки, которые в процессе закрытия, скрыть нельзя.
В первый раз, когда расширение скрывает вкладку, браузер сообщит пользователю, что вкладка скрывается, покажет, как можно получить доступ к скрытой вкладке, и предоставит возможность отключить расширение вместо этого.
Для использования этого API необходимо разрешение «tabHide» разрешение.
Синтаксис
let hiding = browser.tabs.hide( tabIds // integer or integer array )
Параметры
tabIds-
integerилиarrayinteger. Идентификаторы вкладки или вкладок для скрытия.Если какая-либо из этих вкладок не подходит для скрытия, она не будет скрыта, но вызов всё равно выполнится успешно, а подходящие вкладки будут скрыты. Например, если вы передаёте
[1, 3], и1идентифицирует активную вкладку, то только3будет скрыта.Однако, если любой из идентификаторов вкладок недействителен, вызов завершится ошибкой, и никакие вкладки не будут скрыты.
Возвращаемое значение
A Promise, который будет выполнен с массивом, содержащим идентификаторы скрытых вкладок. Если произойдёт какая-либо ошибка, обещание будет отклонено с сообщением об ошибке.
Примеры
Скрыть одну вкладку:
function onHidden() { console.log(`Hidden`); } function onError(error) { console.log(`Error: ${error}`); } browser.tabs.hide(2).then(onHidden, onError);
Скрыть несколько вкладок:
function onHidden() { console.log(`Hidden`); } function onError(error) { console.log(`Error: ${error}`); } browser.tabs.hide([15, 14, 1]).then(onHidden, onError);
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
hide |
Нет | Нет | 61 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
© 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/tabs/hide