chrome.tabГруппы

Описание

Используйте API chrome.tabGroups для взаимодействия с системой группировки вкладок браузера. Вы можете использовать этот API для изменения и изменения порядка групп вкладок в браузере. Чтобы группировать и разгруппировать вкладки или запрашивать, какие вкладки входят в группы, используйте API chrome.tabs .

Разрешения

tabGroups

Доступность

Хром 89+ МВ3+

Типы

Color

Цвет группы.

Перечисление

"серый"

"синий"

"красный"

"желтый"

"зеленый"

"розовый"

"фиолетовый"

"голубой"

"апельсин"

TabGroup

Характеристики

  • рухнул

    логическое значение

    Свернута ли группа. Свернутая группа — это группа, вкладки которой скрыты.

  • цвет

    Цвет

    Цвет группы.

  • идентификатор

    число

    Идентификатор группы. Идентификаторы групп уникальны в рамках сеанса браузера.

  • заголовок

    строка необязательна

    Название группы.

  • идентификатор окна

    число

    Идентификатор окна, содержащего группу.

Характеристики

TAB_GROUP_ID_NONE

Идентификатор, обозначающий отсутствие группы.

Ценить

-1

Методы

get()

Обещать
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

Получает сведения об указанной группе.

Параметры

  • идентификатор группы

    число

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (group: TabGroup) => void

Возврат

  • Обещание< TabGroup >

    Хром 90+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

move()

Обещать
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Перемещает группу и все ее вкладки внутри окна или в новое окно.

Параметры

  • идентификатор группы

    число

    Идентификатор группы, которую нужно переместить.

  • перемещениеСвойства

    объект

    • индекс

      число

      Позиция, в которую следует переместить группу. Используйте -1 , чтобы поместить группу в конец окна.

    • идентификатор окна

      номер необязательно

      Окно, в которое можно переместить группу. По умолчанию это окно, в котором в данный момент находится группа. Обратите внимание, что группы можно перемещать в окна и обратно только с типом windows.WindowType "normal" .

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (group?: TabGroup) => void

Возврат

  • Обещание< TabGroup | не определено>

    Хром 90+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

query()

Обещать
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

Получает все группы с указанными свойствами или все группы, если свойства не указаны.

Параметры

  • запросИнформация

    объект

    • рухнул

      логическое значение необязательно

      Свернуты ли группы.

    • цвет

      Цвет по желанию

      Цвет групп.

    • заголовок

      строка необязательна

      Сопоставьте названия групп с образцом.

    • идентификатор окна

      номер необязательно

      Идентификатор родительского окна или windows.WINDOW_ID_CURRENT для текущего окна .

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: TabGroup[]) => void

Возврат

  • Обещание< TabGroup []>

    Хром 90+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

update()

Обещать
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

Изменяет свойства группы. Свойства, не указанные в updateProperties не изменяются.

Параметры

  • идентификатор группы

    число

    Идентификатор группы, которую необходимо изменить.

  • ОбновлениеСвойства

    объект

    • рухнул

      логическое значение необязательно

      Следует ли свернуть группу.

    • цвет

      Цвет по желанию

      Цвет группы.

    • заголовок

      строка необязательна

      Название группы.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (group?: TabGroup) => void

Возврат

  • Обещание< TabGroup | не определено>

    Хром 90+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

События

onCreated

chrome.tabGroups.onCreated.addListener(
  callback: function,
)

Вызывается при создании группы.

Параметры

onMoved

chrome.tabGroups.onMoved.addListener(
  callback: function,
)

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

Параметры

onRemoved

chrome.tabGroups.onRemoved.addListener(
  callback: function,
)

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

Параметры

onUpdated

chrome.tabGroups.onUpdated.addListener(
  callback: function,
)

Вызывается при обновлении группы.

Параметры