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

CKTIS / JavaScript

Intl.Collator — comparar texto segundo as regras linguísticas

Intl.Collator compara cadeias de caracteres segundo as regras de uma língua selecionada. A função compare pode ser passada diretamente à ordenação; o que importa é o sinal do resultado, não um valor numérico específico.

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

const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);

Intl.Collator faz parte da norma de internacionalização ECMA-402, não das interfaces DOM. Cria um objeto que compara texto de acordo com as definições regionais (locales) e as opções (options). Especificar explicitamente uma língua reduz a dependência das predefinições do ambiente.

Intl.Collator.prototype.compare é um acessor que devolve uma função associada à instância. Pode passar collator.compare diretamente a array.sort(...), sem utilizar bind. Um resultado negativo significa que a primeira cadeia precede a segunda; um resultado positivo significa que vem depois, e 0 indica equivalência segundo as regras de comparação. Não pressuponha que o resultado é exatamente -1 ou 1; 0 não significa necessariamente que as cadeias sejam idênticas.

usage: "sort" destina-se à ordenação, enquanto usage: "search" serve para verificar equivalência, não para ordenar. sensitivity determina quais as diferenças consideradas: "base", "accent", "case" ou "variant". numeric: true permite comparar sequências de algarismos como números, se o ambiente o suportar.

Os dados linguísticos e os detalhes da ordem dependem da implementação. Verifique a disponibilidade da API e das definições regionais necessárias no navegador de destino; a disponibilidade no Node 24 não comprova o suporte nos navegadores. Intl.Collator.supportedLocalesOf(...) ajuda a verificar as definições regionais, enquanto collator.resolvedOptions() mostra as definições efetivamente selecionadas.

Exemplos

const collator = new Intl.Collator("en", { usage: "sort" });
const words = ["c", "a", "b"];
console.log(words.sort(collator.compare).join(","));
console.log(collator.compare("a", "b") < 0);
console.log(collator.compare("a", "a") === 0);

Resultado

a,b,c
true
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.

Fontes