common

Small environment and user-agent checks used to detect whether code is running in a browser, on mobile, and what language/agent and OS platform the browser reports.

Import: @rtorcato/browser-common/common

📖 MDN: Navigator

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
Navigator.userAgent	✅ 1+	✅ 12+	✅ 1+	✅ 1+	✅ 1+	Widely available
Navigator.language	✅ 1+	✅ 12+	✅ 1+ [1]	✅ 1+	✅ 1+	Widely available

1. Firefox: Before Firefox 4, this property's value was also part of the user agent string, as reported by navigator.userAgent. Starting in Firefox 5, this property's value is based on the value of the Accept-Language HTTP header.

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: Navigator.userAgent · Navigator.language

Example

import {
  isBrowser,
  getUserAgent,
  isMobile,
  getBrowserLanguage,
  getPlatform,
  isIOS,
  isAndroid,
} from '@rtorcato/browser-common/common'

if (isBrowser) {
  console.log(getUserAgent(), isMobile(), getBrowserLanguage())
  console.log(getPlatform(), isIOS(), isAndroid())
}

Exports

• isBrowser — true if running in a browser environment
• getUserAgent() — the navigator.userAgent string, or undefined
• isMobile() — true if the user agent matches a mobile device
• getBrowserLanguage() — the navigator.language string, or undefined
• getPlatform() — the OS as a Platform ('ios' | 'android' | 'macos' | 'windows' | 'linux' | 'unknown'); prefers navigator.userAgentData, falls back to the user agent, and reports iPadOS as 'ios'
• isIOS() — true on iOS or iPadOS
• isAndroid() — true on Android

See the API reference for full signatures.