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.

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.