Описание
Используйте API chrome.tabGroups
для взаимодействия с системой группировки вкладок браузера. Вы можете использовать этот API для изменения и изменения порядка групп вкладок в браузере. Чтобы группировать и разгруппировать вкладки или запрашивать, какие вкладки входят в группы, используйте API chrome.tabs
.
Разрешения
tabGroups
Доступность
Типы
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,
)
Вызывается при создании группы.
Параметры
- перезвонить
функция
Параметр
callback
выглядит так:(group: TabGroup) => void
- группа
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
Вызывается, когда группа перемещается внутри окна. События перемещения по-прежнему вызываются для отдельных вкладок внутри группы, а также для самой группы. Это событие не вызывается при перемещении группы между окнами; вместо этого он будет удален из одного окна и создан в другом.
Параметры
- перезвонить
функция
Параметр
callback
выглядит так:(group: TabGroup) => void
- группа
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Вызывается, когда группа закрывается либо непосредственно пользователем, либо автоматически, поскольку в ней нет вкладок.
Параметры
- перезвонить
функция
Параметр
callback
выглядит так:(group: TabGroup) => void
- группа
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Вызывается при обновлении группы.
Параметры
- перезвонить
функция
Параметр
callback
выглядит так:(group: TabGroup) => void
- группа