Назад в Центр знаний
Платформа

navigator.languages и локализация: выбор правильной локали

navigator.languages возвращает упорядоченный список языковых подсказок. Изучите порядок согласования с уважением к явному выбору и полным резервом.

BotBrowser Team

Документация

Нужна структурированная документация по теме Платформа?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Языковые предпочтения браузера помогают выбрать первый перевод, но остаются только подсказкой. navigator.language сообщает основной язык, а navigator.languages может вернуть упорядоченный список. Эти значения не доказывают место проживания, национальность или желаемый язык для каждой задачи. Приложение должно согласовать поддерживаемую локаль, показать переключатель и сохранить понятный запасной вариант.

Настройки профиля BotBrowser могут задать языки и локаль браузера, включая значения auto, выведенные из прокси, но BotBrowser не переводит содержимое приложения и не заменяет явный выбор языка в приложении. Подсказка браузера может быть входом согласования, а приложение сохраняет контроль над переводом, согласием и резервом.

Кратко

navigator.language и navigator.languages. подсказки локализации. Они помогают выбрать начальную локаль, но не доказывают личность или местоположение. Согласуйте выбор со списком поддерживаемых локалей, отдавайте явный выбор языка в приложении выше подсказки браузера и всегда предлагайте полную версию по умолчанию.

Содержание

Что означают значения Navigator

Интерфейс Navigator раскрывает настройки пользователя или браузера. MDN Navigator.language описывает основную языковую метку, а WHATWG Navigator.languages описывает упорядоченные предпочтения. fr-CA выражает языковую и региональную настройку содержимого, но не географическое положение.

Список может отсутствовать, содержать один элемент или измениться после настройки браузера. Используйте его как вход для выбора, а не как постоянный профиль. Атрибут lang документа имеет другую роль: он помогает экранным дикторам и должен обновляться при смене видимого языка.

Согласовать поддерживаемые локали

Определите конечный список действительно переведённых локалей. Нормализуйте метки, сначала проверяйте точную региональную форму, затем родительский язык. При поддержке fr-CA, fr и en канадский запрос получает fr-CA, другой французский получает fr, остальные получают en. Нельзя придумывать перевод или считать регионы взаимозаменяемыми.

Надёжный порядок таков: сохранённый явный выбор, первое поддерживаемое значение из navigator.languages, navigator.language при отсутствии списка и стабильный язык по умолчанию. Такой порядок работает и во встроенном окне с меньшим объёмом данных. Язык по умолчанию должен давать полную страницу, а не необработанные ключи.

Интернационализация различает язык, письменность и регион. W3C Internationalization объясняет, почему эти части нельзя смешивать. Если вариант не поддерживается, сообщите о запасном языке и оставьте переключатель доступным.

Для структурированного сравнения разберите и канонизируйте метки с помощью Intl.Locale, прежде чем сопоставлять их с поддерживаемыми локалями. Сервер также может получить HTTP-заголовок Accept-Language для выбора первого ответа, но это подсказка, а не доказательство личности или местоположения. Используйте только необходимые данные и ставьте сохранённый явный выбор выше обоих источников; BotBrowser задаёт языковые входы браузера, но не определяет серверную политику или итоговую локаль приложения.

Сохранить явный выбор

Автоматический выбор удобен при первом посещении, но не должен запирать человека в непонятном языке. Переключатель должен иметь переведённые названия, ясное текущее значение и управление с клавиатуры. Сохраняйте локаль только после явного выбора и восстанавливайте её до чтения новой настройки браузера. Объясните, меняется ли страница, учётная запись или будущие посещения.

Во время загрузки сохраняйте содержимое и фокус. Не удаляйте форму или черновик при смене языка. При ошибке пакета оставьте последнюю читаемую локаль и предложите повтор. Языковая настройка не является согласием на маркетинг, передачу данных или юридическое решение.

Загрузить ресурсы без потери содержания

Версионируйте переводы и проверяйте наличие всех ключей маршрута. При переходе показывайте прежнюю строку, а не внутренний ключ. Не склеивайте фрагменты предложений: порядок слов и формы множественного числа различаются. Для дат, чисел и списков используйте Intl, но храните канонические данные и не выводите налоговую страну из языка.

Обновляйте lang, заголовки, описания, альтернативные ссылки и направление документа. Проверяйте длинные строки, письмо справа налево и сочетания чисел с кодом. Локализованный URL должен сохранять смысл; отсутствующий перевод не должен вести на несвязанную главную страницу.

Проверить предпочтения, резерв и доступность

Проверьте пустой список, неподдерживаемый регион, метку с письменностью и браузер, который предоставляет только navigator.language. Измените настройку после явного выбора и убедитесь, что выбор сохраняется. Сотрите выбор и проверьте предсказуемое новое согласование.

Проверьте медленную сеть, прерванный ответ и устаревший кеш. Сохраняйте ввод, сообщайте о прогрессе и давайте повторить операцию. Пройдите переключатель с клавиатуры, проверьте фокус и новый lang с экранным диктором. Проверьте формы множественного числа, десятичные разделители, расширение текста и масштабирование.

Используйте фиксированный набор приёмочных примеров, чтобы изменение правил можно было повторить без личных настроек браузера тестировщика. Задайте поддерживаемый список en, fr и fr-CA, затем выполните каждую строку с предпочтениями браузера и сохранённым выбором из набора. После отрисовки зафиксируйте выбранную локаль, источник решения, ревизию загруженного пакета и lang документа. Ожидаемый результат одинаков в ответе сервера и после гидратации; расхождение считается ошибкой, даже если страница в итоге показывает читаемый язык.

Входные данные примераОжидаемый выборПроверка приёмки
Сохранённый аккаунт fr-CA; браузер enfr-CA из аккаунтаСмена настроек браузера не заменяет выбор аккаунта
Нет сохранённого выбора; браузер fr-BE,enРезерв fr по родительскому языкуСелектор называет резерв; lang документа равен fr
Нет сохранённого выбора; браузер deЗначение по умолчанию enПолный английский пакет загружается без внутренних ключей
Выбор устройства en; аккаунт frfr, пока выполнен входВыход возвращает en в области устройства
Пакет fr-CA недоступенПолный пакет fr или enНет смешанных критичных элементов; повтор доступен

Приватность и границы

Предпочтения могут повысить узнаваемость конфигурации вместе с другими данными. Если нужна только локаль, не отправляйте весь список в аналитику. Не используйте метки для вывода места жительства или чувствительных признаков. Для удалённого перевода сообщите сервис, срок хранения и действие, запускающее передачу. Отсутствие локального ресурса не должно незаметно загружать личный текст. Перевод страниц на стороне браузера рассматривается в статье «Перевод страниц Google Translate в BotBrowser».

Документируйте полностью переведённые локали и варианты с резервом. Сохраняйте доступный запасной путь и пересматривайте изменения хранения, синхронизации и упаковки ресурсов.

Для дат и чисел отделяйте выбор локали от хранимых данных согласно руководству по форматированию Intl. Дополнительные настройки приватности браузера помогают проверить границы данных.

То же правило относится к уведомлениям, файлам и поддержке: меняйте подписи, но не данные и разрешения.

Объясните область действия переключателя и покажите понятный резерв, если ресурс отсутствует.

Языковая метка может включать письменность и регион, поэтому эти части нужно сохранять раздельно.

Согласование должно быть детерминированным, чтобы поддержку можно было воспроизвести без хранения всего списка браузера.

Вход и восстановление должны оставаться понятными, если выбранный пакет ещё не загружен.

Серверный и клиентский маршрут должны одинаково учитывать сохранённый явный выбор.

Качество включает заголовки, подписи, предупреждения, альтернативный текст и формы множественного числа.

При отсутствии локали предложите другой язык, вариант по умолчанию или повтор загрузки.

Пересмотрите согласование после изменения приватности, встроенного окна или данных интернационализации.

Язык по умолчанию должен позволять закончить задачу без ожидания новой загрузки.

Смена языка не должна удалять введённые данные или ранее выданные разрешения.

Сообщения об ошибках тоже требуют перевода или понятного резерва.

Смысл сохранённых дат и сумм не должен меняться из-за отображаемой локали.

Направление текста и атрибут lang относятся к доступности.

Настройка браузера не заменяет осознанное решение передать содержимое.

Предпочтения браузера согласуются с доступными ресурсами, а явный выбор имеет приоритет.

Сохраняйте понятный выбор для каждой локали и объясняйте возврат к языку по умолчанию на мобильном устройстве и компьютере.

Те же рекомендации действуют в мобильных и настольных браузерах.

Практический итог

Считайте языковые значения браузера одним из входов документированного порядка согласования: сначала сохранённый явный выбор, затем navigator.languages, потом navigator.language и в конце полная версия по умолчанию. Поддерживайте селектор, резерв и состояние задачи рабочими во всех поддерживаемых локалях и повторяйте проверку при изменении настроек приватности браузера или упаковки ресурсов. Указывайте поддерживаемые локали в документации продукта, чтобы отсутствующую фразу можно было диагностировать как границу, а не дефект.

Связь утверждений с источниками

BotBrowser позволяет задавать языки и локаль браузера, в том числе значения auto, определяемые по прокси, но не переводит приложение и не заменяет явный выбор языка; оставьте в приложении переключатель языка и резервный вариант.

Публичные источники

#Navigator.language#Локализация#Интернационализация#Доступность

Эта статья входит в руководство: Поверхности веб-платформы: карта проверки

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.