launch_handler

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.

Das launch_handler-Mitglied definiert Werte, die den Start einer Webanwendung steuern. Derzeit kann es nur einen einzigen Wert enthalten, client_mode, der den Kontext angibt, in dem die App beim Start geladen werden soll. Zum Beispiel in einem bestehenden Web-App-Client, der eine Instanz der App enthält, oder in einem neuen Web-App-Client. Dies lässt Spielraum dafür, in Zukunft weitere launch_handler-Werte zu definieren.

Werte

launch_handler-Objekte können die folgenden Werte enthalten:

client_mode Experimentell

Ein String oder ein durch Kommas getrenntes Array von Strings, das den Kontext angibt, in dem die App beim Start geladen werden soll. Wenn ein Array von Strings bereitgestellt wird, wird der erste gültige Wert verwendet. Mögliche Werte sind:

auto: Der Benutzeragent entscheidet, welcher Kontext für die Plattform sinnvoll ist, um die App zu laden. Zum Beispiel könnte navigate-existing auf mobilen Geräten sinnvoller sein, wo einzelne App-Instanzen üblich sind, während navigate-new in einem Desktop-Kontext mehr Sinn ergeben könnte. Dies ist der Standardwert, der verwendet wird, wenn alle bereitgestellten Werte ungültig sind.
focus-existing: Wenn die App bereits in einem Web-App-Client geladen ist, wird sie in den Fokus gebracht, jedoch nicht zur Startziel-URL navigiert. Die Ziel-URL ist über Window.launchQueue verfügbar, um die Implementierung einer benutzerdefinierten Start-Navigationssteuerung zu ermöglichen. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das Verhalten von navigate-new genutzt.
navigate-existing: Wenn die App bereits in einem Web-App-Client geladen ist, wird sie in den Fokus gebracht und zur angegebenen Startziel-URL navigiert. Die Ziel-URL ist über Window.launchQueue verfügbar, um zusätzliche benutzerdefinierte Start-Navigationssteuerung zu ermöglichen. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das Verhalten von navigate-new genutzt.
navigate-new: Die App wird in einem neuen Web-App-Client geladen. Die Ziel-URL ist über Window.launchQueue verfügbar, um zusätzliche benutzerdefinierte Start-Navigationssteuerung zu ermöglichen.

Beispiele

json

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

json

{
  "launch_handler": {
    "client_mode": ["focus-existing", "auto"]
  }
}

Spezifikationen

Specification
Web App Launch Handler API # launch_handler-member

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden