기능 위임

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

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

3. 기능 위임 시작

브라우징 문맥이 기능을 다른 브라우징 문맥에 위임하려는 경우, 해당 기능을 지정하는 delegate라는 추가 WindowPostMessageOptions와 함께 두 번째 브라우징 문맥에 메시지를 게시한다. 이 옵션의 값은 feature-identifier여야 한다. 이 옵션은 그 값이 사용자 에이전트가 지원하는 어떤 features에도 해당하지 않으면 무시되어야 한다.

3.1. HTML 명세에 대한 몽키 패치

WindowPostMessageOptions IDL 정의는 다음과 같은 추가 필드를 포함하게 된다:

DOMString? delegate;

window post message 알고리즘에서, 다음 단계:

6. Let transfer be options["transfer"].

뒤에는 다음 두 개의 추가 단계가 이어진다:

7. delegate를 options["delegate"]라고 하자.

8. delegate가 null이 아니면:

   1. 사용자 에이전트가 delegate가 나타내는 feature의 위임을 지원하지 않으면, "NotSupportedError" DOMException을 던진다.

   2. targetWindow의 associated Document가 delegate가 나타내는 feature를 allowed-to-use 할 수 없으면, "NotAllowedError" DOMException을 던진다.

   3. targetOrigin이 단일 U+002A ASTERISK 문자(*)이면, "NotAllowedError" DOMException을 던진다.

      targetOrigin의 기본값은 "/"이며, 메시지를 same-origin 대상으로 제한한다. "*"가 아닌 문자열을 사용해야 한다는 추가 요구사항은 cross-origin 메시지가 의도된 특정 오리진을 지정해야 함을 의미한다.

   4. source를 incumbentSettings의 전역 객체라고 하자.

   5. source가 일시적 활성화를 가지고 있지 않으면, "NotAllowedError" DOMException을 던진다.

   6. source에서 사용자 활성화를 소비한다.

4. 위임된 기능 추적

브라우징 문맥에 위임된 기능은 Window.DELEGATED_CAPABILITY_TIMESTAMPS라는 이름의 맵을 사용하여 추적된다. 어떤 기능이 Window에 위임될 때마다, 기능을 나타내는 feature-identifier와 같은 키와, 현재 DOMHighResTimeStamp와 같은 값을 가진 항목이 DELEGATED_CAPABILITY_TIMESTAMPS에 추가된다. 맵에 이미 같은 키에 대한 항목이 있으면, 기존 값은 현재 DOMHighResTimeStamp로 갱신된다.

4.1. HTML 명세에 대한 몽키 패치

window post message 알고리즘 바로 앞에, 다음과 같은 새 문단이 삽입된다:

브라우징 문맥에 위임된 기능을 추적하기 위해, 각 Window는 맵을 가지며, 이는 feature-identifier에서 DOMHighResTimeStamp로 가는 DELEGATED_CAPABILITY_TIMESTAMPS라고 불린다. 이 맵은 빈 맵으로 초기화된다.

window post message 알고리즘에서, 현재 Step 8에 두 개의 추가 하위 단계가 추가된다. 첫 번째 추가 하위 단계는 다음 하위 단계 뒤에 삽입된다:

8. Queue a global task ...

   2. Let origin be the serialization of incumbentSettings’s origin.

다음과 같다:

8. Queue a global task ... (변경 없음)

   3. delegate를 options["delegate"]라고 하자.

두 번째 추가 하위 단계는 다음 하위 단계 뒤에 삽입된다:

8. Queue a global task ...

   6. Let newPorts be a new frozen array consisting of ...

다음과 같다:

8. Queue a global task ... (변경 없음)

   7. Let newPorts be a new frozen array consisting of ... (번호 매김을 제외하고 변경 없음)

   8. delegate가 null이 아니고, 사용자 에이전트가 delegate 위임을 지원하면, DELEGATED_CAPABILITY_TIMESTAMPS[delegate]를 현재 고해상도 시간으로 설정한다.

5. 위임된 기능 동작 정의

위임된 동작을 정의하는 모든 기능은 해당 기능에 적절한 방식으로 Window.DELEGATED_CAPABILITY_TIMESTAMPS의 해당 항목을 사용한다. 아래는 하나의 특정 기능에 필요한 명세 변경이다.

5.1. Payment Request 명세에 대한 몽키 패치

show() 알고리즘에서, 위임된 동작을 구현하기 위해 다음 단계들이 대체된다:

두 단계:

2. If the relevant global object of request does not have transient activation:

   1. Return a promise rejected with a "SecurityError" DOMException.

3. Consume user activation of the relevant global object.

는 다음 세 단계로 대체된다:

2. request의 관련 전역 객체가 일시적 활성화를 가지고 있지 않고, 관련 전역 객체의 DELEGATED_CAPABILITY_TIMESTAMPS["payment"] 타임스탬프가 undefined이거나 만료된 경우:

   1. "SecurityError" DOMException으로 거부된 promise를 반환한다.

3. request의 관련 전역 객체가 일시적 활성화를 가지고 있지 않으면, 맵 항목 DELEGATED_CAPABILITY_TIMESTAMPS["payment"]를 지운다.

4. 그렇지 않으면, 관련 전역 객체의 사용자 활성화를 소비한다.

5.2. Fullscreen 명세에 대한 몽키 패치

requestFullscreen() 알고리즘에서, 위임된 동작을 구현하기 위해 다음 변경이 수행된다:

Step 5의 마지막 조건:

5. If any of the following conditions are false, then set error to true: ...

   • This’s relevant global object has transient activation or the algorithm is triggered by a user generated orientation change.

은 다음으로 대체된다:

5. If any of the following conditions are false, then set error to true: ... (변경 없음)

   • this의 관련 전역 객체가 일시적 활성화를 가지고 있거나, this의 관련 전역 객체에 있는 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"] 타임스탬프가 undefined가 아니며 만료되지 않았거나, 또는 알고리즘이 사용자 생성 orientation change에 의해 트리거된 경우.

Step 10 바로 앞:

10. Let fullscreenElements be an ordered set initially consisting of this.

에 다음 새 단계가 삽입된다:

10. this의 관련 전역 객체가 일시적 활성화를 가지고 있지 않으면, this의 관련 전역 객체에서 맵 항목 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"]를 지운다.

11. Let fullscreenElements be an ordered set initially consisting of this. (번호 매김을 제외하고 변경 없음)

5.3. [SCREEN-CAPTURE] 명세에 대한 몽키 패치

getDisplayMedia() 알고리즘에서, 위임된 동작을 구현하기 위해 다음 변경이 수행된다:

Step 3의 조건:

3. If the relevant global object of this does not have transient activation, return a promise rejected with a DOMException object whose name attribute has the value InvalidStateError.

은 다음으로 대체된다:

3. this의 관련 전역 객체가 일시적 활성화를 가지고 있지 않고, this의 관련 전역 객체에 있는 DELEGATED_CAPABILITY_TIMESTAMPS["display-capture"] 타임스탬프가 undefined이거나 만료된 경우, name 속성 값이 InvalidStateError인 DOMException 객체로 거부된 promise를 반환한다.