能力委托

window.onclick = () => {
  targetWindow.postMessage('a_message', {delegate: "payment"});
};

window.onmessage = () => {
  const payRequest = new PaymentRequest(...);
  const payResponse = await payRequest.show();
  ...
}

3. 发起能力委托

当某个浏览上下文想要将某项能力委托给另一个浏览 上下文时，它会向第二个浏览上下文发布消息，并带有一个名为 delegate 的额外 WindowPostMessageOptions 来指定该能力。此选项的值必须是一个feature-identifier。 如果该值不对应任何用户代理支持的 特性，则必须 忽略该选项。

3.1. 对 HTML 规范的猴子补丁

WindowPostMessageOptions IDL 定义将包含一个额外字段，如下所示：

DOMString? delegate;

在window post message 的算法中， 以下步骤：

6. 令 transfer 为 options["transfer"]。

后面将跟随如下两个额外步骤：

7. 令 delegate 为 options["delegate"]。

8. 如果 delegate 不为 null，则：

   1. 如果用户代理不支持委托由 delegate 指示的特性， 则抛出一个 "NotSupportedError" DOMException。

   2. 如果 targetWindow 的关联 Document 不被allowed-to-use 由 delegate 指示的特性，则抛出一个 "NotAllowedError" DOMException。

   3. 如果 targetOrigin 是单个 U+002A ASTERISK 字符 (*)，则抛出一个 "NotAllowedError" DOMException。

      targetOrigin 的默认值为 "/"，它将消息限制为同源目标。使用 "*" 之外字符串的额外要求意味着 跨源消息必须指定其所针对的具体源。

   4. 令 source 为 incumbentSettings 的全局对象。

   5. 如果 source 不具有瞬态 激活， 则抛出一个 "NotAllowedError" DOMException。

   6. 在 source 中消耗 用户 激活。

4. 跟踪被委托的能力

委托给某个浏览上下文的能力将使用一个名为 Window.DELEGATED_CAPABILITY_TIMESTAMPS 的映射来跟踪。每次将能力 委托给某个 Window 时， 都会在 DELEGATED_CAPABILITY_TIMESTAMPS 中添加一个条目，其键等于 表示该 能力的 feature-identifier， 值等于当前 DOMHighResTimeStamp。 如果该映射 已经有相同键的条目，则现有值将更新为 当前 DOMHighResTimeStamp。

4.1. 对 HTML 规范的猴子补丁

在window post message 的算法之前， 将插入一个新段落，如下所示：

为了跟踪委托给某个浏览上下文的能力， 每个 Window 都有一个从 feature-identifier 到 DOMHighResTimeStamp 的映射，名为 DELEGATED_CAPABILITY_TIMESTAMPS。 该映射初始化为空映射。

在window post message 的算法中， 将向当前步骤 8 添加两个额外子步骤。第一个额外 子步骤将插入在以下子步骤之后：

8. 排入一个全局任务 ...

   2. 令 origin 为 incumbentSettings 的 origin 的序列化。

如下所示：

8. 排入一个全局任务 ... （不变）

   3. 令 delegate 为 options["delegate"]。

第二个额外子步骤将插入在以下子步骤之后：

8. 排入一个全局任务 ...

   6. 令 newPorts 为一个由 ... 组成的新冻结数组

如下所示：

8. 排入一个全局任务 ... （不变）

   7. 令 newPorts 为一个由 ... 组成的新冻结数组 （除 编号外不变）

   8. 如果 delegate 不为 null，且用户代理支持 委托 delegate，则将 DELEGATED_CAPABILITY_TIMESTAMPS[delegate] 设置为当前 高分辨率 时间。

5. 定义被委托能力的行为

任何定义了被委托行为的能力，都会以适合该 能力的方式使用 Window.DELEGATED_CAPABILITY_TIMESTAMPS 中的相应条目。 下面是某个特定能力所需的规范变更。

5.1. 对 Payment Request 规范的猴子补丁

在 show() 的算法中， 以下步骤将被 替换，以实现被委托行为：

这两个步骤：

2. 如果 request 的相关全局对象不具有瞬态激活：

   1. 返回一个以 "SecurityError" DOMException 拒绝的 promise。

3. 消耗相关全局对象的用户激活。

将由以下三个步骤替换：

2. 如果 request 的相关全局对象不具有瞬态 激活， 且相关全局对象中的时间戳 DELEGATED_CAPABILITY_TIMESTAMPS["payment"] 要么未定义，要么已过期：

   1. 返回一个以 "SecurityError" DOMException 拒绝的 promise。

3. 如果 request 的相关全局对象不具有瞬态激活， 则清除映射条目 DELEGATED_CAPABILITY_TIMESTAMPS["payment"]。

4. 否则，消耗 相关全局对象的用户 激活。

5.2. 对 Fullscreen 规范的猴子补丁

在 requestFullscreen() 的算法中， 将进行以下变更， 以实现被委托行为：

步骤 5 中的最后一个条件：

5. 如果以下任一条件为 false，则将 error 设置为 true：...

   • this 的相关全局对象具有瞬态激活，或者 该算法由用户生成的方向变化触发。

将被替换为：

5. 如果以下任一条件为 false，则将 error 设置为 true：... （不变）

   • this 的相关全局对象具有瞬态激活，或者 this 的相关全局对象中的时间戳 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"] 既不是 undefined，也没有过期， 或者 该算法由用户生成的方向变化触发。

在步骤 10 之前：

10. 令 fullscreenElements 为一个有序集，初始仅包含 this。

将插入以下新步骤：

10. 如果 this 的相关全局对象不具有瞬态激活，则清除 this 的相关全局对象中的映射条目 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"]。

11. 令 fullscreenElements 为一个有序集，初始仅包含 this。（除 编号外不变）

5.3. 对 [SCREEN-CAPTURE] 规范的猴子补丁

在 getDisplayMedia() 的算法中， 将进行以下变更， 以实现被委托行为：

步骤 3 中的条件：

3. 如果 this 的相关全局对象不具有瞬态激活，则返回一个以 name 属性值为 InvalidStateError 的 DOMException 对象拒绝的 promise。

将被替换为：

3. 如果 this 的相关全局对象不具有瞬态激活，且 this 的相关全局对象中的时间戳 DELEGATED_CAPABILITY_TIMESTAMPS["display-capture"] 要么未定义，要么已过期， 则返回一个以 拒绝的 promise，其拒绝原因是一个 DOMException 对象，且其 name 属性的值为 InvalidStateError。