概述
Navigator.share()
方法通过调用本机的共享机制作为 Web Share API 的一部分。如果不支持 Web Share API,则此方法为 undefined
。
此项功能仅在一些支持的浏览器的安全上下文(HTTPS)中可用。
语法
const sharePromise = window.navigator.share(data);
参数
- data包含要共享的数据的对象。必须至少指定以下字段之一。可用选项包括:
url
: 要共享的 URL(USVString
)text
: 要共享的文本(USVString
)title
: 要共享的标题(USVString
)files
: 要共享的文件(“FrozenArray”)
返回值
该方法将会返回一个Promise
。一旦用户完成分享,这个 promise 将会接受。如果指定的共享数据格式不正确,promise 将会立即拒绝;如果用户取消了分享,promise 也会拒绝。
分享文本
navigator.share({ title: "Share Text", text: "正在分享的文本..." })
分享链接
navigator.share({ title: "Share Url", url: "https://www.baidu.com" })
分享文件
navigator.share({ title: "Share File", files: <FileList> })
分享文件前需要使用
navigator.canShare
方法判断下文件是否能分享