Baseline Widely available
Die of()
Methode von Intl.DisplayNames
Instanzen nimmt einen Code entgegen und gibt einen Zeichenkettenwert zurück, basierend auf der beim Erstellen des Intl.DisplayNames
Objekts angegebenen Lokale und Optionen.
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 Parameter
code
Der zu übergebende code
hängt vom type
ab:
code
entweder ein zwei-Buchstaben-ISO-3166 Regionscode oder ein drei-stelliger UN M49 geografischer Regionencode sein. Es muss der unicode_region_subtag
Grammatik folgen. Verwenden Sie GroÃbuchstabencodes (z.B. "US"
), da Kleinbuchstabencodes (z.B. "us"
) nicht überall zuverlässig funktionieren könnten.code
ein vier-Buchstaben-ISO-15924 Schriftcode sein. Es muss der unicode_script_subtag
Grammatik folgen.code
vom unicode_language_id
Nichtterminal übereinstimmen.code
ein drei-Buchstaben-ISO-4217 Währungscode sein. Es muss genau drei alphabetische Zeichen haben.code
einer der folgenden sein: "era"
, "year"
, "quarter"
, "month"
, "weekOfYear"
, "weekday"
, "day"
, "dayPeriod"
, "hour"
, "minute"
, "second"
, "timeZoneName"
.code
ein Kalender-Schlüssel sein. Es muss der type
Grammatik eines Unicode-Locale-Identifiers folgen.Ein sprachspezifisch formatierter String oder undefined
, falls keine Daten für die Eingabe verfügbar sind und fallback
auf "none"
gesetzt ist.
Hinweis: fallback
wird nur verwendet, wenn code
strukturell gültig ist. Siehe Verwendung von Fallback.
RangeError
Wird ausgelöst, wenn code
für den gegebenen type
nicht strukturell gültig ist.
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 von Fallback
Wenn Intl.DisplayNames
mit fallback: "code"
konstruiert wird, gibt die of()
Methode 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.
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 der code
strukturell gültig ist. Zum Beispiel, wenn type
"region"
ist, aber code
nicht der unicode_region_subtag
Grammatik folgt (2 alphabetische Zeichen oder 3 numerische Zeichen), wird direkt ein RangeError
ausgelöst, anstatt den Fallback zu verwenden.
console.log(
new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZLC"),
); // throws RangeError: invalid value "ZLC" for option region
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4