tabs.Tab

型別 tabs.Tab 包含有關標籤頁的資訊。它提供了訪問有關標籤頁內容、內容大小、生效的特殊狀態或限制等資訊的功能。

型別

此型別的值是物件。它們包含以下屬性:

啟用

boolean。標籤頁在其視窗中是否處於活動狀態。即使標籤頁所在的視窗當前未獲得焦點,此值也可能為 true

活動標籤頁通常是選中的那個。然而,在 Firefox for Android 上,擴充套件彈窗會在新標籤頁中開啟。當這個彈窗標籤頁被選中時,活動標籤頁將是開啟該彈窗的那個標籤頁。

attention 可選

boolean。指示標籤頁是否正在引起注意。例如,當標籤頁顯示模態對話方塊時,attention 將為 true

audible 可選

boolean。指示標籤頁是否正在發出聲音。但是,如果標籤頁被靜音,使用者將聽不到聲音(請參閱 mutedInfo 屬性)。

autoDiscardable 可選

boolean。標籤頁是否可以被瀏覽器丟棄。預設值為 true。當設定為 false 時,瀏覽器無法自動丟棄該標籤頁。但是,該標籤頁可以透過 tabs.discard 進行丟棄。

cookieStoreId 可選

string。標籤頁的 Cookie 儲存區。有關更多資訊,請參閱 使用上下文身份

discarded 可選

boolean。標籤頁是否已被丟棄。已丟棄的標籤頁是指其內容已從記憶體中解除安裝,但在標籤欄中仍然可見。下次啟用時,其內容會被重新載入。

favIconUrl 可選

string。標籤頁圖示的 URL。僅當擴充套件程式具有 "tabs" 許可權主機許可權 時才存在。如果頁面沒有圖示,它也可能為 undefined,或者如果標籤頁正在載入,則為空字串。

groupId 可選

integer。標籤頁所屬的標籤組的 ID。如果標籤頁不屬於任何標籤組,則設定為 -1tabGroups.TAB_GROUP_ID_NONE)。請參閱 tabs.group。有關標籤組的更多資訊,請參閱 tabGroups

height 可選

integer。標籤頁的高度(以畫素為單位)。

hidden

boolean。標籤頁是否隱藏。

highlighted

boolean。標籤頁是否被高亮顯示,即是否是當前標籤頁選擇的一部分。活動標籤頁始終被高亮顯示,但某些瀏覽器可能允許其他標籤頁被高亮顯示,例如透過按住 CtrlShift⌘ Command 鍵點選它們。

Firefox for Android 不支援同時高亮顯示多個標籤頁。

id 可選

integer。標籤頁的 ID。標籤頁 ID 在瀏覽器會話中是唯一的。對於不託管內容標籤頁的瀏覽器視窗(例如,開發者工具視窗),標籤頁 ID 也可能被設定為 tabs.TAB_ID_NONE

incognito

boolean。標籤頁是否處於隱私瀏覽視窗中。

index

integer。標籤頁在其視窗中的零基索引。

isArticle

boolean。如果標籤頁可以 以閱讀模式顯示,則為 true,否則為 false

isInReaderMode

boolean。如果標籤頁當前正 以閱讀模式顯示,則為 true,否則為 false

lastAccessed 可選

double。上次訪問標籤頁的時間,以 自紀元以來的毫秒數 表示。

mutedInfo 可選

tabs.MutedInfo。標籤頁當前的靜音狀態以及上次狀態更改的原因。

openerTabId 可選

integer。如果標籤頁是由另一個標籤頁開啟的,則為開啟該標籤頁的標籤頁 ID。此屬性僅在開啟它的標籤頁仍然存在並且在同一個視窗中時才存在。

pendingUrl

string。標籤頁在提交之前正在導航到的 URL。此屬性僅在擴充套件程式的 manifest 包含 "tabs" 許可權且存在待處理導航時才存在。

pinned

boolean。標籤頁是否被固定。

selected 已棄用

boolean。標籤頁是否被選中。此屬性已被 activehighlighted 替換。

sessionId 可選

string。用於唯一標識從 sessions API 獲取的 Tab 的會話 ID。

status 可選

stringloadingcomplete

successorTabId 可選

integer 標籤頁的後繼標籤頁 ID。

title 可選

string。標籤頁的標題。僅當擴充套件程式具有與標籤頁 URL 匹配的 "tabs" 許可權主機許可權 時才存在。

url 可選

string。標籤頁正在顯示的文件的 URL。僅當擴充套件程式具有 "tabs" 許可權 或匹配的 主機許可權 時才存在。

width 可選

integer。標籤頁的寬度(以畫素為單位)。

windowId

integer。承載此標籤頁的視窗的 ID。

擴充套件程式示例

瀏覽器相容性

注意:此 API 基於 Chromium 的 chrome.tabs API。本文件源自 Chromium 程式碼中的 tabs.json