URL: Methode toJSON()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Dezember 2018 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode toJSON() der Schnittstelle URL gibt einen String zurück, der das URL-Objekt repräsentiert. Dies ist derselbe String, den URL.toString() zurückgibt.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein URL-Objekt angetroffen wird. Der serialisierte Wert kann anschließend mit dem Konstruktor URL() innerhalb der Reviver-Funktion von JSON.parse() deserialisiert werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein String.
Beispiele
toJSON() direkt aufrufen
Wenn toJSON() direkt aufgerufen wird, gibt die Methode einen String zurück, der die URL enthält.
const url = new URL(
"https://developer.mozilla.org/en-US/docs/Web/API/URL/toString",
);
const json = url.toJSON();
console.log(json); // https://developer.mozilla.org/en-US/docs/Web/API/URL/toString
console.log(typeof json); // "string"
In einen JSON-String serialisieren
Das URL-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(url));
Dadurch würde der folgende JSON-String ausgegeben, einschließlich der umschließenden doppelten Anführungszeichen, die zum Inhalt des Strings gehören:
"https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"
Spezifikationen
| Spezifikation |
|---|
| URL # dom-url-tojson |