| title | slug | l10n | ||
|---|---|---|---|---|
tabs.Tab |
Mozilla/Add-ons/WebExtensions/API/tabs/Tab |
|
{{AddonSidebar}}
tabs.Tab 类型包含有关标签页的信息。这提供了访问有关标签页内容、大小、特殊状态或限制等的信息。
该类型的值为对象，包含以下属性：
-
active-
:
boolean。标签页是否在其窗口中处于活动状态。即使标签页的窗口当前未被聚焦，此属性也可能为 true。活动标签页通常是选定的标签页。但是，在 Android 版 Firefox 上，扩展弹出窗口会在新标签页中打开。当选择弹出窗口标签页时，活动标签页将是打开弹出窗口的标签页。
-
-
attention{{optional_inline}}- :
boolean。指示标签页是否正在吸引注意力。例如，当标签页显示模态对话框时，attention将为true。
- :
-
audible{{optional_inline}}- :
boolean。指示标签页是否正在播放声音。但是，如果标签页已静音（参见mutedInfo属性），用户将听不到声音。
- :
-
autoDiscardable{{optional_inline}}- :
boolean。标签页是否可以被浏览器丢弃。默认值为true。当设置为false时，浏览器不能自动丢弃标签页，但可以通过 {{WebExtAPIRef("tabs.discard")}} 进行丢弃。
- :
-
cookieStoreId{{optional_inline}}- :
string。标签页的 cookie 存储。更多信息请参见使用上下文身份工作。
- :
-
discarded{{optional_inline}}- :
boolean。标签页是否已被丢弃。已丢弃的标签页是指其内容已从内存中卸载，但在标签栏中仍可见。下次激活时，其内容将重新加载。
- :
-
favIconUrl{{optional_inline}} -
height{{optional_inline}}- :
integer。标签页的高度，以像素为单位。
- :
-
hidden- :
boolean。标签页是否隐藏。
- :
-
highlighted-
:
boolean。标签页是否被突出显示，即是否为当前选定的标签页。活动标签页始终处于突出显示状态，但某些浏览器允许额外的标签页被突出显示，例如通过按住 Ctrl、Shift 或 ⌘ Command 键点击它们。Android 版 Firefox 不支持突出显示多个标签页。
-
-
id{{optional_inline}}- :
integer。标签页的 ID。标签页 ID 在浏览器会话中是唯一的。对于不承载内容的标签页（例如开发者工具窗口），标签页 ID 也可以设置为 {{WebExtAPIRef('tabs.TAB_ID_NONE')}}。
- :
-
incognito- :
boolean。标签页是否在隐私浏览窗口中。
- :
-
index- :
integer。标签页在其窗口中的从零开始的索引。
- :
-
isArticle- :
boolean。如果标签页可以在阅读模式中渲染，则为 true，否则为 false。
- :
-
isInReaderMode- :
boolean。如果标签页当前正在阅读模式中渲染，则为 true，否则为 false。
- :
-
lastAccessed{{optional_inline}}- :
double。标签页上次访问的时间，以自纪元以来的毫秒数表示。
- :
-
mutedInfo{{optional_inline}}- : {{WebExtAPIRef('tabs.MutedInfo')}}。标签页的当前静音状态及最后一次状态更改的原因。
-
openerTabId{{optional_inline}}- :
integer。打开此标签页的标签页的 ID（如果有）。此属性仅在打开者标签页仍然存在且在同一窗口中时才存在。
- :
-
pendingUrl- :
string。标签页正在导航到的 URL，在提交之前有效。此属性仅在扩展清单包含“tabs”权限且存在待定导航时才会出现。
- :
-
pinned- :
boolean。标签页是否被固定。
- :
-
selected{{deprecated_inline}}- :
boolean。标签页是否被选中。此属性已被active和highlighted替代。
- :
-
sessionId{{optional_inline}}- :
string。用于唯一标识从 {{WebExtAPIRef('sessions')}} API 获取的标签页的会话 ID。
- :
-
status{{optional_inline}}- :
string。标签页的加载状态，可能为 loading 或 complete。
- :
-
successorTabId{{optional_inline}}- :
integer。标签页的后继标签页的 ID。
- :
-
title{{optional_inline}} -
url{{optional_inline}} -
width{{optional_inline}}- :
integer。标签页的宽度，以像素为单位。
- :
-
windowId- :
integer。承载此标签页的窗口的 ID。
- :
{{Compat}}
{{WebExtExamples}}
Note
此 API 基于 Chromium 的 chrome.tabs API。本文档来源于 Chromium 代码中的 tabs.json。