Array : méthode statique isArray()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode statique Array.isArray() détermine si la valeur passée est un Array.

Dans cet article

Exemple interactif

console.log(Array.isArray([1, 3, 5]));
// Résultat attendu : true

console.log(Array.isArray("[]"));
// Résultat attendu : false

console.log(Array.isArray(new Array(5)));
// Résultat attendu : true

console.log(Array.isArray(new Int16Array([15, 33])));
// Résultat attendu : false

Syntaxe

Array.isArray(value)

Paramètres

value

La valeur dont on veut vérifier le type.

Valeur de retour

true si value est un Array ; sinon, false. false est toujours retourné si value est une instance de TypedArray.

Array.isArray() vérifie si la valeur passée est un Array. Elle effectue un contrôle de marque (branded check en anglais), similaire à l'opérateur in, pour un champ privé initialisé par le constructeur Array().

C'est une alternative plus robuste à instanceof Array, car elle évite les faux positifs et les faux négatifs :

Array.isArray() rejette les valeurs qui ne sont pas de véritables instances de Array, même si elles possèdent Array.prototype dans leur chaîne de prototypes — instanceof Array accepterait ces valeurs, car il vérifie la chaîne de prototypes.
Array.isArray() accepte les objets Array construits dans un autre environnement d'exécution (realm en anglais) — instanceof Array retourne false pour ceux-ci, car l'identité du constructeur Array est différente entre les environnements.

Voir l'article « Déterminer avec une précision absolue si un objet JavaScript est un tableau » (angl.) pour plus de détails.

Exemples

js
// Tous les appels suivant renvoient true
Array.isArray([]);
Array.isArray([1]);
Array.isArray(new Array());
Array.isArray(new Array("a", "b", "c"));
Array.isArray(new Array(3));
// Une petite anecdote: Array.prototype lui même est un Array
Array.isArray(Array.prototype);

// Tous les appels suivant renvoient 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));
// Ceci n'est pas un tableau, car il n'a pas été créé avec
// la syntaxe littérale de tableau ou le constructeur Array
Array.isArray({ __proto__: Array.prototype });

instanceof contre Array.isArray()

Lors de la vérification d'une instance de Array, il est préférable d'utiliser Array.isArray() plutôt que instanceof, car cela fonctionne entre différents environnements d'exécution (realm en anglais).

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]

// Vérification correcte pour Array
Array.isArray(arr); // true
// Le prototype de arr est xArray.prototype, qui est un
// objet différent de Array.prototype
arr instanceof Array; // false

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 5 nov. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Array
Constructeur
1. Array()
Méthodes statiques
Propriétés statiques
1. [Symbol.species]
Méthodes d'instance
Propriétés d'instance
1. length
2. [Symbol.unscopables]
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor

Array : méthode statique isArray()

Dans cet article

Exemple interactif

Syntaxe

Paramètres

Valeur de retour

Description

Exemples

instanceof contre Array.isArray()

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN