소프트 내비게이션과 상호작용 콘텐츠풀 페인트

Window window가 주어졌을 때 현재 탐색 id 증가시키기는 다음과 같습니다.

1. window의 탐색 횟수를 window의 탐색 횟수에 1을 더한 값으로 설정합니다.

2. newId를 window의 초기 탐색 id 값 더하기 (window의 탐색 횟수 곱하기 window의 탐색 id 증가량)으로 둡니다.

3. window의 현재 탐색 id를 newId로 설정합니다.

[Exposed=(Window,Worker)]
partial interface PerformanceEntry {
    readonly attribute unsigned long long navigationId;
};

현재 상호작용 컨텍스트를 가져온다, Document document가 주어졌을 때:

1. context를 내부 AsyncContext.Variable [[ActiveInteractionContext]]의 값으로 둔다.

2. context가 null이 아니고 context의 컨텍스트 문서가 document와 같지 않으면, null을 반환한다.

3. context를 반환한다.

상호작용에 대한 컨텍스트를 가져오거나 생성한다, Document document와 PerformanceEventTiming timing entry가 주어졌을 때:

1. interaction id를 timing entry의 interactionId로 둔다.

2. interaction id가 0보다 크다고 단언한다.

3. document의 상호작용 id에서 상호작용 컨텍스트로[interaction id]가 존재하면, document의 상호작용 id에서 상호작용 컨텍스트로[interaction id]를 반환한다.

4. interaction context를 새 InteractionContext로 둔다.

5. interaction context의 id를 interaction id로 설정한다.

6. interaction context의 컨텍스트 문서를 document로 설정한다.

7. interaction context의 시작 시간을 timing entry의 startTime으로 설정한다.

8. document의 상호작용 id에서 상호작용 컨텍스트로[interaction id]를 interaction context로 설정한다.

9. interaction context를 반환한다.

이벤트에 대한 상호작용 컨텍스트들을 갱신한다, Document document와 Event event가 주어졌을 때:

1. timestamp를 document의 관련 전역 객체가 주어졌을 때의 현재 고해상도 시간으로 둔다.

2. is scroll을 event의 타입이 "scroll"이면 true로, 그렇지 않으면 false로 둔다.

3. is input을 event의 타입이 has dispatched input event를 트리거할 이벤트 타입이면 true로 두고([EVENT-TIMING]에 정의된 바와 같이), 그렇지 않으면 false로 둔다.

4. is scroll이 false이고 is input이 false이면, 반환한다.

5. document의 상호작용 id에서 상호작용 컨텍스트로의 값들 중 각 interaction context에 대해:

   1. is scroll이 true이고 interaction context의 첫 번째 스크롤 타임스탬프가 0이면:

      1. interaction context의 첫 번째 스크롤 타임스탬프를 timestamp로 설정한다.

   2. is input이 true이고 interaction context의 첫 번째 입력 타임스탬프가 0이면:

      1. interaction context의 첫 번째 입력 타임스탬프를 timestamp로 설정한다.

이벤트 디스패치를 위한 현재 상호작용 컨텍스트를 설정한다, null 또는 PerformanceEventTiming 객체 timing entry가 주어졌을 때:

1. timing entry가 null이면, null을 반환한다.

2. interaction id를 timing entry의 interactionId로 둔다.

3. interaction id가 0이면, null을 반환한다.

4. event를 timing entry의 연결된 이벤트로 둔다.

5. document를 event의 관련 전역 객체의 연결된 Document로 둔다.

6. document와 event가 주어졌을 때 이벤트에 대한 상호작용 컨텍스트들을 갱신한다.

7. interaction context를 document와 timing entry가 주어졌을 때 상호작용에 대한 컨텍스트를 가져오거나 생성한 결과로 둔다.

8. 내부 AsyncContext.Variable [[ActiveInteractionContext]]의 값을 interaction context로 설정한다.

9. interaction context를 반환한다.

이벤트 디스패치 후 현재 상호작용 컨텍스트를 해제한다:

1. 내부 AsyncContext.Variable [[ActiveInteractionContext]]의 값을 null로 설정한다.

[Exposed=Window]
interface InteractionContentfulPaint : PerformanceEntry {
    readonly attribute LargestContentfulPaint largestContentfulPaint;
    readonly attribute unsigned long long interactionId;

    object toJSON();
};

InteractionContentfulPaint includes PaintTimingMixin;

Window window, InteractionContext interaction context, LargestContentfulPaint lcpEntry, 그리고 페인트 타이밍 정보 paintTimingInfo가 주어졌을 때 상호작용 콘텐츠풀 페인트 엔트리 생성하기는 다음과 같습니다.

