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