CKTIS / JavaScript
Array.prototype.sort: ordenação estável no próprio objeto
sort ordena os elementos do mesmo array, opcionalmente com uma função comparadora, e devolve esse objeto.
Versão: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2
Sintaxe
array.sort(compareFn?)array.sort(compareFn?) reúne os elementos existentes e ordena-os no próprio objeto. O valor devolvido é exatamente array. Com compareFn(a, b), um resultado negativo coloca a antes de b, um positivo depois, e zero ou NaN preserva a ordem relativa. Desde ES2019 a ordenação tem de ser estável. O callback nunca recebe undefined.
Sem compareFn, os valores diferentes de undefined são convertidos em strings e comparados por unidades de código UTF-16; assim, [80, 9, 100] torna-se [100, 80, 9]. Os undefined ficam após os restantes valores; os espaços vazios ficam ainda depois e continuam vazios.
O método altera o recetor; use toSorted() ou copie primeiro para evitar a mutação. É genérico para objetos array-like: lê length, escreve propriedades ordenadas e elimina índices finais ausentes. Um compareFn não invocável lança TypeError; propagam-se erros de conversão, callback, acessores, traps de proxy, escrita ou eliminação.
Exemplos
const tasks = [
{ label: "deploy", priority: 2 },
{ label: "test", priority: 1 },
{ label: "docs", priority: 2 },
];
const returned = tasks.sort((a, b) => a.priority - b.priority);
console.log(returned === tasks);
console.log(tasks.map(({ label, priority }) => `${label}:${priority}`).join("|"));
const numbers = [80, 9, 100];
numbers.sort();
console.log(numbers.join(","));
const sparse = [3, , undefined, 1];
sparse.sort();
console.log(sparse.length, 2 in sparse, 3 in sparse, sparse[0], sparse[1], String(sparse[2]));Resultado
true test:1|deploy:2|docs:2 100,80,9 4 true false 1 3 undefined