Skip to content

Установка

Требования

ОкружениеМинимальная версия
Node.js18+
React17+ (опционально — нужен только для os-detect/react)
Vue3+ (опционально — нужен только для os-detect/vue)

Других runtime-зависимостей нет — базовая точка входа работает в любом браузере или Node.js-окружении без дополнительных установок, кроме самого пакета.

Установка

bash
npm install os-detect

React-хуки (опциональная peer-зависимость):

bash
npm install react@>=17

Vue composables (опциональная peer-зависимость):

bash
npm install vue@>=3

CDN

Готовая UMD-сборка доступна через unpkg и jsDelivr — сборка проекта не требуется.

html
<script src="https://unpkg.com/os-detect/dist/index.umd.js"></script>
<script>
  console.log(OsDetect.getOS())
  console.log(OsDetect.detectIsIOS())
  console.log(OsDetect.isMobileDevice())

  OsDetect.detectIsWindows11().then((isWin11) => {
    console.log('Windows 11:', isWin11)
  })
</script>

Глобальное имя — OsDetect. Все функции базовой точки входа доступны через него.

Быстрый старт

ts
import { getOS, detectIsIOS, detectIsWindows, isMobileDevice } from 'os-detect'

console.log(getOS()) // 'windows' | 'macos' | 'ios' | 'android' | 'linux' | 'chromeos' | 'unknown'
console.log(detectIsIOS()) // true на iPhone / iPad
console.log(detectIsWindows()) // true на Windows desktop
console.log(isMobileDevice()) // true на iOS или Android

Все функции синхронны и кэшируются — безопасно вызывать при каждом рендере или в любом реактивном контексте.