围栏框架

• 如果 embedder 是一个 iframe 元素，则：设置在 embedder 的 iframe 沙盒化标志集上的标志。

• 如果 embedder 是一个 fencedframe 元素，则：设置在 embedder 的 fencedframe 沙盒化标志 集上的标志。

1. 令 nested traversable 为为 element 创建新的 嵌套可遍历体的结果。

2. 将 nested traversable 的 加载模式设置为 "fencedframe"。

3. 如果 element 具有 sandbox 属性，则以该属性的值和 element 的 fencedframe 沙盒化标志 集为参数解析沙盒化指令。

不必像通常进行子 可导航体创建或顶级 可遍历体创建时那样调用 URL 和历史记录更新步骤，但我们仍然需要一种机制来初始化新可导航体中的 History.length。 这是 HTML Standard 中的一个现有问题：https://github.com/whatwg/html/issues/9030。

1. TODO: 销毁嵌套可遍历体。

2. 并行地，给定该 Document 的 节点可导航体的 顶级可遍历体，重新计算 所有围栏框架后代的不受信任网络状态。

1. 如果 this 未连接：

   1. 断言：this 的 围栏可导航体为 null。

      注： 这是成立的，因为当该元素从 DOM 中移除时，其移除步骤 会立即销毁该围栏可导航体。

2. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置实例。

3. 如果 instance 不是 null，且其 不受信任网络 状态 不是已启用，则返回。

4. 令 navigation url or urn 为给定 FencedFrameConfig 的 url， 如果 给定 FencedFrameConfig 的 url 不是 null；否则为给定 FencedFrameConfig 的 urn。

5. 如果 navigation url or urn 是 failure，则返回。

6. 令 shared storage context 为给定 FencedFrameConfig 的 sharedStorageContext。

7. 使用 element 的 节点 document，将 element 的 围栏可导航体导航到 navigation url or urn，其中 historyHandling 设为 "replace"，referrerPolicy 设为 "no-referrer"，并使用 shared storage context。

   注： 有关普通 导航流程中针对 fencedframe 的特定 更改，请参见 § 3.8.5 实际导航更改。

1. 断言：namespace 是 HTML 命名空间。

2. 如果 localName 是 sandbox， 则：

   1. 如果 value 是 null，则清空 element 的 fencedframe 沙盒化 标志集。

   2. 否则，给定 value 和 element 的 fencedframe 沙盒化 标志集，运行解析沙盒化指令。

1. 令 pendingMapping 为 mapping 的 待定配置映射。

2. 如果 pendingMapping 的大小 + mapping 的 已完成配置 映射的大小 ≥ mapping 的 最大配置 数量，返回 failure。

3. 令 urn 为一个随机生成的 urn uuid。

4. 断言：urn 不存在于 pendingMapping 中。

5. 设置 pendingMapping[urn] 为 config。

6. 返回 urn。

1. 令 pendingMapping 为 mapping 的 待定配置映射。

2. 令 finalizedMapping 为 mapping 的 已完成配置 映射。

3. 如果 pendingMapping[urn] 不存在，返回 failure。

4. 移除 pendingMapping[urn]。

5. 设置 finalizedMapping[urn] 为 config。

1. 令 nestedMapping 为 mapping 的 嵌套配置映射。

2. 如果 nestedConfigs 为 null，则返回。

3. 对于 nestedConfigs 中的每个 urn → config 执行：

   1. 设置 nestedMapping[urn] 为 config。

   2. 将 nestedMapping[urn] 的 is ad component 设为 true。

1. 令 nestedMapping 为 mapping 的 嵌套配置映射。

2. 令 pendingMapping 为 mapping 的 待定配置映射。

3. 令 finalizedMapping 为 mapping 的 已完成配置 映射。

4. 如果 nestedMapping[urn] 存在，返回 其值。

5. 如果 pendingMapping[urn] 存在，则等待 直到它不再存在。

6. 如果 finalizedMapping[urn] 存在，返回 其值。

7. 返回 failure。

1. 断言 reporting map[destination] 是一个 列表 （即 destination 的 元数据尚未完成）。

2. 令 pending event list 为 reporting map[destination]。

3. 设置 reporting map[destination] 为一个具有以下项的结构体：

   报告 url 声明者源

   reporting url declarer origin

   报告 url 映射

   destination map

   报告宏映射

   macro map

4. 对于 pending event list 中的每个 pending event 执行：

   1. 使用 destination map、pending event 的 事件、 pending event 的 请求发起者，以及 pending event 的 发起者 referrer 策略发送 beacon。

1. 令 destination url 为空字符串。

2. 令 attributionReportingEligibility 为 "unset"。

3. 令 processResponse 为 null。

4. 令 useParallelQueue 为 false。

5. 如果 event 是目标枚举事件或 自动 beacon 事件，则：

   1. 令 destination map 为 destination info 的 报告 url 映射。

   2. 令 eventType 为 event 的目标类型，或者 自动类型，取决于 event 是哪种 变体。

   3. 如果 destination map[eventType] 不存在， 返回。

   4. 将 destination url 设置为 destination map[eventType]。

   5. 如果 event 的 attributionReportingEnabled 为 true 且 event 的 attributionReportingContextOrigin 是合适的：

      1. 如果 event 的 eventType 匹配某个自动 beacon 事件类型值，则将 attributionReportingEligibility 设置为 "navigation-source"。

      2. 否则，将 attributionReportingEligibility 设置为 "event-source"。

      3. 将 processResponse 设置为给定一个响应 response 的这些步骤：

         1. 令 fenced 为 true。

         2. 使用 event 的 attributionReportingContextOrigin、 attributionReportingEligibility、fenced 和 response 运行处理 归因合格响应。

      4. 将 useParallelQueue 设置为 true。

6. 否则：

   1. 断言：event 是一个目标 URL 事件。

   2. 令 macro map 为 destination info 的 报告宏 映射。

   3. 如果 macro map 为 null，则返回。

   4. 将 destination url 设置为 event。

   5. 令 destination url 为使用 macro map 将宏代入 destination url 的 结果。

7. 可选地，返回。

   注： 这个实现定义的条件旨在 允许用户代理出于多种原因丢弃该 beacon，例如用户选择退出，或 destination url 的站点未 登记。

8. 令 request 为一个新的请求，具有以下属性：

   方法

   如果 event 是目标枚举事件，则为 POST， 否则为 GET。

   URL

   destination url

   标头列表

   一个新的标头列表，其中包含一个标头，其名称为 "Content-Type"，且 值为 "text/plain"。

   主体

   如果 event 是一个目标枚举事件，则为一个 主体，其源 是 event 的数据，否则为 null。

   客户端

   null

   service-workers 模式

   "all"

   默认值是 "all"，因此从技术上讲我们不必在这里设置任何内容。我们这样做是为了 提醒自己，这里跳过 service workers 可能更合适，类似于某些 其他 beacon。

   源

   如果 event 是目标 URL 事件，则为 request initiator，否则为 destination info 的 报告 url 声明者源。

   注： 目标 URL 事件的报告目标 由调用 reportEvent() 的 Document 决定， 不同于目标枚举事件或 自动 beacon 事件， 后者的报告 目标是在创建加载此 Document 的围栏框架 配置的 worklet 中决定的。 我们将源设置为决定报告目标的 Document 或 worklet 的源，以防止跨站请求伪造。

   referrer

   request initiator

   referrer 策略

   initiator referrer policy

   模式

   "cors"

   凭据模式

   "omit"

   Attribution Reporting eligibility

   attributionReportingEligibility

9. Fetch request，其中 processResponse 为 processResponse（如果它不是 null），且 useParallelQueue 为 useParallelQueue。

   注： 此算法可以在并行期间调用，也可以在 Document 的 主 线程上调用。为了正确处理并行调用，我们在使用可选的 响应处理算法时，会调用 fetch 并将 useParallelQueue 设为 true；否则，即使此 算法在其他实例中并行运行，也无需这样做。

1. 令 metadata 为 reporter 的 围栏框架 报告元数据引用。

2. 如果 destination 是 "direct-seller"：

   1. 如果 metadata 的 直接卖方 是卖方为 true，则将 destination 设置为 "seller"。

   2. 否则，将 destination 设置为 "component-seller"。

