选项卡.选项卡

类型tabs.Tab包含有关选项卡的信息。这提供了对有关选项卡中包含的内容、内容的大小、生效的特殊状态或限制等信息进行访问。

类型

此类型的值为对象。它们包含以下属性

活动

布尔值。选项卡在其窗口中是否处于活动状态。即使选项卡的窗口当前未处于焦点状态,这也可能为真。

活动选项卡通常是选定的选项卡。但是,在 Android 版 Firefox 中,扩展程序弹出窗口在新选项卡中打开。当选择此弹出窗口选项卡时,活动选项卡将改为弹出窗口打开的选项卡。

attention 可选

布尔值。指示选项卡是否正在引起注意。例如,当选项卡显示模式对话框时,attention 将为 true

audible 可选

布尔值。指示选项卡是否正在发出声音。但是,如果选项卡已静音,则用户将听不到声音(请参阅 mutedInfo 属性)。

autoDiscardable 可选

布尔值。浏览器是否可以丢弃选项卡。默认值为 true。当设置为 false 时,浏览器无法自动丢弃选项卡。但是,选项卡可以通过 tabs.discard 丢弃。

cookieStoreId 可选

字符串。选项卡的 Cookie 存储。有关更多信息,请参阅 使用上下文标识

discarded 可选

布尔值。选项卡是否已丢弃。已丢弃的选项卡是指其内容已从内存中卸载但仍在选项卡栏中可见的选项卡。下次激活时,其内容将重新加载。

favIconUrl 可选

字符串。选项卡收藏夹图标的 URL。仅当扩展程序具有 "tabs" 权限主机权限 时才显示。如果页面没有收藏夹图标,则也可能为 undefined,如果选项卡正在加载,则为空字符串。

height 可选

整数。选项卡的高度(以像素为单位)。

隐藏

布尔值。选项卡是否隐藏。

突出显示

布尔值。选项卡是否突出显示,即当前选项卡选择的一部分。活动选项卡始终突出显示,但某些浏览器可能允许突出显示其他选项卡,例如,在按住 CtrlShift⌘ Command 键的同时单击它们。

Android 版 Firefox 不支持突出显示多个选项卡。

id 可选

整数。选项卡的 ID。选项卡 ID 在浏览器会话中是唯一的。选项卡 ID 也可能设置为 tabs.TAB_ID_NONE,用于不承载内容选项卡的浏览器窗口(例如,开发者工具窗口)。

隐身模式

布尔值。选项卡是否位于私密浏览窗口中。

索引

整数。选项卡在其窗口中的基于零的索引。

isArticle

布尔值。如果选项卡可以 以阅读器模式呈现,则为真,否则为假。

isInReaderMode

布尔值。如果选项卡当前正在 以阅读器模式呈现,则为真,否则为假。

lastAccessed 可选

双精度浮点数。上次访问选项卡的时间,以 自纪元以来的毫秒数 为单位。

mutedInfo 可选

tabs.MutedInfo。选项卡的当前静音状态以及上次状态更改的原因。

openerTabId 可选

整数。如果存在,则打开此选项卡的选项卡的 ID。此属性仅在打开程序选项卡仍然存在且位于同一窗口中时才存在。

pendingUrl

字符串。选项卡正在导航到的 URL,在提交之前。此属性仅在扩展程序的清单包含“选项卡”权限并且存在挂起的导航时才存在。

固定

布尔值。选项卡是否固定。

selected 已弃用

布尔值。选项卡是否已选中。此属性已被 activehighlighted 替换。

sessionId 可选

字符串。用于唯一标识从 sessions API 获取的 Tab 的会话 ID。

status 可选

字符串加载中已完成

successorTabId 可选

整数 选项卡的后继者的 ID。

title 可选

字符串。选项卡的标题。仅当扩展程序具有"tabs" 权限 或与选项卡 URL 匹配的 主机权限 时才会出现。

url 可选

字符串。选项卡正在显示的文档的 URL。仅当扩展程序具有"tabs" 权限 或匹配的 主机权限 时才会出现。

width 可选

整数。选项卡的宽度(以像素为单位)。

windowId

整数。承载此选项卡的窗口的 ID。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例扩展

注意:此 API 基于 Chromium 的 chrome.tabs API。本文档源自 Chromium 代码中的 tabs.json