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

CKTIS / JavaScript

Intl.Collator: sensibilidade e regras de ordenação regionais

Compara e ordena cadeias de texto segundo as regras da configuração regional escolhida. `sensitivity` define que diferenças contam na comparação.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()

The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.

Com Intl.Collator, as regras de ordenação da configuração regional efetivamente usada determinam o que conta como letra de base. Na ordenação alemã predefinida, ä é uma variante de a; na sueca, é uma letra distinta. Por isso, com "base", as duas cadeias podem ser consideradas equivalentes em de, mas não em sv.

As letras de base diferentes são distinguidas com qualquer valor de sensitivity. Entre variantes da mesma letra de base, "base" ignora os diacríticos e as diferenças entre maiúsculas e minúsculas; "accent" distingue os diacríticos, mas ignora as diferenças de maiúsculas e minúsculas; "case" faz o contrário; "variant" distingue ambos os aspetos e pode distinguir outros. Um valor fora desta lista, como "ignore", lança um RangeError.

No modo predefinido usage: "sort", a sensibilidade predefinida é "variant". Com usage: "search", depende da configuração regional; nesse modo, usa compare(a, b) === 0 para verificar uma correspondência, não para ordenar. Ao ordenar, um resultado negativo indica que a vem antes de b, um positivo indica que vem depois e zero significa que a comparação os trata como equivalentes. Não esperes exatamente -1 ou 1. A função collator.compare está associada à sua instância, pelo que a podes passar diretamente a sort(). Um resultado de 0 não implica que a === b.

Pede explicitamente uma configuração regional: se não houver correspondência para nenhuma das configurações pedidas, o ambiente de execução usa a sua predefinição. Intl.Collator.supportedLocalesOf() verifica o suporte sem recorrer à predefinição do ambiente, e resolvedOptions().locale indica a configuração efetivamente usada. Os dados de ordenação podem variar entre ambientes e versões, mesmo com as mesmas opções efetivas.

Exemplos

{
  const locales = ["en", "de", "sv"];
  if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
      Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
    console.log("Intl.Collator or required locales unavailable");
  } else {
    for (const sensitivity of ["base", "accent", "case", "variant"]) {
      const { compare } = new Intl.Collator("en", { sensitivity });
      console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
    }

    for (const locale of ["de", "sv"]) {
      const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
      console.log(`${locale}: ${compare("a", "ä") === 0}`);
    }
  }
}

Resultado

base: true, true
accent: false, true
case: true, false
variant: false, false
de: true
sv: false

Nas primeiras quatro linhas, `true` significa que o par é considerado equivalente: primeiro `a` e `á`, depois `a` e `A`. As últimas duas linhas comparam `a` com `ä` usando `"base"` em `de` e `sv`. O resultado apresentado pressupõe suporte para estas configurações e para `en`, com as regras de ordenação predefinidas descritas.

Lições relacionadas

  • JavaScript · Lição 24 · Intermédio · Versão: 3

Fontes