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可选url可选width可选-
integer。标签页的宽度(以像素为单位)。 windowId-
integer。承载此标签页的窗口的 ID。
扩展程序示例
浏览器兼容性
加载中…
注意:此 API 基于 Chromium 的 chrome.tabs API。本文档源自 Chromium 代码中的 tabs.json。