id

id

Eine Zeichenkette, die die Form einer URL annimmt. Die URL muss mit dem start_url Ihrer Web-App gleich ursprungsbezogen sein. Wenn id eine relative URL ist, wird sie unter Verwendung des Ursprungs von start_url aufgelöst. Jegliche Fragmente im id werden immer ignoriert. Wenn id nicht angegeben ist oder der Wert in irgendeiner Weise ungültig ist (zum Beispiel keine Zeichenkette, keine gültige URL, nicht gleich ursprungsbezogen mit start_url), wird der start_url-Wert verwendet.

Das id Manifestmitglied dient als eindeutiger Bezeichner für Ihre Web-App. Es ermöglicht Browsern, zwischen verschiedenen Anwendungen zu unterscheiden:

• Wenn ein Browser auf ein App-Manifest mit einem id stößt, das nicht mit einer bereits installierten Anwendung übereinstimmt, behandelt er dieses Manifest als Beschreibung einer eigenständigen Anwendung, selbst wenn sie von derselben URL wie eine andere Anwendung bereitgestellt wird.
• Wenn ein Browser auf ein App-Manifest mit einem id stößt, das mit der Identität einer bereits installierten App übereinstimmt, behandelt er das neue Manifest als Ersatz für das bestehende App-Manifest, selbst wenn die App von einer anderen URL als die vorher installierte bereitgestellt wird.

Das id kann auch von Diensten verwendet werden, die Web-App-Listen sammeln, um Anwendungen eindeutig zu identifizieren.

Einige wichtige Punkte, die bei der Verwendung des id-Mitglieds zu beachten sind:

• Verwenden Sie einen vorangestellten /, um anzugeben, dass das id ein root-relativer URL-Pfad ist.
• Da id gegen den Ursprung von start_url aufgelöst wird, lösen id-Werte wie ../foo, foo, /foo und ./foo alle zum selben Bezeichner relativ zum Ursprung auf. Zum Beispiel, wenn start_url https://example.com/app/ ist, werden all diese id-Werte zu https://example.com/foo/ aufgelöst.
• Standardmäßige URL-Codierungs- und -Decodierungsregeln gelten, wenn der id-Wert aufgelöst wird.
• Fragmente im id werden während der Verarbeitung entfernt. Zum Beispiel, wenn id auf foo#bar gesetzt ist, wird es als foo aufgelöst. Ebenso, wenn id undefiniert ist und start_url https://example.com/app/#home ist, wird id zu https://example.com/app/ aufgelöst.
• Abfrageparameter im id werden beibehalten und im endgültig aufgelösten Bezeichner eingeschlossen.

Angenommen, Sie erstellen eine Web-App mit folgendem Manifest:

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/v1",
  "start_url": "https://example.com/app"
}

Wenn Sie später eine weitere Version dieser App mit wesentlichen Änderungen erstellen und sie als andere App behandelt werden soll, können Sie das Manifest folgendermaßen hinzufügen:

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/v2",
  "start_url": "https://example.com/app"
}

In diesem Fall behandeln Browser, selbst wenn beide Manifestdateien von derselben URL bereitgestellt werden, das neue Manifest als Beschreibung einer eigenständigen Anwendung, da das id unterschiedlich ist. Infolgedessen können Benutzer beide Versionen gleichzeitig installiert haben.

Betrachten Sie ein Szenario, in dem Sie eine Web-App mit folgendem Manifest bereitstellen:

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/",
  "start_url": "https://old-domain.com/app"
}

Wenn Sie sich jedoch später entscheiden, die App auf eine andere Domain zu verschieben, würden Sie das Manifest wie folgt aktualisieren:

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/",
  "start_url": "https://new-domain.com/app"
}

Browser behandeln dieses neue Manifest als Aktualisierung der bestehenden App, weil die id-Werte übereinstimmen. In diesem Fall erhalten Benutzer ein Update ihrer bestehenden App, anstatt aufgefordert zu werden, eine neue App zu installieren.

Angenommen, der start_url Ihrer App ist https://example.com/my-app/home. Die folgende Tabelle zeigt, wie verschiedene id-Werte im Manifest aufgelöst werden:

• scope Manifestmitglied
• start_url Manifestmitglied