ドキュメントポリシー

给定一个字典（header），如果可以将其解析为文档 策略，则此算法返回该策略，否则失败。

1. 如果 header 为 null，则返回 null。

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

3. 令 defaultEndpoint 为一个新的字符串，设置为 null。

4. 对于 header 中的每个 name->(value,parameters)，

   1. 令 currentEndpoint 为一个新的字符串，设置为 null。

   2. 如果 parameters["report-to"] 存在并且是字符串，则：

      1. 将 currentEndpoint 设置为 parameters["report-to"] 的值。

   3. 如果 name 是字符串 "*"，则：

      1. 将 defaultEndpoint 设置为 currentEndpoint。

   4. 否则，如果 name 是受支持配置点的名称， 则：

      1. 令 configuration point 为名称为 name 的受支持配置 点。

      2. 如果 policy[configuration point] 存在，则 继续处理下一个 element。

      3. 如果 configuration point 的类型为 boolean，则：

         1. 如果 value 不是 Boolean，则失败。

         2. 将 policy[configuration point] 设置为一个 新的 boolean 策略 配置，其中值 为 value，报告 端点为 currentEndpoint。

         3. 继续处理下一个 element。

      4. 如果 configuration point 的类型为 enum，则：

         1. 如果 value 不是 Token，则失败。

         2. 如果 value 不是 configuration point 允许的枚举值之一的名称，则失败。

         3. 将 policy[configuration point] 设置为一个 新的 enum 策略 配置，其中值 为 value，报告 端点为 currentEndpoint。

         4. 继续处理下一个 element。

      5. 如果 configuration point 的类型为 integer，则：

         1. 如果 value 不是 Integer，则失败。

         2. 如果 value 不在 configuration point 的范围内，则 失败。

         3. 将 policy[configuration point] 设置为一个 新的 integer 策略 配置，其中值 为 value，报告 端点为 currentEndpoint。

         4. 继续处理下一个 element。

      6. 如果 configuration point 的类型为 float，则：

         1. 如果 value 不是 Decimal，则失败。

         2. 如果 value 不在 configuration point 的范围内，则 失败。

         3. 将 policy[configuration point] 设置为一个 新的 float 策略 配置，其中值 为 value，报告 端点为 currentEndpoint。

         4. 继续处理下一个 element。

5. 对于 policy 中的每个 configuration point → config，

   1. 如果 config 没有报告 端点，则将 config 的报告 端点设置为 defaultEndpoint。

6. 返回 policy。

给定一个文档策略（requiredPolicy），此 算法返回一个表示该策略规范序列化形式的 字符串。

1. 令 dict 为一个新的有序映射。

2. 令 features 为 requiredPolicy 的键。

3. 按每个元素的名称以 ASCII 顺序对 features 排序。

4. 对于 features 中的每个 feature：

   1. 令 value 为 requiredPolicy[feature]。

   2. 将 dict[feature] 设置为 value。

5. 返回 dict 的序列化。

给定一个浏览上下文（browsingContext），此 算法返回一个新的Document Policy。

1. 如果 browsingContext 是一个嵌套浏览上下文，则

   1. 令 requiredPolicy 为 browsingContext 的容器文档的嵌套上下文 必需文档 策略的克隆。

   2. 如果 browsingContext 的浏览上下文容器 具有 "policy" 属性，则

      1. 令 containerPolicy 为解析该属性的结果

      2. 对于 containerPolicy 中的每个 feature -> value：

         1. 如果 requiredPolicy[feature] 不 存在，或者 value 比 requiredPolicy[feature] 更严格，则将 requiredPolicy[feature] 设置为 value。

2. 否则，令 requiredPolicy 为一个新的有序映射。

3. 返回 requiredPolicy。

给定一个浏览上下文（browsingContext）和一个响应（response），此算法 返回一个新的Document Policy。

1. 令 requiredPolicy 为给定 browsingContext 运行为浏览上下文创建必需策略的结果。

2. 令 header 为对 response 的标头列表使用标头名称 Document-Policy 和 类型 "dictionary" 调用获取 结构化字段值的结果。

3. 令 declaredPolicy 为在 header 上执行解析文档 策略的结果。

4. 如果 declaredPolicy 与 requiredPolicy 兼容， 则返回 declaredPolicy。

5. 抛出异常。

给定一个浏览上下文（browsingContext）和一个响应（response），此算法 返回一个新的Document Policy。

1. 令 requiredPolicy 为 browsingContext 的必需文档策略的克隆。

2. 令 header 为对 response 的标头列表使用标头名称 Required-Document-Policy 和 类型 "dictionary" 调用获取 结构化字段值的结果。

3. 令 declaredNestedPolicy 为在 header 上执行解析文档 策略的结果。

4. 对于 declaredNestedPolicy 中的每个 feature -> value：

   1. 如果 requiredPolicy[feature] 不存在，或者 value 比 requiredPolicy[feature] 更严格，则将 requiredPolicy[feature] 设置为 value。

5. 返回 requiredPolicy。

给定一个请求（request）以及对 该请求的一个响应（response），如果该响应 与请求的必需策略不兼容，则此算法返回 "blocked"， 否则返回 "valid"。

1. 如果 request 具有必需文档 策略，则

   1. 令 documentPolicy 为对 response 的标头列表使用标头名称 Document-Policy 和 类型 "dictionary" 调用获取 结构化字段值的结果。

   2. 如果 documentPolicy 与 request 的必需文档 策略不兼容，则返回 "blocked"。

   3. 返回 "valid"。

给定一个特性（feature）和一个 Document 对象（document），此 算法返回 document 的文档 策略中 feature 的值。

1. 令 policy 为 document 的Document Policy。

2. 如果 policy[feature] 存在，则返回其值。

3. 返回 feature 的默认值。

给定一个值（value）、一个特性（feature）和一个 Document 对象 （document），此算法返回一个由以下内容组成的元组：

• 一个操作，它是 "compatible" 或 "incompatible"，取决于 value 是否与 document 的文档策略兼容，

• 一个报告端点名称；如果 value 同时与 document 的文档 策略及其仅报告 文档策略兼容，或者未为 feature 配置报告， 则该名称为 null； 否则它将是应向其发送违规报告的报告端点的名称。

注意，如果强制执行策略比仅报告策略更严格， 则不会检查仅报告策略。

1. 令 policy 为 document 的Document Policy。

2. 令 policyConfig 为 policy[feature]（如果存在）， 否则为一个由 feature 的默认值和 null 组成的元组。

3. 令 policyValue 和 reporting endpoint 为 policyConfig 的元素

4. 如果 policyValue 比 value 更严格，则返回一个由 "incompatible" 和 reporting endpoint 组成的元组。

5. 令 report-only policy 为 document 的仅报告文档 策略，

6. 令 report-only policyConfig 为 report-only policy[feature]（如果 存在），否则为一个由 feature 的默认值和 null 组成的元组。

7. 将 policyValue 和 reporting endpoint 设置为 report-only policyConfig 的元素

8. 如果 policyValue 比 value 更严格，则返回一个由 "compatible" 和 reporting endpoint 组成的元组。

9. 返回 ("compatible", null)。

给定一个值（value）、一个特性（feature）和一个 Document 对象 （document），如果 value 与 document 的文档策略兼容，则此算法返回 "compatible"， 否则返回 "incompatible"。如果已配置报告，它还会 排队一个报告。

1. 令 (action, reporting endpoint) 为使用 value、feature 和 document 调用determine-compatibility的结果。

2. 如果 reporting endpoint 不为 null，

   1. 令 body 为一个新的 ECMAScript 对象，具有以下属性： [ECMA-262]

      featureId

      feature 的字符串表示。

      sourceFile

      null

      lineNumber

      null

      columnNumber

      null

      disposition

      如果 action 为 "incompatible"，则为 "enforce"，否则为 "report"。

   2. 如果用户代理当前正在执行脚本，并且可以从设置中提取 源文件的 URL、行号和列号，则 相应地设置 body 的 sourceFile、lineNumber 和 columnNumber。

   3. 令 settings 为 document 的环境设置 对象。

   4. 以 body、"document-policy-violation"、reporting endpoint 和 settings 执行Reporting API § 2.3 Queue data as type for destination。

3. 返回 action。

给定一个值（value）、一个特性（feature）和一个 Document 对象 （document），如果 value 与 document 的文档策略兼容，则此算法返回 "compatible"， 否则返回 "incompatible"。

1. 令 (action, reporting endpoint) 为使用 value、feature 和 document 调用determine-compatibility的结果。

2. 返回 action。