Navigator: свойство language

Baseline Widely available

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

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/ru/web/api/html_dom_api/index.md)

Доступное только для чтения свойство Navigator.language возвращает строку, представляющую предпочитаемый пользователем язык, как правило это язык пользовательского интерфейса браузера.

Значение

Строка представляющая версию языка которая определена в стандарте RFC 5646: Теги для идентификации языков (также известном как BCP 47). Примеры валидных языковых кодов: en, en-US, fr, fr-FR, es-ES и т.д.

В Safari на iOS до версии 10.2 код страны возвращался в нижнем регистре: en-us, fr-fr и т.д.

Примеры

Использование конструкторов Intl для форматирования, зависящего от языка

Конструкторы Intl позволяют форматировать содержимое в соответствии с правилами выбранной локали. Вы можете передать им navigator.language, чтобы отформатировать содержимое в правилах локали, соответствующей языку пользователя:

js
const date = new Date("2012-05-24");

const formattedDate = new Intl.DateTimeFormat(navigator.language).format(date);

Спецификации

Specification
HTML Standard
# dom-navigator-language-dev

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также