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:

js
window.addEventListener("afterprint", resumeFunction);

Syntax

js
let 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:

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

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
printPreview
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 56 (Release date: 2017-09-28)
footnote Full support
Opera – No support
Opera
footnote No 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

Legend

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

Full support
Full support
No support
No support