launch_handler

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 Einzelwert enthalten, client_mode, der den Kontext festlegt, 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 Raum für die zukünftige Definition weiterer launch_handler-Werte.

Werte

launch_handler-Objekte können die folgenden Werte enthalten:

client_mode Experimentell

Ein String oder ein durch Kommas getrenntes Array von Strings, der bzw. 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 Benutzeragent entscheidet, welcher Kontext zum Laden der App auf der Plattform sinnvoll ist. Zum Beispiel könnte navigate-existing auf Mobilgeräten mehr Sinn machen, wo einzelne App-Instanzen weit verbreitet sind, während navigate-new im Desktop-Kontext mehr Sinn machen 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 gebracht, aber nicht zur Ziel-URL des Starts navigiert. Die Ziel-URL ist über Window.launchQueue verfügbar, um eine benutzerdefinierte Startnavigationsbehandlung zu ermöglichen. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das navigate-new-Verhalten verwendet.

Wenn die App bereits in einem Web-App-Client geladen ist, wird sie in den Fokus gebracht und zur angegebenen Ziel-URL des Starts navigiert. Die Ziel-URL ist über Window.launchQueue verfügbar, um zusätzliche benutzerdefinierte Startnavigationsbehandlungen zu ermöglichen. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird stattdessen das navigate-new-Verhalten verwendet.

Die App wird in einem neuen Web-App-Client geladen. Die Ziel-URL ist über Window.launchQueue verfügbar, um zusätzliche benutzerdefinierte Startnavigationsbehandlungen zu ermöglichen.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
launch_handler
Experimental
client_mode
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch