TrustedScriptURL: 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 TrustedScriptURL gibt einen String zurück, der das TrustedScriptURL-Objekt repräsentiert. Dies ist derselbe String, den TrustedScriptURL.toString() zurückgibt.
Die Methode wird von JSON.stringify() automatisch aufgerufen, wenn bei der JSON-Serialisierung ein TrustedScriptURL-Objekt auftritt. Der serialisierte Wert kann anschließend mit der Methode TrustedTypePolicy.createScriptURL() 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 TrustedScriptURL-Objekt. Ein direkter Aufruf von toJSON() gibt den darin gespeicherten Stringwert zurück.
const sanitized = scriptPolicy.createScriptURL(
"https://example.com/my-script.js",
);
const json = sanitized.toJSON();
console.log(json); // Same value as sanitized.toString()
console.log(typeof json); // "string"
In einen JSON-String serialisieren
Das TrustedScriptURL-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(sanitized));
Dabei würde der folgende JSON-String ausgegeben, einschließlich der umgebenden doppelten Anführungszeichen, die zum Inhalt des Strings gehören:
"https://example.com/my-script.js"
Spezifikationen
| Spezifikation |
|---|
| Trusted Types # dom-trustedscripturl-tojson |