W3cubDocs

/Web Extensions

tabs.printPreview()

Opens print preview for the active tab.

This is an asynchronous function that returns a Promise. An extension can detect when print preview has been closed by listening to the afterprint event:
window.addEventListener("afterprint", resumeFunction, false);

Syntax

var openingPreview = browser.tabs.printPreview()

Parameters

None.

Return value

A Promise that will be fulfilled with no arguments when the preview page has opened.

Examples

In this example a background script listens for a click on a browser action, then opens print preview for the currently active tab:

browser.browserAction.onClicked.addListener(() => {
  browser.tabs.printPreview()
    .then(() => {
      console.log("Entered print preview");
    });
});

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
printPreview
No
No
56
?
No
No
?
?
No
?
?
?

© 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/tabs/printPreview