3. 如果 event 是一个目标 URL 事件：

   1. 如果 event 的源不与 metadata 的 允许的 报告源中的任一条目同源：

      1. 将 metadata 的 尝试 向不允许源进行自定义 url 报告设置为 true。

   2. 如果 metadata 的 尝试 向不允许源进行自定义 url 报告为 true，则返回。

4. 令 reporting map 为对 metadata 的 围栏框架 报告映射的引用。

5. 如果 reporting map[destination] 不存在，返回。

6. 如果 reporting map[destination] 是一个列表：

   1. 令 newEvent 为一个新的待定事件，具有以下内容：

      目标

      destination

      事件

      event

      请求发起者

      request initiator

      发起者 referrer 策略

      initiator referrer policy

   2. 将 newEvent追加到 reporting map[destination]。

   3. 返回。

      注： 该待定事件将被异步发送。

7. 断言 reporting map[destination] 是一个 映射（即 destination 的 元数据已经完成）。

8. 使用 reporting map[destination]、event、request initiator 和 initiator referrer policy发送 beacon。

1. 如果 event 的 eventType 以 "reserved." 开头，则返回。

2. reporter event TODO: 填写此处

映射 url

config 的映射 url的值

容器尺寸

config 的容器尺寸

内容尺寸

如果 config 的内容尺寸为 null，则为它本身；否则为 config 的内容尺寸的值

兴趣组 描述符

如果 config 的兴趣组描述符为 null，则为它本身；否则为 config 的 兴趣组描述符的 值

on navigate 回调

config 的on navigate 回调

有效沙盒化 标志

如果 config 的有效沙盒化标志 为 null，则为它本身；否则为 config 的 有效沙盒化 标志的值

权限策略 行为

如果 config 的有效启用 权限为 null，则为 flexible，否则为fixed。

有效启用 权限

如果 config 的有效启用 权限为 null，则为它本身；否则为 config 的有效启用 权限的值

围栏框架报告器

1. 如果 config 的围栏框架 报告元数据的值为 null，则设为 null。

2. 否则，设置为一个围栏框架报告器，具有 以下 成员：

   围栏 框架报告元数据引用

   对 config 的围栏 框架报告元数据的 值的引用

外泄 预算元数据引用

1. 如果 config 的外泄预算 元数据为 null，则设为 null。

2. 否则，设置为一个外泄 预算元数据引用：

   源

   config 的外泄 预算元数据的值的源

   要 扣减的量引用

   对 config 的外泄 预算元数据的 值的要扣减的 量的引用

嵌套配置

1. 如果 config 的嵌套配置为 null，则设为 null。

2. 否则：

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

   2. 对于 config 的嵌套配置的值中的每个 nested config 执行：

      1. 令 urn 为随机生成的 urn uuid。

      2. 设置 results[urn] 为 nested config。

   3. 将嵌套配置 设为 results。

分区 nonce

一个随机、唯一的分区 nonce

嵌入者 shared storage 上下文

config 的嵌入者 shared storage 上下文

is ad component

config 的is ad component

允许跨源报告

config 的允许跨源报告

不受信任网络状态

enabled

网络禁用时 promise

一个空的映射。

1. 令 config 为一个新的 FencedFrameConfig 对象。

2. 将 config 的url 设为对 url 运行 URL 解析器的结果。

3. 返回 config。

1. 如果 forStorage 为 true，则抛出一个 DataCloneError DOMException。

2. 将 serialized.[[Url]] 设为 value 的url。

3. 将 serialized.[[Urn]] 设为 value 的urn。

4. 将 serialized.[[SharedStorageContext]] 设为 value 的sharedStorageContext。

1. 将 value 的url 初始化为 serialized.[[Url]]。

2. 将 value 的urn 初始化为 serialized.[[Urn]]。

3. 将 value 的sharedStorageContext 初始化为 serialized.[[SharedStorageContext]]。

1. TODO: 规范 此内容。 将 macros 中的键替换为 string 中对应的值， 并返回 新字符串。不存在递归替换。

1. 令 urn 为 null。

2. 如果 urnOrConfig 是一个 USVString， 则将 urn 设为 urnOrConfig。

3. 否则，将 urn 设为 urnOrConfig 的urn。

4. 如果 urn 不是有效的 urn uuid （即不会通过 urn uuid第 3 节中的 ABNF），则抛出一个 TypeError。

5. 对于 replacements 中的每个 key → _ 执行：

   1. 如果 key 不是以 ${ 或 %% 开头， 则抛出一个 TypeError。

   2. 如果 key 不是以 } 或 %% 结尾， 则抛出一个 TypeError。

6. 令 p 为一个新的 promise。

7. 令 global 为 this 的相关全局对象。

8. 并行地运行以下步骤：

   1. 令 mapping 为 global 的可导航体的 可遍历可导航体的围栏框架配置 映射。

   2. 令 config 为在 mapping 中以 urn查找配置的结果。

   3. 如果 config 为 failure，则在给定 global 的情况下，在DOM 操作任务源上排入一个全局任务，以使用 undefined 解析 p， 并中止这些步骤。

   4. 令 substitutedUrl 为使用 replacements 将宏代入 config 的映射 url的值的结果。

   5. 将 config 的映射 url的值设置为 substitutedUrl。

   6. 在给定 global 的情况下，在DOM 操作任务源上排入一个全局任务，以 使用 undefined解析 p。

9. 返回 p。

1. 令 urn 为 null。

2. 如果 urnOrConfig 是一个 USVString， 则将 urn 设为 urnOrConfig。

3. 否则，将 urn 设为 urnOrConfig 的urn。

4. 如果 urn 不是有效的 urn uuid （即不会通过 urn uuid第 3 节中的 ABNF），则抛出一个 TypeError。

5. 令 p 为一个新的 promise。

6. 令 global 为 this 的相关全局对象。

7. 并行地运行以下步骤：

   1. 令 mapping 为 global 的可导航体的 可遍历可导航体的围栏框架配置 映射。

   2. 如果 mapping 的已完成配置 映射[urn] 不 存在，则在给定 global 的情况下，在DOM 操作任务源上排入一个全局任务， 以使用 undefined解析 p， 并中止这些步骤。

   3. 令 config 为 mapping 的已完成配置 映射[urn]。

   4. 在给定 global 的情况下，在DOM 操作任务源上排入一个全局任务，以 使用 config 的映射 url的值解析 p。

   5. 如果 send_reports 为 true，则运行 config 的 on navigate 回调中的步骤。

8. 返回 p。

1. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置 实例。

2. 如果 instance 为 null，则抛出一个 InvalidStateError DOMException。

3. 如果 this 的相关设置对象的源与 instance 的映射 url的源不是同源，则抛出一个 InvalidStateError DOMException。

4. 令 maxAdComponents 为 40。

5. 如果 numAdComponents > maxAdComponents，则将 numAdComponents 设为 maxAdComponents。

6. 令 adComponentsURNs 为空的由urn组成的列表。

7. 对于 instance 的 嵌套配置中的每个 urn → config 执行：

   1. 如果 numAdComponents 等于 0，则中断。

   2. 将 urn追加到 adComponentsURNs。

   3. 将 numAdComponents 设为 numAdComponents − 1。

8. 返回 adComponentsURNs。

1. 令 document 为 this 的相关全局对象的关联 Document。

2. 如果 document 不是完全活动的，则抛出一个 SecurityError DOMException。

3. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置 实例。

4. 如果 instance 为 null，则返回。

5. 如果 instance 的is ad component 为 true，则 返回。

6. 如果 instance 的围栏框架报告器 为 null，则返回。

7. 令 request initiator 为 this 的相关设置对象的源。

8. 令 initiator referrer policy 为 document 的策略容器的referrer 策略。

9. 如果 event 是一个 DOMString：

   1. 如果 this 的相关设置对象的源与 instance 的映射 url的源不是同源，则返回。

   2. 使用 instance 的围栏框架 报告器和 event 运行报告私有聚合 事件。

