Array.isArray()

Die Methode Array.isArray() prüft, ob ein übergebenes Objekt ein Array ist.

Syntax

Array.isArray(obj)

Parameter

obj

Das zu überprüfende Objekt.

Rückgabewert

true, wenn das Objekt ein Array ist, andernfalls false.

Beschreibung

Wenn das übergebene Objekt ein Array ist, wir true zurückzugeben, andernfalls wird false zurückgegeben.

Für eine tiefergehende Beschreibung sei der folgende Artikel empfohlen: "Determining with absolute accuracy whether or not a JavaScript object is an array" (auf Englisch).

Beispiele

// die folgenden Ausdrücke geben alle true zurück
Array.isArray([]);
Array.isArray([1]);
Array.isArray( new Array() );

// wenig bekannt: Array.prototype ist selbst ein Array.
Array.isArray( Array.prototype );

// die folgenden Ausdrücke geben alle false zurück
Array.isArray();
Array.isArray({});
Array.isArray(null);
Array.isArray(undefined);
Array.isArray(17);
Array.isArray("Array");
Array.isArray(true);
Array.isArray(false);
Array.isArray({ __proto__ : Array.prototype });

Polyfill

Der folgende Code implementiert die Methode, wenn Array.isArray() nicht nativ unterstützt wird.

if(!Array.isArray) {
  Array.isArray = function (vArg) {
    return Object.prototype.toString.call(vArg) === "[object Array]";
  };
}

Spezifikationen

Browserkompatibilität

Siehe auch

• Array