Navigator.share - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Navigator.share()方法通过调用本机的共享机制作为Web Share API的一部分。如果不支持Web Share API，则此方法为undefined。

语法

const sharePromise = window.navigator.share(data);

参数

data

包含要共享的数据的对象。必须至少指定以下字段之一。可用选项包括：

• url: 要共享的URL（ USVString ）
• text: 要共享的文本（ USVString ）
• title: 要共享的标题（ USVString）
• files: 要共享的文件（“FrozenArray”）

返回值

该方法将会返回一个Promise。一旦用户完成分享，这个promise将会接受 。如果指定的共享数据格式不正确，promise将会立即拒绝；如果用户取消了分享，promise也会拒绝。

例如, 在Android的Chrome上, 将在用户选择要共享的应用程序后将会解析共享的内容。.

示例

navigator.share({
  title: document.title,
  text: 'Hello World',
  url: 'https://developer.mozilla.org',
}); // 分享MDN的URL

分享文件

分享文件之前，先使用navigator.canShare().判断这个文件能否被分享，Then include an array of files in the call to navigator.share():

Notice: That the sample handles feature detection by testing for navigator.canShare() rather than for navigator.share(). The data object passed to canShare() only supports the files property. Image, video, audio, and text files can be shared.

if (navigator.canShare && navigator.canShare({ files: filesArray })) {
  navigator.share({
    files: filesArray,
    title: 'Pictures',
    text: 'Our Pictures.',
  })
  .then(() => console.log('Share was successful.'))
  .catch((error) => console.log('Sharing failed', error));
} else {
  console.log(`Your system doesn't support sharing files.`);
}

规范

Specification	Status	Comment
Web Share API share()	Draft

浏览器兼容性

BCD tables only load in the browser

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

参见

• navigator.canShare()