Array.isArray()

Zusammenfassung

Die Methode Array.isArray() gibt true zurück, wenn das übergebene Objekt ein Array ist, andernfalls false.

Syntax

Array.isArray(obj)

Parameter

obj

Das zu überprüfende Objekt.

Beschreibung

Mit ECMAScript 5 wurde die Methode zur Überprüfung, ob ein Objekt ein Array ist oder nicht, eingeführt.

Eine alternative Überprüfung lautet obj instanceof Array. Hiermit kann ebenfalls ermittelt werden, ob obj ein Array ist. Allerdings hat diese Überprüfung die Beschränkung, dass nur Arrays des selben Fensters richtig erkannt werden. Wird ein Array von einem Fenster in das nächste übergeben, schlägt der Ausdruck fehl.
Die Methode Array.isArray() hat diese Beschränkung nicht.

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

Browser Unterstützung

Basierend auf Kangax's compat table.

Siehe auch

• Array