Defines how zoom changes are handled. Extensions can pass this value into tabs.setZoomSettings()
to control how the browser handles attempts to change zoom settings for a tab. Defaults to "automatic".
On this page
tabs.ZoomSettingsMode
Type
Values of this type are strings. Possible values are:
- "automatic"
-
Zoom changes are handled normally by the browser.
- "disabled"
-
Disables all zooming in the tab. The tab will revert to the default zoom level, and all attempted zoom changes will be ignored.
- "manual"
-
The extension will handle zoom changes itself, by listening for the
tabs.onZoomChange
event and scaling the page accordingly. This mode does not supportper-origin
zooming: it will ignore thescope
zoom setting
and always useper-tab
.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ZoomSettingsMode |
38 | 79 | 45 | ? | 25 | No | ? | ? | No | ? | No | ? |
Note: This API is based on Chromium's chrome.tabs
API. This documentation is derived from tabs.json
in the Chromium code.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode