Utility FunctionsLocales

determineLocale

Справка по API функции determineLocale

Обзор

Функция determineLocale выбирает наиболее подходящую локаль из утверждённых на основе предпочтений пользователя, при этом экземпляр класса GT не требуется.


Справка

Параметры

Prop

Type

Возвращает

string | undefined — наиболее подходящую локаль или undefined, если совпадений нет


Примеры

Согласование контента

import { determineLocale } from 'generaltranslation';

const approvedLocales = ['en-US', 'es-ES', 'fr-FR', 'de-DE'];

// Точное совпадение
console.log(determineLocale('en-US', approvedLocales)); // 'en-US'

// Запасной вариант языка
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'

// Несколько предпочтений
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'

// Нет совпадений
console.log(determineLocale('it-IT', approvedLocales)); // undefined

Примечания

  • Реализует интеллектуальный выбор локали
  • Возвращает первое точное совпадение или совпадение по языку из утверждённого списка
  • Учитывает порядок предпочтений во входном массиве
  • Возвращает undefined, если совпадений не найдено
  • Критично для механизма согласования локали в веб‑приложениях

Дальнейшие шаги

Насколько полезно это руководство?

determineLocale