Navigator: свойство userAgent

Базовый уровень Широко доступен

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Свойство Navigator.userAgent чтения только для чтения возвращает строку user agent текущего браузера.

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

Также следует помнить, что пользователи браузера могут изменить значение этого поля по своему желанию (spoofing UA).

Идентификация браузера на основе распознавания строки user agent ненадежна и не рекомендуется, так как строка user agent может быть настроена пользователем. Например:

В Firefox вы можете изменить предпочтение general.useragent.override в about:config. Некоторые расширения Firefox делают это; однако это меняет только заголовок HTTP, который отправляется и возвращается navigator.userAgent. Могут быть и другие методы, которые используют код JavaScript для идентификации браузера.
Opera 6+ позволяет пользователям задавать строку идентификации браузера через меню.

Значение

Строка, определяющая полную строку user agent, предоставляемую браузером как в заголовках HTTP, так и в ответ на это и другие связанные методы объекта Navigator.

Строка user agent построена на формальной структуре, которую можно разбить на несколько фрагментов информации. Каждый из этих фрагментов информации поступает из других свойств объекта Navigator, которые также могут настраиваться пользователем. Для получения дополнительной информации о формате строки user agent см. заголовок HTTP User-agent.

Примеры

alert(window.navigator.userAgent);
// alerts "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:124.0) Gecko/20100101 Firefox/124.0"

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

Спецификация
HTML # dom-navigator-useragent-dev

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

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`userAgent`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4

См. также

User-Agent заголовок HTTP

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgent