Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

NavigatorUAData: Methode toJSON()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die Methode toJSON() der Schnittstelle NavigatorUAData gibt ein JSON-serialisierbares einfaches Objekt zurück, das das NavigatorUAData-Objekt repräsentiert. Es enthält nur Werte mit niedriger Entropie. Um Werte mit hoher Entropie zu erhalten, verwenden Sie NavigatorUAData.getHighEntropyValues().

Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein NavigatorUAData-Objekt verarbeitet wird.

Syntax

js
toJSON()

Parameter

Keine.

Rückgabewert

Ein JSON-serialisierbares einfaches Objekt mit den folgenden Eigenschaften:

  • brands: Das Array und seine Objekte mit den Eigenschaften brand und version werden in ein neues Array und neue Objekte kopiert.
  • mobile
  • platform

Sofern nicht anders angegeben, wird der Wert jeder Eigenschaft unverändert kopiert.

Beispiele

toJSON() direkt aufrufen

Wenn toJSON() direkt auf navigator.userAgentData aufgerufen wird, gibt die Methode ein einfaches Objekt zurück. Dessen Eigenschaften haben dieselben Werte wie die entsprechenden Eigenschaften des ursprünglichen Objekts.

js
const json = navigator.userAgentData.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.mobile); // Same value as navigator.userAgentData.mobile

In eine JSON-Zeichenfolge serialisieren

Das NavigatorUAData-Objekt wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.

js
console.log(JSON.stringify(navigator.userAgentData));

Dadurch würde eine JSON-Zeichenfolge wie die folgende ausgegeben (zur besseren Lesbarkeit formatiert):

json
{
  "brands": [
    {
      "brand": "Chromium",
      "version": "126"
    },
    {
      "brand": "Not/A)Brand",
      "version": "8"
    }
  ],
  "mobile": false,
  "platform": "Windows"
}

Spezifikationen

Spezifikation
User-Agent Client Hints
# dom-navigatoruadata-tojson

Browser-Kompatibilität