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

CKTIS / JavaScript

Intl.PluralRules — seleção de uma categoria gramatical

Intl.PluralRules seleciona uma categoria gramatical de número segundo regras específicas de cada língua. O método select devolve o nome de uma categoria, não uma palavra flexionada nem uma mensagem completa.

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 rules = new Intl.PluralRules(locales, options);
rules.select(value);

Intl.PluralRules faz parte da norma de internacionalização ECMA-402, não do DOM. O método de instância PluralRules.select, formalmente Intl.PluralRules.prototype.select(value), devolve uma categoria: zero, one, two, few, many ou other. As categorias disponíveis dependem da língua; estes nomes não representam simples testes de igualdade.

A opção predefinida type: "cardinal" diz respeito a quantidades. type: "ordinal" diz respeito a posições numa sequência. A API não traduz nem flexiona palavras: a aplicação associa texto às categorias e deve disponibilizar uma alternativa other. As opções de algarismos e de arredondamento podem alterar a categoria selecionada.

O exemplo seleciona explicitamente en e as regras cardinais, em vez de depender da língua predefinida do ambiente. O resultado esperado pressupõe que estão disponíveis os dados linguísticos de inglês. A especificação não é uma tabela de compatibilidade de navegadores: verifica os ambientes de destino e a disponibilidade da língua com Intl.PluralRules.supportedLocalesOf(["en"]). A disponibilidade da API no Node 24 não comprova a sua compatibilidade com navegadores.

Exemplos

const rules = new Intl.PluralRules("en", { type: "cardinal" });
const forms = { one: "file", other: "files" };

for (const count of [0, 1, 2]) {
  const category = rules.select(count);
  console.log(`${count} ${forms[category] ?? forms.other}`);
}

Resultado

0 files
1 file
2 files

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