JavaScriptTableaux

Array.isArray()

Vérifie si une valeur est un tableau.

Renvoie
true ou false.
Modifie l’original
Non
Sur cette page

Exemple

#
JavaScript
console.log(Array.isArray([1, 2]))
console.log(Array.isArray({ length: 2 }))
console.log(Array.isArray('texte'))
console.log(typeof [1, 2])
Console
true
false
false
object

Définition et utilisation

#

La méthode statique Array.isArray() renvoie true si la valeur donnée est un tableau, et false dans tous les autres cas.

Elle est nécessaire car l’opérateur typeof renvoie "object" pour les tableaux, tout comme pour les objets ordinaires et null. Vous ne pouvez pas les distinguer de cette façon.

Elle est utile avec des données externes, par exemple provenant d’une API ou d’un fichier JSON, où un champ peut être une valeur unique ou une liste.

Syntaxe

#
Syntaxe
Array.isArray(value)

Paramètres

#
  • value

    valeur quelconque

    Valeur à vérifier.

Plus d’exemples

#
Normalisation de données
JavaScript
const toList = (value) => (Array.isArray(value) ? value : [value])

console.log(toList('HTML'))
console.log(toList(['HTML', 'CSS']))
Console
['HTML']
['HTML', 'CSS']

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne vérifiez pas un tableau avec typeof. Il renverra toujours "object".
  • Une fonction qui transforme une valeur unique en tableau (toList) simplifie le traitement des données de formulaires et d’API.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.