Spec-Zone.ru › Web Extensions

tabs.hide()

Скрывает одну или несколько вкладок.

Скрытые вкладки больше не отображаются в строке вкладок браузера. Скрытые вкладки не закрываются автоматически: код, выполняемый в них, продолжает выполняться. Вы можете явно закрыть вкладки всякий раз, когда скрываете их: хотя это не всегда уместно, это поможет уменьшить ресурсы, используемые браузером.

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

Не все вкладки подходят для скрытия:

  • Вкладки, которые закреплены, скрыть нельзя.
  • Вкладки, которые используют экран, микрофон или камеру, скрыть нельзя.
  • Текущую активную вкладку скрыть нельзя.
  • Вкладки, которые в процессе закрытия, скрыть нельзя.

В первый раз, когда расширение скрывает вкладку, браузер сообщит пользователю, что вкладка скрывается, покажет, как можно получить доступ к скрытой вкладке, и предоставит возможность отключить расширение вместо этого.

Для использования этого API необходимо разрешение «tabHide» разрешение.

Синтаксис

let hiding = browser.tabs.hide(
  tabIds          // integer or integer array
)

Параметры

tabIds

integer или array integer. Идентификаторы вкладки или вкладок для скрытия.

Если какая-либо из этих вкладок не подходит для скрытия, она не будет скрыта, но вызов всё равно выполнится успешно, а подходящие вкладки будут скрыты. Например, если вы передаёте [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

Spec-Zone.ru

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