--- title: tabs.Tab slug: Mozilla/Add-ons/WebExtensions/API/tabs/Tab tags: - 扩展 - 标签 - 标签页 - 类型 - 非标准 - 页面扩展 translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab ---
{{AddonSidebar()}}

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

类型

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

active
boolean. 该标签页是否在其窗口中处于活动状态。即使标签的窗口当前没有被关注，也可能是true。
audible {{optional_inline}}
boolean. 如果标签页没有静音：标签页是否正在发出声音。如果标签页被静音：如果没有静音标签页是否会发出声音。
autoDiscardable {{optional_inline}}
boolean. 资源不足时浏览器是否可以自动丢弃该标签页。
cookieStoreId {{optional_inline}}
string. 该标签页的Cookie存储. 如果不同的标签可以有不同的cookie存储 (例如, 支持 contextual identity), you can pass this as the storeId option into various methods of the {{WebExtAPIRef("cookies")}} API, 设置和获取与此标签页的Cookie存储关联的Cookie。 只有在扩展名具有“cookies”权
string. 该标签页的Cookie存储. 如果不同的标签可以有不同的cookie存储 (例如, 支持 contextual identity), 你可以将此作为 storeId 选项传递给 {{WebExtAPIRef("cookies")}} API的各种方法, 设置和获取与此标签页的Cookie存储关联的Cookie。 只有在扩展具有“cookies”权限的情况下才会出现.
discarded {{optional_inline}}
boolean. 是否丢弃的标签页。被丢弃的标签页是其内容已经从内存中卸载的标签页，但在标签页条中仍可见。它的内容在下一次被激活时被重新加载。
favIconUrl {{optional_inline}}
string. 该标签的图标的网址。 只有在扩展具有“cookies”权限的情况下才会出现. 如果标签页正在加载中,该值可以为空字符串
height {{optional_inline}}
integer. 标签页的像素单位高度。
highlighted
boolean. 标签页是否突出显示。
id {{optional_inline}}
integer. 标签页的ID. 标签 ID在浏览器的会话中是唯一的 。 在浏览器窗口中不包含内容的标签页 (例如, devtools 窗口),标签 ID 也可以设置为 {{WebExtAPIRef('tabs.TAB_ID_NONE')}} 。
incognito
boolean. 该标签页是否在隐私浏览窗口中。
index
integer. 窗口中的标签页从零开始的索引。
isArticle
boolean. 如果标签页可以在 Reader模式下呈现，则返回true，否则返回false。
isInReaderMode
boolean. 如果标签页正在 Reader模式下呈现，则返回true，否则返回false。
lastAccessed
double. 上次访问该标签页的时间 , 参考 milliseconds since the epoch.
mutedInfo {{optional_inline}}
{{WebExtAPIRef('tabs.MutedInfo')}}.标签页的当前静音状态以及上次状态更改的原因。
openerTabId {{optional_inline}}
integer. 打开此标签页的标签页ID（如果有）。如果开启者标签页仍然存在，该属性才会出现。
pinned
boolean. 标签页是否被固定
selected {{deprecated_inline}}
boolean.标签页是否被选中
sessionId {{optional_inline}}
string. 从{{WebExtAPIRef('sessions')}} API 获取的标签页的唯一标识会话ID.
status {{optional_inline}}
string.加载 或 完成.
title {{optional_inline}}
string. 标签页的标题. 只有当扩展具有 "tabs" 权限 时才会出现.
url {{optional_inline}}
string. 该选项卡正在显示的文档的URL。只有当扩展具有 "tabs" 权限 时才会出现.
width {{optional_inline}}
integer. 标签页的像素单位宽度。
windowId
integer. 包含此标签页的窗口ID。

浏览器兼容性

{{Compat("webextensions.api.tabs.Tab", 10)}}

{{WebExtExamples}}

感谢

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

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