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 语法

参数

监听器

当此事件发生时调用的函数。该函数将传递此参数

ZoomChangeInfo

object。有关缩放事件的信息。有关更多详细信息,请参阅 ZoomChangeInfo 部分。

额外对象

ZoomChangeInfo

tabId

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

oldZoomFactor

number。之前的缩放系数。

newZoomFactor

number。新的缩放系数。

zoomSettings

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

示例

监听缩放事件并记录信息

js
function handleZoomed(zoomChangeInfo) {
  console.log(`Tab: ${zoomChangeInfo.tabId} zoomed`);
  console.log(`Old zoom: ${zoomChangeInfo.oldZoomFactor}`);
  console.log(`New zoom: ${zoomChangeInfo.newZoomFactor}`);
}

browser.tabs.onZoomChange.addListener(handleZoomed);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.tabs API。此文档源自 Chromium 代码中的 tabs.json