W3cubDocs

/Web Extensions

browserSettings.zoomSiteSpecific

A BrowserSetting object whose underlying value is a boolean.

This property sets the configuration setting browser.zoom.siteSpecific, which controls how zoom settings are applied to sites and tabs.

If browser.zoom.siteSpecific is true, zoom operations apply to all pages from the same site so that:

  • when a page loads, if there is a zoom level for that site it is applied to the page otherwise the global default zoom level is applied.
  • when the zoom level for a page changes, the zoom levels of other pages from the site in other tabs are also changed.

If browser.zoom.siteSpecific is set false, zoom operations apply to the active tab only so that:

  • when a new tab opens, the global default zoom level is applied.
  • when the zoom level in a tab changes, it persists across page loads and does not affect the zoom level in any other tab.

When Firefox is installed, browser.zoom.siteSpecific is true.

If privacy.websites.resistFingerprinting is true, this setting has no effect and zoom is set on a per-tab basis.

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
zoomSiteSpecific
No
No
75
?
No
No
?
?
No
?
?
?

Examples

Set the setting to false:

function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.zoomSiteSpecific.set({value: false}).
  then(logResult);

© 2005–2021 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/browserSettings/zoomSiteSpecific