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

CKTIS / JavaScript

Syntaxe spread et rest (...)

La notation `...` a deux rôles selon le contexte : spread développe des valeurs ou des propriétés, tandis que rest rassemble les arguments, éléments ou propriétés restants. Ce n’est pas un opérateur d’expression autonome. Les copies réalisées avec cette syntaxe sont superficielles.

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

fn(...iterable)
[...iterable]
({ ...source })
function fn(first, ...args) {}
const [first, ...tail] = iterable;
const { key, ...remaining } = source;

... désigne la syntaxe spread ou rest selon son emplacement ; ce n’est pas un opérateur d’expression autonome. Spread dans fn(...iterable) transmet des valeurs comme arguments, tandis que [...iterable] les place dans un nouveau tableau. La source doit être itérable : un objet ordinaire ne suffit pas. Des développements d’arguments très volumineux peuvent dépasser la limite du moteur.

Spread dans { ...source } copie les propriétés propres énumérables, y compris les clés Symbol ; l’itérabilité n’est pas nécessaire. Les définitions ultérieures remplacent les valeurs précédentes pour une même clé. Le prototype et les descripteurs de propriété ne sont pas copiés, et la lecture des propriétés peut déclencher des getters. Les sources null et undefined sont ignorées ici, mais [...null] déclenche un TypeError.

Rest dans function fn(first, ...args) {} rassemble les arguments restants dans un véritable tableau. En déstructuration, const [first, ...tail] = iterable rassemble les valeurs restantes de l’itérateur dans un tableau, tandis que const { key, ...remaining } = source crée un objet contenant les propriétés propres énumérables restantes. Rest doit être en dernière position de sa liste et ne peut pas être suivi d’une virgule ; un paramètre rest ne peut pas avoir de valeur par défaut.

Les copies sont superficielles : les objets imbriqués restent partagés. L’exemple montre le développement, la collecte et le partage de settings. Les paramètres rest, le rest de tableau et le spread de tableaux et d’arguments datent d’ES2015 ; le rest/spread d’objet date d’ES2018. Ce sont des fonctionnalités ECMAScript, pas des Web APIs. La spécification n’est pas un tableau de compatibilité des navigateurs ; la prise en charge dans un navigateur donné doit être vérifiée séparément, et la présence de Node 24 dans un dépôt ne la prouve pas.

Exemples

function sum(...values) {
  return values.reduce((total, value) => total + value, 0);
}

const numbers = [2, 3, 4];
const [first, ...tail] = numbers;
const original = { name: "Ada", settings: { active: true } };
const copy = { ...original, name: "Lin" };
const { name, ...remaining } = copy;

console.log(sum(...numbers));
console.log(JSON.stringify([first, ...tail, 5]));
console.log(name, remaining.settings === original.settings);

Résultat

9
[2,3,4,5]
Lin 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