Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Objets semblables à des tableaux

Un objet semblable à un tableau expose une longueur et des propriétés indexées, mais n’est pas nécessairement un tableau ni un objet itérable. Découvrez le rôle de `length` et comment `Array.from()` crée un tableau à partir de cette structure.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const arrayLike = { 0: value0, 1: value1, length: 2 };

Un objet semblable à un tableau (array-like) possède généralement une propriété length et des éléments accessibles aux indices de 0 à length - 1. Il ne s’agit ni d’une classe distincte ni d’une garantie que l’objet est un tableau. arguments dans une fonction ordinaire en est un exemple ; il n’hérite pas des méthodes de tableau telles que map().

La propriété length d’un objet semblable à un tableau indique sa longueur. Les méthodes de tableau normalisent cette valeur en un entier compris entre 0 et 2 ** 53 - 1. Tous les indices ne sont pas nécessairement présents. Sur un objet ordinaire, l’ajout d’un indice ne met pas automatiquement length à jour, et la diminution de length ne supprime pas les propriétés — contrairement à un tableau.

Le fait d’être semblable à un tableau et celui d’être itérable sont deux caractéristiques distinctes. Une propriété length à elle seule ne fournit pas la méthode [Symbol.iterator]() requise par for...of et la syntaxe [...value]. Array.from() utilise la méthode d’itération si elle est appelable. Il ne lit length et les propriétés indexées que si la propriété Symbol.iterator est absente ou vaut undefined ou null. Si Symbol.iterator contient une autre valeur non appelable, telle que false, Array.from() lève une exception TypeError avant de lire length. Lors de la lecture par indice, un indice manquant donne lieu, dans le nouveau tableau, à un élément présent dont la valeur est undefined.

De nombreuses méthodes de tableau peuvent être empruntées, par exemple avec Array.prototype.map.call(arrayLike, fn), mais toutes ne sont pas génériques. La conversion avec Array.from() elle-même repose uniquement sur ECMAScript et ne nécessite aucune API du DOM. Pour afficher les résultats, l’exemple utilise console.log, fourni par l’environnement d’exécution. Le fait que l’exemple fonctionne dans Node.js ne prouve pas la prise en charge des API de navigateur.

Exemples

const arrayLike = { 0: "A", 2: "C", length: 3 };
const values = Array.from(arrayLike);

console.log(Array.isArray(arrayLike));
console.log(typeof arrayLike[Symbol.iterator]);
console.log(values.length);
console.log(values[0], values[1], values[2]);
console.log(1 in values);

Résultat

false
undefined
3
A undefined C
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources