Web 分享 API

此 API 向 Navigator 接口添加以下内部槽位。

Promise? [[sharePromise]]

此 this.[[sharePromise]] 为一个 Promise，表示用户当前希望将某些数据分享至共享目标的意图。它初始为 null。

当调用 share() 且传入参数 data 时，按照下列步骤执行，同时考虑以下安全影响。

Web Share 使网站能够将数据发送到一个共享目标，该目标可以是本地应用。虽然此能力并非 Web Share 独有，但它带来多种潜在安全风险，风险程度取决于底层平台。

传递给 share() 的数据可能被用于利用共享目标中的缓冲区溢出或其他远程代码执行漏洞。没有通用方法可以防范此类问题，但实现者应意识到其可能性（尤其是在共享文件时）。

共享目标 若对共享的 URL 进行解析并转发，可能不经意间泄露本应保密的信息。如果共享的内容仅在该应用、运行所在主机或其网络位置可访问，则可能导致意外的信息泄漏。

恶意站点可能利用会泄露信息的共享目标，提供最终指向本地资源的 URL，包括但不限于 “file:” URL 或本应不可访问的本地服务。即使此 API 将共享的 URL 限制在一组可共享方案之内，使用重定向到其他 URL 或对这些 URL 所在主机的 DNS 记录进行篡改，也可能导致应用获取内容。

为避免被用于上述攻击，共享目标可以仅消费 URL、检索内容并在不共享的情况下处理信息。例如，照片编辑应用可能检索“共享”给它的图像。共享目标也可以只共享 URL 而不获取任何被引用的内容。

为了提供预览或进行内容共享而获取内容的共享目标存在信息泄漏风险。用户预览并授权的内容可能安全转发，但用户并不总能判断何时信息应当保密，因此转发任何内容都存在风险。特别是title 可能被攻击者用来欺骗用户误解内容的性质（另见5. 可访问性考虑）。

与任何使用DOMException 的代码一样，实现者需谨慎考虑在share() 被拒绝时错误信息中透露了哪些信息。即使仅区分“没有可用的共享目标”与“用户取消”，也可能泄露用户设备上已安装的共享目标信息。

1. 令 global 为 this 的相关全局对象。
2. 令 document 为 global 的关联的 Document。
3. 如果 document 不是完全激活，则返回一个被拒绝的 Promise，其原因为 InvalidStateError DOMException。
4. 如果 document 不被允许使用 "web-share"，则返回一个被拒绝的 Promise，其原因为 NotAllowedError DOMException。
5. 如果 this.[[sharePromise]] 不是 null，则返回一个被拒绝的 Promise，其原因为 InvalidStateError DOMException。
6. 如果 global 没有瞬时激活，则返回一个被拒绝的 Promise，其原因为 NotAllowedError DOMException。
7. 消费 global 的用户激活。
8. 令 base 为 this 的相关设置对象的API 基础 URL。
9. 如果使用 data 与 base 进行验证共享数据返回 false，则返回一个被拒绝的 Promise，其原因为 TypeError。
10. 如果 data 的url 成员存在
    1. 令 url 为对 data 的url 使用 base 进行URL 解析器后的结果。
    2. 断言：url 为 URL。
    3. 将 data 设为其自身的副本，并将其url 成员设为对 url 使用URL 序列化器后的结果。
11. 如果因安全考虑而阻止某种文件类型，返回一个被拒绝的 Promise，其原因为 “NotAllowedError” DOMException。
12. 将 this.[[sharePromise]] 设为一个新 Promise。
13. 返回 this.[[sharePromise]] 并并行执行。
    1. 如果没有可用的共享目标，则在用户交互任务源上使用 global 排入全局任务，以
       1. 拒绝 this.[[sharePromise]]，并使用 “AbortError” DOMException。
       2. 将 this.[[sharePromise]] 设为 null。
       3. 终止此算法。
    2. 向用户展示一个选择界面，列出一个或多个共享目标以及中止操作的选项。此 UI 界面充当安全确认，确保网站无法静默将数据发送至本地应用。用户代理 应当 显示中间 UI，以便用户核实共享内容（如果操作系统层面的 UI 未提供此功能）。
    3. 等待用户的选择。
    4. 如果用户选择中止共享操作，则在用户交互任务源上使用 global 排入全局任务，以
       1. 拒绝 this.[[sharePromise]]，并使用 “AbortError” DOMException，
       2. 将 this.[[sharePromise]] 设为 null。
       3. 终止此算法。
    5. 激活已选中的共享目标，将 data 转换为适合目标摄取的格式，并将转换后的数据传输给目标。
    6. 如果启动目标或传输数据时出现错误，则在用户交互任务源上使用 global 排入全局任务，以
       1. 拒绝 this.[[sharePromise]]，并使用 “DataError” DOMException。
       2. 将 this.[[sharePromise]] 设为 null。
       3. 终止此算法。
    7. 一旦数据已成功传输至共享目标，或已成功传输至操作系统（若无法确认已传输至共享目标），则在用户交互任务源上使用 global 排入全局任务，以
       注
       1. 解析 this.[[sharePromise]] 为 undefined。
       2. 将 this.[[sharePromise]] 设为 null。

当 canShare() 方法以 ShareData data 为参数被调用时，执行以下步骤

1. 令 document 为 this 的相关全局对象的关联的 Document。
2. 如果 document 不是完全激活，返回 false。
3. 如果 document 不被允许使用 "web-share"，返回 false。
4. 返回使用 data 与 this 的相关设置对象的API 基础 URL进行验证共享数据的结果。

一个可共享方案指以下任意URL 方案

• http
• https
• 用户代理支持用于共享的任何安全列入方案。

使用 data 与 base 验证共享数据，执行以下步骤

1. 如果 data 的成员 title、text、url 或 files 均不存在，返回 false。
2. 令 titleTextOrUrl 为 true，若 title、text 或 url 任一存在。
3. 如果 data 的files 成员存在
   1. 如果 titleTextOrUrl 为 false 且 data 的files 成员为空，返回 false。
      注

      这会导致 { files: [] } 字典被视作空字典。然而，传入如 {text: "text", files: []} 的字典是可以的，因为 files 将被忽略。

   2. 如果实现不支持文件共享，返回 false。
   3. 如果用户代理判断共享 files 中的任意文件可能导致敌对共享（例如因内容、大小或其他特性判定文件为恶意），返回 false。
4. 如果 data 的url 成员存在
   1. 令 url 为对 data 的url 成员使用 base（且不覆写编码）进行URL 解析器后的结果。
   2. 如果 url 为失败，返回 false。
   3. 如果 url 的方案是本地方案，或 file、javascript、ws、wss，返回 false。
   4. 如果 url 的方案不是可共享方案，返回 false。
5. 返回 true。