10. 如果 event 是一个 FenceEvent：

    1. 如果 event 的 eventType 以 "reserved." 开头，则 返回。

    2. 如果以下所有条件都为 true：

       • this 的相关设置对象的源与 instance 的映射 url的源不是同源；

       • event 的 crossOriginExposed 为 false，或 instance 的 允许跨源 报告为 false；

       则返回。

    3. 如果 event 具有 destinationURL：

       1. 如果 event 具有 destination 或 eventType 或 eventData：

          1. 抛出一个 TypeError。

       2. 令 destinationURL 为对 destinationURL 运行URL 解析器的结果。

       3. 如果以下任一条件成立，则抛出一个 TypeError：

          • destinationURL 为 failure；

          • destinationURL 的scheme 不是 "https"；

       4. 使用 instance 的围栏 框架报告器、buyer、 request initiator、initiator referrer policy，以及一个目标 URL 事件运行报告事件，该事件是 event 的 destinationURL。

    4. 否则：

       1. 如果 event 不具有 destination 或 event 不具有 eventType：

          1. 抛出一个 TypeError。

       2. 令 attributionReportingEnabled 为确定 document 是否被允许使用 "attribution-reporting" 特性的结果。

       3. 令 attributionReportingContextOrigin 为 document 的上下文源。

       4. 对于 event 的 destination 中的每个 destination 执行：

          1. 使用 instance 的围栏 框架报告器、destination、request initiator、initiator referrer policy，以及一个 目标 枚举事件运行报告事件，该事件具有以下项：

             类型

             event 的 eventType

             数据

             event 的 eventData （若未定义则为空字符串）。

          attributionReportingEnabled

          attributionReportingEnabled

          attributionReportingContextOrigin

          attributionReportingContextOrigin

1. 如果 this 的相关全局对象的关联 Document不是完全活动的，则抛出一个 SecurityError DOMException。

2. 如果 event 不具有 destination 或 event 不具有 eventType：

   1. 抛出一个 TypeError。

3. 如果 event 的 eventType 与任何自动 beacon 事件类型 值都不匹配，则返回。

4. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置 实例。

5. 如果 instance 为 null，则返回。

6. 如果 this 的相关设置对象的源与 instance 的映射 url的源不是同源，且 event 的 crossOriginExposed 为 false，则返回。

7. 如果 instance 的围栏框架报告器 为 null，则返回。

8. 将 this 的相关全局对象的关联 Document的自动 beacon 数据 映射[event 的 eventType] 设为一个自动 beacon 数据，具有以下 项：

   eventData

   如果已定义且 instance 的is ad component 为 false，则为 event 的 eventData， 否则为空字符串。

   destination

   event 的 destination

   once

   event 的 once

   crossOriginExposed

   event 的 crossOriginExposed

1. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置 实例。

2. 如果 instance 为 null，则返回。

3. 如果 this 的相关设置对象的源与 instance 的映射 url的源不是同源，则返回。

4. 如果 instance 的嵌套配置为 null，则 返回。

5. 令 results 为空的由 FencedFrameConfig 组成的列表。

6. 对于 instance 的嵌套配置中的每个 urn → config 执行：

   1. 令 newConfig 为在 this 的相关 Realm 中创建的一个新的 FencedFrameConfig 对象，具有以下内容：

      urn

      urn

      sharedStorageContext

      config 的嵌入者 shared storage 上下文

   2. 将 newConfig追加到 results。

7. 返回 results。

1. 如果 this 的相关全局对象的关联 Document不是完全活动的，则抛出一个 SecurityError DOMException。

2. 令 navigable 为 this 的相关全局对象的可导航体。

3. 如果满足以下任一条件，则抛出一个 SecurityError DOMException：

   • navigable 不是一个围栏可导航体；

   • event 的 isTrusted 为 false；

   • event 的dispatch flag 未设置；

   • event 的 type 不是 "click"

4. 如果 this 的相关全局对象没有瞬态激活，则返回。

5. 消耗 this 的相关全局对象的用户激活。

6. 令 parentNavigable 为 navigable 的非围栏 父级。

7. 在给定 parentNavigable 的 活动 window 的情况下，在DOM 操作任务源上排入一个全局任务来运行这些步骤：

   1. 执行激活通知步骤。

   2. 在 navigable 的 围栏可导航体容器上触发一个事件，其名称为 "fencedtreeclick"。 将该事件的 bubbles 和 cancelable 属性初始化为 true。在运行 内部事件创建 步骤时，将 time 设为一个实现定义的值，该值在此方法的所有调用中保持 一致。

1. 令 p 为一个新的 promise。

2. 如果 this 的相关全局对象的关联 Document不是完全活动的，则抛出一个 SecurityError DOMException。

3. 令 instance 为 this 的相关全局对象的浏览上下文的 围栏框架配置 实例。

4. 如果 instance 为 null，则返回。

5. 如果相关设置对象的源与 instance 的映射 url的源不是同源，则用 TypeError拒绝 p。

6. 如果 this 的相关全局对象的可导航体的可遍历可导航体不是一个围栏可导航体，则用 undefined解析 p 并返回 p。

7. 令 global 为 this 的相关全局对象。

8. 令 settings 为 this 的相关设置对象。

9. 对于每个相关全局对象为 global 的 WebSocket 对象 webSocket 执行：给定 webSocket，运行使 WebSocket 连接失败。

10. 对于每个相关全局对象为 global 的 WebTransport 对象 webTransport 执行：用一个新创建的 WebTransportError 清理 webTransport，该错误的 source 为 "session"。

    注： 不传入 WebTransportCloseInfo 可确保 WebTransport 对象被 设为 "failed" 状态，而不是 "closed" 状态。

11. 并行地运行以下步骤：

    1. 令 fencedFrameNonce 为 instance 的分区 nonce。

    2. 令 credentiallessNonce 为 global 的页面 credentialless nonce。

    3. 以 settings 对 fencedFrameNonce 调用撤销分区 nonce 的网络。

    4. 如果 credentiallessNonce 非 null，则以 settings 对 credentiallessNonce 调用撤销分区 nonce 的网络。

    5. 将 instance 的不受信任 网络状态设为disabled for this tree。

    6. 令 promises 为 instance 的网络 禁用时 promise。

    7. 如果 promises[global] 存在，则将 p追加到 promises[global]。

       否则，设置 promises[global] 为列表 « p »。

    8. 给定 global 的浏览上下文的顶级可遍历体，重新计算 所有围栏框架后代的不受信任网络状态。

12. 返回 p。

1. 断言：这是并行地运行。

2. 令 navigables 为 topLevelTraversable 的活动 document的 包含后代可导航体，其中 unfenced 设为 true。

3. 令 navigablesWithNetworkChildren 为由围栏可导航体组成的集合，初始为 空。

4. 当 navigables 不为空时循环：

   1. 令 currentNavigable 为从 navigables 弹出的 结果。

   2. 令 ongoingNavigation 为 currentNavigable 的进行中的导航。

   3. 如果 currentNavigable 不是一个围栏可导航体：

      1. 如果 ongoingNavigation 非 null：

         1. 令 ancestorFencedRoot 为 currentNavigable 的可遍历可导航体。

         2. 如果 ancestorFencedRoot 是一个围栏 可导航体， 则将 ancestorFencedRoot追加到 navigablesWithNetworkChildren。

      2. 继续。

   4. 令 config 为 currentNavigable 的活动浏览上下文的围栏框架配置 实例。

   5. 如果 config 的不受信任 网络状态为disabled for this tree and fenced subtrees，且 ongoingNavigation 为 null， 则继续。

   6. 如果 navigablesWithNetworkChildren 不包含 currentNavigable，且 config 的不受信任 网络状态 为disabled for this tree，则令 networkCutoffReady 为 true；否则为 false。

      注： 当某个围栏可导航体 是另一个被确定为尚未准备好进行网络切断的围栏框架的非围栏祖先时，它会被添加到 navigablesWithNetworkChildren。

   7. 如果 networkCutoffReady 为 true：

      1. 将 config 的不受信任 网络状态设为disabled for this tree and fenced subtrees。

         注： 此时，任何受不受信任网络已禁用这一条件限制的 API 都可以立即使用，即使 promise 尚未完成解析。

      2. 对于 config 的网络 禁用时 promise中的每个 global → promises 执行：

         1. 对于 promises 中的每个 promise 执行：

            1. 在给定 global 的情况下，在DOM 操作 任务源上排入一个全局任务，以 使用 undefined解析 promise。

      3. 清空 config 的网络 禁用时 promise。

   8. 如果 networkCutoffReady 为 false 或 ongoingNavigation 非 null：

      1. 令 ancestorFencedRoot 为 currentNavigable 的非围栏父级的可遍历可导航体。

      2. 如果 ancestorFencedRoot 是一个围栏 可导航体， 则将 ancestorFencedRoot追加到 navigablesWithNetworkChildren。

