KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.PluralRules.prototype.select(): een meervoudscategorie kiezen

`select(value)` geeft de grammaticale categorie van één waarde terug op basis van de taalinstelling en opties van de instantie. Gebruik de uitkomst om een vertaalde tekstvariant te kiezen, niet om een getal op te maken.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

rules.select(value)

Intl.PluralRules.prototype.select is een instantiemethode. Maak rules met new Intl.PluralRules(locales, options) en roep rules.select(value) aan. De methode geeft een van de tekenreeksen "zero", "one", "two", "few", "many" of "other" terug. Welke categorieën voorkomen, hangt af van de gebruikte taalinstelling en het regeltype; "one" komt niet altijd overeen met value === 1. Gebruik de categorie als sleutel voor een vertaalde tekstvariant: de methode vertaalt geen tekst en maakt geen getal op.

Het standaardtype "cardinal" geeft een hoeveelheid aan (‘hoeveel?’); "ordinal" geeft een positie aan (‘de hoeveelste?’). Afronding en opties zoals minimumFractionDigits kunnen de categorie veranderen, omdat regels van zichtbare decimalen kunnen afhangen. select classificeert één waarde; selectRange classificeert een heel bereik. Bekijk rules.resolvedOptions().locale voor de werkelijk gebruikte taalinstelling: die kan afwijken van de gevraagde instelling.

De ontvanger (this) moet een geïnitialiseerde Intl.PluralRules-instantie zijn. Aanroepen op het prototype zelf of als losstaande, ongebonden functie geeft TypeError. Zowel in ECMA-402 (2024) als in de huidige conceptversie gebruikt select de bewerking ToNumber: numerieke tekenreeksen worden omgezet in Number-waarden ("2" wordt 2), terwijl BigInt en Symbol een TypeError veroorzaken. Een weggelaten argument wordt NaN; NaN en beide oneindigheden geven "other". De uitkomst is dus geen bewijs dat de invoer geldig is.

Voorbeelden

{
  const cardinal = new Intl.PluralRules('en-US');
  const ordinal = new Intl.PluralRules('en-US', { type: 'ordinal' });
  const withFraction = new Intl.PluralRules('en-US', { minimumFractionDigits: 1 });

  console.log(cardinal.select(1));
  console.log(cardinal.select(2));
  console.log(ordinal.select(2));
  console.log(withFraction.select(1));
}

Resultaat

one
other
two
other

Volgens de regels voor Amerikaans-Engels levert `2` als hoofdtelwoord `other` op en als rangtelwoord `two`. Met één verplichte decimaal wordt `1` geclassificeerd als `1.0`, met `other` in plaats van `one` als resultaat.

Gerelateerde lessen

  • JavaScript · Les 24 · Gevorderd · Versie: 4

Bronnen