tabs.onZoomChange

当标签页缩放时触发。

语法

js
browser.tabs.onZoomChange.addListener(listener)
browser.tabs.onZoomChange.removeListener(listener)
browser.tabs.onZoomChange.hasListener(listener)

事件有三个函数:

addListener(listener)

向此事件添加一个监听器。

removeListener(listener)

停止监听此事件。listener 参数是要移除的监听器。

hasListener(listener)

检查 listener 是否已注册此事件。如果正在监听,则返回 true,否则返回 false

addListener 语法

参数

listener

此事件发生时调用的函数。该函数接收以下参数:

ZoomChangeInfo

object。关于缩放事件的信息。详见 ZoomChangeInfo 部分。

附加对象

ZoomChangeInfo

tabId

integer。被缩放的标签页的 ID。

oldZoomFactor

number。之前的缩放因子。

newZoomFactor

number。新的缩放因子。

zoomSettings

tabs.ZoomSettings。标签页的缩放设置。

示例

监听缩放事件并记录信息:

js
function handleZoomed(zoomChangeInfo) {
  console.log(`标签:${zoomChangeInfo.tabId} 被缩放`);
  console.log(`旧缩放因子:${zoomChangeInfo.oldZoomFactor}`);
  console.log(`新缩放因子:${zoomChangeInfo.newZoomFactor}`);
}

browser.tabs.onZoomChange.addListener(handleZoomed);

浏览器兼容性

BCD tables only load in the browser

备注: 该 API 基于 Chromium 的 chrome.tabs API。此文档来自 Chromium 代码中的 tabs.json