기능 위임

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

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

3. 기능 위임 시작

한 탐색 컨텍스트가 다른 탐색 컨텍스트에 기능을 위임하려면 두 번째 탐색 컨텍스트에 메시지를 보내면서 기능을 지정하는 추가 WindowPostMessageOptions인 delegate를 붙입니다. 이 옵션의 값은 반드시 기능 식별자여야 합니다. 값이 사용자 에이전트가 지원하는 기능 중 어느 것에도 해당하지 않으면 반드시 이 옵션을 무시해야 합니다.

3.1. HTML 명세에 대한 임시 수정

WindowPostMessageOptions의 IDL 정의에 다음 필드를 추가합니다:

DOMString? delegate;

창 메시지 전송 알고리즘에서 다음 단계:

6. transfer를 options["transfer"]로 둡니다.

뒤에 다음 두 단계를 추가합니다:

7. delegate를 options["delegate"]로 둡니다.

8. delegate가 null이 아니면:

   1. 사용자 에이전트가 delegate로 표시된 기능의 위임을 지원하지 않으면 "NotSupportedError" DOMException을 던집니다.

   2. targetWindow의 연결된 Document에 사용이 허용되지 않은 기능을 delegate가 가리키면 "NotAllowedError" DOMException을 던집니다.

   3. targetOrigin가 단일 U+002A 별표 문자(*)이면 "NotAllowedError" DOMException을 던집니다.

      옵션 targetOrigin의 기본값은 "/"이며 메시지를 동일 출처 대상으로 제한합니다. "*" 이외의 문자열을 사용해야 한다는 추가 요건은 교차 출처 메시지에서 의도한 수신 대상의 구체적인 출처를 지정해야 함을 뜻합니다.

   4. source를 incumbentSettings의 전역 객체로 둡니다.

   5. source에 일시적 활성화가 없으면 "NotAllowedError" DOMException을 던집니다.

   6. 사용자 활성화를 소비합니다. 대상은 source입니다.

4. 위임된 기능 추적

탐색 컨텍스트에 위임된 기능은 Window.DELEGATED_CAPABILITY_TIMESTAMPS라는 맵으로 추적합니다. 기능이 Window에 위임될 때마다 DELEGATED_CAPABILITY_TIMESTAMPS에 항목을 추가합니다. 키는 그 기능을 나타내는 기능 식별자이고 값은 현재 DOMHighResTimeStamp입니다. 맵에 같은 키의 항목이 이미 있으면 기존 값을 현재 DOMHighResTimeStamp로 갱신합니다.

4.1. HTML 명세에 대한 임시 수정

창 메시지 전송 알고리즘 바로 앞에 다음 문단을 삽입합니다:

탐색 컨텍스트에 위임된 기능을 추적하기 위해 각 Window에는 맵이 있습니다. 이름은 DELEGATED_CAPABILITY_TIMESTAMPS이며 기능 식별자를 DOMHighResTimeStamp에 대응시킵니다. 이 맵은 빈 맵으로 초기화됩니다.

창 메시지 전송 알고리즘의 현재 8단계에 두 하위 단계를 추가합니다. 첫 번째 추가 하위 단계는 다음 하위 단계 뒤에 삽입합니다:

8. 전역 작업을 큐에 넣습니다...

   2. origin을 incumbentSettings의 출처를 직렬화한 결과로 둡니다.

다음과 같습니다:

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. 결제 요청 명세에 대한 임시 수정

show() 알고리즘에서 위임 동작을 구현하도록 다음 단계들을 교체합니다:

다음 두 단계:

2. request의 관련 전역 객체에 일시적 활성화가 없으면:

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

3. 관련 전역 객체의 사용자 활성화를 소비합니다.

를 다음 세 단계로 교체합니다:

2. request의 관련 전역 객체에 일시적 활성화가 없고 그 관련 전역 객체의 타임스탬프 DELEGATED_CAPABILITY_TIMESTAMPS["payment"]가 undefined이거나 만료되었으면:

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

3. request의 관련 전역 객체에 일시적 활성화가 없으면 맵 항목 DELEGATED_CAPABILITY_TIMESTAMPS["payment"]를 지웁니다.

4. 그렇지 않으면 사용자 활성화를 소비합니다. 대상은 관련 전역 객체입니다.

5.2. 전체 화면 명세에 대한 임시 수정

requestFullscreen() 알고리즘에서 위임 동작을 구현하도록 다음과 같이 변경합니다:

5단계의 마지막 조건:

5. 다음 조건 중 하나라도 false이면 error를 true로 설정합니다: ...

   • this의 관련 전역 객체에 일시적 활성화가 있거나 사용자가 일으킨 방향 변경으로 알고리즘이 실행됩니다.

를 다음으로 교체합니다:

5. 다음 조건 중 하나라도 false이면 error를 true로 설정합니다: ... (변경 없음)

   • this의 관련 전역 객체에 일시적 활성화가 있거나, 해당 객체의 타임스탬프 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"]가 undefined가 아니고 만료되지 않았거나, 사용자가 일으킨 방향 변경으로 알고리즘이 실행됩니다.

다음 10단계 바로 앞에:

10. fullscreenElements를 처음에는 this만 포함하는 순서 있는 집합으로 둡니다.

다음 새 단계를 삽입합니다:

10. this의 관련 전역 객체에 일시적 활성화가 없으면 해당 객체의 맵 항목 DELEGATED_CAPABILITY_TIMESTAMPS["fullscreen"]를 지웁니다.

11. fullscreenElements를 처음에는 this만 포함하는 순서 있는 집합으로 둡니다. (번호 외에는 변경 없음)

5.3. 임시 수정: [SCREEN-CAPTURE] 명세

getDisplayMedia() 알고리즘에서 위임 동작을 구현하도록 다음과 같이 변경합니다:

3단계의 조건:

3. this의 관련 전역 객체에 일시적 활성화가 없으면 name 속성값이 InvalidStateError인 DOMException 객체로 거부된 promise를 반환합니다.

를 다음으로 교체합니다:

3. this의 관련 전역 객체에 일시적 활성화가 없고, 타임스탬프 DELEGATED_CAPABILITY_TIMESTAMPS["display-capture"]가 this의 관련 전역 객체에서 undefined이거나 만료되었으면 거부된 promise를 반환합니다. 거부 사유는 DOMException 객체이며 그 name 속성값은 InvalidStateError입니다.