tabs.setZoomSettings()

为指定标签页设置缩放设置。这些设置在标签页导航后将重置为默认设置。

这是一个异步函数,返回一个 Promise

语法

js
let settingZoomSettings = browser.tabs.setZoomSettings(
  tabId,           // optional integer
  zoomSettings     // ZoomSettings
)

参数

tabId 可选

integer。要更改缩放设置的标签页的 ID。默认为当前窗口的活动标签页。

zoomSettings

tabs.ZoomSettings。定义如何处理缩放更改以及缩放的范围。

返回值

一个 Promise,在缩放设置更改后,将不带参数地履行。如果找不到标签页或发生其他错误,Promise 将被拒绝并附带错误消息。

示例

禁用当前标签页的缩放

js
function onSet() {
  console.log(`Set zoom factor`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let setting = browser.tabs.setZoomSettings({ mode: "disabled" });
setting.then(onSet, onError);

浏览器兼容性

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