1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. tabs
  6. tabs.ZoomSettingsMode

tabs.ZoomSettingsMode

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".

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 support per-origin zooming: it will ignore the scope zoom setting and always use per-tab.

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
ZoomSettingsMode
Chrome – Full support
Chrome 38 (Release date: 2014-10-07)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 45 (Release date: 2016-03-08)
footnote Full support
Opera – Full support
Opera 25 (Release date: 2014-10-15)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android
footnote No support
Safari on iOS – No support
Safari on iOS
footnote No support

Tip: you can click/tap on a cell for more information.

Full support
No support

Note: This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.

This page was last modified on by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.