Array.of()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

La methode Array.of() permet de créer une nouvelle instance d'objet Array à partir d'un nombre variable d'arguments, quels que soient leur nombre ou leur type.

La différence entre Array.of() et le constructeur Array se situe dans la gestion de d'arguments entiers : Array.of(7) crée un tableau avec un seul élément, 7, tandis que Array(7) produit un tableau avec 7 éléments vides (à ne pas confondre avec des éléments qui auraient explicitement la valeur undefined).

js
Array.of(7); // [7]
Array.of(1, 2, 3); // [1, 2, 3]

Array(7); // un tableau avec 7 emplacements vides
Array(1, 2, 3); // [1, 2, 3]

Syntaxe

js
Array.of(element0[, element1[, ...[, elementN]]])

Paramètres

element0, element1, ..., elementN

Les éléments avec lesquels on souhaite construire le nouveau tableau.

Valeur de retour

Une nouvelle instance de Array.

Description

Cette fonction fait partie du standard ECMAScript 2015. Pour plus d'informations, voir les pages sur la proposition pour Array.of et Array.from ainsi que la page sur le fragment d'émulation pour Array.of.

js
Array.of(7); // [7]
Array.of(1, 2, 3); // [1, 2, 3]

Array(7); // [ , , , , , , ]
Array(1, 2, 3); // [1, 2, 3]

Exemples

js
Array.of(1); // [1]
Array.of(1, 2, 3); // [1, 2, 3]
Array.of(undefined); // [undefined]

Prothèse d'émulation (polyfill)

Exécuter ce code avant tout autre code permettra de créer la méthode Array.of() si elle n'est pas prise en charge nativement.

js
if (!Array.of) {
  Array.of = function () {
    return Array.prototype.slice.call(arguments);
  };
}

Spécifications

Specification
ECMAScript Language Specification
# sec-array.of

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi