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

Spezifikation Status Kommentar
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Array.isArray' in dieser Spezifikation.
Standard Initiale Definition. Eingeführt in JavaScript 1.8.5
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Array.isArray' in dieser Spezifikation.
Standard  
ECMAScript 2017 Draft (ECMA-262)
Die Definition von 'Array.isArray' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Grundlegende Unterstützung 5 4.0 (2.0) 9 10.5 5
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Grundlegende Unterstützung (Ja) (Ja) 4.0 (2.0) (Ja) (Ja)

(Ja)

Siehe auch

Elementare Unterstützung

 

Schlagwörter des Dokuments und Mitwirkende

 Mitwirkende an dieser Seite: schlagi123, oliver-j, fscholz, yacchatta
 Zuletzt aktualisiert von: schlagi123,