toObject

[ Funktion ]

public static toObject<T extends object>(
    value: any, 
    defaultValue: T | null = null
): T | null;

Konvertiert einen beliebigen kompatiblen Wert in ein Objekt bzw. Array. Ist der Parameter schon ein Objekt bzw. Array, so wird es direkt zurückgegeben, ist es ein String, so wird er per JSON.parse in ein Objekt bzw. Array gewandelt.

Achtung, dabei wird keine Typprüfung durchgeführt. Dies sollte nachgelagert zum Beispiel per TcHmi.isSolidColor, Array.isArray oder ähnlichem erfolgen.

Parameter

Name	Typ	Beschreibung
value	any	Der zu konvertierende Wert. Beispiel: Ein JSON String.
defaultValue	any, null	Dieser Wert wird zurückgegeben, wenn der erste Parameter nicht konvertiert werden kann. Wird dieser Parameter nicht übergeben, so gilt null.

Name

Typ

Beschreibung

value

any

Der zu konvertierende Wert.

Beispiel: Ein JSON String.

defaultValue

any, null

Dieser Wert wird zurückgegeben, wenn der erste Parameter nicht konvertiert werden kann. Wird dieser Parameter nicht übergeben, so gilt null.

Rückgabewert

Typ	Beschreibung
T, null	Gibt ein Objekt/Array oder im Fehlerfall defaultValue oder null zurück.

	Verfügbar ab Version 1.8