문서 정책

딕셔너리(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]를 값 value와 보고 엔드포인트 currentEndpoint를 가진 새 boolean 정책 구성으로 설정합니다.

         3. 다음 element로 계속합니다.

      4. configuration point의 타입이 enum이면:

         1. value가 Token이 아니면 실패합니다.

         2. value가 configuration point의 허용된 enum 값 중 하나의 이름이 아니면 실패합니다.

         3. policy[configuration point]를 값 value와 보고 엔드포인트 currentEndpoint를 가진 새 enum 정책 구성으로 설정합니다.

         4. 다음 element로 계속합니다.

      5. configuration point의 타입이 integer이면:

         1. value가 Integer가 아니면 실패합니다.

         2. value가 configuration point의 범위 안에 없으면 실패합니다.

         3. policy[configuration point]를 값 value와 보고 엔드포인트 currentEndpoint를 가진 새 integer 정책 구성으로 설정합니다.

         4. 다음 element로 계속합니다.

      6. configuration point의 타입이 float이면:

         1. value가 Decimal이 아니면 실패합니다.

         2. value가 configuration point의 범위 안에 없으면 실패합니다.

         3. policy[configuration point]를 값 value와 보고 엔드포인트 currentEndpoint를 가진 새 float 정책 구성으로 설정합니다.

         4. 다음 element로 계속합니다.

5. policy의 각 configuration point → config에 대해,

   1. config에 보고 엔드포인트가 없으면, config의 보고 엔드포인트를 defaultEndpoint로 설정합니다.

6. policy를 반환합니다.

문서 정책(requiredPolicy)이 주어졌을 때, 이 알고리즘은 정책의 표준 직렬화를 나타내는 문자열을 반환합니다.

1. dict를 새 순서 있는 맵으로 둡니다.

2. features를 requiredPolicy의 키로 둡니다.

3. features를 각 원소의 이름 기준 ASCII 순서로 정렬합니다.

4. features의 각 feature에 대해:

   1. value를 requiredPolicy[feature]로 둡니다.

   2. dict[feature]를 value로 설정합니다.

5. dict의 직렬화를 반환합니다.

브라우징 컨텍스트(browsingContext)가 주어졌을 때, 이 알고리즘은 새 문서 정책을 반환합니다.

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)이 주어졌을 때, 이 알고리즘은 새 문서 정책을 반환합니다.

1. requiredPolicy를 browsingContext가 주어졌을 때 브라우징 컨텍스트에 대한 필수 정책 생성을 실행한 결과로 둡니다.

2. header를 response의 header list에서 헤더 이름 Document-Policy와 타입 "dictionary"로 구조화된 필드 값 가져오기를 호출한 결과로 둡니다.

3. declaredPolicy를 header에 대해 문서 정책 구문 분석을 실행한 결과로 둡니다.

4. declaredPolicy가 requiredPolicy와 호환되면 declaredPolicy를 반환합니다.

5. 예외를 throw합니다.

브라우징 컨텍스트(browsingContext)와 응답(response)이 주어졌을 때, 이 알고리즘은 새 문서 정책을 반환합니다.

1. requiredPolicy를 browsingContext의 필수 문서 정책의 복제본으로 둡니다.

2. header를 response의 header list에서 헤더 이름 Required-Document-Policy와 타입 "dictionary"로 구조화된 필드 값 가져오기를 호출한 결과로 둡니다.

3. declaredNestedPolicy를 header에 대해 문서 정책 구문 분석을 실행한 결과로 둡니다.

4. declaredNestedPolicy의 각 feature -> value에 대해:

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

5. requiredPolicy를 반환합니다.

request(request)와 그 요청에 대한 response(response)가 주어졌을 때, 이 알고리즘은 응답이 요청의 필수 정책과 호환되지 않으면 "blocked"를 반환하고, 그렇지 않으면 "valid"를 반환합니다.

1. request에 필수 문서 정책이 있으면,

   1. documentPolicy를 response의 header list에서 헤더 이름 Document-Policy와 타입 "dictionary"로 구조화된 필드 값 가져오기를 호출한 결과로 둡니다.

   2. documentPolicy가 request의 필수 문서 정책과 호환되지 않으면 "blocked"를 반환합니다.

   3. "valid"를 반환합니다.

기능(feature)과 Document 객체(document)가 주어졌을 때, 이 알고리즘은 document의 문서 정책 안에서 feature에 대한 값을 반환합니다.

1. policy를 document의 문서 정책으로 둡니다.

2. policy[feature]가 존재하면, 그 값을 반환합니다.

3. feature의 기본값을 반환합니다.

값(value), 기능(feature) 및 Document 객체 (document)가 주어졌을 때, 이 알고리즘은 다음으로 구성된 튜플을 반환합니다.

• 동작. 이는 value가 document의 문서 정책과 호환되는지에 따라 "compatible" 또는 "incompatible"입니다.

• 보고 엔드포인트 이름. value가 document의 문서 정책 및 그 보고 전용 문서 정책 모두와 호환되거나, feature에 대해 보고가 구성되지 않은 경우 null이 됩니다. 그렇지 않으면 위반 보고서를 전송해야 하는 보고 엔드포인트의 이름이 됩니다.

강제 정책이 보고 전용 정책보다 더 엄격한 경우, 보고 전용 정책은 검사되지 않습니다.

1. policy를 document의 문서 정책으로 둡니다.

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을 반환합니다.