ドキュメントポリシー

2 つの document policy、 requiredPolicy および declaredPolicy が与えられた場合、 このアルゴリズムは declaredPolicy が requiredPolicy と互換性がある場合は true を返し、 それ以外の場合は false を返します。

1. requiredPolicy 内の各 configuration point → value について:

   1. declaredPolicy[configuration point] が存在しない場合、 false を返します。

   2. value が declaredPolicy[configuration point] より厳格な場合、 false を返します。

2. true を返します。

dictionary (header) が与えられた場合、 このアルゴリズムは、それとして解析できる場合は document policy を返し、 それ以外の場合は失敗します。

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 がサポートされている configuration point の名前の場合:

      1. configuration point を、 名前が name であるサポートされた configuration point とします。

      2. policy[configuration point] が存在する場合、 次の element に続行します。

      3. configuration point の type が boolean の場合:

         1. value が Boolean でない場合、失敗します。

         2. policy[configuration point] を、 新しい boolean policy configuration として設定します。 その value は value、 reporting endpoint は currentEndpoint です。

         3. 次の element に続行します。

      4. configuration point の type が enum の場合:

         1. value が Token でない場合、失敗します。

         2. value が configuration point の 許可された enum 値のいずれかの名前でない場合、失敗します。

         3. policy[configuration point] を、 新しい enum policy configuration として設定します。 その value は value、 reporting endpoint は currentEndpoint です。

         4. 次の element に続行します。

      5. configuration point の type が integer の場合:

         1. value が Integer でない場合、失敗します。

         2. value が configuration point の range 内に 存在しない場合、失敗します。

         3. policy[configuration point] を、 新しい integer policy configuration として設定します。 その value は value、 reporting endpoint は currentEndpoint です。

         4. 次の element に続行します。

      6. configuration point の type が float の場合:

         1. value が Decimal でない場合、失敗します。

         2. value が configuration point の range 内に 存在しない場合、失敗します。

         3. policy[configuration point] を、 新しい float policy configuration として設定します。 その value は value、 reporting endpoint は currentEndpoint です。

         4. 次の element に続行します。

5. policy 内の各 configuration point → config について:

   1. config が reporting endpoint を持たない場合、 config の reporting endpoint を defaultEndpoint に設定します。

6. policy を返します。

document policy（requiredPolicy）が与えられた場合、 このアルゴリズムは、そのポリシーの正規シリアライズを表す 文字列を返します。

1. dict を新しい順序付きマップとします。

2. features を requiredPolicy のキーとします。

3. features を、各要素の名前によって ASCII 順でソートします。

4. features 内の各 feature について:

   1. value を requiredPolicy[feature] とします。

   2. dict[feature] を value に設定します。

5. dict のシリアライズ結果を返します。

browsing context （browsingContext）が与えられた場合、 このアルゴリズムは新しい Document Policy を返します。

1. browsingContext が nested browsing context の場合:

   1. requiredPolicy を、 browsingContext の container document の nested context required document policy のクローンとします。

   2. browsingContext の browsing context container に "policy" 属性がある場合:

      1. containerPolicy を、その属性を解析した結果とします。

      2. containerPolicy 内の各 feature → value について:

         1. requiredPolicy[feature] が存在しない場合、 または value が requiredPolicy[feature] より厳格な場合、 requiredPolicy[feature] を value に設定します。

2. それ以外の場合、requiredPolicy を新しい順序付きマップとします。

3. requiredPolicy を返します。

browsing context （browsingContext）と response （response）が与えられた場合、 このアルゴリズムは新しい Document Policy を返します。

1. requiredPolicy を、 browsingContext を指定して browsing context 用の必須ポリシーを作成する を実行した結果とします。

2. header を、response の header list からヘッダー名 Document-Policy、 型 "dictionary" で get a structured field value を呼び出した結果とします。

3. declaredPolicy を、 header に対して document policy を解析する を実行した結果とします。

4. declaredPolicy が 互換性がある 場合、requiredPolicy と互換性があるなら、 declaredPolicy を返します。

5. 例外を投げます。

browsing context （browsingContext）と response （response）が与えられた場合、 このアルゴリズムは新しい Document Policy を返します。

1. requiredPolicy を、 browsingContext の required document policy のクローンとします。

2. header を、response の header list からヘッダー名 Required-Document-Policy、 型 "dictionary" で get a structured field value を呼び出した結果とします。

3. declaredNestedPolicy を、 header に対して document policy を解析する を実行した結果とします。

4. declaredNestedPolicy 内の各 feature → value について:

   1. requiredPolicy[feature] が存在しない場合、 または value が requiredPolicy[feature] より厳格な場合、 requiredPolicy[feature] を value に設定します。

5. requiredPolicy を返します。

request （request）と、その request に対する response （response）が与えられた場合、 このアルゴリズムは response が request の required policy と互換性がない場合は "blocked" を返し、それ以外の場合は "valid" を返します。

1. request が required document policy を持つ場合:

   1. documentPolicy を、response の header list からヘッダー名 Document-Policy、 型 "dictionary" で get a structured field value を呼び出した結果とします。

   2. documentPolicy が request の required document policy と互換性がない場合、 "blocked" を返します。

   3. "valid" を返します。

機能（feature）と Document オブジェクト（document）が与えられた場合、 このアルゴリズムは document の document policy 内の feature の値を返します。

1. policy を document の Document Policy とします。

2. policy[feature] が存在する場合、 その value を返します。

3. feature の default value を返します。

値（value）、機能（feature）および Document オブジェクト（document）が与えられた場合、 このアルゴリズムは以下で構成されるタプルを返します。

• アクション。 これは、value が document の document policy と互換性があるかどうかに応じて、 "compatible" または "incompatible" のいずれかです。

• レポートエンドポイント名。 これは、value が document の document policy および その report-only document policy の両方と互換性がある場合、 または feature に対してレポートが構成されていない場合は null になります。 それ以外の場合は、違反レポートを送信する reporting endpoint の名前になります。

適用ポリシーが report-only ポリシーより厳格な場合、 report-only ポリシーはチェックされないことに注意してください。

1. policy を document の Document Policy とします。

2. policyConfig を、存在する場合は policy[feature] とし、 それ以外の場合は feature の default value と null からなるタプルとします。

3. policyValue および reporting endpoint を policyConfig の要素とします。

4. policyValue が value より厳格な場合、 "incompatible" と reporting endpoint からなるタプルを返します。

5. report-only policy を document の report-only document policy とします。

6. report-only policyConfig を、存在する場合は report-only policy[feature] とし、 それ以外の場合は feature の default value と null からなるタプルとします。

7. policyValue および reporting endpoint を report-only policyConfig の要素に設定します。

8. policyValue が value より厳格な場合、 "compatible" と reporting endpoint からなるタプルを返します。

9. ("compatible", null) を返します。

値（value）、機能（feature）および Document オブジェクト（document）が与えられた場合、 このアルゴリズムは value が document の document policy と互換性がある場合は "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 の environment settings object とします。

   4. Reporting API § 2.3 Queue data as type for destination を、body、 "document-policy-violation"、 reporting endpoint、 settings とともに実行します。

3. action を返します。

値（value）、機能（feature）および Document オブジェクト（document）が与えられた場合、 このアルゴリズムは value が document の document policy と互換性がある場合は "compatible"、 それ以外の場合は "incompatible" を返します。

1. (action, reporting endpoint) を、 value、feature および document を使用して determine-compatibility を呼び出した結果とします。

2. action を返します。