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.