Launch Handler API

Eingeschrnkt verfgbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Experimentell: Dies ist eine experimentelle Technologie
berprfen Sie die Browser-Kompatibilittstabelle sorgfltig vor der Verwendung auf produktiven Webseiten.

Die Launch Handler API ermglicht es Entwicklern, zu kontrollieren, wie eine progressive Web-App (PWA) gestartet wird zum Beispiel, ob sie ein bestehendes Fenster verwendet oder ein neues erstellt, und wie die Ziel-Start-URL der App behandelt wird.

Konzepte und Verwendung

Sie knnen das Startverhalten Ihrer App festlegen, indem Sie das Feld launch_handler zu Ihrer Web-App-Manifestdatei hinzufgen. Dieses hat ein Unterfeld, client_mode, das einen Zeichenfolgenwert enthlt, der angibt, wie die App gestartet und navigiert werden soll. Zum Beispiel:

json

{
  "launch_handler": {
    "client_mode": "focus-existing"
  }
}

Falls nicht angegeben, ist der Standardwert fr client_mode auto. Verfgbare Werte sind:

focus-existing: Der zuletzt interagierte Browsing-Kontext in einem Web-App-Fenster wird ausgewhlt, um den Start zu behandeln. Dies wird die Ziel-Start-URL in der targetURL Eigenschaft des LaunchParams Objekts fllen, das in die Rckruffunktion von window.launchQueue.setConsumer() bergeben wird. Wie unten zu sehen ist, ermglicht dies, die Startbehandlung Ihrer App individuell anzupassen.
navigate-existing: Der zuletzt interagierte Browsing-Kontext in einem Web-App-Fenster wird zur Ziel-Start-URL navigiert. Die Ziel-URL wird weiterhin ber window.launchQueue.setConsumer() verfgbar gemacht, um zustzliche individuelle Startnavigationsbehandlungen zu implementieren.
navigate-new: Ein neuer Browsing-Kontext wird in einem Web-App-Fenster erstellt, um die Ziel-Start-URL zu laden. Die Ziel-URL wird weiterhin ber window.launchQueue.setConsumer() verfgbar gemacht, um zustzliche individuelle Startnavigationsbehandlungen zu implementieren.
auto: Der User-Agent entscheidet, was am besten fr die Plattform funktioniert. Zum Beispiel knnte navigate-existing auf Mobilgerten mehr Sinn machen, wo einzelne App-Instanzen blich sind, whrend navigate-new in einem Desktop-Kontext mehr Sinn machen knnte. Dies ist der Standardwert, falls angegebene Werte ungltig sind.

Wenn focus-existing verwendet wird, knnen Sie Code innerhalb der Rckruffunktion von window.launchQueue.setConsumer() einfgen, um eine individuelle Behandlung der targetURL bereitzustellen.

window.launchQueue.setConsumer((launchParams) => {
  // Do something with launchParams.targetURL
});

Hinweis: LaunchParams hat auch eine LaunchParams.files Eigenschaft, die ein schreibgeschtztes Array von FileSystemHandle Objekten zurckgibt, die Dateien reprsentieren, die zusammen mit der Startnavigation ber die POST-Methode bergeben wurden. Dies ermglicht die Implementierung einer individuellen Datei-Behandlung.

Schnittstellen

LaunchParams: Wird bei der Implementierung individueller Startnavigationsbehandlung in einer PWA verwendet. Wenn window.launchQueue.setConsumer() aufgerufen wird, um die Startnavigations-Behandlungsfunktionalitt einzurichten, wird die Rckruffunktion innerhalb von setConsumer() eine Instanz des LaunchParams Objekts bergeben.
LaunchQueue: Wenn eine progressive Web-App (PWA) mit einem launch_handler client_mode Wert von focus-existing, navigate-new oder navigate-existing gestartet wird, ermglicht LaunchQueue den Zugriff auf Funktionen, die eine individuelle Startnavigationsbehandlung in der PWA implementieren. Diese Funktionalitt wird durch die Eigenschaften des LaunchParams Objekts gesteuert, das in die Rckruffunktion von setConsumer() bergeben wird.

Erweiterungen zu anderen Schnittstellen

window.launchQueue: Bietet Zugriff auf die LaunchQueue Klasse, die es ermglicht, eine individuelle Startnavigationsbehandlung in einer progressiven Web-App (PWA) zu implementieren, wobei der Behandlungskontext durch den launch_handler Manifest-Feld client_mode Wert angezeigt wird.

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();
      }
    }
  });
}

Dieser Code wird in der PWA eingebunden und bei jedem Start der App ausgefhrt. Die Rckruffunktion von window.launchQueue.setConsumer() extrahiert das Such-Param aus der LaunchParams.targetURL und, falls sie einen track Parameter findet, verwendet sie diesen, um das src des <audio> Elements zu fllen und den Audiotrack abzuspielen, auf den dies verweist.

Sehen Sie sich die Demo-App Musicr 2.0 fr vollstndigen funktionierenden Code an.

Spezifikationen

Spezifikation
Web App Launch Handler API # launchqueue-interface

Browser-Kompatibilitt

Siehe auch

Launch Handler API: Control how your app is launched

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

Launch Handler API
Interfaces
1. LaunchParams
2. LaunchQueue
Eigenschaften
1. Window.launchQueue