大网数据广告活动
Web 标准与前端开发

Navigator:canShare() 方法

· 52CE 我爱测

Navigator 接口的 **`canShare()`** 方法在对 navigator.share() 的等效调用能够成功时返回 `true`。

Web Share API

Navigator 接口的 canShare() 方法在对 navigator.share() 的等效调用能够成功时返回 true。

如果数据无法通过验证,该方法将返回 false。数据可能无效的原因包括:

  • data 参数已被省略或仅包含具有未知值的属性。请注意,用户代理无法识别的任何属性都会被忽略。
  • URL 格式错误。
  • 指定了要分享的文件但用户代理实现不支持文件共享。
  • 共享了将被用户代理视为“恶意共享”的指定数据。

Web 共享 API 受 web-share 权限策略限制。如果支持该权限但尚未授予,则 canShare() 方法将返回 false。

语法

canShare()
canShare(data)

参数

  • data
    • : 定义要测试的共享数据的对象。

      通常,如果此调用返回 true,则具有相同属性的对象将传递给 navigator.share()。用户代理未知的属性将被忽略;共享数据仅根据用户代理理解的属性进行评估。所有属性都是可选的,但必须至少指定一个已知的数据属性,否则该方法将返回 false。

      可能的值为:

      • url
        • : 表示要共享的 URL 的字符串。
      • text
        • : 表示要共享的文本的字符串。
      • title
        • : 表示要共享的标题的字符串。
      • files
        • : 表示要共享的文件的 File 对象数组。

返回值

如果指定的 data 参数可以等效成功调用 Navigator.share() 方法,则返回 true,否则返回 false。

示例

发送 MDN URL

该示例使用 navigator.canShare() 来检查 navigator.share() 是否可以共享指定的数据。

HTML

HTML 部分只是创建一个段落来显示测试结果。

<p class="result"></p>

JavaScript

let shareData = {
  title: "MDN",
  text: "在 MDN 上学习 Web 开发!",
  url: "https://developer.mozilla.org",
};

const resultPara = document.querySelector(".result");

if (!navigator.canShare) {
  resultPara.textContent = "不支持 navigator.canShare()。";
} else if (navigator.canShare(shareData)) {
  resultPara.textContent =
    "支持 navigator.canShare()。我们可以使用 navigator.share() 来发送数据。";
} else {
  resultPara.textContent = "指定的数据无法共享。";
}

结果

下面的框应说明该浏览器是否支持 navigator.canShare(),如果支持,我们是否可以使用 navigator.share() 来共享指定的数据:

发送 MDN URL

特性检测示例

此方法功能测试特定数据属性是否有效且可共享。如果与单个 data 属性一起使用,则仅当该属性有效并且可以在平台上共享时才会返回 true。

下面的代码演示了验证数据属性是否受支持。

// 可能不支持的功能
let testShare = { someNewProperty: "要共享的数据" };

// 使用新数据属性的复杂数据
const shareData = {
  title: "MDN",
  text: "在 MDN 上学习 Web 开发!",
  url: "https://developer.mozilla.org",
  someNewProperty: "数据共享",
};

// 共享之前测试新数据属性是否有效且受支持
if (navigator.canShare(testShare)) {
  // 使用 navigator.share() 共享“shareData”
} else {
  // 处理新数据属性无法共享的情况。
}

规范

浏览器兼容性

参见

  • navigator.share()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。