GT ClassMethodsLocales
determineLocale
API Reference zur GT-Methode determineLocale
Übersicht
Die Methode determineLocale ermittelt auf Basis der Benutzerpräferenzen die bestpassende locale aus einer Liste freigegebener locales.
Sie führt Locale‑Aushandlung durch, um die geeignetste locale zu finden, wenn keine exakte Übereinstimmung verfügbar ist.
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});
// Exakte Übereinstimmung
console.log(gt.determineLocale('en-US')); // 'en-US'
// Sprach-Standardwert
console.log(gt.determineLocale('en-GB')); // 'en-US' (closest English variant)
// Mehrere Präferenzen
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (closest Spanish)
// Keine Übereinstimmung
console.log(gt.determineLocale('it-IT')); // undefinedReferenzen
Parameter
Prop
Type
Rückgabewert
string | undefined – Bestpassende locale oder undefined, wenn keine Übereinstimmung gefunden wird
Beispiele
Aushandlung der Benutzerlocale
const gt = new GT({
sourceLocale: 'en-US',
locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});
// Browser-Accept-Language-Header simulieren
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' basierend auf der PräferenzreihenfolgeHinweise
- Gibt die erste exakte Übereinstimmung aus den freigegebenen locales zurück
- Greift auf Sprachübereinstimmungen zurück, wenn die genaue Region nicht verfügbar ist
- Berücksichtigt die Präferenzreihenfolge im Eingabe-Array
- Gibt undefined zurück, wenn keine passende Übereinstimmung gefunden wird
- Wesentlich für die Implementierung der locale‑Aushandlung in Webanwendungen
Nächste Schritte
- Prüfen Sie den Übersetzungsbedarf mit
requires-translation - Vergleichen Sie Sprachen mit
is-same-language
Wie ist diese Anleitung?