tabs.Tab
tabs.Tab
包含有关标签页的信息 . 这样可以访问有关标签页中的内容,内容有多大,特殊状态或限制有效的信息等等。
类型
这种类型的值是对象。它包含以下属性:
active
-
boolean
. 该标签页是否在其窗口中处于活动状态。即使标签的窗口当前没有被关注,也可能是 true。 audible
可选-
boolean
. 如果标签页没有静音:标签页是否正在发出声音。如果标签页被静音:如果没有静音标签页是否会发出声音。 autoDiscardable
可选-
boolean
. 资源不足时浏览器是否可以自动丢弃该标签页。 -
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
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 美国许可证下。