tabs.Tab
型別 tabs.Tab 包含有關標籤頁的資訊。它提供了訪問有關標籤頁內容、內容大小、生效的特殊狀態或限制等資訊的功能。
型別
此型別的值是物件。它們包含以下屬性:
啟用-
boolean。標籤頁在其視窗中是否處於活動狀態。即使標籤頁所在的視窗當前未獲得焦點,此值也可能為true。活動標籤頁通常是選中的那個。然而,在 Firefox for Android 上,擴充套件彈窗會在新標籤頁中開啟。當這個彈窗標籤頁被選中時,活動標籤頁將是開啟該彈窗的那個標籤頁。
attention可選-
boolean。指示標籤頁是否正在引起注意。例如,當標籤頁顯示模態對話方塊時,attention將為true。 audible可選-
boolean。指示標籤頁是否正在發出聲音。但是,如果標籤頁被靜音,使用者將聽不到聲音(請參閱mutedInfo屬性)。 autoDiscardable可選-
boolean。標籤頁是否可以被瀏覽器丟棄。預設值為true。當設定為false時,瀏覽器無法自動丟棄該標籤頁。但是,該標籤頁可以透過tabs.discard進行丟棄。 -
string。標籤頁的 Cookie 儲存區。有關更多資訊,請參閱 使用上下文身份。 discarded可選-
boolean。標籤頁是否已被丟棄。已丟棄的標籤頁是指其內容已從記憶體中解除安裝,但在標籤欄中仍然可見。下次啟用時,其內容會被重新載入。 favIconUrl可選-
string。標籤頁圖示的 URL。僅當擴充套件程式具有"tabs"許可權 或 主機許可權 時才存在。如果頁面沒有圖示,它也可能為undefined,或者如果標籤頁正在載入,則為空字串。 groupId可選-
integer。標籤頁所屬的標籤組的 ID。如果標籤頁不屬於任何標籤組,則設定為-1(tabGroups.TAB_GROUP_ID_NONE)。請參閱tabs.group。有關標籤組的更多資訊,請參閱tabGroups。 height可選-
integer。標籤頁的高度(以畫素為單位)。 -
boolean。標籤頁是否隱藏。 highlighted-
boolean。標籤頁是否被高亮顯示,即是否是當前標籤頁選擇的一部分。活動標籤頁始終被高亮顯示,但某些瀏覽器可能允許其他標籤頁被高亮顯示,例如透過按住 Ctrl、Shift 或 ⌘ 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。標籤頁是否被選中。此屬性已被active和highlighted替換。 sessionId可選-
string。用於唯一標識從sessionsAPI 獲取的Tab的會話 ID。 status可選-
string。loading 或 complete。 successorTabId可選-
integer標籤頁的後繼標籤頁 ID。 title可選-
string。標籤頁的標題。僅當擴充套件程式具有與標籤頁 URL 匹配的"tabs"許可權 或 主機許可權 時才存在。 url可選-
string。標籤頁正在顯示的文件的 URL。僅當擴充套件程式具有"tabs"許可權 或匹配的 主機許可權 時才存在。 width可選-
integer。標籤頁的寬度(以畫素為單位)。 windowId-
integer。承載此標籤頁的視窗的 ID。
擴充套件程式示例
瀏覽器相容性
載入中…
注意:此 API 基於 Chromium 的 chrome.tabs API。本文件源自 Chromium 程式碼中的 tabs.json。