1. entry를 window의 realm 안의 새 InteractionContentfulPaint 객체로 둡니다.

2. entry의 컨텍스트를 interaction context로 설정합니다.

3. entry의 최대 콘텐츠풀 페인트를 lcpEntry로 설정합니다.

4. entry의 연결된 페인트 타이밍 정보를 paintTimingInfo로 설정합니다.

5. entry를 반환합니다.

새로 귀속된 콘텐츠풀 페인트 후보를 처리한다, 가장 큰 콘텐츠풀 페인트 후보 lcpCandidate, Document document, InteractionContext interaction context, 그리고 페인트 타이밍 정보 paintTimingInfo가 주어졌을 때:

1. interaction context의 첫 번째 스크롤 타임스탬프가 0보다 크고 lcpEntry의 renderTime이 interaction context의 첫 번째 스크롤 타임스탬프보다 크면, 반환한다.

2. interaction context의 첫 번째 입력 타임스탬프가 0보다 크고 lcpEntry의 renderTime이 interaction context의 첫 번째 입력 타임스탬프보다 크면, 반환한다.

3. lcpEntry를 lcpCandidate, paintTimingInfo, 그리고 document로 LargestContentfulPaint 엔트리를 생성한 결과로 둔다.

4. global을 document의 관련 전역 객체로 둔다.

5. paint timing info를 lcpEntry의 연결된 페인트 타이밍 정보로 둔다.

6. icpEntry를 global, interaction context, lcpEntry, 그리고 paint timing info가 주어졌을 때 상호작용 콘텐츠풀 페인트 엔트리를 생성한 결과로 둔다.

7. icpEntry를 큐에 넣는다.

8. icpEntry를 global의 성능 엔트리 버퍼에 추가한다.

9. interaction context의 첫 번째 콘텐츠풀 페인트가 null이면:

   1. interaction context의 첫 번째 콘텐츠풀 페인트를 icpEntry로 설정한다.

10. interaction context의 가장 큰 콘텐츠풀 페인트를 icpEntry로 설정한다.

11. interaction context의 현재 가장 큰 콘텐츠풀 페인트 후보를 lcpCandidate로 설정한다.

Document document, paint timing info paintTimingInfo, ordered set인 pending image records paintedImages, 그리고 ordered set인 elements paintedTextNodes가 주어졌을 때 interaction contentful paints 및 soft navigations 보고를 수행하려면:

1. contextToCandidateSets를 새 map으로 둔다.

2. paintedImages의 각 record에 대해 반복한다:

   1. element를 record의 element로 둔다.

   2. interaction context를 element에 대해 paint attribution interaction context 가져오기를 수행한 결과로 둔다.

   3. interaction context가 null이 아니면:

      1. contextToCandidateSets가 interaction context를 포함하지 않으면, contextToCandidateSets[interaction context]를 « «», «» »로 설정한다.

      2. record를 contextToCandidateSets[interaction context][0]에 추가한다.

3. paintedTextNodes의 각 element에 대해 반복한다:

   1. interaction context를 element에 대해 paint attribution interaction context 가져오기를 수행한 결과로 둔다.

   2. interaction context가 null이 아니면:

      1. contextToCandidateSets가 interaction context를 포함하지 않으면, contextToCandidateSets[interaction context]를 « «», «» »로 설정한다.

      2. element를 contextToCandidateSets[interaction context][1]에 추가한다.

4. contextToCandidateSets 안의 각 interaction context → candidateSets에 대해 반복한다:

   1. newCandidate를 document, candidateSets[0], candidateSets[1], 그리고 interaction context의 current largest contentful paint candidate가 주어졌을 때 새로운 largest contentful paint candidate 계산을 수행한 결과로 둔다.

   2. newCandidate가 null이 아니면:

      1. newCandidate, document, interaction context, 그리고 paintTimingInfo가 주어졌을 때 새로운 귀속된 contentful paint candidate 처리를 수행한다.

      2. document와 interaction context가 주어졌을 때 soft navigation emission 평가를 수행한다.

InteractionPaintTimingNodeState node state가 InteractionPaintTimingNodeState 또는 null인 other node state보다 더 최근인지 판단하려면:

1. other node state가 null이거나 node state의 modification id가 other node state의 modification id보다 크면 true를 반환하고, 그렇지 않으면 false를 반환한다.

주어진 Node node에 대해 paint attribution interaction context 가져오기를 수행하려면:

1. document를 node의 node document로 둔다.

2. node state를 document의 propagated node state[node]로 두되, 기본값을 null로 하는 with default를 사용한다.

