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

View in English Always switch to English

NotRestoredReasons: 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.

Die Methode toJSON() der Schnittstelle NotRestoredReasons gibt ein einfaches, JSON-serialisierbares Objekt zurück, das das NotRestoredReasons-Objekt repräsentiert.

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

Syntax

js
toJSON()

Parameter

Keine.

Rückgabewert

Ein einfaches, JSON-serialisierbares Objekt mit den folgenden Eigenschaften:

Der Wert jeder Eigenschaft wird unverändert kopiert. Wenn das zurückgegebene Objekt an JSON.stringify() übergeben wird, werden die Objekte in den Arrays reasons und children mit NotRestoredReasonDetails.toJSON() beziehungsweise NotRestoredReasons.toJSON() weiter serialisiert, sofern die Arrays nicht null sind.

Beispiele

toJSON() direkt aufrufen

Dieses Beispiel ruft ein NotRestoredReasons-Objekt aus dem ersten Navigationseintrag ab. Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück. Seine Eigenschaften haben dieselben Werte wie die entsprechenden Eigenschaften des ursprünglichen Objekts.

js
const navEntries = performance.getEntriesByType("navigation");
const navEntry = navEntries[0];
const reasons = navEntry.notRestoredReasons;

const json = reasons.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.url); // Same value as reasons.url

In einen JSON-String serialisieren

Das Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.

js
console.log(JSON.stringify(reasons));

Dadurch würde ein JSON-String wie der folgende protokolliert (zur besseren Lesbarkeit formatiert):

json
{
  "src": null,
  "id": null,
  "url": "https://example.com/",
  "name": null,
  "reasons": [
    {
      "reason": "masked"
    }
  ],
  "children": [
    {
      "src": "https://other.example/frame.html",
      "id": "frame",
      "url": null,
      "name": null,
      "reasons": null,
      "children": null
    }
  ]
}

Spezifikationen

Spezifikation
HTML
# notrestoredreasons

Browser-Kompatibilität

Siehe auch