chrome.tabГруппы

Описание

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

Разрешения

tabGroups

Доступность

Chrome 89+ MV3+

Типы

Color

Цвет группы.

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

"серый"

"синий"

"красный"

"желтый"

"зеленый"

"розовый"

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

"голубой"

"апельсин"

TabGroup

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

  • рухнул

    булев

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

  • цвет

    Цвет

    Цвет группы.

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

    число

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

  • поделился

    булев

    Хром 137+

    Является ли группа общей.

  • заголовок

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

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

  • windowId

    число

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

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

TAB_GROUP_ID_NONE

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

Ценить

-1

Методы

get()

chrome.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

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

Параметры

  • groupId

    число

Возврат

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

    Хром 90+

move()

chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

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

Параметры

  • groupId

    число

    Идентификатор группы для перемещения.

  • moveProperties

    объект

    • индекс

      число

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

    • windowId

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

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

Возврат

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

    Хром 90+

query()

chrome.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

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

Параметры

  • queryInfo

    объект

    • рухнул

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

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

    • цвет

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

      Цвет групп.

    • поделился

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

      Хром 137+

      Является ли группа общей.

    • заголовок

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

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

    • windowId

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

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

Возврат

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

    Хром 90+

update()

chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

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

Параметры

  • groupId

    число

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

  • updateProperties

    объект

    • рухнул

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

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

    • цвет

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

      Цвет группы.

    • заголовок

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

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

Возврат

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

    Хром 90+

События

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,
)

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

Параметры