GeolocationCoordinates: Methode toJSON()
Baseline 2024
Neu verfügbar
Seit September 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die Methode toJSON() des Interfaces GeolocationCoordinates gibt ein JSON-serialisierbares einfaches Objekt zurück, das das GeolocationCoordinates-Objekt repräsentiert.
Die Methode wird von JSON.stringify() automatisch aufgerufen, wenn bei der JSON-Serialisierung ein GeolocationCoordinates-Objekt gefunden wird.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein JSON-serialisierbares einfaches Objekt mit den folgenden Eigenschaften:
Der Wert jeder Eigenschaft wird unverändert kopiert.
Beispiele
toJSON() direkt aufrufen
Dieses Beispiel ruft ein GeolocationCoordinates-Objekt ab. Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück. Dessen Eigenschaften haben dieselben Werte wie die entsprechenden Eigenschaften des ursprünglichen Objekts.
navigator.geolocation.getCurrentPosition((position) => {
const coords = position.coords;
const json = coords.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.latitude); // Same value as coords.latitude
});
Als JSON-Zeichenfolge serialisieren
Innerhalb der Callback-Funktion aus dem vorherigen Beispiel kann dasselbe Objekt mit JSON.stringify() serialisiert werden. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(coords));
Dadurch würde eine JSON-Zeichenfolge wie die folgende ausgegeben (zur besseren Lesbarkeit formatiert):
{
"accuracy": 12.5,
"latitude": 53.125,
"longitude": 8.75,
"altitude": null,
"altitudeAccuracy": null,
"heading": null,
"speed": null
}
Spezifikationen
| Spezifikation |
|---|
| Geolocation # tojson-method-0 |