CKTIS / JavaScript
Sintaxe spread e rest (...)
A notação `...` tem duas funções consoante o contexto: spread expande valores ou propriedades, enquanto rest reúne os argumentos, elementos ou propriedades restantes. Não é um operador de expressão autónomo. As cópias criadas com esta sintaxe são superficiais.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
fn(...iterable)
[...iterable]
({ ...source })
function fn(first, ...args) {}
const [first, ...tail] = iterable;
const { key, ...remaining } = source;... representa a sintaxe spread ou rest, consoante a posição; não é um operador de expressão autónomo. Spread em fn(...iterable) passa valores como argumentos, enquanto [...iterable] os coloca num novo array. A origem tem de ser iterável: um objeto normal não basta. Expansões de argumentos muito grandes podem ultrapassar o limite do motor.
Spread em { ...source } copia propriedades próprias enumeráveis, incluindo chaves Symbol; não exige iterabilidade. Definições posteriores substituem valores anteriores da mesma chave. Não copia o protótipo nem os descritores das propriedades, e a leitura de propriedades pode invocar getters. As origens null e undefined são ignoradas neste caso, mas [...null] gera um TypeError.
Rest em function fn(first, ...args) {} reúne os argumentos restantes num array real. Na desestruturação, const [first, ...tail] = iterable reúne os valores restantes do iterador num array, enquanto const { key, ...remaining } = source cria um objeto com as propriedades próprias enumeráveis restantes. Rest tem de ser o último elemento da respetiva lista e não pode ter uma vírgula final; um parâmetro rest não pode ter um valor predefinido.
As cópias são superficiais: os objetos aninhados continuam partilhados. O exemplo demonstra a expansão, a recolha e a partilha de settings. Os parâmetros rest, o rest de arrays e o spread de arrays e argumentos existem desde ES2015; o rest/spread de objetos, desde ES2018. São funcionalidades ECMAScript, não Web APIs. A especificação não é uma tabela de compatibilidade dos browsers; o suporte num browser específico tem de ser verificado separadamente, e a presença de Node 24 num repositório não o comprova.
Exemplos
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);Resultado
9 [2,3,4,5] Lin true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.