launch_handler
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Das launch_handler
-Element definiert Werte, die den Start einer Webanwendung steuern. Derzeit kann es nur einen einzigen Wert enthalten, client_mode
, welcher den Kontext spezifiziert, in dem die App geladen werden soll, wenn sie gestartet wird. 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 Definition weiterer launch_handler
-Werte in der Zukunft.
Werte
launch_handler
-Objekte können die folgenden Werte enthalten:
client_mode
Experimentell-
Ein String oder ein kommasepariertes Array von Strings, das den Kontext spezifiziert, in dem die App geladen werden soll, wenn sie gestartet wird. Wenn ein Array von Strings bereitgestellt wird, wird der erste gültige Wert verwendet. Mögliche Werte sind:
auto
-
Der User-Agent entscheidet, welcher Kontext für die Plattform sinnvoll ist, um die App darin zu laden. Zum Beispiel könnte
navigate-existing
auf Mobilgeräten mehr Sinn machen, wo einzelne App-Instanzen üblich sind, währendnavigate-new
in einem Desktop-Kontext mehr Sinn machen 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 fokussiert, aber nicht zur Startziel-URL navigiert. Die Ziel-URL ist über
Window.launchQueue
verfügbar, um die Implementierung einer benutzerdefinierten Startnavigationsbehandlung zu ermöglichen. Wenn die App noch nicht in einem Web-App-Client geladen ist, wird dasnavigate-new
-Verhalten stattdessen verwendet. -
Wenn die App bereits in einem Web-App-Client geladen ist, wird sie fokussiert und zur angegebenen Startziel-URL 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 dasnavigate-new
-Verhalten stattdessen 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
"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
BCD tables only load in the browser