文档策略

给定两个文档策略， requiredPolicy 和 declaredPolicy， 如果 declaredPolicy 与 requiredPolicy 兼容， 则此算法返回 true，否则返回 false。

1. 对于 requiredPolicy 中的每个 configuration point → value：

   1. 如果 declaredPolicy[configuration point] 不存在， 则返回 false。

   2. 如果 value 比 declaredPolicy[configuration point] 更严格， 则返回 false。

2. 返回 true。

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

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

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

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

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

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

   2. 如果 parameters["report-to"] 存在，并且是一个 token，则：

      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），此算法返回一个由以下内容组成的元组：

• 一个操作，根据 value 是否与 document 的 文档策略 兼容，取值为 "compatible" 或 "incompatible"，

• 一个报告端点名称，如果 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 调用 确定兼容性 的结果。

2. 如果 reporting endpoint 不为 null，则

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

      featureId

      功能的字符串表示形式。

      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 将数据作为类型排队到目标。

3. 返回 action。

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

1. 令 (action, reporting endpoint) 为使用 value、feature 和 document 调用 确定兼容性 的结果。

2. 返回 action。