tabs.Tab

Тип tabs.Tab содержит информацию о вкладке. Он предоставляет доступ к данным о содержимом вкладки, его размерах, особых состояниях или ограничениях и т.д.

Тип

Значения этого типа представляют собой объекты. Они содержат следующие свойства:

active

boolean. Указывает, активна ли вкладка в окне. Это может быть истинно, даже если окно вкладки не является в данный момент фокусированным.

Активная вкладка, как правило, является выбранной. Однако в Firefox для Android всплывающие окна расширений открываются в новой вкладке. При выборе этой вкладки, активной станет та вкладка, в которой было открыто всплывающее окно.

attention Необязательно

boolean. Указывает, привлекает ли вкладка внимание. Например, когда вкладка отображает модальное диалоговое окно, значение attention будет true.

audible Необязательно

boolean. Указывает, воспроизводит ли вкладка звук. Однако пользователь не услышит звук, если вкладка заглушена (см. свойство mutedInfo).

autoDiscardable Необязательно

boolean. Указывает, может ли браузер автоматически отбросить вкладку, когда ресурсы ограничены.

cookieStoreId Необязательно

string. Хранилище cookie вкладки. Если разные вкладки могут иметь разные хранилища cookie (например, для поддержки контекстуальной идентификации), вы можете передать это как параметр storeId в различные методы API cookies для установки и получения cookie, связанных с хранилищем cookie этой вкладки. Присутствует только если у расширения есть "cookies" разрешение.

discarded Необязательно

boolean. Указывает, отброшена ли вкладка. Отброшенная вкладка — это та, содержимое которой было загружено из памяти, но она всё ещё видна в строке вкладок. Её содержимое перезагружается при следующем активации.

favIconUrl Необязательно

string. URL значка вкладки. Присутствует только если у расширения есть "tabs" разрешение или разрешения на хост. Также может быть undefined если у страницы нет значка или пустой строкой, если вкладка загружается.

height Необязательно

integer. Высота вкладки в пикселях.

hidden

boolean. Скрыта ли вкладка.

highlighted

boolean. Выделена ли вкладка, т.е. входит в текущий выбор вкладок. Активная вкладка всегда выделена, но некоторые браузеры могут позволять выделять дополнительные вкладки, например, нажав их, удерживая клавиши Ctrl, Shift или ⌘ Command.

Firefox для Android не поддерживает выделение нескольких вкладок, а Firefox для настольных компьютеров требует предпочтения browser.tabs.multiselect (включено по умолчанию).

id Необязательно

integer. Идентификатор вкладки. Идентификаторы вкладок уникальны в рамках сеанса браузера. Идентификатор вкладки также может быть задан как tabs.TAB_ID_NONE для окон браузера, которые не содержат вкладок с содержимым (например, окна разработчика).

incognito

boolean. Открыта ли вкладка в окне приватного просмотра.

index

integer. Нумерация вкладки в окне, начиная с нуля.

isArticle

boolean. Истинно, если вкладку можно отобразить в режиме чтения, ложно в противном случае.

isInReaderMode

boolean. Истинно, если вкладка в данный момент отображается в режиме чтения, ложно в противном случае.

lastAccessed

double. Время последнего доступа к вкладке в миллисекундах с начала эпохи .

mutedInfo Необязательно

tabs.MutedInfo. Текущее состояние заглушения вкладки и причина последнего изменения состояния.

openerTabId Необязательно

integer. Идентификатор вкладки, открывшей текущую вкладку, если таковая имеется. Это свойство присутствует только если вкладка-открыватель всё ещё существует и находится в том же окне.

pinned

boolean. Прикреплена ли вкладка.

selected Устарело

boolean. Выбрана ли вкладка. Это свойство заменено на active и highlighted.

sessionId Необязательно

string. Идентификатор сеанса, используемый для уникальной идентификации Tab, полученный из API sessions.

status Необязательно

string. Либо загрузка, либо завершено.

successorTabId Необязательно

integer Идентификатор преемника вкладки.

title Необязательно

string. Заголовок вкладки. Присутствует только если у расширения есть "tabs" разрешение или разрешения на хост, соответствующие URL вкладки.

url Необязательно

string. URL документа, отображаемого в вкладке. Присутствует только если у расширения есть "tabs" разрешение или соответствующие разрешения на хост.

width Необязательно

integer. Ширина вкладки в пикселях.

windowId

integer. Идентификатор окна, содержащего эту вкладку.

Совместимость с браузерами

	Настольный						Мобильный
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`active`	16	14	45	?	15	14	?	?	54	?	15	?
`audible`	45	79	45	?	32	14	?	?	54	?	15	?
`autoDiscardable`	54	79	No	?	41	No	?	?	No	?	No	?
`cookieStoreId`	No	No	52	?	No	No	?	?	No	?	No	?
`discarded`	54	79	57	?	41	No	?	?	57–79	?	No	?
`favIconUrl`	5	14	45	?	15	No	?	?	No	?	No	?
`height`	31	79	45	?	18	14	?	?	54	?	15	?
`highlighted`	16	79	45	?	15	14	?	?	54–79	?	15	?
`id`	5	14	45	?	15	14	?	?	54	?	15	?
`incognito`	16	14	45	?	15	14	?	?	54	?	15	?
`index`	5	14	45	?	15	14	?	?	54	?	15	?
`isArticle`	No	No	58	?	No	No	?	?	No	?	No	?
`isInReaderMode`	No	No	58	?	No	No	?	?	No	?	No	?
`lastAccessed`	No	No	56	?	No	No	?	?	56	?	No	?
`mutedInfo`	46	79	45	?	33	14 `reason` and `extensionId` will not be populated.	?	?	54	?	No	?
`openerTabId`	18	79	57	?	15	14	?	?	No	?	15	?
`pinned`	9	14	45	?	15	14	?	?	54	?	No	?
`selected`	5	79	45	?	15	14	?	?	54	?	15	?
`sessionId`	31	79	52	?	18	No	?	?	No	?	No	?
`status`	5	14	45	?	15	14	?	?	54	?	15	?
`successorTabId`	No	No	65	?	No	No	?	?	No	?	No	?
`title`	5	14	45	?	15	14	?	?	54	?	15	?
`url`	5	14	45	?	15	14	?	?	54	?	15	?
`width`	31	79	45	?	18	14	?	?	54	?	15	?
`windowId`	5	14	45	?	15	14	?	?	54	?	15	?

Примеры расширений

Примечание: Этот API основан на API chrome.tabs Chromium. Эта документация получена из tabs.json в коде Chromium.

© 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/Tab