Array.isArray()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
La méthodeArray.isArray() permet de déterminer si l'objet passé en argument est un objetArray, elle renvoietrue si le paramètre passé à la fonction est de typeArray etfalse dans le cas contraire.
Array.isArray([1, 2, 3]); // trueArray.isArray({ toto: 123 }); // falseArray.isArray("tototruc"); // falseArray.isArray(undefined); // falseSyntaxe
Array.isArray(value);Paramètres
valueLa valeur dont on veut vérifier le type
Valeur de retour
true si la valeur est un tableau (une instance deArray),false sinon.
Description
Si l'objet indiqué en paramètre est unArray, la méthode renvoietrue, sinon, elle renvoiefalse.
Voir aussi : «Determining with absolute accuracy whether or not a JavaScript object is an array » (en anglais) pour avoir plus de détails. Si on passe un objetTypedArray en argument, ce sera toujours la valeurfalse qui sera renvoyée.
Exemples
// Tous les appels suivant renvoient trueArray.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 ArrayArray.isArray(Array.prototype);// Tous les appels suivant renvoient falseArray.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));Array.isArray({ __proto__: Array.prototype });Prothèse d'émulation (polyfill)
Exécuter ce code avant tout les autres aboutira à la création de la méthodeArray.isArray()si elle n'est pas nativement prise en charge par le navigateur.
if (!Array.isArray) { Array.isArray = function (arg) { return Object.prototype.toString.call(arg) === "[object Array]"; };}Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.isarray |