LaunchQueue: setConsumer() Methode

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die setConsumer()-Methode der LaunchQueue-Schnittstelle wird verwendet, um den Rückruf zu deklarieren, der die benutzerdefinierte Startnavigation in einer Progressive Web App (PWA) behandelt. Eine solche benutzerdefinierte Navigation 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.

Syntax

js
setConsumer(callback)

Parameter

callback

Eine Rückruffunktion, die die benutzerdefinierte Navigation für die PWA behandelt. Der Rückruf erhält eine LaunchParams-Objektinstanz als Parameter.

Rückgabewert

undefined.

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
# dom-launchqueue-setconsumer

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch