ケイパビリティ委譲

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

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

3. ケイパビリティ委譲の開始

ブラウジングコンテキストが別の ブラウジング コンテキストへケイパビリティを委譲したい場合、そのケイパビリティを指定する delegate と呼ばれる追加の WindowPostMessageOptions を付けて、2 番目の ブラウジングコンテキストにメッセージを投稿します。この オプションの値は feature-identifier でなければなりません。 その値が、ユーザー エージェントがサポートする機能のいずれにも対応しない場合、このオプションは無視されなければなりません。

3.1. HTML 仕様へのモンキーパッチ

WindowPostMessageOptions IDL 定義は、次のように追加フィールドを含みます:

DOMString? delegate;

window post message のアルゴリズムにおいて、 次の手順:

6. transfer を options["transfer"] とします。

の後に、次の 2 つの追加手順が続きます:

7. delegate を options["delegate"] とします。

8. delegate が null でない場合:

   1. ユーザーエージェントが delegate により示される機能の委譲をサポートしない場合、 "NotSupportedError" DOMException を投げます。

   2. targetWindow の 関連付けられた Document が、delegate により示される機能を allowed-to-use でない場合、 "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 に 2 つの追加サブ手順が追加されます。最初の追加 サブ手順は、次のサブ手順の後に挿入されます:

8. グローバルタスクをキューに追加する ...

   2. origin を incumbentSettings の origin の直列化とします。

次のようになります:

8. グローバルタスクをキューに追加する ... （変更なし）

   3. delegate を options["delegate"] とします。

2 番目の追加サブ手順は、次のサブ手順の後に挿入されます:

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 つの手順:

2. request の関連するグローバルオブジェクトが一時的アクティベーションを持たない場合:

   1. "SecurityError" DOMException で拒否された promise を返します。

3. 関連するグローバルオブジェクトのユーザーアクティベーションを消費します。

は、次の 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"] のタイムスタンプが未定義でなく、かつ 期限切れ でもない、または アルゴリズムがユーザー生成の向き変更によりトリガーされている。

手順 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"] のタイムスタンプが未定義または 期限切れのいずれかである場合、 name 属性の値が InvalidStateError である DOMException オブジェクトで 拒否された promise を返します。