tabs.ZoomSettingsMode

Defines how zoom changes are handled. Add-ons 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 add-on 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 Firefox for Android Opera
Basic Support Yes No 45.0 No 33

Acknowledgements

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

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: Jeremie, wbamberg
 Last updated by: Jeremie,