LaunchParams
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das LaunchParams
-Interface der Launch Handler API wird verwendet, wenn Sie in einer PWA eine benutzerdefinierte Startnavigationsbehandlung implementieren. Wenn window.launchQueue.setConsumer()
aufgerufen wird, um die Startnavigationsbehandlungs-Funktionalität einzurichten, wird der Callback-Funktion innerhalb von setConsumer()
eine LaunchParams
-Objektinstanz übergeben.
Eine solche benutzerdefinierte Navigationsbehandlung wird über Window.launchQueue
initiiert, 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 Experimentell-
Gibt ein schreibgeschütztes Array von
FileSystemHandle
-Objekten zurück, die alle Dateien darstellen, die zusammen mit der Startnavigation über diePOST
-Methode übergeben wurden. LaunchParams.targetURL
Schreibgeschützt Experimentell-
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.substr(1);
audio.play();
}
}
});
}
Spezifikationen
Specification |
---|
Web App Launch Handler API # launchparams-interface |