LaunchParams

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

Ein solches benutzerdefiniertes Navigationshandling wird über Window.launchQueue eingeleitet, wenn eine PWA mit einem launch_handler client_mode-Wert von focus-existing, navigate-new oder navigate-existing gestartet wurde.

Instanz-Eigenschaften

LaunchParams.files Schreibgeschützt

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

LaunchParams.targetURL Schreibgeschützt

Gibt die Ziel-URL des Starts zurück.

Beispiele

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.slice(1);
 audio.play();
 }
 }
 });
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Launch Handler API: Control how your app is launched
• Window.launchQueue
• Musicr 2.0 Demo-App