Skip to main content

htmlmedia

Playback controls and event helpers for <audio>/<video> elements via HTMLMediaElement.

Import: @rtorcato/browser-common/htmlmedia

📖 MDN: HTMLMediaElement

Browser support​

APIChromeEdgeFirefoxSafariiOS SafariBaseline
HTMLMediaElement.play✅ 3+✅ 12+✅ 3.5+✅ 3.1+✅ 3+Widely available
HTMLMediaElement.pause✅ 3+✅ 12+✅ 3.5+✅ 3.1+✅ 3+Widely available

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

Example​

import { playMedia, setVolume, onMediaEvent } from '@rtorcato/browser-common/htmlmedia'

setVolume(audio, 0.5)
await playMedia(audio)

const off = onMediaEvent(audio, 'ended', () => console.log('done'))
off()

Exports​

  • playMedia(media) — plays the media element, returns the play Promise
  • pauseMedia(media) — pauses the media element
  • setCurrentTime(media, time) — sets playback position in seconds
  • setVolume(media, volume) — sets volume, clamped to 0.0–1.0
  • setMuted(media, muted) — mutes or unmutes
  • loadMediaSource(media, src, autoplay?) — sets src, calls load(), optionally plays
  • onMediaEvent(media, event, handler) — adds an event listener; returns a cleanup function

See the API reference for full signatures.