Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

LaunchQueue: setConsumer() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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 Callback zu deklarieren, der das benutzerdefinierte Startnavigations-Handling in einer progressiven Web-App (PWA) verarbeiten wird. Solch eine 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 Callback-Funktion, die die benutzerdefinierte Navigation für die PWA verarbeitet. Dem Callback wird ein LaunchParams-Objektinstanz als Parameter übergeben.

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

Spezifikationen

Specification
Web App Launch Handler API
# dom-launchqueue-setconsumer

Browser-Kompatibilität

Siehe auch