tabs.setZoom()

缩放指定标签页。

这是一个返回 Promise 的异步函数。

语法

js
let zooming = browser.tabs.setZoom(
  tabId,           // 可选整型
  zoomFactor       // 数字
);

参数

tabId 可选

integer。要缩放的标签页的 ID。默认为当前窗口中的活动标签页。

zoomFactor

number。新的缩放因子。在这里使用值 0 将标签页设置为当前默认的缩放级别。否则,必须是介于 0.3 到 5 之间的数字,表示缩放因子。

返回值

一个 Promise,在缩放因子更改后其会被兑现且不带有参数。如果找不到标签页或发生其他错误,promise 会以错误消息拒绝。

示例

将当前标签页的缩放因子设置为 2:

js
function onError(error) {
  console.log(`发生错误:${error}`);
}

let setting = browser.tabs.setZoom(2);
setting.then(null, onError);

将 ID 为 16 的标签页的缩放因子设置为 0.5:

js
function onError(error) {
  console.log(`发生错误:${error}`);
}

let setting = browser.tabs.setZoom(16, 0.5);
setting.then(null, onError);

示例扩展

浏览器兼容性

BCD tables only load in the browser

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