Array.isArray()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die Array.isArray() statische Methode bestimmt, ob der übergebene Wert ein Array ist.

In diesem Artikel

Probieren Sie es aus

console.log(Array.isArray([1, 3, 5]));
// Expected output: true

console.log(Array.isArray("[]"));
// Expected output: false

console.log(Array.isArray(new Array(5)));
// Expected output: true

console.log(Array.isArray(new Int16Array([15, 33])));
// Expected output: false

Syntax

Array.isArray(value)

Rückgabewert

true, wenn value ein Array ist; andernfalls false. false wird immer zurückgegeben, wenn value eine Instanz von TypedArray ist.

Array.isArray() prüft, ob der übergebene Wert ein Array ist. Es führt eine markierte Prüfung durch, ähnlich dem in Operator, für ein privates Feld, das durch den Array() Konstruktor initialisiert wird.

Es ist eine robustere Alternative zum instanceof Array, da es falsche Positive und falsche Negative vermeidet:

Array.isArray() lehnt Werte ab, die keine tatsächlichen Array Instanzen sind, selbst wenn sie Array.prototype in ihrer Prototypenkette haben — instanceof Array würde diese akzeptieren, da es die Prototypenkette überprüft.
Array.isArray() akzeptiert Array Objekte, die in einem anderen Kontext konstruiert wurden — instanceof Array gibt false für diese zurück, da die Identität des Array Konstruktors zwischen den Kontexten verschieden ist.

Details finden Sie im Artikel "Determining with absolute accuracy whether or not a JavaScript object is an array".

Beispiele

Verwendung von Array.isArray()

js
// all following calls return true
Array.isArray([]);
Array.isArray([1]);
Array.isArray(new Array());
Array.isArray(new Array("a", "b", "c", "d"));
Array.isArray(new Array(3));
// Little known fact: Array.prototype itself is an array:
Array.isArray(Array.prototype);

// all following calls return false
Array.isArray();
Array.isArray({});
Array.isArray(null);
Array.isArray(undefined);
Array.isArray(17);
Array.isArray("Array");
Array.isArray(true);
Array.isArray(false);
Array.isArray(new Uint8Array(32));
// This is not an array, because it was not created using the
// array literal syntax or the Array constructor
Array.isArray({ __proto__: Array.prototype });

instanceof vs. Array.isArray()

Beim Prüfen auf eine Array Instanz wird Array.isArray() dem instanceof vorgezogen, da es über verschiedene Kontexte hinweg funktioniert.

js
const iframe = document.createElement("iframe");
document.body.appendChild(iframe);
const xArray = window.frames[window.frames.length - 1].Array;
const arr = new xArray(1, 2, 3); // [1, 2, 3]

// Correctly checking for Array
Array.isArray(arr); // true
// The prototype of arr is xArray.prototype, which is a
// different object from Array.prototype
arr instanceof Array; // false

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Array
Konstruktor
1. Array()
Statische Methoden
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Instanzeigenschaften
1. length
2. [Symbol.unscopables]
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

Array.isArray()

In diesem Artikel

Probieren Sie es aus

Syntax

Parameter

Rückgabewert

Beschreibung

Beispiele

Verwendung von Array.isArray()

instanceof vs. Array.isArray()

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN