NavigatorUAData

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает во всех распространённых браузерах.

Экспериментально: Это экспериментальная технология.
Перед использованием в рабочей среде внимательно ознакомьтесь со таблицей совместимости браузеров.

Примечание: Эта функция доступна в Web Workers.

Интерфейс NavigatorUAData API User-Agent Client Hints возвращает информацию о браузере и операционной системе пользователя.

Экземпляр этого объекта возвращается при вызове Navigator.userAgentData или WorkerNavigator.userAgentData. Поэтому у этого интерфейса нет конструктора.

Примечание: Термины высокая энтропия и низкая энтропия относятся к количеству информации, которую эти значения раскрывают о браузере. Возвращаемые свойства считаются с низкой энтропией и маловероятны для идентификации пользователя. Значения, возвращаемые NavigatorUAData.getHighEntropyValues(), могут потенциально раскрыть больше информации. Поэтому эти значения извлекаются с помощью Promise, позволяя браузеру запросить разрешение пользователя или выполнить другие проверки.

Свойства экземпляра

NavigatorUAData.brands Только для чтения Экспериментально: Возвращает массив информации о брендах, содержащий имя и версию браузера.
NavigatorUAData.mobile Только для чтения Экспериментально: Возвращает true , если пользовательский агент работает на мобильном устройстве.
NavigatorUAData.platform Только для чтения Экспериментально: Возвращает марку платформы, на которой работает пользовательский агент.

Методы экземпляра

NavigatorUAData.getHighEntropyValues() Экспериментально: Возвращает Promise, который разрешается объектом словаря, содержащим значения высокой энтропии, возвращаемые пользовательским агентом.
NavigatorUAData.toJSON() Экспериментально: Сериализатор, который возвращает JSON-представление свойств низкой энтропии объекта NavigatorUAData.

Примеры

Получение бренда

В следующем примере значение NavigatorUAData.brands выводится в консоль.

console.log(navigator.userAgentData.brands);

Возвращение значений высокой энтропии

В следующем примере запрашивается ряд подсказок с помощью метода NavigatorUAData.getHighEntropyValues(). После разрешения промиса эта информация выводится в консоль.

navigator.userAgentData
  .getHighEntropyValues([
    "architecture",
    "model",
    "platform",
    "platformVersion",
    "fullVersionList",
  ])
  .then((ua) => {
    console.log(ua);
  });

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

Спецификация
User-Agent Client Hints # navigatoruadata

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

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`NavigatorUAData`	90	90	Нет	76	Нет	90	Нет	64	Нет	Нет	Нет
`brands`	90	90	Нет	76	Нет	90	Нет	64	Нет	Нет	Нет
`getHighEntropyValues`	90	90	Нет	76	Нет	90	Нет	64	Нет	Нет	Нет
`mobile`	90	90	Нет	76	Нет	90	Нет	64	Нет	Нет	Нет
`platform`	93	93	Нет	79	Нет	93	Нет	66	Нет	Нет	Нет
`toJSON`	93	93	Нет	79	Нет	93	Нет	66	Нет	Нет	Нет

См. также

Улучшение конфиденциальности пользователей и опыта разработчиков с помощью User-Agent Client Hints

© 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/NavigatorUAData