此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

tabs.Tab

tabs.Tab 类型包含有关标签页的信息。这提供了访问有关标签页内容、大小、特殊状态或限制等的信息。

类型

该类型的值为对象,包含以下属性:

active

boolean。标签页是否在其窗口中处于活动状态。即使标签页的窗口当前未被聚焦,此属性也可能为 true。

活动标签页通常是选定的标签页。但是,在 Android 版 Firefox 上,扩展弹出窗口会在新标签页中打开。当选择弹出窗口标签页时,活动标签页将是打开弹出窗口的标签页。

attention 可选

boolean。指示标签页是否正在吸引注意力。例如,当标签页显示模态对话框时,attention 将为 true。

audible 可选

boolean。指示标签页是否正在播放声音。但是,如果标签页已静音(参见 mutedInfo 属性),用户将听不到声音。

autoDiscardable 可选

boolean。标签页是否可以被浏览器丢弃。默认值为 true。当设置为 false 时,浏览器不能自动丢弃标签页,但可以通过 tabs.discard 进行丢弃。

cookieStoreId 可选

string。标签页的 cookie 存储。更多信息请参见使用上下文身份工作。

discarded 可选

boolean。标签页是否已被丢弃。已丢弃的标签页是指其内容已从内存中卸载,但在标签栏中仍可见。下次激活时,其内容将重新加载。

favIconUrl 可选

string。标签页的网站图标(favicon)的 URL。仅当扩展具有 "tabs" 权限或主机权限时才会显示。如果页面没有网站图标,则可能为 undefined,或者如果标签页正在加载,则为空字符串。

height 可选

integer。标签页的高度,以像素为单位。

hidden

boolean。标签页是否隐藏。

highlighted

boolean。标签页是否被突出显示,即是否为当前选定的标签页。活动标签页始终处于突出显示状态,但某些浏览器允许额外的标签页被突出显示,例如通过按住 Ctrl、Shift 或 ⌘ Command 键点击它们。

Android 版 Firefox 不支持突出显示多个标签页。

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,在提交之前有效。此属性仅在扩展清单包含“tabs”权限且存在待定导航时才会出现。

pinned

boolean。标签页是否被固定。

selected

boolean。标签页是否被选中。此属性已被 active 和 highlighted 替代。

sessionId 可选

string。用于唯一标识从 sessions API 获取的标签页的会话 ID。

status 可选

string。标签页的加载状态,可能为 loading 或 complete。

successorTabId 可选

integer。标签页的后继标签页的 ID。

title 可选

string。标签页的标题。仅当扩展具有 "tabs" 权限或匹配标签页 URL 的主机权限时才会显示。

url 可选

string。标签页显示的文档的 URL。仅当扩展具有 "tabs" 权限或匹配主机权限时才会显示。

width 可选

integer。标签页的宽度,以像素为单位。

windowId

integer。承载此标签页的窗口的 ID。

浏览器兼容性

示例扩展

备注:此 API 基于 Chromium 的 chrome.tabs API。该文档衍生自 Chromium 代码中的 tabs.json。