注： Chromium 内部的 Web 平台测试可在 third_party/blink/web_tests/wpt_internal/fenced_frame/disable-untrusted-network-ongoing-navigation.https.html 获取。 一旦 WICG/fenced-frame#192 解决，它将被上游化并在此处链接。

给定 removedNode， iframe 的HTML 元素移除步骤 为：

1. 令 topLevelTraversable 为 removedNode 的内容可导航体的 顶级可遍历体。

2. 给定 removedNode，销毁子可导航体。

3. 并行地，给定 topLevelTraversable，重新计算 所有围栏框架后代的不受信任网络状态。

3. 如果 newValue 为 null，则并行地，给定该 navigable 的 顶级可遍历体，重新计算 所有围栏框架后代的不受信任网络状态。

1. 断言：这是并行地运行。

2. 将 nonce追加到用户代理的网络撤销 nonce 集。

3. 终止 settings 的fetch 组。

1. 令 key 为对 request 运行确定网络分区 键的结果。

2. 令 nonce 为 key 的nonce。

3. 如果用户代理的网络撤销豁免 映射[nonce] 存在，且 request 的URL存在于 其中，则返回 allowed。

4. 如果用户代理的网络撤销 nonce 集包含 nonce，则返回 blocked。

5. 返回 allowed。

If should request be blocked due to a bad port, should fetching request be blocked as mixed content, or should request be blocked by Content Security Policy returns blocked, then set response to a network error.

在 "should request be blocked by Content Security Policy" 之后的条件中添加“必须因被撤销的 分区 nonce 而被阻止”。

