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

CKTIS / JavaScript

String.prototype.localeCompare — comparação de texto segundo regras linguísticas

String.prototype.localeCompare compara duas cadeias de caracteres segundo regras de ordenação linguísticas. O sinal do resultado determina a ordem; locales e options permitem personalizar a comparação em ambientes compatíveis com ECMA-402.

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

string.localeCompare(compareString, locales?, options?)

String.prototype.localeCompare compara a cadeia de caracteres recetora com compareString. Um resultado negativo indica que fica antes da outra cadeia, um positivo indica que fica depois, e 0 significa equivalência nessa comparação, não necessariamente texto idêntico. Verifique o sinal do resultado, não os valores exatos -1 e 1.

Em ambientes com ECMA-402, locales pede um idioma preferido, como "en"; se for omitido, são usadas as predefinições do ambiente. options personaliza a comparação: numeric: true ordena sequências de algarismos pelo respetivo valor numérico. As regras dependem dos dados de idioma disponíveis; sem ECMA-402, não é possível contar com o suporte destes argumentos.

Para ordenar, passe (a, b) => a.localeCompare(b, "en", options). Não passe o método isoladamente como função de comparação: precisa do recetor this correto. No exemplo, numeric: true coloca item2 antes de item10; a linha esperada é item1, item2, item10.

Exemplos

const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));

Resultado

item1, item2, item10

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