Docs4dev
Docs
web_extensions / latest / api / tabs / printpreview.html

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

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:

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

© 2005–2023 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