软导航与交互内容绘制

给定一个 Window window，要 increment the current navigation id：

1. 将 window 的 navigation count 设置为 window 的 navigation count 加 1。

2. 令 newId 为 window 的 initial navigation id value 加上 （window 的 navigation count 乘以 window 的 navigation id increment）。

3. 将 window 的 current navigation 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. 如果 event 的类型为 "scroll"，则令 is scroll 为 true；否则为 false。

3. 如果 event 的类型是会触发 已派发输入事件的事件类型（如 [EVENT-TIMING] 中定义），则令 is input 为 true；否则为 false。

4. 如果 is scroll 为 false 且 is input 为 false，则返回。

5. 对于 document 的交互 id 到交互 上下文的 values 中的每个 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，以及一个 paint timing info paintTimingInfo，要 create an interaction contentful paint entry：

1. 令 entry 为 window 的 realm 中的一个新的 InteractionContentfulPaint 对象。

2. 将 entry 的 context 设置为 interaction context。

3. 将 entry 的 largest contentful paint 设置为 lcpEntry。

4. 将 entry 关联的 paint timing info 设置为 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、一个 绘制定时信息 paintTimingInfo、一个由 待处理图像记录组成的有序 集合 paintedImages，以及一个由 元素组成的有序 集合 paintedTextNodes：

1. 令 contextToCandidateSets 为一个新的映射。

2. 对 paintedImages 的每个 record：

   1. 令 element 为 record 的元素。

   2. 令 interaction context 为针对 element获取绘制 归因交互上下文的结果。

   3. 如果 interaction context 不为 null：

      1. 如果 contextToCandidateSets 不包含 interaction context，则 将 contextToCandidateSets[interaction context] 设置为 « «», «» »。

      2. 将 record 追加到 contextToCandidateSets[interaction context][0]。

3. 对 paintedTextNodes 的每个 element：

   1. 令 interaction context 为针对 element获取绘制 归因交互上下文的结果。

   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 的 当前 最大内容绘制候选项计算新的 最大内容绘制候选项的结果。

   2. 如果 newCandidate 不为 null：

      1. 给定 newCandidate、 document、 interaction context 和 paintTimingInfo，处理 新的已归因内容绘制候选项。

      2. 给定 document 和 interaction context，评估软导航 发出。

要确定一个 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 获取绘制归因交互上下文：

1. 令 document 为 node 的节点文档。

2. 令 node state 为 document 的传播节点状态[node] 默认值为 null。

3. 如果 node state 为 null，则返回 null；否则返回 node state 的 context。

要将节点记录为已为交互 绘制定时而修改，给定一个 Node target node：

1. 令 document 为 node 的节点文档。

2. 如果给定 document 时，target node 未暴露给绘制定时，则返回。

3. 令 interaction context 为给定 document获取当前交互上下文的结果。

4. 如果 interaction context 为 null，则返回。

5. 如果 document 的最后修改上下文不等于 interaction context：

   1. 将 document 的最后修改上下文设置为 interaction context。

   2. 将 document 的当前修改 代 id加 1。

6. 令 previous node state 为 document 的已标记节点 状态[target node] 默认值为 null。

7. 如果 previous node state 不为 null，且 previous node state 的 modification id等于 document 的 当前修改代 id，则返回。

8. 令 node state 为一个新的 InteractionPaintTimingNodeState。

9. 将 node state 的context设置为 interaction context。

10. 将 node state 的modification id设置为 document 的当前修改代 id。

11. 设置 document 的已标记节点 状态[node] 为 node state。

12. 将 document 的交互绘制定时为 脏设置为 true。

要更新文档及其后代的 交互上下文，给定一个 Document document：

1. 如果 document 的交互绘制定时为 脏为 false，则返回。

2. 给定 document 和 null，更新节点及其后代的 交互上下文。

3. 将 document 的交互绘制定时为 脏设置为 false。

要更新节点及其后代的交互上下文， 给定一个 Node node 和一个 InteractionPaintTimingNodeState inherited node state 或 null：

1. 令 document 为 node 的节点文档。

2. 令 node state 为 document 的已标记节点 状态[node] 默认值为 null。

3. 如果 node state 不为 null：

   1. 如果 node state 比 inherited node state 更新：

      1. 将 inherited node state 设置为 node state。

      2. 如果 node 是一个 Text 节点，则移除 document 的 已标记节点 状态[node]。

   2. 否则，移除 document 的已标记 节点状态[node]。

4. 如果 inherited node state 不为 null，且 node 符合定时条件：

   1. 令 attribution element 为针对 node获取 归因元素的结果。

   2. 令 previous propagated state 为传播节点 状态[attribution element] 默认值为 null。

   3. 如果 inherited node state 比 previous propagated state 更新：

      1. 将传播节点 状态[attribution element] 设置为 inherited node state。

      2. 如果 previous propagated state 为 null，或 previous propagated state 的 context不等于 inherited node state 的 context，则对 attribution element重置绘制跟踪。

5. 对 node 的每个子child node， 给定 child node 和 inherited node state，更新 节点及其后代的交互上下文。

[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 的 realm 中的一个新的 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 node 以 以下方式之一被修改时：

• 元素的 class 或 style 属性被修改。

• 资源属性（例如 img 或 video 元素上的 src）被修改。

运行以下步骤：

1. 给定 node，将节点记录为 已为交互绘制定时而修改。

在为历史步骤应用更新 document中，在 5.5.1（如果 documentsEntryChanged 为 true 且如果 documentIsNew 为 false）之前，给定该 处理一次同 document 提交，给定该 Document、 目标条目的 url，以及 "traverse"。

在共享 历史 push/replace 步骤 （如 [HTML] 中所定义）中，在 URL 更新后，给定该 处理一次同 document 提交，给定该 Document、新 URL，以及操作类型（即 "push" 或 "replace"）。

在 [NAVIGATION-TIMING] 中，当为 初始导航创建 PerformanceNavigationTiming 条目时，用户代理必须将其 navigationId 设置为该 Window 的 当前导航 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 规范的事件 分派算法的修改中：

1. 在将 timingEntry 设置为初始化并记录事件 定时处理开始结果的步骤之后，立即运行以下步骤：

   1. 给定 timingEntry，为事件分派设置当前 交互上下文。

2. 在调用记录事件定时处理结束的步骤之前， 立即运行以下步骤：

   1. 在事件分派后取消设置 当前交互上下文。

修改标记绘制定时，在步骤 1 之后添加以下步骤，给定一个 Document document：

1. 给定 document，更新 文档及其后代的交互上下文。

修改标记绘制定时，在步骤 10.3（报告最大内容绘制）之后添加以下步骤，给定一个 Document document、一个 绘制定时信息 paintTimingInfo、 一个由 待处理图像记录组成的有序集合 paintedImages，以及一个由 元素组成的有序 集合 paintedTextNodes：

1. 给定 document、 paintTimingInfo、paintedImages 和 paintedTextNodes，报告交互 内容绘制和软导航。

要为一个 Node node 重置绘制 跟踪：

1. 重置文本元素跟踪 node。

2. 重置图像元素跟踪 node。

要为一个 Node node 获取 归因元素：

1. 如果 node 是一个 Text 节点，则返回用于确定 node 的 包含块的 Element。

2. 否则，返回 node。