Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Ordenar e comparar elementos de um array

A ordenação organiza os elementos de acordo com uma regra de comparação. Aprende a ordem textual predefinida, os comparadores numéricos, a estabilidade e a diferença entre sort(), que altera o array, e toSorted(), que cria uma cópia.

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

array.sort(compareFn)
array.toSorted(compareFn)
compareFn(a, b) // Number: < 0, 0, > 0

A ordenação organiza os elementos de acordo com uma regra de comparação. array.sort(compareFn) altera o array e devolve esse mesmo array. Sem compareFn, compara as representações em cadeia de caracteres dos elementos lexicograficamente, segundo unidades de código UTF-16, e não numericamente: [10, 2, 1].sort() produz [1, 10, 2].

Um comparador recebe a e b e devolve um Number: um valor negativo se a deve ficar antes, positivo se deve ficar depois, ou 0 se os elementos tiverem a mesma prioridade. Para números finitos, (a, b) => a - b ordena por ordem crescente e (a, b) => b - a por ordem decrescente. Não uses (a, b) => a > b: um resultado booleano não descreve corretamente os três casos. O comparador deve ser determinístico, não alterar os dados comparados e manter a consistência do sinal quando os argumentos são trocados, bem como a transitividade. Um resultado NaN é tratado como 0.

A ordenação é estável: os elementos considerados iguais mantêm a ordem original. Assim, podes ordenar objetos por um campo sem alterar a ordem dos elementos empatados. A especificação não exige um algoritmo específico nem garante complexidade temporal ou espacial. Em arrays comuns, undefined fica depois dos outros valores e o comparador não é chamado para esse valor; sort() coloca as posições vazias depois de undefined.

array.toSorted(compareFn) está normalizado desde ECMAScript 2023 e devolve uma nova cópia superficial com os elementos ordenados. Usa o mecanismo habitual de pesquisa de propriedades em cada índice, pelo que pode ler um valor herdado mesmo que não exista uma propriedade própria nesse índice. A leitura só dá undefined se não for encontrada nenhuma propriedade ou se a propriedade encontrada devolver undefined ao ser lida. Antes de o utilizar, verifica typeof Array.prototype.toSorted === "function" no ambiente de destino; estar disponível em Node.js não prova que seja suportado nos browsers. O exemplo usa [...numbers].sort(...) para preservar o array denso original sem exigir toSorted().

Exemplos

const numbers = [10, 2, 1];
const lexical = [...numbers].sort();
const numeric = [...numbers].sort((a, b) => a - b);
console.log(JSON.stringify(lexical));
console.log(JSON.stringify(numeric));
console.log(JSON.stringify(numbers));

Resultado

[1,10,2]
[1,2,10]
[10,2,1]

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.

Fontes