选项卡.选项卡
类型tabs.Tab
包含有关选项卡的信息。这提供了对有关选项卡中包含的内容、内容的大小、生效的特殊状态或限制等信息进行访问。
类型
此类型的值为对象。它们包含以下属性
活动
-
布尔值
。选项卡在其窗口中是否处于活动状态。即使选项卡的窗口当前未处于焦点状态,这也可能为真。活动选项卡通常是选定的选项卡。但是,在 Android 版 Firefox 中,扩展程序弹出窗口在新选项卡中打开。当选择此弹出窗口选项卡时,活动选项卡将改为弹出窗口打开的选项卡。
attention
可选-
布尔值
。指示选项卡是否正在引起注意。例如,当选项卡显示模式对话框时,attention
将为true
。 audible
可选-
布尔值
。指示选项卡是否正在发出声音。但是,如果选项卡已静音,则用户将听不到声音(请参阅mutedInfo
属性)。 autoDiscardable
可选-
布尔值
。浏览器是否可以丢弃选项卡。默认值为true
。当设置为false
时,浏览器无法自动丢弃选项卡。但是,选项卡可以通过tabs.discard
丢弃。 -
字符串
。选项卡的 Cookie 存储。有关更多信息,请参阅 使用上下文标识。 discarded
可选-
布尔值
。选项卡是否已丢弃。已丢弃的选项卡是指其内容已从内存中卸载但仍在选项卡栏中可见的选项卡。下次激活时,其内容将重新加载。 favIconUrl
可选-
字符串
。选项卡收藏夹图标的 URL。仅当扩展程序具有"tabs"
权限 或 主机权限 时才显示。如果页面没有收藏夹图标,则也可能为undefined
,如果选项卡正在加载,则为空字符串。 height
可选-
整数
。选项卡的高度(以像素为单位)。 -
布尔值
。选项卡是否隐藏。 突出显示
-
布尔值
。选项卡是否突出显示,即当前选项卡选择的一部分。活动选项卡始终突出显示,但某些浏览器可能允许突出显示其他选项卡,例如,在按住 Ctrl、Shift 或 ⌘ Command 键的同时单击它们。Android 版 Firefox 不支持突出显示多个选项卡。
id
可选-
整数
。选项卡的 ID。选项卡 ID 在浏览器会话中是唯一的。选项卡 ID 也可能设置为tabs.TAB_ID_NONE
,用于不承载内容选项卡的浏览器窗口(例如,开发者工具窗口)。 隐身模式
-
布尔值
。选项卡是否位于私密浏览窗口中。 索引
-
整数
。选项卡在其窗口中的基于零的索引。 isArticle
-
布尔值
。如果选项卡可以 以阅读器模式呈现,则为真,否则为假。 isInReaderMode
-
布尔值
。如果选项卡当前正在 以阅读器模式呈现,则为真,否则为假。 lastAccessed
可选-
双精度浮点数
。上次访问选项卡的时间,以 自纪元以来的毫秒数 为单位。 mutedInfo
可选-
tabs.MutedInfo
。选项卡的当前静音状态以及上次状态更改的原因。 openerTabId
可选-
整数
。如果存在,则打开此选项卡的选项卡的 ID。此属性仅在打开程序选项卡仍然存在且位于同一窗口中时才存在。 pendingUrl
-
字符串
。选项卡正在导航到的 URL,在提交之前。此属性仅在扩展程序的清单包含“选项卡”权限并且存在挂起的导航时才存在。 固定
-
布尔值
。选项卡是否固定。 selected
已弃用-
布尔值
。选项卡是否已选中。此属性已被active
和highlighted
替换。 sessionId
可选-
字符串
。用于唯一标识从sessions
API 获取的Tab
的会话 ID。 status
可选-
字符串
。加载中或已完成。 successorTabId
可选-
整数
选项卡的后继者的 ID。 title
可选url
可选width
可选-
整数
。选项卡的宽度(以像素为单位)。 windowId
-
整数
。承载此选项卡的窗口的 ID。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例扩展
注意:此 API 基于 Chromium 的 chrome.tabs
API。本文档源自 Chromium 代码中的 tabs.json
。