문서 정책

두 개의 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. 각 요소의 이름을 기준으로 ASCII 순서에 따라 features를 정렬합니다.

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를 주어진 Create a required policy for a browsing context 실행 결과로 설정합니다.

2. header를 response의 header list에서 헤더 이름 Document-Policy와 유형 "dictionary"를 사용하여 get a structured field value를 호출한 결과로 설정합니다.

3. declaredPolicy를 header에 대해 Parse document policy를 실행한 결과로 설정합니다.

4. declaredPolicy가 requiredPolicy와 compatible이면 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에 대해 Parse document policy를 실행한 결과로 설정합니다.

4. declaredNestedPolicy의 각 feature → value에 대해:

   1. requiredPolicy[feature]가 존재하지 않거나, value가 requiredPolicy[feature]보다 엄격한 경우, requiredPolicy[feature]를 value로 설정합니다.

5. requiredPolicy를 반환합니다.

request (request)와 해당 요청에 대한 response (response)가 주어지면, 이 알고리즘은 응답이 요청의 필수 정책과 호환되지 않는 경우 "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와 compatible하지 않으면 "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을 반환합니다.