WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.PluralRules — Auswahl einer Plural-Kategorie

Intl.PluralRules wählt anhand sprachspezifischer Regeln eine grammatische Numeruskategorie aus. Die Methode select gibt den Namen einer Kategorie zurück, nicht ein gebeugtes Wort oder eine vollständige Nachricht.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const rules = new Intl.PluralRules(locales, options);
rules.select(value);

Intl.PluralRules gehört zum Internationalisierungsstandard ECMA-402, nicht zum DOM. Die Instanzmethode PluralRules.select, formal Intl.PluralRules.prototype.select(value), gibt eine Kategorie zurück: zero, one, two, few, many oder other. Welche Kategorien verfügbar sind, hängt von der Sprache ab; diese Namen stehen nicht für einfache Gleichheitstests.

Die Standardoption type: "cardinal" betrifft Mengenangaben. type: "ordinal" betrifft Positionen in einer Reihenfolge. Die API übersetzt oder beugt keine Wörter: Die Anwendung ordnet den Kategorien Texte zu und sollte eine other-Fallback-Variante bereitstellen. Optionen für Ziffern und Rundung können die ausgewählte Kategorie beeinflussen.

Das Beispiel wählt ausdrücklich en und Kardinalregeln, statt von der Standardsprache der Umgebung abhängig zu sein. Die erwartete Ausgabe setzt voraus, dass englische Sprachdaten verfügbar sind. Die Spezifikation ist keine Browser-Kompatibilitätstabelle: Prüfe die Zielumgebungen und die Verfügbarkeit der Sprache mit Intl.PluralRules.supportedLocalesOf(["en"]). Dass die API in Node 24 verfügbar ist, belegt nicht ihre Unterstützung in Browsern.

Beispiele

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}`);
}

Ergebnis

0 files
1 file
2 files

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen