LaunchParams

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Das LaunchParams-Interface der Launch Handler API wird verwendet, um benutzerdefinierte Startnavigationsverarbeitung in einer PWA zu implementieren. Wenn window.launchQueue.setConsumer() aufgerufen wird, um die Funktion zum Handling der Startnavigation einzurichten, wird der Callback-Funktion innerhalb von setConsumer() eine Instanz des LaunchParams-Objekts übergeben.

Eine solche benutzerdefinierte Navigationsverarbeitung wird über Window.launchQueue initiiert, wenn eine PWA mit einem launch_handler client_mode-Wert von focus-existing, navigate-new oder navigate-existing gestartet wird.

Instanz-Eigenschaften

LaunchParams.files Nur lesbar

Gibt ein schreibgeschütztes Array von FileSystemHandle-Objekten zurück, die alle Dateien repräsentieren, die mit der Startnavigation über die POST-Methode übergeben wurden.

LaunchParams.targetURL Nur lesbar

Gibt die Ziel-URL des Starts zurück.

Beispiele

js
if ("launchQueue" in window) {
  window.launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const params = new URL(launchParams.targetURL).searchParams;

      // Assuming a music player app that gets a track passed to it to be played
      const track = params.get("track");
      if (track) {
        audio.src = track;
        title.textContent = new URL(track).pathname.substr(1);
        audio.play();
      }
    }
  });
}

Spezifikationen

Specification
Web App Launch Handler API
# launchparams-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch