TrustedScript: Methode toJSON()
Baseline 2026
Neu verfügbar
Seit Februar 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode toJSON() der Schnittstelle TrustedScript gibt einen String zurück, der das TrustedScript-Objekt repräsentiert. Dies ist derselbe String, den TrustedScript.toString() zurückgibt.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein TrustedScript-Objekt gefunden wird. Der serialisierte Wert kann anschließend mit der Methode TrustedTypePolicy.createScript() innerhalb des Revivers von JSON.parse() zurückkonvertiert werden. Dabei wird die Transformation der Policy erneut auf den Wert angewendet.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein String.
Beispiele
toJSON() direkt aufrufen
Dieses Beispiel erstellt ein TrustedScript-Objekt. Ein direkter Aufruf von toJSON() gibt dessen gespeicherten String-Wert zurück.
const sanitized = scriptPolicy.createScript("eval('2 + 2')");
const json = sanitized.toJSON();
console.log(json); // Same value as sanitized.toString()
console.log(typeof json); // "string"
In einen JSON-String serialisieren
Das TrustedScript-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(sanitized));
Dadurch würde der folgende JSON-String ausgegeben, einschließlich der umschließenden doppelten Anführungszeichen, die Teil des String-Inhalts sind:
"eval('2 + 2')"
Spezifikationen
| Spezifikation |
|---|
| Trusted Types # dom-trustedscript-tojson |