screencapture

Prompt the user to share a screen, window, or tab via the Screen Capture API.

Import: @rtorcato/browser-common/screencapture

📖 MDN: Screen Capture API

getDisplayMedia needs a secure context and throws where unsupported — guard with isScreenCaptureAvailable() first.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
MediaDevices.getDisplayMedia	✅ 72+	✅ 79+	✅ 66+	✅ 13+	❌	Limited

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

Example

import { isScreenCaptureAvailable, getDisplayMedia } from '@rtorcato/browser-common/screencapture'

if (isScreenCaptureAvailable()) {
  const stream = await getDisplayMedia({ video: true })
}

Exports

• isScreenCaptureAvailable() — feature check
• getDisplayMedia(options?) — prompts the user and resolves to a MediaStream

See the API reference for full signatures.