3. node state가 null이면 null을 반환하고, 그렇지 않으면 node state의 context를 반환한다.

Node target node가 주어졌을 때 interaction paint timing을 위해 수정된 노드로 기록하려면:

1. document를 node의 node document로 둔다.

2. target node가 document가 주어졌을 때 exposed for paint timing이 아니면, 반환한다.

3. interaction context를 document가 주어졌을 때 current interaction context 가져오기를 수행한 결과로 둔다.

4. interaction context가 null이면 반환한다.

5. document의 last modification context가 interaction context와 같지 않으면:

   1. document의 last modification context를 interaction context로 설정한다.

   2. document의 current modification generation id를 1 증가시킨다.

6. previous node state를 document의 marked node state[target node]로 두되, 기본값을 null로 하는 with default를 사용한다.

7. previous node state가 null이 아니고 previous node state의 modification id가 document의 current modification generation id와 같으면, 반환한다.

8. node state를 새로운 InteractionPaintTimingNodeState로 둔다.

9. node state의 context를 interaction context로 설정한다.

10. node state의 modification id를 document의 current modification generation id로 설정한다.

11. document의 marked node state[node]를 node state로 설정한다.

12. document의 is interaction paint timing dirty를 true로 설정한다.

Document document가 주어졌을 때 document 및 그 자손에 대한 interaction context 갱신을 수행하려면:

1. document의 is interaction paint timing dirty가 false이면, 반환한다.

2. document와 null이 주어졌을 때 node 및 그 자손에 대한 interaction context 갱신을 수행한다.

3. document의 is interaction paint timing dirty를 false로 설정한다.

Node node 및 InteractionPaintTimingNodeState inherited node state 또는 null이 주어졌을 때 node 및 그 자손에 대한 interaction context 갱신을 수행하려면:

1. document를 node의 node document로 둔다.

2. node state를 document의 marked node state[node]로 두되, 기본값을 null로 하는 with default를 사용한다.

3. node state가 null이 아니면:

   1. node state가 inherited node state보다 더 최근이면:

      1. inherited node state를 node state로 설정한다.

      2. node가 Text node이면, document의 marked node state[node]를 제거한다.

   2. 그렇지 않으면, document의 marked node state[node]를 제거한다.

4. inherited node state가 null이 아니고 node가 timing-eligible이면:

   1. attribution element를 node에 대해 attribution element 가져오기를 수행한 결과로 둔다.

   2. previous propagated state를 propagated node state[attribution element]로 두되, 기본값을 null로 하는 with default를 사용한다.

   3. inherited node state가 previous propagated state보다 더 최근이면:

      1. propagated node state[attribution element]를 inherited node state로 설정한다.

      2. previous propagated state가 null이거나 previous propagated state의 context가 inherited node state의 context와 같지 않으면, attribution element에 대해 paint tracking 재설정을 수행한다.

5. node의 각 자식 child node에 대해 반복하여, child node 및 inherited node state가 주어졌을 때 node 및 그 자손에 대한 interaction context 갱신을 수행한다.

[Exposed=Window]
interface PerformanceSoftNavigation : PerformanceEntry {
    readonly attribute NavigationType navigationType;
    readonly attribute unsigned long long interactionId;
    InteractionContentfulPaint? getLargestInteractionContentfulPaint();
};

PerformanceSoftNavigation includes PaintTimingMixin;

소프트 내비게이션 방출을 평가한다, Document document와 InteractionContext interaction context가 주어졌을 때:

1. interaction context의 방출됨이 true이면, 반환한다.

2. document의 활성 소프트 내비게이션 후보가 interaction context가 아니면, 반환한다.

3. interaction context의 첫 번째 URL 값이 null이면, 반환한다.

4. interaction context의 첫 번째 콘텐츠풀 페인트가 null이면, 반환한다.

5. window를 document의 관련 전역 객체로 둔다.

6. entry를 window와 interaction context가 주어졌을 때 소프트 내비게이션 엔트리를 생성한 결과로 둔다.

7. window와 entry가 주어졌을 때 소프트 내비게이션 엔트리를 방출한다.

8. interaction context의 방출됨을 true로 설정한다.

소프트 내비게이션 엔트리를 생성한다, Window window와 InteractionContext interaction context가 주어졌을 때:

1. entry를 window의 렐름 안에 있는 새 PerformanceSoftNavigation 객체로 둔다.

2. entry의 컨텍스트를 interaction context로 설정한다.

3. first paint를 interaction context의 첫 번째 콘텐츠풀 페인트로 둔다.

4. first paint가 null이 아니라고 단언한다.