这需要同时传入 围栏框架 nonce 以及 iframe credentialless nonce（如果存在）。 (WICG/fenced-frame#191)

1. 令 nonce 为 key 的nonce。

2. 如果用户代理的网络撤销豁免 映射[nonce] 存在，但 网络撤销豁免 映射[nonce][yrl] 不存在，则：

   1. 如果用户代理的网络撤销 nonce 集包含 nonce，则返回 failure。

在第 1 步之前插入以下步骤：

1. 令 nonce 为 key 的nonce。

2. 如果用户代理的网络撤销豁免 映射[nonce] 存在，但 网络撤销豁免 映射[nonce][url] 不存在，则：

   1. 如果用户代理的网络撤销 nonce 集包含 nonce，则返回 failure。

11. 如果给定 client 的全局对象的 可导航体运行确定可导航体是否已为自身撤销网络的结果为 true，则使 WebSocket 连接失败。

5. 如果以下任一条件为 true：

   • 使用 request 运行请求是否应被 Content Security Policy 阻止？返回 "Blocked"；

   • 使用 request 运行请求是否应因坏端口而被阻止返回 "blocked"；

   • 给定 client 的全局对象的可导航体运行确定可导航体是否已为自身撤销网络 返回 true；

   则中止剩余步骤，并使用 transport排入一个网络任务以运行这些步骤：

2. 如果 context 是一个 Document， 且给定 context 的节点可导航体运行确定可导航体是否已为自身撤销网络的结果为 true，则返回。

4. 如果确定 request 是否必须因被撤销的 分区 nonce 而阻止的结果为 false，则并行地，为 parsedExchange 和 report 等待并排队报告。

A user agent should set value to the first matching statement, if any, switching on request’s destination:

将 "fencedframe" 添加到 switch cases 中，与 "document"、 "frame" 和 "iframe" 并列。

1. 如果 navigable 的可遍历可导航体不是一个围栏可导航体，则返回 false。

2. 令 config 为 navigable 的活动浏览上下文的围栏框架配置 实例。

3. 如果 config 的不受信任网络 状态不是disabled for this tree and fenced subtrees，则返回 false。

4. 返回 true。

1. 如果 navigable 的可遍历可导航体不是一个围栏可导航体，则返回 false。

2. 令 config 为 navigable 的活动浏览上下文的围栏框架配置 实例。

3. 如果 config 的不受信任网络 状态为enabled，则返回 false。

4. 返回 true。

1. 如果 sourceSnapshotParams 的目标围栏框架 配置为 null，则 返回 false。

   其意图是 sourceSnapshotParams 的目标围栏框架 配置对于嵌入者发起的 fencedframe 导航应为非 null，而在其他情况下为 null。 然而，在此议题 解决之前，这一点并不成立。

2. 如果 navigable 的可遍历可导航体的非围栏父级为 null，则返回 false。

   注： 当 navigable 的可遍历可导航体的非围栏父级为 null 时，随着 navigable 的围栏 可导航体容器被销毁， navigable 将停止加载。

3. 如果以下所有条件为 true：

   • 给定 navigable 运行确定可导航体是否已为自身撤销网络的结果为 true；且

   • 给定 navigable 的可遍历可导航体的非围栏父级运行确定可导航体是否已为自身撤销网络的结果为 true，

     注： 算法确定可导航体是否已为自身撤销网络会在 navigable 以及 navigable 的可遍历可导航体的非围栏父级上运行。这是 因为父围栏框架能够导航一个已经禁用不受信任网络访问的 子围栏框架。如果父围栏 框架在子围栏框架导航刚发起后立即禁用不受信任网络访问， 则该导航必须被阻止。因此该算法必须同时在 父级和子级上运行。否则，如果允许导航提交，父围栏 框架将禁用不受信任网络访问，但子围栏框架不会。

   则返回 true。

4. 否则，返回 false。

1. 如果 targetDocument 的节点可导航体的可遍历可导航体不是一个顶级可遍历体，则中止这些步骤。

2. 如果 sourceSnapshotParams 的具有瞬态激活被设为 false，则中止这些步骤。

3. 令 config 为 sourceSnapshotParams 的发起者围栏 框架配置实例。

4. 如果 config 为 null，则中止这些步骤。

   注： 由于此算法会无条件地针对所有导航调用， 这用于捕获到顶级可遍历体的导航并非源自 fencedframe 的情况。

5. 如果 config 的is ad component 为 false，则令 request initiator 为 sourceOrigin；否则为 sourceSnapshotParams 的发起者祖先根 源。

6. 如果 config 的is ad component 为 false，则令 initiator referrer policy 为 sourceSnapshotParams 的源策略容器的referrer 策略；否则为 sourceSnapshotParams 的发起者 祖先根 referrer 策略。

7. 如果 sourceOrigin 与 config 的映射 url的源不是同源，则令 isCrossOrigin 为 true；否则为 false。

8. 如果 isCrossOrigin 为 false，则令 beaconMapping 为 sourceSnapshotParams 的快照自动 beacon 存储的数据映射； 否则为 sourceSnapshotParams 的快照自动 beacon 存储的 跨源 暴露数据映射。

9. 令 beaconData 为 beaconMapping[eventType]。

10. 令 automaticBeaconsAllowed 为 sourceSnapshotParams 的允许自动 beacon。

    注： 这会跟踪是否通过 `Allow-Fenced-Frame-Automatic-Beacons` 标头进行了选择加入。当此值为 false 时，对于同源 document 或通过设置数据选择加入的 document， 仍然可以发送自动 beacon。

11. 如果 beaconData 为 null 且 automaticBeaconsAllowed 为 false，则中止这些 步骤。

12. 如果 isCrossOrigin 为 true 且 automaticBeaconsAllowed 为 false，则中止这些 步骤。

13. 对于 config 的围栏框架报告器的 围栏框架 报告元数据引用的 围栏框架报告映射的键中的每个 destination 执行：

    1. 使用 config 的围栏框架 报告器、destination、request initiator、 initiator referrer policy，以及一个 自动 beacon 事件运行报告 事件，该事件具有以下项：

       类型

       eventType

       数据

       如果 beaconData 为 null，则为空字符串；否则为 beaconData 的eventData。

       attributionReportingEnabled

       sourceSnapshotParams 的已启用 attribution reporting

       attributionReportingContextOrigin

       sourceSnapshotParams 的attribution reporting 上下文源

14. 如果 beaconData 的once 为 true，则将 beaconMapping[eventType] 设为 null。

5. 给定 sourceSnapshotParams、initiatorOriginSnapshot、 navigable 关联的 Document 和 reserved.top_navigation_start，尝试发送自动 beacon。

6. 如果 failure 为 false，则：

   1. 给定 sourceSnapshotParams、entry 的document state 的发起者源、 document 和 reserved.top_navigation_commit，尝试发送自动 beacon。

   2. 给定 sourceSnapshotParams、entry 的document state 的发起者源、 document 和 reserved.top_navigation，尝试发送自动 beacon。

1. 如果 this 的浏览上下文的围栏框架配置 实例 非 null，则返回 this 的 fence。

2. 返回 null。

• If creator is non-null, then:

改为使用更严格的条件：

• If creator is non-null and embedder is not a fencedframe element, then:

注： 这是因为我们需要确保不会跨围栏框架 边界泄露 creator 的referrer、源、document 基 URL、策略容器。

向此算法第 4 步（上面已修改）添加一个子步骤，内容为：

4. 将 browsingContext 的围栏框架配置 实例设置为 creator 的浏览上下文的围栏框架配置 实例。

重写第 3 步，内容为：

3. 如果 responseURL 为本地，initiatorPolicyContainer 不是 null，且 fenced 为 false， 则返回 initiatorPolicyContainer 的一个克隆。

注： 我们不需要修改 responseURL 是 about:srcdoc 的情况， 因为围栏框架不支持导航到 about:srcdoc。

23. 如果 navigable 是一个围栏可导航体，则令 fenced 为 true； 否则为 false。

    注： 这确保无论发起者 Document 是 navigable 的活动 document 还是其非围栏 父级，fenced 都为 true。

重写第 23 步（现在是第 24 步），内容为：

24. 令 resultPolicyContainer 为给定 response 的URL、 entry 的document state的历史策略容器、 sourceSnapshotParams 的源策略容器、null、 responsePolicyContainer 和 fenced，确定导航参数 策略容器的结果。

1. 如果 navigable 是一个子可导航体，则返回 navigable 的父级。

2. 断言：navigable 是一个围栏可导航体。

3. 返回 navigable 的非围栏父级。

注： 此算法与可遍历可导航体的非围栏父级 getter 不同，因为此 算法首先会在 navigable 是普通子可导航体时，尝试获取该可导航体的 普通父级。

1. 令 parentNavigable 为 navigable 的非围栏 父级。

2. 返回 parentNavigable 的活动 document。

1. 给定 documentState，初始化可导航体 traversable。

2. 将 traversable 的非围栏父级设置为 parent。

1. 令 group 为一个新的浏览上下文组。

注： 似乎没有理由像创建新的浏览上下文组和 document那样，将 group追加到用户代理的浏览上下文组集合。

1. 令 document 为给定 element 的节点 document、element 和 group，运行创建新的浏览上下文和 document 的第二个返回值。

2. 令 documentState 为一个新的document state，其document 是 document。

3. 令 traversable 为一个新的可遍历可导航体。

4. 令 parentNavigable 为 element 的节点可导航体。

5. 给定 documentState 和 parentNavigable，初始化嵌套可遍历体 traversable。

6. 将 element 的围栏可导航体设置为 traversable。

7. 令 initialHistoryEntry 为 traversable 的活动会话历史条目。

8. 将 initialHistoryEntry 的step 设为 0。

9. 将 initialHistoryEntry追加到 traversable 的会话历史条目中。

10. 返回 traversable。

1. 令 navigable 为 inputNavigable。

2. 循环：

   1. 如果 navigable 的父级和非围栏父级均为 null，则中断。

   2. 将 navigable 设为 navigable 的父级或非围栏父级，取其中 非 null 的那个。

      注： 此处 navigable 的父级或非围栏父级中恰好有一个 为非 null。

3. 返回 navigable。

进一步将此算法的第 2 步重写为：

2. 用 document 的 后代可导航体扩展 navigables，其中 unfenced 设为 unfenced。

1. 令 navigables 为一个新的列表。

2. 令 navigableContainers 为一个列表，其中包含 document 的所有包含影树的后代中，作为可导航体容器的那些元素（如果 unfenced 为 true，则还包括围栏 可导航体容器），按包含影树的树序排列。

3. 对于 navigableContainers 中的每个 navigableContainer 执行：

   1. 如果 navigableContainer 的内容可导航体和围栏可导航体均为 null，则继续。

   2. 令 descendantNavigable 为 navigableContainer 的内容可导航体或围栏可导航体， 取其中非 null 的那个。

   3. 用 descendantNavigable 的活动 document的 包含后代可导航体扩展 navigables， 其中 unfenced 设为 unfenced。

4. 返回 navigables。

1. 令 navigable 为 document 的节点可导航体的父级。

2. 如果 navigable 为 null 且 unfenced 为 true，则将 navigable 设为 document 的 节点可导航体的可遍历可导航体的非围栏父级。

3. 令 ancestors 为空列表。

4. 当 navigable 不是 null 时：

   1. 将 navigable前置到 ancestors。

   2. 将 navigable 设为 navigable 的父级。

   3. 如果 navigable 为 null 且 unfenced 为 true，则将 navigable 设为 navigable 的可遍历可导航体的非围栏父级。

5. 返回 ancestors。

在算法第 3 步（会改变新的焦点目标）之后添加一个新步骤，内容为：

3. 如果 new focus target 是一个围栏可导航体容器，且具有非 null 的 围栏可导航体，则将 new focus target 设为该 围栏可导航体的活动 document。

在定义 new chain 变量的步骤之后添加一个新步骤，内容为：

9. 如果 unfenced 为 false，new chain 包含一个 Document document，其节点可导航体的可遍历可导航体是一个 围栏可导航体，且 old chain 并不也 包含 document，则返回。

   注： 这就是在焦点尝试跨越围栏时，我们如何在调用 焦点更新步骤之前提前退出。

修改聚焦步骤中算法步骤之后的用户代理句子，使其内容为：

每当用户尝试将焦点移动到 candidate 时，用户代理必须立即对一个可聚焦区域或 可导航体 candidate 运行聚焦步骤，并将 unfenced 设为 true。

1. 对该元素运行聚焦步骤，并将 unfenced 设为 true。

2. 在该元素上触发一个 click 事件。

当用户激活一个点击可聚焦的可聚焦区域时，用户代理必须 对该可聚焦区域运行聚焦步骤，并将 focus trigger 设为 "click"，且将 unfenced 设为 true。

10. 如果 previouslyFocusedElement 不是 null，则：

    1. 将 element 的先前聚焦元素设为 null。

    2. 如果 focusPreviousElement 为 true，则对 previouslyFocusedElement 运行聚焦步骤，并将 unfenced 设为 true；执行此步骤时不应滚动 视口。

注： 尽管手动关闭 popover 是一个 用户发起的手势， 聚焦步骤仍会在 unfenced 设为 false 的情况下被调用， 无论这是通过用户手势调用还是通过脚本调用。

• 用户代理可以在此过程中通过为该元素运行 聚焦步骤来聚焦其中一个元素，并且可以改变 document 的滚动位置，或者执行其他某种将该元素引起用户注意的操作。 如果这些步骤是由用户手势调用的，则聚焦步骤可以在 unfenced 设为 true 的情况下调用。对于 与表单关联的自定义元素，用户代理 应改为使用其FACE 验证锚点， 以用于这些操作的目的。

3. 如果 candidate 的聚焦区域是一个围栏可导航体容器，且具有一个非 null 的 围栏可导航体，则将 candidate 设为该围栏 可导航体容器的围栏可导航体的 活动 document。

3. 如果 currentObject 是一个可聚焦区域，则将 currentObject 设为 currentObject 的DOM 锚点的节点 document。

   否则，如果 currentObject 是一个 Document， 其节点可导航体的父级 非 null，则将 currentObject 设为 currentObject 的节点可导航体的 父级。

   否则，如果 currentObject 是一个 Document， 其节点可导航体是一个可遍历可导航体，且其非围栏父级非 null，则 将 currentObject 设为 currentObject 的节点可导航体的非围栏父级。

   否则，中断。

如果 focus target 是一个围栏可导航体容器，且具有非 null 的 围栏可导航体

返回该围栏可导航体容器的围栏可导航体的活动 document。

注： 此算法可以无条件“跳过围栏” 边界，因为其返回值总是 会输入到一个确实会谨慎考虑围栏边界的算法中。

3. 当 candidate 的聚焦区域是一个具有 非 null 内容可导航体的可导航体容器，或是一个具有 非 null 围栏可导航体的围栏 可导航体容器时循环：将 candidate 设为该可导航体容器的内容可导航体，或该围栏 可导航体容器的围栏可导航体的 活动 document，取其中非 null 的那个。

6. 如果 candidate 不是 null，则对 candidate 运行聚焦步骤，并将 unfenced 设为 true，然后返回。

修改顺序焦点导航算法的第 9 步，使其内容为：

9. 否则，starting point 是一个可聚焦区域，其节点 document的节点可导航体是一个子可导航体或围栏可导航体。将 starting point 设为该节点可导航体的非围栏 父级，并返回到 标记为 loop 的步骤。

2. 如果 candidate 是一个可导航体容器，且具有非 null 的 内容可导航体，则令 new candidate 为使用 candidate 的 内容可导航体作为第一个参数、 direction 作为 第二个参数，并以 sequential 作为第三个参数运行 顺序导航搜索 算法的结果。

   如果 candidate 是一个围栏可导航体容器，且具有非 null 的 围栏可导航体，则令 new candidate 为使用 candidate 的 围栏可导航体作为第一个 参数、 direction 作为第二个参数，并以 sequential 作为第三个参数运行 顺序导航搜索 算法的结果。

   如果 new candidate 为 null，则令 starting point 为 candidate，并返回到此算法的开头。否则，令 candidate 为 new candidate。

8. 否则，如果以下所有条件为 true：

   • navigationParams 的可导航体的可遍历可导航体是 一个围栏可导航体；

   • navigationParams 的响应的URL的scheme为 "https"；且

   • 为 navigationParams 的响应获取支持的加载模式的结果不包含 `fenced-frame`

   则将 failure 设为 true。

• navigable 的容器 document

重写为：

• navigable 的非围栏容器 document

1. 如果 response 不是网络错误，navigable 是一个子可导航体或围栏可导航体，且使用 navigable 的非围栏容器 document的 源、navigable 的非围栏容器 document的相关设置对象、request 的目标、response 和 true 执行跨源资源策略检查的结果为 blocked， 则将 response 设为一个网络错误，并中断。

   注： 这里我们是在针对 非围栏父级可导航体运行跨源资源策略检查，而不是针对 navigable 本身。这是 因为我们关心的是嵌入内容相对于嵌入者上下文的同源性（忽略“围栏”），而不是导航源。

发起者 围栏框架配置实例

一个围栏框架配置实例或 null， 初始为 null。

发起者祖先根 源

一个源或 null，初始为 null。

发起者 祖先根 referrer 策略

一个referrer 策略或 null，初始为 null。

目标围栏框架 配置

一个围栏 框架配置或 null，初始为 null。

注： 发起者围栏框架 配置实例是加载到导航发起者浏览上下文中的围栏框架配置实例，如果存在的话。 对于组件广告，发起者祖先根 源是顶级广告容器的源（如果存在）。对于组件广告，发起者祖先根 referrer 策略是顶级广告容器的 referrer 策略（如果存在）。 如果由 fencedframe 发起的 导航成功，它们会被尝试发送自动 beacon算法用于比较 源，并确定要向哪些 FenceReportingDestination 发送 beacon，以及附带什么 信息。另一方面，目标围栏框架配置是未实例化的围栏框架配置，它会在 以围栏框架为目标的导航中加载到 fencedframe 元素中。 这些字段之间并不会以任何有意义的方式相互交互。

已启用 attribution reporting

一个布尔值。

attribution reporting 上下文源

一个源。

允许自动 beacon

一个布尔值。

快照自动 beacon 存储

一个快照自动 beacon 存储。

1. 断言这些步骤正在 sourceDocument 的事件循环上运行。

2. 令 info 为一个新的空快照自动 beacon 存储。

3. 令 mapping 为 info 的数据映射。

4. 令 crossOriginMapping 为 info 的跨源 暴露数据映射。

5. 令 current navigable 为 sourceDocument 的节点可导航体。

6. 当 current navigable 不是 null 时循环：

   1. 对于 current navigable 的活动 document的自动 beacon 数据 映射中的每个 type → data 执行：

      1. 如果 mapping[type] 不存在，则将 mapping[type] 设为 data。

      注： 这保证了第一个包含特定类型自动 beacon 数据的 祖先可被发起导航的 document 使用。这也会 防止某个祖先阻止 document 使用在更高层祖先中设置的数据。

      1. 如果 crossOriginMapping[type] 不存在，且 data 的crossOriginExposed 为 true，则将 crossOriginMapping[type] 设为 data。

   2. 将 current navigable 设为 current navigable 的父级。

7. 返回 info。

注： 存储在 info 中的映射意在 保存对原始 Document 的 自动 beacon 数据映射的引用，这些映射 被用来构造 info。稍后会在尝试发送自动 beacon中修改这些映射，以清除 任何 once 设为 true 的 beacon 数据。

1. 令 navigable 为 sourceDocument 的节点可导航体。

2. 当 navigable 不是 null 且 navigable 不是围栏可导航体时：

   1. 将 navigable 设为 navigable 的父级。

3. 如果 navigable 为 null，则返回 null。

4. 断言：navigable 是一个围栏可导航体。

5. 将 navigable 设为 navigable 的非围栏 父级。

6. 当 navigable 不是 null 且 navigable 不是围栏可导航体时：

   1. 将 navigable 设为 navigable 的父级。

7. 返回 navigable。

Main frame (origin A)
  <fencedframe> (origin B)
    <iframe> (origin C)
      <fencedframe> (origin D)
        <iframe> (origin E)
          <fencedframe> (origin F)

发起者围栏 框架配置实例

sourceDocument 的浏览上下文的围栏框架配置 实例

发起者祖先根 源

如果在 sourceDocument 上运行获取发起者的围栏 曾祖先的可导航体的结果为 null，则为 null。否则，为 sourceDocument 的发起者的围栏 曾祖先的可导航体的 活动 document的源。

发起者祖先 根 referrer 策略

如果在 sourceDocument 上运行获取发起者的围栏 曾祖先的可导航体的结果为 null，则为 null。否则，为 sourceDocument 的发起者的围栏 曾祖先的可导航体的 活动 document的策略容器的referrer 策略。

已启用 attribution reporting

确定 sourceDocument 是否被允许使用 "attribution-reporting" 特性的结果

attribution reporting 上下文源

sourceDocument 的上下文源

允许自动 beacon

sourceDocument 的允许自动 beacon

快照自动 beacon 存储

在 sourceDocument 上运行快照自动 beacon 数据 映射的结果。

• document 的相关全局对象的可导航体是一个围栏可导航体；

  注： 这确保 fencedframe 内部的所有导航都会以 "replace" 模式进行，无论发起者是谁。

在 [HTML] 的navigate 算法第 5 步之后添加一个步骤，内容为：

6. 如果给定 sourceDocument 的节点可导航体运行确定可导航体是否已为自身撤销网络的结果为 true，则返回。

修改 [HTML] 的navigate 算法第 13 步（"If all of the following are true:"），以 包含以下条件：

• sourceDocument 的节点可导航体不是一个围栏 可导航体容器， 同时 navigable 是一个围栏可导航体。

  注： 这确保嵌入者发起的 导航永远不会触发 fencedframe 内部的片段导航。

将这些步骤插入到第 22 步，即并行地执行的步骤之后，使得 后续内容成为已修补算法中最先并行地运行的步骤：

1. 如果 url 是一个urn uuid 且 navigable 是一个围栏可导航体：

   上述条件没有达到 应有的严格程度。例如，如果一个 fencedframe 使用生成配置的 API 生成一个 FencedFrameConfig， 然后正确猜出该配置的 urn:uuid，那么理论上它可以 通过类似 location API 的方式，将猜出的 urn 作为一个URL传入 navigate 算法， 从而将自身导航到该配置。 这很糟糕，因为 FencedFrameConfig 的目的 是确保只有嵌入者才能通过直接使用配置对象，将 fencedframe 导航到由该配置表示的资源。有关修复此问题的想法，请参见 #194。

   1. 令 config 为在 sourceDocument 的节点可导航体的可遍历可导航体的围栏框架配置 映射中查找配置的结果。

      注： 这可能会“等待” 任意长时间，直到与 urn uuid url 关联的 config 在围栏框架配置 映射中“完成”。这就是为什么此步骤并行地运行。若随后发生任何嵌入者发起的导航，则该导航应 通过通常跟踪进行中的导航的机制被取消。

   2. 将 config 的嵌入者 shared storage 上下文设为 sharedStorageContext。

   3. 断言：sourceSnapshotParams 的目标围栏框架 配置 为 null。

   4. 将 sourceSnapshotParams 的目标围栏框架 配置设为 config。

   5. 断言 config 的映射 url的值是一个 URL，其scheme为 "https"。

   6. 将 url 设为 config 的映射 url的值。

   7. 运行 config 的导航时回调中的步骤。

2. 如果 navigable 是一个围栏可导航体，且 sourceDocument 的节点可导航体位于 navigable 的活动 document的祖先可导航体中，且 unfenced 设为 true：

   1. 令 config 为一个新的围栏框架配置，具有以下项：

      映射 url

      一个具有以下项的结构体：

      值

      url

      可见性

      transparent

      有效 沙盒化标志

      一个具有以下项的结构体：

      值

      默认 围栏框架有效沙盒化标志。

      可见性

      opaque

      有效 启用权限

      null

   2. 断言：sourceSnapshotParams 的目标围栏框架 配置 为 null。

   3. 将 sourceSnapshotParams 的目标围栏框架 配置设为 config。

将以 "Let unloadPromptCanceled be the result of" 开头的步骤重写为：

1. 如果 navigable 是一个围栏可导航体，则令 unloadPromptCanceled 为 false；否则为对 navigable 的 活动 document的包含后代可导航体检查卸载是否被用户取消的结果。

在第 22.8.2 步（Let finalSandboxFlags be the union...）之后添加一个步骤，内容为：

3. 如果 sourceSnapshotParams 的目标围栏框架 配置不是 null， 且如果 sourceSnapshotParams 的目标围栏框架 配置的 有效沙盒化标志 不是 null，则将 finalSandboxFlags 设为 finalSandboxFlags 和 sourceSnapshotParams 的目标围栏框架 配置的有效沙盒化标志的 值之间的并集。

   注： 这确保 finalSandboxFlags 至少与目标围栏框架 配置中定义的有效沙盒化标志 一样严格。被 沙盒化标志阻止？算法中的单独检查会确保 finalSandboxFlags 不会比有效沙盒化标志更严格。

围栏框架配置实例

一个围栏框架配置实例或 null， 初始为 null。

注： 这仅会为 嵌入者发起的 fencedframe 导航设置；如果这样的导航创建了一个新的 Document， 则该成员会转移到新的 围栏可导航体的活动浏览上下文的 围栏框架配置 实例成员。

围栏框架配置实例

如果 sourceSnapshotParams 的目标围栏框架 配置为 null，则为 null；否则，为实例化 sourceSnapshotParams 的 目标围栏框架 配置的结果。

3. 如果 navigationParams 的围栏框架配置 实例不是 null：

   1. 断言：browsingContext 不等于 navigationParams 的可导航体的活动浏览上下文。

      注： 这是因为 嵌入者发起的导航（由 navigationParams 的 围栏框架配置 实例非 null 表示）始终会导致一次 § 3.8.6 浏览上下文组交换。

   2. 将 navigationParams 的围栏框架配置 实例的允许跨源 报告设为在 navigationParams 的响应的 标头列表上，给定 `Allow-Cross-Origin-Event-Reporting` 和 "item"，运行获取结构化字段 值的结果。

   3. 将 browsingContext 的围栏框架配置 实例设为 navigationParams 的围栏框架配置 实例。

在第 9 步之后添加一个新步骤，内容为：

10. 令 automaticBeaconsAllowed 为在 navigationParams 的响应的标头列表上 给定 `Allow-Fenced-Frame-Automatic-Beacons` 和 "item"，运行获取结构化字段值的结果。

进一步重写第 10 步（现在为第 12 步），以返回一个带有额外参数的新 Document：

允许自动 beacon

automaticBeaconsAllowed。

• 给定 navigable 和 sourceSnapshotParams 运行确定 嵌入者发起的围栏框架导航是否应被阻止的结果为 true；

6. 如果以下所有条件为 true：

   • navigable 是一个围栏可导航体；

   • sourceSnapshotParams 的fetch 客户端不是 navigable 的活动 document的相关设置对象；

   • navigationParams 非 null

   则将 navigationParams 的COOP 强制执行结果的需要浏览上下文组切换布尔值设为 true。

   这确实 可行，但我们应考虑使用一种单独机制来完成此事， 而不是搭载在 COOP 机制之上；COOP 机制在设计时并未考虑围栏框架， 并且可能会以给本规范带来不期望副作用的方式演进。

修改下面的段落，以将以下文本替换掉：

• "top" means the top-level traversable of the navigable that the link or script is in,

替换为：

• "top" 指链接或脚本所在可导航体的可遍历可导航体，"outermost top" 指 链接或脚本所在可导航体的顶级可遍历体，

注： 这一更改是必要的，因为本规范 添加了 可遍历可导航体和顶级可遍历体之间的区别，而二者此前 在功能上是等价的。

在下面的表格中，添加一个名为 "Effect in a fenced frame" 的列。此列中所有现有 行的值都与 "ordinary effect" 相同。然后，添加两行，其内容为：

6.5. 否则，如果 name 与 "_unfencedTop" 进行 ASCII 大小写不敏感匹配，且 currentNavigable 的可遍历可导航体是一个围栏可导航体，则将 chosen 设为 currentNavigable 的顶级可遍历体。

3. 如果 request 的目标为 "fencedframe"，且 此指令的 值不包含 "https:"、"https://*:*" 或 "*" 中的任意一个，则返回 "Blocked"。

3. 如果 request 的目标为 "fencedframe"，且 此指令的 值不包含 "https:"、"https://*:*" 或 "*" 中的任意一个， 则返回 "Blocked"。

2. 如果 context 的必需 csp不是 null，且 request 的 目标为 "fencedframe"， 则返回 "Blocked"。

directive-name  = "fenced-frame-src"
directive-value = serialized-source-list

Content-Security-Policy: fenced-frame-src https://example.com/

<fencedframe src="https://example.org/">
</fencedframe>

预请求 检查和 后请求 检查将 与 frame-src 的检查相同。

Content-Security-Policy: connect-src 'self';
                        ...
                        worker-src 'self'

现在将表述为：

Content-Security-Policy: connect-src 'self';
                        ...
                        fenced-frame-src 'self';
                        ...
                        worker-src 'self'

"fenced-frame-src"

1. 返回 << "fenced-frame-src", "frame-src", "child-src", "default-src" >>。

"fencedframe"

1. 返回 fenced-frame-src。

iframe 和 fencedframe 元素分别具有 allow 属性 （iframe： allow； fencedframe： allow）， 其中包含一个ASCII 序列化策略指令。

属性中命名特性的允许列表可以为空；在这种情况下，该允许列表的默认 值为 "src"，它表示 iframe 的 src 属性中 URL 的源，或 fencedframe 的围栏框架配置。

非空时， iframe 的 allow 或 fencedframe 的 allow 属性会在构造 iframe 或 fencedframe 的 容器策略时，为每个受支持特性添加一个允许列表。

给定一个围栏可导航体容器（container）和 一个源（origin），此算法 返回一个新的权限策略。

1. 令 fencedFrameConfig 为 container 的节点 document的活动浏览上下文的围栏框架配置 实例。

2. 令 inheritedPolicy 为一个新的有序 映射。

3. 如果 fencedFrameConfig 不是 null，且 fencedFrameConfig 的权限策略 行为为fixed，则：

   1. 对于每个受支持的 feature 执行：

      1. 如果 fencedFrameConfig 的有效 启用权限 包含 feature，则将 inheritedPolicy[feature] 设为 "Enabled"。

         否则，将 inheritedPolicy[feature] 设为 "Disabled"。

      注： 虽然这没有将 allow 属性纳入考虑，但由于导航请求的导航响应是否应被权限策略阻止？， 在调用这里之前它已经被检查过了。任何在 allow 中指定的过于严格的策略都会导致围栏框架不加载， 而任何比有效启用 权限中指定的内容更宽松的策略都将被忽略。

4. 否则：

   1. 对于每个受支持的 feature 执行：

      1. 如果 feature 匹配围栏框架允许 权限之一，则将 inheritedPolicy[feature] 设为给定 feature、 container 和 origin 运行为容器中某源处的特性定义继承策略的结果。

         否则，将 inheritedPolicy[feature] 设为 "Disabled"。

5. 令 policy 为一个新的权限策略，其继承策略为 inheritedPolicy，且声明策略初始化为两个新的 有序映射。

6. 返回 policy。

给定 null 或一个元素（container）、一个源（origin），以及一个默认值为 false 的可选布尔值 matchAll，此算法返回一个新的权限策略。

将第 1 步重写为：

1. 断言：如果非 null，container 要么是可导航体容器，要么是 围栏可导航体容器。

将第 3 步重写为：

4. 对于每个受支持的 feature 执行：

   1. 令 isInherited 为在 feature、container、 origin 和 matchAll 上运行为容器中某源处的特性定义继承策略的结果。

   2. 将 inherited policy[feature] 设为 isInherited。

给定 null、一个可导航体容器或围栏可导航体 容器（container）、一个 源（origin），以及一个响应 （response），此算法返回一个 新的权限策略。

将第 1 步重写为：

1. 如果 container 是一个围栏可导航体容器，则令 policy 为给定 container 和 origin 运行 为围栏可导航体创建权限策略的结果。

   否则，令 policy 为给定 container 和 origin 运行为可导航体创建权限策略的结果。

1. 如果 element 不是 iframe 元素，也不是 fencedframe 元素，则 返回一个空的策略指令。

• 给定 navigationParams 运行导航 请求的导航响应是否应被权限策略阻止？的结果为 "Blocked"；

• 给定 navigationParams 和 sourceSnapshotParams 运行导航 请求的导航响应是否应被沙盒化标志阻止？的结果为 "Blocked"；

注： 如果这些算法中的任意一个返回 "Blocked"，则 fencedframe 中已有的 Document 不会继续保留；将加载错误页面。

给定一个导航参数（navigationParams），此算法 返回 "Blocked" 或 "Allowed"：

1. 令 navigable 为 navigationParams 的可导航体。

2. 如果 navigable 不是一个围栏可导航体，则返回 "Allowed"。

3. 令 origin 为 navigationParams 的源。

4. 令 effective permissions 为 navigable 的活动浏览上下文的 围栏框架配置 实例的有效启用 权限。

   根据 pull request #84 中省略的工作，配置实例 此时尚未赋值给浏览上下文。我们应考虑把该实例存储在 navigationParams 中，并改为从这里引用它。

5. 令 permissionsPolicy 为给定 navigable 的围栏 可导航体容器、origin 和 true 创建权限策略的结果。

   注： 这几乎等同于在导航构造此待定导航的最终 Document 时将会被创建的权限策略。区别在于，此算法就像在 iframe 上调用时一样， 会包含 allow 属性中指定的所有权限，即使该权限未在围栏框架配置的有效启用 权限中指定。我们现在创建它并对其运行 测试，因为这是确定导航是否会失败的适当时机，然后 将其丢弃。如果导航成功，它将被重新创建并无条件安装 到 Document 上。 但是，重新创建时不会包含任何未包含在有效启用 权限中的额外启用权限， 从而有效地将启用权限锁定为有效启用 权限中指定的内容。

6. 令 inheritedPolicy 为 permissionsPolicy 的继承策略。

7. 对于 effective permissions 中的每个 effective permission 执行：

   1. 如果 inheritedPolicy[effective permission] 为 "Disabled"，则返回 "Blocked"。

8. 返回 "Allowed"。

给定一个导航参数（navigationParams）和一个源快照参数 （sourceSnapshotParams），此算法返回 "Blocked" 或 "Allowed"：

1. 令 navigable 为 navigationParams 的可导航体。

2. 如果 navigable 不是一个围栏可导航体，则返回 "Allowed"。

3. 令 effectiveSandboxingFlags 为 sourceSnapshotParams 的目标围栏框架 配置的有效沙盒化标志。

4. 如果 navigationParams 的最终沙盒化标志集不是 effectiveSandboxingFlags 的子集，则返回 "Blocked"。

   注： 这意味着最终沙盒化标志集不能限制一个在有效沙盒化 标志中尚未受限的特性，因为额外限制可被用作通信信道。到这个 时点，最终沙盒化标志集将已经被设为 至少与有效沙盒化 标志一样严格的内容。

5. 否则，返回 "Allowed"。

给定一个特性（feature）、null 或一个可导航体容器（container）、该容器中一个 document 的源（origin），以及一个默认值为 false 的可选布尔值 matchAll， 此算法返回该特性的继承策略。

将第 3 步重写为：

3. 如果在 feature、 container 的节点 document、origin 和 matchAll 上执行特性是否在 document 中对某源启用？的结果为 "Disabled"，则返回 "Disabled"。

注： 我们不必重写第 2 步；该步骤也 委托给同一个算法，以传入 matchAll 布尔值，因为第 2 步涉及检查 feature 是否已在 container 的节点 document中启用，而不是在 container 内部托管的 Document 中启用。

将第 7 步重写为：

7. 如果 matchAll 为 false，feature 的默认允许列表为 'self'，且 origin 与 container 的节点 document的 origin 同源，则返回 "Enabled"。

给定一个特性（feature）、一个 Document 对象（document）、一个源 （origin），以及 一个默认值为 false 的可选布尔值 matchAll，如果 feature 应被视为禁用，则此算法返回 "Disabled"，否则返回 "Enabled"。

将第 3 步重写为：

3. 如果 feature 存在于 policy 的声明策略中，

   1. 如果 matchAll 为 false，且 policy 的 声明策略中 feature 的允许列表匹配 origin，则返回 "Enabled"。

   2. 否则，如果 matchAll 为 true，且 policy 的 声明策略中 feature 的允许列表是特殊值 *，则返回 "Enabled"。

   3. 否则，返回 "Disabled"。

将第 5 步重写为：

5. 如果 matchAll 为 false，feature 的默认允许列表为 'self'，且 origin 与 document 的 origin 同源，则返回 "Enabled"。

4. 如果 node 的节点 document的浏览上下文的围栏框架配置 实例不是 null，则返回 node 的节点 document的 浏览上下文的围栏框架配置 实例的映射 url。

注： 这确保在使用围栏框架配置导航 fencedframe （或使用映射到围栏 框架配置的 urn 导航 iframe）时， 可在 allow 属性中设置的 'src' 允许列表能够生效。

14. 如果 scrolling box 关联的 Element 关联的 Document 的 节点可导航体的可遍历可导航体是一个围栏可导航体，或者如果 scrolling box 关联的视口关联的 Document 的 节点可导航体的可遍历可导航体是一个围栏可导航体，则令 这成为该算法的最后一个实例，并停止原本会继续执行的 任何进一步递归实例。

注： 这允许滚动“向上冒泡”到 围栏框架边界，但不跨越该边界。

1. 如果 credentialless 为 true，则返回关联浏览上下文的顶级浏览上下文的页面 credentialless nonce。

2. 如果 newFencedFrameNonce 不是 null，则返回 newFencedFrameNonce。

3. 令 instance 为关联浏览上下文的围栏框架配置 实例。

4. 如果 instance 不是 null，则返回 instance 的分区 nonce，否则返回 null。

网络分区键是一个由以下内容组成的元组：

• 一个站点。

• null 或一个实现定义的值。

• 一个 nonce（null 或一个实现定义的值）。

在通过获取创建导航参数中，在第 18 步和第 19 步之间添加一个 新步骤，其内容为：

19. 令 partitionNonce 为在 browsingContext 上运行计算有效 分区 nonce的结果，给定在 browsingContext 上计算导航的 credentialless 标志的结果，以及 null。

注： 我们在此处向计算有效 分区 nonce传入 null，是因为 我们希望源自围栏框架的导航获取使用与围栏框架自身相同的分区。 在导航获取完成并初始化 document 后，我们可以通过围栏框架配置实例的 分区 nonce访问正确的分区 nonce。

将第 19 步重新编号为第 20 步，并将第 20.2.4 步重写为：

4. 将 request 的保留客户端设为一个新的环境，其 id 是一个唯一不透明字符串，目标浏览上下文是 navigable 的活动浏览上下文，创建 URL是 currentURL，顶级创建 URL是 topLevelCreationURL，顶级源是 topLevelOrigin，且分区 nonce是 partitionNonce.

6.9. 令 partitionNonce 为在 browsingContext 上计算有效 分区 nonce的结果，给定 navigationParams 的 credentialless，以及如果 navigationParams 的围栏框架配置实例为 null，则为 null，否则为 navigationParams 的围栏框架配置实例的分区 nonce。

1. 令 navigable 为 this 的相关全局对象的可导航体。

2. 如果 navigable 不是 null，且 navigable 的可遍历可导航体是一个围栏可导航体，则抛出一个 NotAllowedError DOMException。