컴퓨팅 압력 레벨 1

초록

컴퓨팅 압력 API는 웹사이트가 대상 기기의 CPU 압력 변화에 대응할 수 있는 방법을 제공하여, 웹사이트가 향상된 사용자 경험을 위해 리소스를 절충할 수 있도록 한다.

컴퓨팅 압력 API를 사용하면 개발자가 CPU와 같은 시스템 리소스의 압력을 파악할 수 있다.

WebIDLcallback PressureUpdateCallback = undefined (
  sequence<PressureRecord> changes,
  PressureObserver observer
);

이 콜백은 압력 상태가 변경되면 호출된다.

PressureObserver를 사용하여 압력 상태의 변화를 관찰할 수 있다.

WebIDL[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
interface PressureObserver {
  constructor(PressureUpdateCallback callback);

  Promise<undefined> observe(PressureSource source, optional PressureObserverOptions options = {});
  undefined unobserve(PressureSource source);
  undefined disconnect();
  sequence<PressureRecord> takeRecords();

  [SameObject] static readonly attribute FrozenArray<PressureSource> knownSources;
};

PressureObserver 인터페이스는 PressureObserver를 나타낸다.

new PressureObserver(callback) 생성자 단계는 다음과 같다:

this.[[Callback]]을 callback으로 설정한다.

observe(source, options) 메서드 단계는 다음과 같다:

relevantGlobal을 this의 관련 전역 객체로 둔다.
relevantGlobal의 소유 문서 집합에 있는 각 document에 대해 다음을 반복한다:
1. document가 사용하도록 허용되지 않은 정책 제어 기능 토큰 "compute-pressure"를 사용한다면 다음으로 거부된 프로미스인 NotAllowedError를 반환한다.
참고

워커에는 HTTP 헤더를 통해 설정할 수 있는 자체 정책 컨테이너가 있다. 6. 정책 제어의 예제를 참조한다.
this.[[SampleIntervalMap]][source]를 options의 sampleInterval로 설정한다.
promise를 새 프로미스로 둔다.
pendingPromiseTuple을 (source, promise)로 둔다.
pendingPromiseTuple을 this.[[PendingObservePromises]]에 추가한다.
promise에 반응한다:
- promise가 이행되거나 거부되었다면:
  1. this.[[PendingObservePromises]]에서 tuple을 제거한다.
다음 단계를 병렬로 실행한다:
1. platformCollector를 null로 둔다.
2. relevantGlobal의 플랫폼 수집기 매핑이 source를 포함한다면:
  1. platformCollector를 relevantGlobal의 플랫폼 수집기 매핑[source]으로 설정한다.
3. 그렇지 않으면:
  1. newCollector를 연관된 압력 소스가 null인 새 플랫폼 수집기로 둔다.
  2. virtualPressureSource를 source와 relevantGlobal을 사용하여 가상 압력 소스 가져오기를 호출한 결과로 둔다.
  3. virtualPressureSource가 null이 아니라면:
    1. virtualPressureSource의 샘플 제공 가능이 true라면:
      1. newCollector의 연관된 압력 소스를 virtualPressureSource로 설정한다.
      2. newCollector를 virtualPressureSource의 연결된 플랫폼 수집기에 추가한다.
  4. 그렇지 않으면:
    1. realPressureSource를 구현 정의 압력 소스로 둔다. 이 소스는 source에 관한 텔레메트리 데이터를 제공하며 존재하지 않으면 null이다.
    2. newCollector의 연관된 압력 소스를 realPressureSource로 설정한다.
  5. newCollector의 연관된 압력 소스가 null이 아니라면:
    1. platformCollector를 newCollector로 설정한다.
    2. relevantGlobal의 플랫폼 수집기 매핑[source]을 platformCollector로 설정한다.
4. platformCollector가 null이면 주어진 relevantGlobal에 대해 PressureObserver 태스크 소스에 전역 태스크를 대기열에 추가하여 promise를 NotSupportedError로 거부하고 이 단계를 중단한다.
5. source와 relevantGlobal을 사용하여 데이터 수집 활성화를 호출한다.
6. 주어진 relevantGlobal에 대해 PressureObserver 태스크 소스에 전역 태스크를 대기열에 추가하여 다음 단계를 실행한다:
  1. promise가 거부되었다면 다음 하위 단계를 실행한다:
    1. source에 대한 relevantGlobal의 등록된 관찰자 목록이 비어 있다면, source와 relevantGlobal을 사용하여 데이터 수집 비활성화를 호출한다.
    2. 반환한다.
  2. 관찰자가 this인 새 등록된 관찰자를 source에 대한 relevantGlobal의 등록된 관찰자 목록에 추가한다.
  3. promise를 이행한다.
promise를 반환한다.

unobserve(source) 메서드 단계는 다음과 같다:

source가 지원되는 소스 유형이 아니라면 "NotSupportedError"를 예외로 던진다.
this.[[QueuedRecords]]에서 source와 연결된 모든 records를 제거한다.
this.[[SampleIntervalMap]][source]를 제거한다.
this.[[LastRecordMap]][source]를 제거한다.
this.[[AfterPenaltyRecordMap]][source]를 제거한다.
this.[[PendingObservePromises]]의 각 (promiseSource, pendingPromise)에 대해 반복하여, source가 promiseSource와 같다면 pendingPromise를 AbortError로 거부한다.
relevantGlobal을 this의 관련 전역 객체로 둔다.
registeredObserverList를 relevantGlobal의 등록된 관찰자 목록으로 두며, source에 대한 목록이다.
registeredObserverList에서 관찰자가 this인 모든 등록된 관찰자를 제거한다.
registeredObserverList가 비어 있다면:
1. source와 relevantGlobal을 사용하여 데이터 수집 비활성화를 호출한다.
2. relevantGlobal의 플랫폼 수집기 매핑[source]를 제거한다.

disconnect() 메서드 단계는 다음과 같다:

observer.[[QueuedRecords]]를 비운다.
this.[[SampleIntervalMap]]을 지운다.
this.[[LastRecordMap]]을 지운다.
this.[[AfterPenaltyRecordMap]]을 지운다.
this.[[PendingObservePromises]]의 각 (promiseSource, pendingPromise)에 대해 반복하여 pendingPromise를 AbortError로 거부한다.
relevantGlobal을 this의 관련 전역 객체로 둔다.
relevantGlobal의 등록된 관찰자 목록 순서 있는 맵의 각 source → registeredObserverList에 대해 다음을 반복한다:
1. 다음 항목을 제거한다: 등록된 관찰자 중 registeredObserverList에 있으며 그 관찰자가 this인 모든 항목.
2. registeredObserverList가 비어 있다면:
  1. source와 relevantGlobal을 사용하여 데이터 수집 비활성화를 호출한다.
  2. relevantGlobal의 플랫폼 수집기 매핑[source]을 제거한다.

참고

일반적인 사용 사례는 관찰자의 연결을 끊기 직전에 보류 중인 모든 상태 변경 레코드를 즉시 가져와 관찰자를 종료할 때 보류 중인 모든 상태 변경을 처리하는 것이다.

또 다른 사용 사례는 콜백이 호출될 때까지 기다리지 않고 보류 중인, 이미 생성된 상태 변경을 수신하는 것이다. 콜백은 이벤트 루프 주기의 일부로 태스크 대기열에서 호출되므로 이벤트 루프 주기 외부에서 현재 상태를 확인할 수 있다.

takeRecords() 메서드 단계는 다음과 같다:

records를 observer.[[QueuedRecords]]의 복제본으로 둔다.
observer.[[QueuedRecords]]를 비운다.
records를 반환한다.

knownSources getter 단계는 다음과 같다:

사용자 에이전트의 지원되는 소스 유형을 알파벳순으로 반환한다.

참고

WebIDL[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
interface PressureRecord {
  readonly attribute PressureSource source;
  readonly attribute PressureState state;
  readonly attribute DOMHighResTimeStamp time;
  [Default] object toJSON();
};

생성된 PressureRecord 객체에는 다음 내부 슬롯이 있다:

현재 소스 유형을 나타내는 PressureSource 유형의 [[Source]] 값.
현재 압력 상태를 나타내는 PressureState 유형의 [[State]] 값.
DOMHighResTimeStamp 유형의 [[Time]] 값으로, 해당 값은 알림을 생성한 PressureObserver 인스턴스와 연결된 전역 객체의 시간 원점을 기준으로 시스템에서 데이터를 얻은 시각에 해당한다.

source getter 단계는 해당 객체의 [[Source]] 내부 슬롯을 반환한다.

state getter 단계는 해당 객체의 [[State]] 내부 슬롯을 반환한다.

time getter 단계는 해당 객체의 [[Time]] 내부 슬롯을 반환한다.

PressureRecord.toJSON이 호출되면 Web IDL 표준의 기본 toJSON 단계를 실행한다.

WebIDLdictionary PressureObserverOptions {
  [EnforceRange] unsigned long sampleInterval = 0;
};

sampleInterval 멤버는 밀리초 단위로 표현된 요청된 샘플링 간격을 나타낸다. 값이 0으로 설정된 경우 시스템은 PressureUpdateCallback을 PressureState가 변경된 경우에만 호출한다.

참고

각 전역 객체는 해당 등록된 관찰자 목록의 등록된 관찰자에 대한 강한 참조를 갖는다(소스마다 하나씩).

참고

PressureObserver가 source를 관찰하는 것은 observe(), unobserve() 및 disconnect() 호출로 수정되는 등록된 관찰자 목록에 존재하는 경우이다.

이는 다음 두 조건이 모두 충족될 때까지 PressureObserver 객체 observer가 계속 살아 있어 가비지 컬렉션되지 않는다는 의미이다:

observer에 대한 스크립트 참조가 없다.
observer가 어떤 source도 관찰하지 않는다.

예제 2에는 관찰자 콜백에서 disconnect() 또는 다른 PressureObserver 메서드를 사용하는 방법의 예제가 포함되어 있다.

이 절에서는 사용자 에이전트가 이 명세를 구현할 때 수행해야 하는 단계를 설명한다.

인수 observer가 주어졌을 때 관찰 창 재설정 단계는 다음과 같다:

observer.[[ObservationWindow]]을 구현 정의 무작위 정숫값으로 설정한다. 이 값은 구현 정의 범위 내의 밀리초 단위 값이다.
observer.[[MaxChangesThreshold]]을 구현 정의 무작위 정숫값으로 설정한다. 이 값은 observationWindow 동안 허용되는 최대 변경 횟수이며 구현 정의 범위 내에 있다.
observer.[[PenaltyDuration]]을 구현 정의 무작위 정숫값으로 설정한다. 이 값은 구현 정의 범위 내의 밀리초 단위 값이다.
observer.[[ChangesCountMap]] 맵을 비운다.

관찰 창 재설정 단계를 실행하고, observer.[[ObservationWindow]] 시간이 지나면 다른 무작위 값을 사용하여 이 단계를 다시 실행하는 타이머를 시작한다.

참고

다음 기준과 일치하는 문서(iframe 및 팝업 창 포함)와 워커에서 판독값을 사용할 수 있다:

해당 항목이 완전히 활성인 문서이거나 활성 상태의 필요한 워커이다.
해당 항목의 출처가 동일 출처이며, 그 출처는 문서와 동일하다. 이 문서에는 포커스된 노드가 포함되어 있거나, 활성 Picture-in-Picture 세션의 개시자이거나, 탐색 컨텍스트가 캡처 중이다. 캡처에는 마이크, 카메라 및 디스플레이가 포함된다.

관련 전역 객체 relevantGlobal의 소유 문서 집합을 결정하려면:

owningDocumentSet을 빈 집합으로 둔다.
relevantGlobal이 Window라면 relevantGlobal의 연결된 문서를 owningDocumentSet에 추가한다.
그렇지 않으면 다음을 반복한다. WorkerGlobalScope relevantGlobal의 소유자 집합에 있는 각 owner에 대해:
1. owner가 Document라면 owner를 owningDocumentSet에 추가한다.
2. owner가 WorkerGlobalScope라면, owningDocumentSet을 owningDocumentSet과 owner의 소유 문서 집합의 합집합으로 설정한다.
owningDocumentSet을 반환한다.

인수 document가 주어졌을 때 문서에 암시적 포커스가 있음 단계는 다음과 같다:

document가 완전히 활성인 상태가 아니라면 false를 반환한다.
relevantGlobal을 document의 관련 전역 객체로 둔다.
활성 Picture-in-Picture 세션의 개시자에 있는 각 origin에 대해 다음을 반복한다:
1. relevantGlobal의 관련 설정 객체의 출처가 origin과 동일 출처라면 true를 반환한다.
relevantGlobal의 탐색 컨텍스트가 캡처 중이라면 true를 반환한다.
topLevelBC를 relevantGlobal의 탐색 컨텍스트의 최상위 탐색 컨텍스트로 둔다.
topLevelBC에 시스템 포커스가 없다면 false를 반환한다.
focusedDocument를 topLevelBC의 현재 포커스된 영역의 노드 문서로 둔다.
relevantGlobal의 관련 설정 객체의 출처가 focusedDocument의 출처와 동일 출처라면 true를 반환한다.
그렇지 않으면 false를 반환한다.

인수 observer가 주어졌을 때 데이터를 수신할 수 있음 단계는 다음과 같다:

relevantGlobal을 observer의 관련 전역 객체로 둔다.
relevantGlobal이 Window 객체라면:
1. 문서에 암시적 포커스가 있음을 relevantGlobal의 연결된 Document와 함께 실행한 결과를 반환한다.
relevantGlobal이 WorkerGlobalScope 객체라면:
1. owningDocuments를 relevantGlobal의 소유 문서 집합으로 둔다.
2. owningDocuments에 있는 각 document에 대해 다음을 반복한다:
  1. 문서에 암시적 포커스가 있음을 document와 함께 실행한 결과가 true라면 true를 반환한다.
  2. 그렇지 않으면 계속한다.
false를 반환한다.

참고

인수 observer, source 및 timestamp가 주어졌을 때 빈도 테스트 통과 단계는 다음과 같다:

observer.[[LastRecordMap]][source]가 존재하지 않으면 true를 반환한다.
record를 observer.[[LastRecordMap]][source]로 둔다.
sampleInterval을 observer.[[SampleIntervalMap]][source]로 둔다.
timeDeltaMilliseconds = timestamp - record.[[Time]]으로 둔다.
timeDeltaMilliseconds ≥ sampleInterval이면 true를 반환하고, 그렇지 않으면 false를 반환한다.

인수 observer, source, state가 주어졌을 때 디스패치해야 함 단계는 다음과 같다:

observer.[[SampleIntervalMap]][source] > 0이면 true를 반환한다.
observer.[[LastRecordMap]][source]가 존재하지 않으면 true를 반환한다.
record를 observer.[[LastRecordMap]][source]로 둔다.
record.[[State]]가 state와 같지 않으면 true를 반환한다.
false를 반환한다.

인수 observer, source가 주어졌을 때 빈도 난독화 테스트 통과 단계는 다음과 같다:

observer.[[ChangesCountMap]][source]를 1 증가시킨다.
observer.[[ChangesCountMap]][source] ≤ observer.[[MaxChangesThreshold]]인지 반환한다.

소스 유형 source와 relevantGlobal이 주어졌을 때 가상 압력 소스 가져오기를 수행하려면 다음 단계를 수행한다. 이 단계는 가상 압력 소스 또는 null을 반환한다.

topLevelTraversable을 null로 둔다.
relevantGlobal이 Window 객체라면:
1. topLevelTraversable을 relevantGlobal의 탐색 가능 항목의 최상위 순회 가능 항목으로 설정한다.
relevantGlobal이 DedicatedWorkerGlobalScope 객체라면:
1. owningDocuments를 relevantGlobal의 소유 문서 집합으로 둔다.
2. owningDocuments가 비어 있다면 null을 반환한다.
3. 단언: owningDocuments의 크기는 1이다.
4. topLevelTraversable을 owningDocuments[0]의 노드 탐색 가능 항목의 최상위 순회 가능 항목으로 설정한다.
topLevelTraversable이 null이면 null을 반환한다.
topLevelVirtualPressureSourceMapping을 topLevelTraversable의 가상 압력 소스 매핑으로 둔다.
virtualPressureSource를 null로 둔다.
topLevelVirtualPressureSourceMapping이 source를 포함한다면:
1. virtualPressureSource를 topLevelVirtualPressureSourceMapping[source]으로 설정한다.
virtualPressureSource를 반환한다.

소스 유형 source 및 relevantGlobal이 주어졌을 때 데이터 수집 활성화를 수행하려면 다음 단계를 수행한다:

relevantGlobal의 플랫폼 수집기 매핑이 source를 포함하지 않으면 이 단계를 중단한다.
platformCollector를 relevantGlobal의 플랫폼 수집기 매핑[source]으로 둔다.
platformCollector의 활성화됨이 true라면 이 단계를 중단한다.
platformCollector의 활성화됨을 true로 설정한다.
구현 정의 방식으로 relevantGlobal, source 및 platformCollector을 사용하여 데이터 수집 단계를 실행하기 시작한다.

참고

이 단계는 구현이 폴링하거나 플랫폼 또는 OS별 알림을 구독하여 텔레메트리 데이터를 수집할 수 있는 재량을 제공한다.

소스 유형 source 및 relevantGlobal이 주어졌을 때 데이터 수집 비활성화를 수행하려면 다음 단계를 수행한다:

relevantGlobal의 플랫폼 수집기 매핑이 source를 포함하지 않으면 이 단계를 중단한다.
platformCollector를 relevantGlobal의 플랫폼 수집기 매핑[source]으로 둔다.
platformCollector의 활성화됨이 false라면 이 단계를 중단한다.
구현 정의 방식으로 relevantGlobal, source 및 platformCollector을 사용한 데이터 수집 단계의 실행을 중지한다.
platformCollector의 활성화됨을 false로 설정한다.
platformCollector의 연관된 압력 소스가 가상 압력 소스라면:
1. platformCollector를 해당 연관된 압력 소스의 연결된 플랫폼 수집기에서 제거한다.
그렇지 않으면 platformCollector의 연관된 압력 소스에 텔레메트리 데이터 검색을 중지하도록 알리는 구현 정의 단계를 수행한다.

relevantGlobal, source 및 platformCollector이 주어졌을 때 데이터 수집 단계는 다음과 같다:

pressureSource를 platformCollector의 연관된 압력 소스로 둔다.
pressureSource가 null이면 이 단계를 중단한다.
sample을 pressureSource의 최신 샘플로 둔다.
sample이 null이면 이 단계를 중단한다.
state를 null로 둔다.
pressureSource가 가상 압력 소스라면:
1. state를 sample의 데이터에 저장된 PressureState로 설정한다.
그렇지 않으면:
1. 기여 요인의 변화가 상당함이 false라면 이 단계를 중단한다.
2. state를 source와 sample의 데이터에서 계산한 조정된 압력 상태로 설정한다.
  
  참고
  
  sample의 데이터와 압력 상태 사이의 매핑은 구현 정의이며 다양한 메트릭을 사용할 수 있다. 예를 들어 CPU의 경우 프로세서 주파수와 사용률 및 열 상태를 고려할 수 있다.
단언: state는 null이 아니다.
rawTimestamp를 sample의 타임스탬프로 둔다.
timeValue를 상대 고해상도 시간으로 둔다. 이 값은 rawTimestamp와 relevantGlobal을 기반으로 한다.
relevantGlobal의 source에 대한 등록된 관찰자 목록에 있는 각 observer에 대해 다음을 반복한다:
1. 데이터를 수신할 수 있음을 observer와 함께 실행한 결과가 false라면 계속한다.
2. 빈도 테스트 통과를 observer, source 및 timeValue와 함께 실행한 결과가 false라면 계속한다.
3. 디스패치해야 함을 observer, source, state와 함께 실행한 결과가 false라면 계속한다.
4. record를 새 PressureRecord 객체로 둔다. 객체의 [[Source]]는 source로, [[State]]는 state로, [[Time]]은 timeValue로 설정한다.
5. observer.[[AfterPenaltyRecordMap]][source]가 존재한다면:
  1. observer.[[AfterPenaltyRecordMap]][source]를 record로 설정한다.
  2. 계속한다.
6. 빈도 난독화 테스트 통과를 observer 및 source와 함께 실행한 결과가 false라면:
  1. observer.[[AfterPenaltyRecordMap]][source]를 record로 설정한다.
  2. observer.[[ChangesCountMap]][source]를 0으로 설정한다.
  3. 다음 콜백을 사용하는 observer.[[PenaltyDuration]] 지속 시간의 타이머를 생성한다:
    1. observer.[[AfterPenaltyRecordMap]][source]가 존재한다면:
      1. record를 observer.[[AfterPenaltyRecordMap]][source]로 둔다.
      2. observer.[[AfterPenaltyRecordMap]][source]를 제거한다.
      3. 레코드를 대기열에 추가를 observer, source, record와 함께 실행한다.
  4. 계속한다.
7. 레코드를 대기열에 추가를 observer, source, record와 함께 실행한다.

인수 observer, source, record가 주어졌을 때 레코드를 대기열에 추가하려면 다음 단계를 실행한다:

observer.[[QueuedRecords]]의 크기가 최대 대기 레코드 수보다 크면 첫 번째 항목을 제거한다.
record를 observer.[[QueuedRecords]]에 추가한다.
observer.[[LastRecordMap]][source]를 record로 설정한다.
observer의 관련 전역 객체를 사용하여 압력 관찰자 태스크를 대기열에 추가한다.

PressureObserver 태스크 소스는 태스크 소스이며, 10.6.5 압력 관찰자에게 알림을 위한 태스크를 스케줄링하는 데 사용된다.

relevantGlobal이 입력으로 주어졌을 때 압력 관찰자 태스크를 대기열에 추가하려면 다음 단계를 실행한다:

relevantGlobal의 압력 관찰자 태스크가 대기열에 추가됨이 true이면 반환한다.
relevantGlobal의 압력 관찰자 태스크가 대기열에 추가됨을 true로 설정한다.
relevantGlobal을 사용하여 PressureObserver 태스크 소스에 전역 태스크를 대기열에 추가하고 압력 관찰자에게 알림을 수행한다.

relevantGlobal이 입력으로 주어졌을 때 압력 관찰자에게 알림을 수행하려면 다음 단계를 실행한다:

relevantGlobal의 압력 관찰자 태스크가 대기열에 추가됨을 false로 설정한다.
notifySet을 집합으로 둔다. 이 집합에는 relevantGlobal의 등록된 관찰자 목록에 있는 모든 관찰자가 포함된다.
notifySet의 각 observer에 대해 다음을 반복한다:
1. records를 observer.[[QueuedRecords]]의 복제본으로 둔다.
2. observer.[[QueuedRecords]]를 비운다.
3. records가 비어 있지 않다면 observer.[[Callback]]을 호출한다. 이때 « records, observer » 및 "report"를 사용한다.

이 명세는 Document document가 주어졌을 때 다음 문서 언로드 정리 단계를 정의한다:

relevantGlobal을 document의 관련 전역 객체로 둔다.
relevantGlobal의 등록된 관찰자 목록 순서 있는 맵의 각 source 키에 대해 다음을 반복한다:
1. source와 relevantGlobal을 사용하여 데이터 수집 비활성화를 호출한다.
2. relevantGlobal의 플랫폼 수집기 매핑[source]을 제거한다.

이슈 275: bfcache 통합 전략을 올바르게 결정

이 명세에는 이전에 Document가 다시 완전히 활성인 상태가 되는 경우, 즉 Document의 재활성화 단계와의 통합을 다루는 단계가 포함되어 있었다. 의도한 동작을 논의하는 동안 해당 단계는 제거되었다.

참고

WorkerGlobalScope relevantGlobal의 종료 중 플래그가 true로 설정될 때마다 다음 단계를 수행한다:

각각에 대해 source 키, relevantGlobal의 등록된 관찰자 목록 순서 있는 맵:
1. source 및 relevantGlobal과 함께 데이터 수집 비활성화를 호출한다.
2. relevantGlobal의 플랫폼 수집기 매핑[source]을 제거한다.

참고

작업 그룹은 알려진 모든 이론적 및 실제 공격 벡터를 이 절에 나열할 예정이다.

출처를 공유하지 않는 사이트가 고유하거나 매우 정밀한 값에 동시에 접근할 수 있다면, 동일 출처가 아닌 사이트 전반에서 사용자를 식별할 수 있다. 이 공격은 11.2.1 데이터 최소화, 11.2.2 빈도 난독화, 그리고 11.2.7 동일 출처 제한으로 완화된다.

컴퓨터 보안에서 은닉 채널은 통신이 허용되어서는 안 되는 프로세스 사이에서 정보를 전송할 수 있는 기능을 만든다. 현대적인 다중 프로세스 웹 엔진에서는 일반적으로 각 창이나 탭이 자체 프로세스에 존재한다(동일 출처인 문서나 동일 사이트인 사이트는 일반적으로 같은 프로세스를 공유한다). 이 API를 사용하면 교차 사이트 은닉 채널 C를 만들 수 있다. 한 탭의 사이트 A가 CPU 상태를 조작한 후 먼저 채널 C로 브로드캐스트한다. 그런 다음 다른 탭의 사이트 B(사이트 A와 동일 사이트가 아님)가 이 API를 사용하여 CPU 상태가 변경된 시점을 파악함으로써 채널 C에서 브로드캐스트된 데이터를 읽는다. 이 프로세스는 사이트 A와 B 모두에서 스크립트가 실행되는 동안 반복된다.

이 공격은 11.2.2 빈도 난독화 및 11.2.5 보정 방해로 완화된다. 구현자는 장시간 실행되는 스크립트에 이러한 완화책을 모두 고려하는 것이 좋다.

참고

스크립트가 오래 실행될수록 제안된 교차 사이트 은닉 채널을 사용하여 더 많은 정보를 전송할 수 있다. 예를 들어 사용자가 화상 회의 사이트와 장시간 실행되는 다른 사이트를 함께 이용하면 일반적인 브라우징 시나리오보다 더 많은 정보를 전송할 수 있다. 반면에 화상 회의 세션과 같은 워크로드는 일반적으로 CPU에 지속적인 압력을 가하므로 압력 상태를 예측 가능한 방식으로 조작하기가 더 어려워진다.

표적 비익명화 공격은 사용자의 익명성을 위협하는 중대한 위협 유형이다. 이러한 공격을 사용하면 악의적이거나 부분적으로 침해된 웹사이트(“악성 사이트”라고 함)가 웹사이트 방문자에게 이메일 주소나 소셜 미디어 계정명과 같은 특정 공개 식별자가 있는지를 확인할 수 있다.

일부에게 익명성은 사치일 수 있지만, 어떤 사람들에게는 그보다 훨씬 중요하며 생존의 문제이기도 하다. 예를 들어 정치 시위에 참여하거나 민감한 주제를 취재하는 언론인으로 일하는 사람 등을 생각해 보라.

공격자는 예를 들어 공개 리소스 공유 서비스(“피해자 사이트”)를 사용하여 표적과 리소스를 비공개로 공유한 다음, 부채널을 통해 리소스를 로드할 때 발생하는 부수 효과(성공적인 접근을 나타냄)를 측정할 수 있다. 로그인한 방문자가 삽입된 리소스에 성공적으로 접근할 수 있다면, 현재 방문자가 실제로 의도한 표적임을 나타낸다.

구체적으로, 전체 CPU 압력에 관한 신뢰할 수 있는 정보를 노출하면 공격 사이트가 교차 출처 탐색 대상(예: 다른 사이트의 iframe 또는 팝업 창)이 CPU 집약적인 작업을 수행했는지 파악할 수 있다.

팝언더 및 탭언더와 같은 기법을 사용하여 로딩을 사용자에게 숨길 수 있다.

가능한 공격 중 하나는 악성 웹사이트가 사용자가 로그인한 피해자 사이트의 리소스 (예: 동영상 스트리밍 사이트 또는 온라인 문서 편집기)에 대해 팝업 등을 열고, 특정 사용자와 공유된 리소스를 가리키게 하는 것이다.

리소스를 로드할 때 CPU 압력이 증가한다고 가정하면, 이는 공격 사이트에 사용자가 해당 리소스에 접근할 수 있는 계정으로 로그인했는지를 알려주는 부채널을 형성하여 사용자의 익명성을 해제한다.

현대 CPU는 높은 압력에서 빠르게 회복하므로, 가능한 완화 전략 중 하나는 팝업 및 iframe 콘텐츠를 로드한 후 몇 초 동안 판독을 일시적으로 비활성화하는 것이다.

참고

이 절에서는 이 명세에 적용할 수 있는 완화 전략을 개괄적으로 설명한다. 이러한 완화책의 규범적 정의는 이 명세의 각 알고리즘에 통합되어 있다. 구현자는 이 명세에 정의된 완화책을 구현할 때 비공개 브라우징 모드에 관한 TAG 지침을 고려하는 것이 좋다.

이 명세는 기반 플랫폼의 저수준 세부 정보와 관련된 데이터의 노출을 가치가 높은 사용 사례를 처리하는 데 필요한 최소한으로 제한하기 위해 일반적인 데이터 최소화 원칙을 준수한다. 여기에는 기기에 관한 식별 정보의 노출 제한을 고려하는 것도 포함된다.

이 명세의 맥락에서 데이터 최소화 원칙을 구체적으로 적용하는 방법은 11.2.2 빈도 난독화 및 11.2.7 동일 출처 제한에서 설명한다.

이 명세에서는 구현 정의 슬라이딩 관찰 창에서 압력 변경 횟수를 추적하고, 압력 변경 횟수가 구현 정의 임계값을 초과하면 플래그를 설정하는 빈도 난독화 완화책을 구현하도록 요구한다. 마찬가지로 여러 상태에 걸쳐 압력 상태 변경 횟수가 많은 것과 같은 비정상 활동을 구현이 관찰하고, 동일한 방식으로 이 플래그를 설정하는 것도 권장한다.

이 플래그가 설정되면 구현은 압력 관찰자에게 페널티를 부여하는 것이 좋다. 이 페널티가 지속되는 동안에는 평소처럼 압력 상태 변경을 스크립트에 알릴 수 없다. 이 페널티의 지속 시간은 구현 정의이며 무작위화하는 것이 권장된다. 페널티 이후 압력 관찰자에게 알림이 작업을 재개하면 최신 압력 상태만 보고하고, 이 페널티 동안 플랫폼 수집기에서 받은 모든 중간 상태 정보는 무시한다.

구현 경험에 기반하여 구현자는 다음을 사용해야 한다:

PressureObserver의 [[MaxChangesThreshold]] 내부 슬롯에는 50회에서 100회 사이의 변경 범위.
PressureObserver의 [[PenaltyDuration]] 내부 슬롯에는 5000밀리초에서 10000밀리초 사이의 범위.

참고

이 절은 비규범적이다.

구현 경험에 기반하여 구현자는 다음을 사용하는 것이 좋다:

PressureObserver의 [[ObservationWindow]] 내부 슬롯에는 300000밀리초(5분)에서 600000밀리초(10분) 사이의 범위.

참고

보정 과정에서 공격자는 조작된 워크로드가 가하는 압력에 대한 응답으로 이 API가 특정 압력 상태로의 전환을 가장 높은 확률로 보고하도록 CPU를 조작하려 한다. 이 보정 방해 완화책은 이러한 압력 상태 전환에 기여하는 구현 정의 저수준 하드웨어 측정치를 런타임에 조금씩 변경하여, 이 보정 과정이 성공하지 못하게 하거나 속도를 늦출 수 있다. 초기 보정이 성공하더라도 이 완화책이 계속 실행되면서 런타임에 그 결과가 무효화된다. 다시 보정하려는 모든 시도도 마찬가지로 완화된다.

참고

이 절은 비규범적이다.

구현 경험에 기반하여 구현자는 120000밀리초(2분)에서 240000밀리초(4분) 사이 범위의 무작위 시간 값에 완화책을 적용하는 것이 좋다.

참고

기본적으로 데이터 전달은 활성 PIP 세션의 개시자와 동일한 출처에서 제공된 문서, 캡처 중인 문서, 또는 존재하는 경우 시스템 포커스가 있는 문서로 제한된다.

위 규칙에 따라 데이터 전달 요건을 충족하는 문서는 자식 탐색 가능 객체의 문서에 이를 위임할 수 있다.

이 기능은 선언된 정책을 통해서만 iframe과 같은 서드 파티 컨텍스트로 확장할 수 있다.

공유 작업자는 최상위 문서와 연결된 iframe 등 여러 문서에서 공유될 수 있다. 소유자 집합의 문서 중 하나가 위의 데이터 전달 요건을 충족하면 공유 작업자도 데이터 전달 요건을 충족한다. 즉, 삽입된 iframe이 데이터를 삽입 문서에 전달할 수 있다.

컴퓨팅 압력 API는 인터페이스를 완전히 시험하려면 예측 가능한 방식으로 응답하는 물리적 하드웨어 기기가 필요하므로 테스트 작성자에게 어려움을 준다.

이 문제를 해결하기 위해 이 문서는 실제 압력 소스처럼 동작하면서 특정 속성을 가질 수 있고 판독값을 사용자가 전적으로 정의할 수 있는 가상 압력 소스를 정의하고 제어할 수 있도록 하는 [WEBDRIVER2] 확장 명령을 정의한다.

가상 압력 소스는 실제 압력 소스의 동작을 제어된 방식으로 모의하는 압력 소스이다. 가상 압력 소스는 연결된 0개 이상의 플랫폼 수집기에 압력 변경을 보고한다.

그러나 실제 압력 소스와 달리, 플랫폼 수집기가 압력 상태로 처리해야 하는 구현 정의 값을 보고하는 대신, 압력 상태 값을 직접 보고한다. 다시 말해, 가상 압력 소스의 압력 소스 샘플의 데이터는 PressureState이다.

모든 압력 소스와 관련된 데이터(예: 압력 소스 샘플) 외에도, 각 가상 압력 소스에는 다음 항목이 있다:

샘플 제공 가능 불리언.
연결된 플랫폼 수집기의 집합. 각 항목은 플랫폼 수집기이다.

각 최상위 탐색 가능 객체에는 가상 압력 소스 매핑이 있다. 이는 소스 유형을 가상 압력 소스에 대응시키는 순서 있는 맵이다.

참고

현재 명시된 바에 따르면 가상 압력 소스는 Window 또는 DedicatedWorkerGlobalScope의 플랫폼 수집기 매핑에 가상 압력 소스가 나타내는 소스 유형 항목이 없을 때만 영향을 준다.

다시 말해, 이미 observe()가 호출된 소스 유형에 대한 가상 압력 소스를 만들더라도 기존 인스턴스에서 disconnect()나 unobserve()가 호출되기 전까지는 해당 인스턴스에 영향을 주지 않는다. 기존 관찰자의 연결이 해제된 후 observe()가 호출된 경우에만 새 인스턴스가 새 가상 압력 소스를 사용한다.

마찬가지로 하나 이상의 PressureObserver 인스턴스에서 가상 압력 소스를 사용하고 있는 중에 해당 소스가 제거되면, observe() 호출이 실제 압력 소스에 연결을 시도하기 전에 모든 인스턴스가 관찰을 중지해야 한다.

HTTP 메서드	URI 템플릿
POST	/session/{session id}/pressuresource

이 확장 명령은 지정된 소스 유형의 새 가상 압력 소스를 생성한다. 같은 소스 유형의 PressureObserver 인스턴스에서 observe()를 호출하면, 가상 압력 소스가 13.1.1.2 가상 압력 소스 삭제가 실행될 때까지 해당 인스턴스의 기반 압력 소스로 사용된다.

이 알고리즘에서 사용하는 parameters 인수의 속성
매개변수 이름	값 유형	필수
type	String	예
supported	Boolean	아니요

session, URL variables 및 parameters가 주어졌을 때 원격 단 단계는 다음과 같다:

virtualPressureSourceType을 parameters에서 "type"에 대해 속성 가져오기를 호출한 결과라고 하자.
사용자 에이전트의 지원되는 소스 유형에 virtualPressureSourceType이 포함되지 않으면, WebDriver 오류 코드가 잘못된 인수인 오류를 반환한다.
topLevelTraversable을 현재 브라우징 컨텍스트의 최상위 탐색 가능 객체라고 하자.
topLevelVirtualPressureSourceMapping을 topLevelTraversable의 가상 압력 소스 매핑이라고 하자.
topLevelVirtualPressureSourceMapping에 virtualPressureSourceType이 포함되어 있으면, WebDriver 오류 코드가 잘못된 인수인 오류를 반환한다.
supported를 parameters에서 "supported" 및 true를 사용해 기본값을 사용해 속성 가져오기를 호출한 결과라고 하자.
virtualPressureSource를 새 가상 압력 소스라고 하자.
virtualPressureSource의 샘플 제공 가능을 supported로 설정한다.
topLevelVirtualPressureSourceMapping[virtualPressureSourceType]을 virtualPressureSource로 설정한다.
데이터가 null인 성공을 반환한다.

HTTP 메서드	URI 템플릿
DELETE	/session/{session id}/pressuresource/{type}

이 확장 명령은 지정된 가상 압력 소스를 삭제한다. 즉, 주어진 소스 유형의 데이터를 사용할 수 있다면 가상 방식이 아닌 일반적인 방식으로 전달한다.

session, URL variables 및 parameters가 주어졌을 때 원격 단 단계는 다음과 같다:

virtualPressureSourceType을 URL variables["type"]의 값이라고 하자.
사용자 에이전트의 지원되는 소스 유형에 virtualPressureSourceType이 포함되지 않으면, WebDriver 오류 코드가 잘못된 인수인 오류를 반환한다.
topLevelTraversable을 현재 브라우징 컨텍스트의 최상위 탐색 가능 객체라고 하자.
topLevelVirtualPressureSourceMapping을 topLevelTraversable의 가상 압력 소스 매핑이라고 하자.
pressureSource를 topLevelVirtualPressureSourceMapping[virtualPressureSourceType]이라고 하자.
pressureSource의 연결된 플랫폼 수집기에 있는 각 platformCollector에 대해:
1. platformCollector의 연관된 압력 소스를 null로 설정한다.
topLevelVirtualPressureSourceMapping[virtualPressureSourceType]을 제거한다.
데이터가 null인 성공을 반환한다.

HTTP 메서드	URI 템플릿
POST	/session/{session id}/pressuresource/{type}

이 확장 명령을 사용하면 새 압력 소스 샘플을 푸시하여 가상 압력 소스의 상태를 업데이트할 수 있다.

참고

이 알고리즘에서 사용하는 parameters 인수의 속성
매개변수 이름	값 유형	필수
sample	`PressureState`	예

session, URL variables 및 parameters가 주어졌을 때 원격 종단 단계는 다음과 같다:

virtualPressureSourceType을 URL variables["type"]의 값이라고 하자.
사용자 에이전트의 지원되는 소스 유형에 virtualPressureSourceType이 포함되지 않으면, WebDriver 오류 코드가 잘못된 인수인 오류를 반환한다.
topLevelTraversable을 현재 브라우징 컨텍스트의 최상위 탐색 가능 객체라고 하자.
topLevelVirtualPressureSourceMapping을 topLevelTraversable의 가상 압력 소스 매핑이라고 하자.
topLevelVirtualPressureSourceMapping에 virtualPressureSource가 포함되지 않으면, WebDriver 오류 코드가 지원되지 않는 작업인 오류를 반환한다.
virtualPressureSource를 topLevelVirtualPressureSourceMapping[virtualPressureSourceType]이라고 하자.
sample을 parameters에서 "sample"에 대해 속성 가져오기를 호출한 결과라고 하자.
sample의 유형이 PressureState가 아니면, WebDriver 오류 코드가 잘못된 인수인 오류를 반환한다.
virtualPressureSource의 최신 샘플을 새 압력 소스 샘플로 설정한다. 이 샘플의 데이터는 sample 이고 타임스탬프는 안전하지 않은 공유 현재 시각이다.
구현 정의 방식으로 virtualPressureSource의 최신 샘플을 virtualPressureSource의 연결된 플랫폼 수집기에서 사용할 수 있게 한다.
데이터가 null인 성공을 반환한다.

이 절은 비규범적이다.

예시 2: 콜백에서 관찰자에 접근하는 방법

const samples = [];

function pressureChange(records, observer) {
  for (const record of records) {
    samples.push(record.state);

    // 20개의 샘플만 필요하다.
    if (samples.length == 20) {
      observer.disconnect();
      return;
    }
  }
}

const observer = new PressureObserver(pressureChange);
observer.observe("cpu");

다음 예시에서는 압력이 critical 상태가 될 때 동시 동영상 스트림 수를 줄이려고 한다. 단순화를 위해 이 상태만 고려한다.

스트림 수를 줄이더라도 critical 상태에서 벗어나지 못하거나 적어도 즉시 벗어나지는 못할 수 있으므로, 여전히 critical 상태에 있는 동안 30초마다 한 번에 스트림 하나씩 줄이는 전략을 사용한다.

이를 위해 콜백이 최소한 30초마다 한 번 또는 상태가 실제로 변경될 때 호출되도록 한다. 상태가 변경되면 간격 타이머를 재설정한다.

예시 3: CPU 압력에 따라 동영상 피드 수를 조정하는 방법

let timerId = -1;
function pressureChange(records) {
  // 실제 상태 변경 또는 setTimeout 호출(아래 참조)로 이 함수가 호출될 때마다
  // 타이머를 지운다.
  if (timerId > 0) {
    clearTimeout(timerId);
  }

  // critical 상태가 되면 30초마다 여전히 critical 상태인지 다시 확인하고,
  // 그렇다면 동시 스트림 수를 더 줄이려고 한다.
  // 이를 위해 변경 사항이 없을 때 마지막 결과와 함께 이 함수를 다시 호출하는
  // 30초 타이머를 생성한다.
  const lastRecordArray = [records.at(records.length - 1)];
  timerId = setTimeout(pressureChange.bind(this, lastRecordArray), 30_000);

  for (const record of records) {
    if (record.state == "critical") {
      let streamsCount = getStreamsCount();
      setStreamsCount(streamsCount--);
    }
  }
}

const observer = new PressureObserver(pressureChange);
observer.observe("cpu");

다음 예시에서는 콜백이 마지막으로 호출된 이후 누적된 나머지 records를 가져와 takeRecords()를 사용하는 방법을 보여준다.

disconnect() 전에 이 작업을 수행하는 것이 좋다. 그렇지 않으면 disconnect()가 레코드를 지우며 레코드는 영원히 손실된다.

예를 들어 벤치마킹 워크로드 중의 압력을 측정하여 워크로드가 지속되는 정확한 시간 동안의 압력 원격 측정값을 얻고자 할 수 있다. 이는 작업이 완료되면 모든 관찰자의 연결을 즉시 해제하고, 이벤트 루프 주기의 일부로 아직 전달되지 않았을 수 있는 현재 시점까지의 보류 중인 압력 원격 측정값을 수동으로 요청하는 것을 의미한다.

예시 4: 연결 해제 직전까지의 모든 상태 변경을 처리하는 방법

function logWorkloadStatistics(records) {
  // records로 무언가를 수행한다.
}

const observer = new PressureObserver(logWorkloadStatistics);
observer.observe("cpu");

// 보류 중인 상태 변경 레코드를 읽는다. 그렇지 않으면 연결을 해제할 때
// 레코드가 지워진다.
const records = observer.takeRecords();
logWorkloadStatistics(records);

observer.disconnect();

다음 예시에서는 source를 사용해 unobserve()를 호출하여 관찰자가 특정 source의 감시를 중지하도록 하는 방법을 보여준다.

참고

예시 5: 관찰자가 특정 소스의 상태 변경 감시를 중지하도록 하는 방법

const observer = new PressureObserver(records => { /* records로 무언가를 수행한다. */ });

observer.observe("cpu");
observer.observe("gpu");

// 이제 'cpu' 또는 'gpu'의 압력 상태가 변경될 때마다 콜백이 호출된다.

observer.unobserve("gpu");

// 이제 'cpu'의 압력 상태가 변경될 때만 콜백이 호출된다.

다음 예시에서는 disconnect()를 호출하여 관찰자가 모든 상태 변경 감시를 중지하도록 하는 방법을 보여준다. disconnect()를 호출하면 이전 observe() 호출에서 관찰한 모든 소스의 관찰을 중지한다.

또한 마지막으로 콜백이 호출된 이후 수집된 보류 중인 모든 레코드를 지운다.

예시 6: 관찰자가 모든 상태 변경 감시를 중지하도록 하는 방법

const observer = new PressureObserver(records => { // records로 무언가를 수행한다. });
observer.observe("cpu");
observer.observe("gpu");

// 어느 정도 시간이 지난 후...

observer.disconnect();

// 앞서 disconnect()를 호출했으므로 records는 빈 배열이다.
const records = observer.takeRecords();

이 절은 비규범적이다.

데이터 수집 활성화 §10.6.2
활성화됨 §4.
조정된 압력 상태 §9.
[[AfterPenaltyRecordMap]]: PressureObserver의 내부 슬롯 §7.
연관된 압력 소스 §4.
보정 방해 §11.2.5
[[Callback]]: PressureObserver의 내부 슬롯 §7.
샘플 제공 가능 §13.1
기여 요인의 변경이 상당함 §9.
[[ChangesCountMap]]: PressureObserver의 내부 슬롯 §7.
연결된 플랫폼 수집기 §13.1
constructor(): PressureObserver의 생성자 §10.2.1
기여 요인 §9.
"cpu": PressureSource의 열거형 값 §3.2
"critical": PressureState의 열거형 값 §8.
데이터 §4.
데이터 수집 §10.6.2
데이터 수집 비활성화 §10.6.2
disconnect(): PressureObserver의 메서드 §10.2.4
문서에 암시적 포커스가 있음 §10.6.1
"fair": PressureState의 열거형 값 §8.
가상 압력 소스 가져오기 §10.6.1
knownSources: PressureObserver의 속성 §10.2.6
[[LastRecordMap]]: PressureObserver의 내부 슬롯 §7.
최신 샘플 §4.
대기열에 추가할 수 있는 최대 레코드 수 §7.
[[MaxChangesThreshold]]: PressureObserver의 내부 슬롯 §7.
데이터를 수신할 수 있음 §10.6.1
"nominal": PressureState의 열거형 값 §8.
압력 관찰자에게 알림 §10.6.5
[[ObservationWindow]]: PressureObserver의 내부 슬롯 §7.
observe(): PressureObserver의 메서드 §10.2.2
관찰자 §7.
소유 문서 집합 §10.6.1
빈도 난독화 테스트를 통과함 §10.6.1
빈도 테스트를 통과함 §10.6.1
[[PenaltyDuration]]: PressureObserver의 내부 슬롯 §7.
[[PendingObservePromises]]: PressureObserver의 내부 슬롯 §7.
플랫폼 수집기 §4.
플랫폼 수집기 매핑 §7.
압력 관찰자 태스크가 대기열에 추가됨 §7.
압력 소스 §4.
압력 소스 샘플 §4.
압력 상태 §8.
PressureObserver 인터페이스 §10.2
PressureObserver 태스크 소스 §10.6.4
PressureObserverOptions 사전 §10.4
PressureRecord 인터페이스 §10.3
PressureSource 열거형 §3.2
PressureState 열거형 §8.
PressureUpdateCallback §10.1
처리 장치 §3.1
압력 관찰자 태스크를 대기열에 추가 §10.6.4
레코드를 대기열에 추가 §10.6.3
[[QueuedRecords]]: PressureObserver의 내부 슬롯 §7.
빈도 난독화 §11.2.2
등록된 관찰자 §7.
등록된 관찰자 목록 §7.
보고 빈도 §3.3
요청된 샘플링 간격 §3.3
요청된 샘플링 빈도 §3.3
관찰 창 재설정 §10.6.1
sampleInterval: PressureObserverOptions의 멤버 §10.4.1
[[SampleIntervalMap]]: PressureObserver의 내부 슬롯 §7.
샘플링 빈도 §3.3
"serious": PressureState의 열거형 값 §8.
디스패치해야 함 §10.6.1
source: PressureRecord의 속성 §10.3.1
소스 유형 §4.
[[Source]]: PressureRecord의 내부 슬롯 §10.3
state: PressureRecord의 속성 §10.3.2
[[State]]: PressureRecord의 내부 슬롯 §10.3
지원되는 소스 유형 §7.
takeRecords(): PressureObserver의 메서드 §10.2.5
time: PressureRecord의 속성 §10.3.3
[[Time]]: PressureRecord의 내부 슬롯 §10.3
타임스탬프 §4.
toJSON: PressureRecord의 메서드 §10.3.4
unobserve(): PressureObserver의 메서드 §10.2.3
사용자 에이전트 §15.
유효한 소스 유형 §3.2
가상 압력 소스 §13.1
가상 압력 소스 매핑 §13.1

[DOM]은 다음을 정의한다:
- Document 인터페이스
- 문서
- 노드
- 노드 문서(Node의 경우)
[ECMASCRIPT]는 다음을 정의한다:
- 에이전트 (ECMAScript의 경우)
- globalThis 속성 (globalThis의 경우)
[HR-TIME]은 다음을 정의한다:
- DOMHighResTimeStamp
- 상대적 고해상도 시각
- 안전하지 않은 현재 시각(단조 시계의 경우)
- 안전하지 않은 공유 현재 시각
[HTML]은 다음을 정의한다:
- 사용이 허용됨
- 연관된 문서
- 브라우징 컨텍스트
- 자식 탐색 가능 객체
- 종료 중(WorkerGlobalScope의 경우)
- DedicatedWorkerGlobalScope 인터페이스
- 완전히 활성임(Document의 경우)
- 전역 객체
- iframes 요소
- 병렬로
- 탐색 가능 객체(Window의 경우)
- 노드 탐색 가능 객체
- 출처
- 소유자 집합(WorkerGlobalScope의 경우)
- 정책 컨테이너(WorkerGlobalScope의 경우)
- 전역 태스크를 대기열에 추가
- 재활성화(Document의 경우)
- 관련 전역 객체
- 관련 설정 객체
- 동일 출처
- 동일 사이트
- 시스템 포커스(최상위 탐색 가능 객체의 경우)
- 태스크 소스
- 시간 원점(환경 설정 객체의 경우)
- 최상위 브라우징 컨텍스트
- 최상위 탐색 가능 객체
- 최상위 탐색 가능 객체(브라우징 컨텍스트의 경우)
- 문서 언로드 정리 단계
- Window 인터페이스
- WorkerGlobalScope 인터페이스
[INFRA]는 다음을 정의한다:
- 추가 (list의 경우)
- 추가 (set의 경우)
- 단언
- 지우기 (map의 경우)
- 복제 (list의 경우)
- 포함 (list의 경우)
- 포함 (map의 경우)
- 계속 (iteration의 경우)
- 비어 있음 (list의 경우)
- 각각에 대해 (list의 경우)
- 각각에 대해 (map의 경우)
- 구현 정의
- 항목 (list의 경우)
- 항목 (struct의 경우)
- 키 (map의 경우)
- 목록
- 순서 있는 맵
- 대기열
- 제거 (list의 경우)
- 제거 (map의 경우)
- 집합
- 크기 (list의 경우)
- 구조체
- 튜플
- 합집합 (set의 경우)
- 값 (map의 경우)
[MEDIACAPTURE-STREAMS]는 다음을 정의한다:
- 컨텍스트가 캡처 중임
[PERMISSIONS-POLICY]는 다음을 정의한다:
- 기본 허용 목록(정책 제어 기능의 경우)
- 정책 제어 기능
[WEBDRIVER2]는 다음을 정의한다:
- 현재 브라우징 컨텍스트
- 오류
- 오류 코드
- 확장 명령 URI 템플릿
- 확장 명령
- 속성 가져오기
- 기본값을 사용해 속성 가져오기
- 잘못된 인수
- 원격 종단 단계
- 성공
- 지원되지 않는 작업
[WEBIDL]은 다음을 정의한다:
- 새 프로미스
- 다음으로 거부된 프로미스
- AbortError 예외
- [Default] 확장 속성
- 기본 toJSON 단계
- [EnforceRange] 확장 속성
- [Exposed] 확장 속성
- FrozenArray 인터페이스
- getter 단계
- 호출
- NotAllowedError 예외
- NotSupportedError 예외
- object 유형
- Promise 인터페이스
- 반응 (promise의 경우)
- 거부됨
- 이행됨
- [SameObject] 확장 속성
- [SecureContext] 확장 속성
- 시퀀스
- this
- TypeError 예외
- undefined 유형
- unsigned long 유형

WebIDLenum PressureSource { "cpu" };

enum PressureState { "nominal", "fair", "serious", "critical" };

callback PressureUpdateCallback = undefined (
  sequence<PressureRecord> changes,
  PressureObserver observer
);

[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
interface PressureObserver {
  constructor(PressureUpdateCallback callback);

  Promise<undefined> observe(PressureSource source, optional PressureObserverOptions options = {});
  undefined unobserve(PressureSource source);
  undefined disconnect();
  sequence<PressureRecord> takeRecords();

  [SameObject] static readonly attribute FrozenArray<PressureSource> knownSources;
};

[Exposed=(DedicatedWorker,SharedWorker,Window), SecureContext]
interface PressureRecord {
  readonly attribute PressureSource source;
  readonly attribute PressureState state;
  readonly attribute DOMHighResTimeStamp time;
  [Default] object toJSON();
};

dictionary PressureObserverOptions {
  [EnforceRange] unsigned long sampleInterval = 0;
};

컴퓨팅 압력 레벨 1

초록

이 문서의 상태

1. 서론

2. 기능 감지에 관한 참고 사항

3. 개념

3.1 처리 장치

3.2 압력 소스

3.3 샘플링 및 보고 빈도

4. 플랫폼 기본 요소

5. 사용자 알림

6. 정책 제어

7. 내부 슬롯 정의

8. 압력 상태

9. 기여 요인

10. 압력 관찰자

10.1 PressureUpdateCallback 콜백

10.2 PressureObserver 객체

10.2.1 constructor() 메서드

10.2.2 observe() 메서드

10.2.3 unobserve() 메서드

10.2.4 disconnect() 메서드

10.2.5 takeRecords() 메서드

10.2.6 knownSources 속성

10.3 PressureRecord 인터페이스

10.3.1 source 속성

10.3.2 state 속성

10.3.3 time 속성

10.3.4 toJSON 멤버

10.4 PressureObserverOptions 사전

10.4.1 sampleInterval 멤버

10.5 수명 주기 및 가비지 컬렉션

10.6 처리 모델

10.6.1 지원 알고리즘

10.6.2 데이터 수집 및 전달

10.6.3 PressureRecord를 대기열에 추가

10.6.4 압력 관찰자 태스크를 대기열에 추가

10.6.5 압력 관찰자에게 알림

10.6.6 완전히 활성인 상태의 변경 처리

10.6.7 작업자 상태 변경 처리

11. 보안 및 개인 정보 보호 고려 사항

11.1 개인 정보 보호 및 보안 위협의 유형

11.1.1 타이밍 공격

11.1.2 교차 사이트 은닉 채널

11.1.3 표적 비익명화 공격

11.2 완화 전략

11.2.1 데이터 최소화

11.2.2 빈도 난독화

11.2.3 빈도 난독화 규범적 매개변수

11.2.4 빈도 난독화 비규범적 매개변수

11.2.5 보정 방해

11.2.6 보정 방해 매개변수

11.2.7 동일 출처 제한

12. 접근성 고려 사항

13. 자동화

13.1 가상 압력 소스

13.1.1 확장 명령

13.1.1.1 가상 압력 소스 생성

13.1.1.2 가상 압력 소스 삭제

13.1.1.3 가상 압력 소스 업데이트

14. 예시

15. 적합성

A. 감사의 말

B. 실질적 변경 사항 요약

B.1 첫 번째 공개 작업 초안(2022/12/20) 이후의 변경 사항

B.2 색인

B.2.1 이 명세에서 정의하는 용어

B.2.2 참조로 정의되는 용어

B.3 IDL 색인

C. 참고 문헌

C.1 규범적 참고 문헌

C.2 비규범적 참고 문헌

10.1 `PressureUpdateCallback` 콜백

10.2 `PressureObserver` 객체

10.2.1 `constructor()` 메서드

10.2.2 `observe()` 메서드

10.2.3 `unobserve()` 메서드

10.2.4 `disconnect()` 메서드

10.2.5 `takeRecords()` 메서드

10.2.6 `knownSources` 속성

10.3 `PressureRecord` 인터페이스

10.3.1 `source` 속성

10.3.2 `state` 속성

10.3.3 `time` 속성

10.3.4 `toJSON` 멤버

10.4 `PressureObserverOptions` 사전

10.4.1 `sampleInterval` 멤버