5. entry의 연결된 페인트 타이밍 정보를 first paint의 연결된 페인트 타이밍 정보로 설정한다.

6. entry를 반환한다.

소프트 내비게이션 엔트리를 방출한다, Window window와 PerformanceSoftNavigation entry가 주어졌을 때:

1. window가 주어졌을 때 현재 내비게이션 id를 증가시킨다.

2. entry를 큐에 넣는다.

3. entry를 window의 성능 엔트리 버퍼에 추가한다.

동일 문서 커밋을 처리한다, Document document, 문자열 url, 그리고 NavigationType navigation type이 주어졌을 때:

1. url이 document의 url과 같으면, 반환한다.

2. interaction context를 document가 주어졌을 때 현재 상호작용 컨텍스트를 가져온 결과로 둔다.

3. interaction context가 null이면, 반환한다.

4. interaction context의 마지막 URL 값을 url로 설정한다.

5. interaction context의 첫 번째 URL 갱신 타임스탬프가 null이면:

   1. interaction context의 첫 번째 URL 갱신 타임스탬프를 document의 관련 전역 객체가 주어졌을 때의 현재 고해상도 시간으로 설정한다.

   2. interaction context의 첫 번째 URL 값을 url로 설정한다.

   3. interaction context의 내비게이션 타입을 navigation type으로 설정한다.

6. document의 활성 소프트 내비게이션 후보를 interaction context로 설정한다.

7. document와 interaction context가 주어졌을 때 소프트 내비게이션 방출을 평가한다.

node insert 시, 또는 node node가 다음 방식 중 하나로 수정될 때:

• 요소의 class 또는 style 속성이 수정된다.

• 리소스 속성(예: img 또는 video 요소의 src)이 수정된다.

다음 단계를 실행한다:

1. node가 주어졌을 때 interaction paint timing을 위해 수정된 노드로 기록한다.

히스토리 단계 적용을 위해 문서를 갱신할 때, 5.5.1 이전에(documentsEntryChanged가 true이고 documentIsNew가 false인 경우), 동일 문서 커밋을 처리한다. 이때 Document, 대상 엔트리의 url, 그리고 "traverse"가 주어진다.

공유 히스토리 push/replace 단계 ([HTML]에 정의된 바와 같이)에서, URL이 갱신된 후, 동일 문서 커밋을 처리한다. 이때 Document, 새 URL, 그리고 작업 타입("push" 또는 "replace" 중 하나)이 주어진다.

[NAVIGATION-TIMING]에서, 초기 내비게이션을 위한 PerformanceNavigationTiming entry를 생성할 때, 사용자 에이전트는 그 navigationId를 Window의 current navigation id로 설정해야 한다.

Window window에 대해 다음 interactionId 가져오기를 수행하려면:

1. window의 interaction count를 window의 interaction count에 1을 더한 값으로 설정한다.

2. window의 initial interactionId value에 (window의 interaction count에 window의 interactionId increment를 곱한 값)을 더한 값을 반환한다.

[EVENT-TIMING]에 정의된 DOM 명세의 event dispatch 알고리즘에 대한 수정에서:

1. timingEntry를 event timing processing start 초기화 및 기록의 결과로 설정하는 단계 직후에 다음 단계를 실행한다:

   1. timingEntry가 주어졌을 때 event dispatch에 대한 현재 interaction context 설정을 수행한다.

2. event timing processing end 기록을 호출하는 단계 직전에 다음 단계를 실행한다:

   1. event dispatch 이후 현재 interaction context 해제를 수행한다.

mark paint timing을 변경하여, Document document가 주어졌을 때 1단계 이후 다음 단계를 추가한다:

1. document가 주어졌을 때 document 및 그 자손에 대한 interaction context 갱신을 수행한다.

mark paint timing을 변경하여, Document document, paint timing info paintTimingInfo, ordered set인 pending image records paintedImages, 그리고 ordered set인 elements paintedTextNodes가 주어졌을 때, 10.3단계(largest contentful paint 보고) 이후 다음 단계를 추가한다:

1. document, paintTimingInfo, paintedImages, 그리고 paintedTextNodes가 주어졌을 때 interaction contentful paints 및 soft navigations 보고를 수행한다.

Node node에 대해 paint tracking 재설정을 수행하려면:

1. node에 대한 text element tracking을 재설정한다.

2. node에 대한 image element tracking을 재설정한다.

Node node에 대해 attribution element 가져오기를 수행하려면:

1. node가 Text node이면, node의 containing block을 결정하는 Element를 반환한다.

2. 그렇지 않으면, node를 반환한다.