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-Element 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. Beispielsweise in einem vorhandenen Web-App-Client, der eine Instanz der App enthält, oder in einem neuen Web-App-Client. Dies lässt Spielraum für die zukünftige Definition weiterer launch_handler-Werte.

Werte

launch_handler-Objekte können die folgenden Werte enthalten:

client_mode

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

auto

Der User-Agent entscheidet, welcher Kontext sinnvoll ist, um die App auf der Plattform zu laden. Beispielsweise könnte navigate-existing auf mobilen Geräten mehr Sinn machen, wo einzelne App-Instanzen häufig sind, während navigate-new in einem Desktop-Kontext sinnvoller sein könnte. Dies ist der Standardwert, der verwendet wird, wenn alle angegebenen Werte ungültig sind.

focus-existing

Wenn die App bereits in einem Web-App-Client geladen ist, wird sie in den Fokus gerückt, aber nicht zur Start-Ziel-URL navigiert. Die Ziel-URL wird über Window.launchQueue verfügbar gemacht, um eine benutzerdefinierte Handhabung der Startnavigation zu implementieren. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das navigate-new-Verhalten angewendet.

Wenn die App bereits in einem Web-App-Client geladen ist, wird sie in den Fokus gerückt und zur angegebenen Start-Ziel-URL navigiert. Die Ziel-URL wird über Window.launchQueue verfügbar gemacht, um zusätzliche benutzerdefinierte Handhabungen der Startnavigation zu implementieren. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das navigate-new-Verhalten angewendet.

Die App wird in einem neuen Web-App-Client geladen. Die Ziel-URL wird über Window.launchQueue verfügbar gemacht, um zusätzliche benutzerdefinierte Handhabungen der Startnavigation zu implementieren.

Beispiele

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

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

Spezifikationen

Specification
Web App Launch Handler API
# launch_handler-member

Browser-Kompatibilität

Siehe auch