Intl.DisplayNames.prototype.of()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die of() Methode von Intl.DisplayNames Instanzen erhält einen Code und gibt einen String basierend auf dem Gebietsschema und den bereitgestellten Optionen zurück, die beim Instanziieren dieses Intl.DisplayNames Objekts angegeben wurden.

Probieren Sie es aus

const regionNamesInEnglish = new Intl.DisplayNames(["en"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
  type: "region",
});

console.log(regionNamesInEnglish.of("US"));
// Expected output: "United States"

console.log(regionNamesInTraditionalChinese.of("US"));
// Expected output: "美國"

Syntax

js
of(code)

Parameter

code

Der zu bereitstellende code hängt vom type ab:

Rückgabewert

Ein sprachspezifisch formatierter String oder undefined, wenn keine Daten für die Eingabe vorhanden sind und fallback "none" ist.

Hinweis: fallback wird nur verwendet, wenn code strukturell gültig ist. Siehe Verwendung des Fallbacks.

Ausnahmen

RangeError

Wird ausgelöst, wenn code für den gegebenen type strukturell ungültig ist.

Beispiele

Verwendung der of-Methode

js
const regionNames = new Intl.DisplayNames("en", { type: "region" });
regionNames.of("419"); // "Latin America"

const languageNames = new Intl.DisplayNames("en", { type: "language" });
languageNames.of("fr"); // "French"

const currencyNames = new Intl.DisplayNames("en", { type: "currency" });
currencyNames.of("EUR"); // "Euro"

const languageNamesStandard = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "standard",
});
languageNamesStandard.of("fr-CA"); // "français (Canada)"

const languageNamesDialect = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "dialect",
});
languageNamesDialect.of("fr-CA"); // "français canadien"

Verwendung des Fallbacks

Wenn Intl.DisplayNames mit fallback: "code" konstruiert wird, gibt die Methode of() den code zurück, wenn die Eingabe strukturell gültig aussieht, aber keine Daten für die Eingabe vorhanden sind. Wenn fallback "none" ist, wird undefined zurückgegeben.

js
console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZL"),
); // "ZL"

console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "none" }).of("ZL"),
); // undefined

Dies gilt jedoch nur, wenn code strukturell gültig ist. Beispielsweise, wenn type "region" ist, aber code nicht der unicode_region_subtag Grammatik entspricht (2 alphabetische oder 3 numerische Zeichen), wird direkt ein RangeError ausgelöst, anstatt den Fallback zu verwenden.

js
console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZLC"),
); // throws RangeError: invalid value "ZLC" for option region

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.DisplayNames.prototype.of

Browser-Kompatibilität

Siehe auch