UD5工具箱
Web Share API 基础概念
Web Share API：由W3C标准化的Web平台API，允许Web应用调用操作系统原生的分享功能。该API于2022年进入W3C工作草案阶段，目前已在主流浏览器中获得广泛支持。Web Share API的核心价值在于将Web应用的分享能力提升到与原生应用同等的水平，用户无需离开浏览器即可完成内容分享。
navigator.share()方法：Web Share API的核心方法，用于触发分享操作。该方法接受一个可选的ShareData对象作为参数，包含title、text、url和files四个属性。调用该方法后，浏览器会唤起设备的原生分享面板。该方法返回一个Promise，成功时resolves为undefined，失败时rejects相应的错误。
ShareData 对象与参数
ShareData接口：定义了分享数据的结构，包含四个可选属性。title属性设置分享标题，在分享面板中显示为主要内容标题。text属性设置分享正文，可以包含更详细的文字描述。url属性设置分享链接，必须是有效的URL格式。files属性接受File对象数组，用于分享本地文件，这是Web Share API Level 2引入的功能。
title属性：字符串类型，表示分享内容的标题。在移动设备上，标题通常显示在分享面板的最顶部位置。虽然该属性为可选，但建议在大多数场景下提供标题，因为部分分享目标可能需要标题信息来正确显示分享内容。
text属性：字符串类型，表示分享的正文内容。与标题不同，文本属性适合承载更长的描述性内容。在某些分享场景下，文本内容会成为分享消息的主体部分。如果同时提供了title和text，分享面板通常会同时展示两者。
url属性：字符串类型，表示分享的URL地址。该属性应包含有效的HTTP或HTTPS链接。在链接分享场景中，url是最核心的参数，分享面板会将该链接传递给目标应用。许多分享目标应用会自动解析URL并生成预览卡片。
files属性：File对象数组类型，表示要分享的本地文件。这是Web Share API Level 2引入的文件分享功能。该功能允许Web应用分享图片、PDF、文本文件等多种格式的文件。文件分享的兼容性相对较低，仅在部分浏览器和平台上支持。
API版本与兼容性概念
Web Share API Level 1：初始版本，仅支持分享标题、文本和URL等文本类型的数据。Level 1在Chrome 61、Firefox 63、Safari 12.2等浏览器中获得支持，覆盖了绝大多数现代浏览器环境。
Web Share API Level 2：扩展版本，在Level 1的基础上增加了文件分享能力。Level 2的兼容性相对有限，目前主要在Chrome 76以上和部分Chromium内核浏览器中支持。Safari和Firefox尚未完全实现文件分享功能。
canShare()方法：用于检测浏览器是否支持特定的分享数据格式。该方法接受ShareData对象作为参数，返回布尔值表示给定的数据是否可以被分享。在文件分享场景中，canShare()特别有用，可以提前判断文件类型和大小是否被支持。
安全与权限相关概念
用户手势要求：Web Share API要求分享操作必须由用户手势（如点击、触摸等）直接触发。这是浏览器安全策略的重要组成部分，防止网页在用户不知情的情况下自动弹出分享面板。如果尝试在非用户手势事件中调用navigator.share()，浏览器会抛出DOMException。
HTTPS要求：Web Share API仅在安全上下文（HTTPS）中可用。这是因为分享操作涉及用户数据的传递，浏览器要求使用加密连接来保护数据传输安全。在HTTP页面或本地文件（file://协议）中，该API不可用。
跨域限制：Web Share API不涉及跨域数据传输问题，因为分享操作的执行和数据处理均在浏览器本地完成。分享面板由操作系统管理，Web应用仅传递数据，不参与后续的分享流程。