VideoColorSpace: 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.
Want more browser support for this feature? Tell us why.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Die Methode toJSON() der Schnittstelle VideoColorSpace gibt ein JSON-serialisierbares einfaches Objekt zurück, das das VideoColorSpace-Objekt repräsentiert.
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein VideoColorSpace-Objekt auftritt. Der serialisierte Wert kann anschließend mit dem Konstruktor VideoColorSpace() innerhalb der Reviver-Funktion von JSON.parse() deserialisiert werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein JSON-serialisierbares einfaches Objekt mit den folgenden Eigenschaften:
Der Wert jeder Eigenschaft wird unverändert übernommen.
Beispiele
toJSON() direkt aufrufen
Ein direkter Aufruf von toJSON() gibt ein einfaches Objekt zurück, das die Eigenschaften des VideoColorSpace-Objekts enthält.
const colorSpace = new VideoColorSpace({
primaries: "bt709",
transfer: "bt709",
matrix: "bt709",
fullRange: true,
});
const json = colorSpace.toJSON();
console.log(json);
// { fullRange: true, matrix: "bt709", primaries: "bt709", transfer: "bt709" }
console.log(typeof json); // "object"
In einen JSON-String serialisieren
Das VideoColorSpace-Objekt aus dem vorherigen Beispiel wird mit JSON.stringify() serialisiert. Dabei wird die Methode toJSON() automatisch aufgerufen.
console.log(JSON.stringify(colorSpace));
Dadurch würde ein JSON-String wie der folgende ausgegeben (zur besseren Lesbarkeit formatiert):
{
"fullRange": true,
"matrix": "bt709",
"primaries": "bt709",
"transfer": "bt709"
}
Spezifikationen
| Spezifikation |
|---|
| WebCodecs # dom-videocolorspace-tojson |