protocol_handlers

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 protocol_handlers-Element gibt ein Array von Objekten an, die Protokolle darstellen, die diese Web-App registrieren und behandeln kann. Protokoll-Handler registrieren die Anwendung in den Anwendungseinstellungen eines Betriebssystems; die Registrierung verknüpft eine spezifische Anwendung mit dem angegebenen Protokollschema. Zum Beispiel öffnen sich bei der Verwendung des Protokoll-Handlers mailto:// auf einer Webseite die registrierten E-Mail-Anwendungen.

Nachdem eine Web-App als Protokoll-Handler registriert wurde, öffnet sich die registrierte PWA und empfängt die URL, wenn ein Benutzer auf einen Hyperlink mit einem bestimmten Schema wie mailto:// oder web+music:// aus einem Browser oder einer nativen App klickt.

Werte

Protokoll-Handler-Objekte können die folgenden Werte enthalten:

protocol Experimentell

Ein erforderlicher String, der das zu behandelnde Protokoll enthält; z.B.: mailto, ms-word, web+jngl.

url Experimentell

Erforderliche HTTPS-URL innerhalb des Anwendungsbereichs scope, die das Protokoll behandeln wird. Der %s-Token wird durch die URL ersetzt, die mit dem Protokoll-Handler-Schema beginnt. Wenn url eine relative URL ist, wird die Basis-URL die URL des Manifests sein.

Beispiele

In diesem Beispiel deklariert ein Web-App-Manifest, dass die App so registriert werden soll, dass sie die Protokolle web+jngl und web+jnglstore behandelt.

json
"protocol_handlers": [
  {
    "protocol": "web+jngl",
    "url": "/lookup?type=%s"
  },
  {
    "protocol": "web+jnglstore",
    "url": "/shop?for=%s"
  }
]

Ein Entwickler kann ein Feld im manifest.json hinzufügen, um zu deklarieren, welche Protokolle die Web-App verarbeiten kann. Wie im obigen Beispiel zu sehen ist, heißt der Schlüssel protocol_handlers und enthält ein Array von Protokoll-Handler-Deklarationsobjekten.

Die Registrierung von Anwendungen zur Behandlung von URL-Schemata ist betriebssystemabhängig. Diese Zuordnung erfolgt normalerweise während der Installation der Anwendung, kann aber auch nachträglich aus einer bereits installierten App heraus erfolgen.

Spezifikationen

Specification
Manifest Incubations
# protocol_handlers-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
protocol_handlers
Experimental
protocol
Experimental
url
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.