tabs.Tab

tabs.Tab 包含有关标签页的信息 . 这样可以访问有关标签页中的内容,内容有多大,特殊状态或限制有效的信息等等。

类型

这种类型的值是对象。它包含以下属性:

active

boolean. 该标签页是否在其窗口中处于活动状态。即使标签的窗口当前没有被关注,也可能是 true。

audible 可选

boolean. 如果标签页没有静音:标签页是否正在发出声音。如果标签页被静音:如果没有静音标签页是否会发出声音。

autoDiscardable 可选

boolean. 资源不足时浏览器是否可以自动丢弃该标签页。

cookieStoreId 可选

string. 该标签页的 Cookie 存储。如果不同的标签可以有不同的 cookie 存储 (例如,支持 contextual identity), 你可以将此作为 storeId 选项传递给 cookies API 的各种方法,设置和获取与此标签页的 Cookie 存储关联的 Cookie。只有在扩展具有“cookies”权限的情况下才会出现。

discarded 可选

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

favIconUrl 可选

string. 该标签的图标的网址。只有在扩展具有“cookies”权限的情况下才会出现。如果标签页正在加载中,该值可以为空字符串

height 可选

integer. 标签页的像素单位高度。

highlighted

boolean. 标签页是否突出显示。

id 可选

integer. 标签页的 ID. 标签 ID 在浏览器的会话中是唯一的。在浏览器窗口中不包含内容的标签页 (例如,devtools 窗口),标签 ID 也可以设置为 tabs.TAB_ID_NONE (en-US)

incognito

boolean. 该标签页是否在隐私浏览窗口中。

index

integer. 窗口中的标签页从零开始的索引。

isArticle

boolean. 如果标签页可以在 Reader 模式下呈现,则返回 true,否则返回 false。

isInReaderMode

boolean. 如果标签页正在 Reader 模式下呈现,则返回 true,否则返回 false。

lastAccessed

double. 上次访问该标签页的时间 , 参考 milliseconds since the epoch.

mutedInfo 可选

tabs.MutedInfo (en-US).标签页的当前静音状态以及上次状态更改的原因。

openerTabId 可选

integer. 打开此标签页的标签页 ID(如果有)。如果开启者标签页仍然存在,该属性才会出现。

pinned

boolean. 标签页是否被固定

selected 已弃用

boolean.标签页是否被选中

sessionId 可选

string. 从sessions (en-US) API 获取的标签页的唯一标识会话 ID.

status 可选

string.加载完成.

title 可选

string. 标签页的标题。只有当扩展具有 "tabs" 权限 时才会出现。

url 可选

string. 该选项卡正在显示的文档的 URL。只有当扩展具有 "tabs" 权限 时才会出现。

width 可选

integer. 标签页的像素单位宽度。

windowId

integer. 包含此标签页的窗口 ID。

浏览器兼容性

BCD tables only load in the browser

Example extensions

备注: 此 API 基于 Chromium 的 chrome.tabs API. 本文档来源于 Chromium 代码中的 tabs.json.

Microsoft Edge 兼容性数据由 Microsoft Corporation 提供,并包含在 Creative Commons Attribution 3.0 美国许可证下。