webshare

Share text, links, or files via the platform's native share sheet, using the Web Share API.

Import: @rtorcato/browser-common/webshare

📖 MDN: Navigator: share() method · 📊 caniuse: web-share

navigator.share needs a user gesture; wide support on mobile, but Firefox desktop never shipped it.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
Navigator.share	✅ 128+	✅ 93+	❌ flag only	✅ 12.1+	✅ 12.2+	Limited
Navigator.canShare	✅ 128+	✅ 93+	❌ flag only	✅ 14+	✅ 14+	Limited

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

Example

import {
  isWebShareAvailable,
  isFileShareAvailable,
  share,
} from '@rtorcato/browser-common/webshare'

if (isWebShareAvailable()) {
  await share({ title: 'Look', url: 'https://example.com' })
}

if (isFileShareAvailable()) {
  await share({ files: [myFile] })
}

Exports

• isWebShareAvailable() — feature check
• share(data) — shares { title, text, url, files } via navigator.share; throws if unsupported
• isFileShareAvailable() — checks whether navigator.canShare supports sharing files

See the API reference for full signatures.