motion

Listen for device motion (acceleration) events via the DeviceMotionEvent and Generic Sensor APIs.

Import: @rtorcato/browser-common/motion

📖 MDN: DeviceMotionEvent · 📊 caniuse: deviceorientation

iOS 13+ Safari requires an explicit user-gesture permission grant (requestMotionPermission).

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
DeviceMotionEvent	✅ 31+	✅ 12+	✅ 6+	✅ 17+	✅ 4.2+	Widely available
DeviceMotionEvent.requestPermission	✅ 152+	✅ 152+	❌	❌	✅ 14.5+	Limited

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

Example

import { isDeviceMotionAvailable, onDeviceMotion, requestMotionPermission } from '@rtorcato/browser-common/motion'

button.addEventListener('click', async () => {
  if ((await requestMotionPermission()) === 'granted' && isDeviceMotionAvailable()) {
    const off = onDeviceMotion((e) => console.log(e.acceleration))
  }
})

Exports

• isDeviceMotionAvailable() — feature check for DeviceMotionEvent
• onDeviceMotion(callback) — subscribes to motion events, returns an unsubscribe function
• isGenericSensorApiAvailable() — feature check for the Generic Sensor API
• requestMotionPermission() — requests iOS 13+ motion permission, resolves 'granted' | 'denied' | 'default'

See the API reference for full signatures.