tabs.saveAsPDF()

Speichert die aktuelle Seite als PDF-Datei. Dies öffnet ein Dialogfenster, bereitgestellt durch das zugrunde liegende Betriebssystem, das den Benutzer fragt, wo die PDF-Datei gespeichert werden soll.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let saving = browser.tabs.saveAsPDF(
  pageSettings   // object
)

Parameter

pageSettings

object. Einstellungen für die gespeicherte Seite, als ein tabs.PageSettings-Objekt. Dieses Objekt muss angegeben werden, aber alle seine Eigenschaften sind optional. Alle hier nicht angegebenen Eigenschaften erhalten die Standardwerte, die in der PageSettings-Dokumentation aufgeführt sind.

Rückgabewert

Ein Promise, das mit einer Statuszeichenfolge erfüllt wird, wenn das Dialogfenster geschlossen wurde. Die Zeichenfolge kann eine der folgenden sein:

  • "saved"
  • "replaced"
  • "canceled"
  • "not_saved"
  • "not_replaced"

Beispiele

In diesem Beispiel hört ein Hintergrundskript auf einen Klick auf eine Browser-Aktion, versucht dann, die derzeit aktive Registerkarte als PDF-Datei zu speichern, und protokolliert schließlich das Ergebnis:

js
browser.browserAction.onClicked.addListener(() => {
  browser.tabs.saveAsPDF({}).then((status) => {
    console.log(status);
  });
});

Browser-Kompatibilität

BCD tables only load in the browser