리소스 타이밍

3.2. PerformanceResourceTiming 인터페이스에 포함된 리소스

이 절은 비규범적입니다.

null이 아닌 클라이언트가 가져온 리소스 요청은 페치 과정의 일부로 타임라인에서 제외되는 경우를 빼고, 그 클라이언트의 전역 객체의 Performance Timeline에 PerformanceResourceTiming 객체로 포함됩니다. HTTP 캐시에서 가져온 리소스도 Performance Timeline에 PerformanceResourceTiming 객체로 포함됩니다. 페치를 시작했지만 이후 중단된 리소스(예: 네트워크 오류로 인한 경우)는 시작 및 종료 타이밍과 함께 Performance Timeline에 PerformanceResourceTiming 객체로 포함됩니다.

예시:

• 같은 정규화된(canonical) URL이 두 개의 HTML IMG 요소의 src로 사용되는 경우, 첫 번째 HTML IMG 요소가 시작한 해당 리소스의 가져오기(fetch)는 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다. 사용자 에이전트는 두 번째 IMG 요소에 대해 URL을 재요청하지 않고 첫 번째 IMG 요소를 위해 시작된 기존 다운로드를 대신 사용할 수 있습니다. 이 경우 첫 번째 IMG 요소에 의한 리소스의 가져오기만이 Performance Timeline에 기록될 수 있습니다.
• HTML IMG 요소의 src 속성이 스크립트로 변경되는 경우, 원래 리소스의 가져오기와 새 URL의 가져오기가 모두 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다.
• 만약 HTML IFRAME 요소가 마크업으로 추가되었으나 src 속성이 지정되지 않았다면, 사용자 에이전트는 해당 IFRAME에 대해 about:blank 문서를 로드할 수 있습니다. 이후 스크립트로 동적으로 src 속성이 변경되면 사용자 에이전트는 IFRAME의 새 URL 리소스를 가져오기할 수 있습니다. 이 경우 새 URL에 대한 가져오기만이 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다.
• 동일한 정규화된 URL에 대해 XMLHTTPRequest가 두 번 생성된 경우, 해당 리소스에 대한 두 번의 가져오기가 모두 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다. 이는 두 번째 XMLHttpRequest에 대한 리소스의 가져오기가 첫 번째 XMLHttpRequest에 대해 발행된 다운로드를 재사용할 수 없기 때문입니다.
• 페이지에 HTML IFRAME 요소가 포함된 경우, 부모 문서의 Performance Timeline에는 오직 IFRAME의 src 속성으로 요청된 리소스만 PerformanceResourceTiming 객체로 포함됩니다. IFRAME 문서가 요청하는 서브리소스는 해당 IFRAME 문서의 Performance Timeline에 포함되며 부모 문서의 Performance Timeline에는 포함되지 않습니다.
• HTML IMG 요소가 소스로 data: URI를 사용할 경우, 이 리소스는 PerformanceResourceTiming 객체로 Performance Timeline에 포함되지 않습니다. PerformanceResourceTiming 항목은 오직 http(s) 리소스에 대해서만 보고됩니다.
• 리소스 가져오기가 네트워크 오류(예: DNS, TCP 또는 TLS 오류)로 중단된 경우, 해당 가져오기는 PerformanceResourceTiming 객체로 Performance Timeline에 포함되며 startTime, fetchStart, duration, responseEnd만 설정됩니다.
• 가져오기가 가져오기 전제 조건(fetch precondition)을 실패(예: 혼합 콘텐츠, CORS 제한, CSP 정책 등)하여 중단된 경우, 해당 리소스는 Performance Timeline에 PerformanceResourceTiming 객체로 포함되지 않습니다.

3.3. PerformanceResourceTiming 인터페이스

[Exposed=(Window,Worker)]
interface PerformanceResourceTiming : PerformanceEntry {
    readonly attribute DOMString initiatorType;
    readonly attribute DOMString deliveryType;
    readonly attribute ByteString nextHopProtocol;
    readonly attribute DOMHighResTimeStamp workerStart;
    readonly attribute DOMHighResTimeStamp redirectStart;
    readonly attribute DOMHighResTimeStamp redirectEnd;
    readonly attribute DOMHighResTimeStamp fetchStart;
    readonly attribute DOMHighResTimeStamp domainLookupStart;
    readonly attribute DOMHighResTimeStamp domainLookupEnd;
    readonly attribute DOMHighResTimeStamp connectStart;
    readonly attribute DOMHighResTimeStamp connectEnd;
    readonly attribute DOMHighResTimeStamp secureConnectionStart;
    readonly attribute DOMHighResTimeStamp requestStart;
    readonly attribute DOMHighResTimeStamp finalResponseHeadersStart;
    readonly attribute DOMHighResTimeStamp firstInterimResponseStart;
    readonly attribute DOMHighResTimeStamp responseStart;
    readonly attribute DOMHighResTimeStamp responseEnd;
    readonly attribute DOMHighResTimeStamp workerRouterEvaluationStart;
    readonly attribute DOMHighResTimeStamp workerCacheLookupStart;
    readonly attribute DOMString workerMatchedRouterSource;
    readonly attribute DOMString workerFinalRouterSource;
    readonly attribute unsigned long long  transferSize;
    readonly attribute unsigned long long  encodedBodySize;
    readonly attribute unsigned long long  decodedBodySize;
    readonly attribute unsigned short responseStatus;
    readonly attribute RenderBlockingStatusType renderBlockingStatus;
    readonly attribute DOMString contentType;
    readonly attribute DOMString contentEncoding;
    [Default] object toJSON();
};

PerformanceResourceTiming 는 연관된 DOMString인 initiator type을 가집니다.

PerformanceResourceTiming 는 연관된 DOMString인 delivery type을 가집니다.

PerformanceResourceTiming 는 연관된 DOMString인 requested URL을 가집니다.

PerformanceResourceTiming 는 연관된 DOMString인 cache mode (빈 문자열, "local", 또는 "validated")을 가집니다.

PerformanceResourceTiming 는 연관된 fetch timing info인 timing info를 가집니다.

PerformanceResourceTiming 는 연관된 response body info인 resource info를 가집니다.

PerformanceResourceTiming 는 연관된 status인 response status를 가집니다.

PerformanceResourceTiming 는 연관된 RenderBlockingStatusType 인 render-blocking status를 가집니다.

toJSON가 호출되면, 기본 toJSON 단계를 PerformanceResourceTiming에 대해 실행합니다.

initiatorType getter 단계는 개시자 유형을 this에 대해 반환하는 것입니다.

initiatorType의 설정은 리소스 타이밍 항목이 보고되는 여러 장소(예: fetch 표준)에서 이루어집니다.

deliveryType getter 단계는 전달 유형을 this에 대해 반환하는 것입니다.

workerStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 서비스 워커 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP fetch를 참조하십시오.

redirectStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 리디렉션 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP 리디렉션 fetch를 참조하십시오.

redirectEnd getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 리디렉션 종료 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP 리디렉션 fetch를 참조하십시오.

fetchStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 리디렉션 후 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP fetch를 참조하십시오.

domainLookupStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 연결 타이밍 정보의 도메인 조회 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

domainLookupEnd getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 연결 타이밍 정보의 도메인 조회 종료 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

connectStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 연결 타이밍 정보의 연결 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

connectEnd getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 연결 타이밍 정보의 연결 종료 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

secureConnectionStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 연결 타이밍 정보의 보안 연결 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

nextHopProtocol getter 단계는 동형 디코딩을 this의 타이밍 정보의 최종 연결 타이밍 정보의 ALPN 협상 프로토콜에 적용하는 것입니다. 자세한 내용은 연결 타이밍 정보 기록을 참조하십시오.

이슈 221에서는 사용자의 네트워크 구성에 관한 세부 정보를 노출할 수 있으므로 nextHopProtocol 지원을 제거할 것을 제안합니다.

requestStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 네트워크 요청 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP fetch를 참조하십시오.

firstInterimResponseStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 첫 번째 중간 네트워크 응답 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP fetch를 참조하십시오.

finalResponseHeadersStart getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 최종 네트워크 응답 시작 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 HTTP fetch를 참조하십시오.

responseStart getter 단계는 this의 firstInterimResponseStart가 0이 아닌 경우 이를 반환하고, 그렇지 않으면 this의 finalResponseHeadersStart를 반환하는 것입니다.

responseEnd getter 단계는 fetch 타임스탬프를 변환하는 것으로, this의 타이밍 정보의 종료 시간과 관련 전역 객체를 this에 대해 사용합니다. 자세한 내용은 fetch를 참조하십시오.

encodedBodySize getter 단계는 this의 리소스 정보의 인코딩된 크기를 반환하는 것입니다.

decodedBodySize getter 단계는 this의 리소스 정보의 디코딩된 크기를 반환하는 것입니다.

transferSize getter 단계는 다음과 같습니다:

1. this의 캐시 모드가 "local"이면 0을 반환합니다.

2. this의 캐시 모드가 "validated"이면 300을 반환합니다.

3. this의 리소스 정보의 인코딩된 크기에 300을 더한 값을 반환합니다.

   transferSize에 추가되는 상수 값은 HTTP 헤더의 전체 바이트 크기를 노출하는 대신 사용되며, 전체 크기를 노출하면 특정 쿠키의 존재가 드러날 수 있기 때문입니다. 이 이슈를 참조하십시오.

responseStatus getter 단계는 this의 응답 상태를 반환하는 것입니다.

responseStatus는 Fetch에서 결정됩니다. 교차 출처 no-cors 요청에서는 응답이 불투명하게 필터링된 응답이므로 0이 됩니다.

contentType getter 단계는 this의 리소스 정보의 콘텐츠 유형을 반환하는 것입니다.

contentEncoding getter 단계는 this의 리소스 정보의 콘텐츠 인코딩을 반환하는 것입니다.

renderBlockingStatus getter 단계는 차단을 반환하는 것으로, this의 타이밍 정보의 렌더링 차단이 true인 경우이며, 그렇지 않으면 비차단을 반환합니다.

workerRouterEvaluationStart getter 단계는 this의 타이밍 정보의 서비스 워커 타이밍 정보의 워커 라우터 평가 시작을 반환하는 것입니다.

workerCacheLookupStart getter 단계는 this의 타이밍 정보의 서비스 워커 타이밍 정보의 워커 캐시 조회 시작을 반환하는 것입니다.

workerMatchedRouterSource getter 단계는 this의 타이밍 정보의 서비스 워커 타이밍 정보의 워커가 일치시킨 라우터 소스를 반환하는 것입니다.

workerFinalRouterSource getter 단계는 this의 타이밍 정보의 서비스 워커 타이밍 정보의 워커의 최종 라우터 소스를 반환하는 것입니다.

PerformanceResourceTiming을 구현하는 사용자 에이전트는 supportedEntryTypes에 "resource"를 포함해야 합니다. 이를 통해 개발자는 Resource Timing 지원 여부를 감지할 수 있습니다.

enum RenderBlockingStatusType {
    "blocking",
    "non-blocking"
};

3.4. Performance 인터페이스의 확장

사용자 에이전트는 PerformanceResourceTiming 객체로 Performance Timeline에 포함되는 리소스 수를 제한하도록 선택할 수 있습니다. 이 절은 저장되는 PerformanceResourceTiming 객체의 수를 제어하기 위해 Performance 인터페이스를 확장합니다.

권장 최소 PerformanceResourceTiming 객체 수는 250개이며, 사용자 에이전트에 의해 변경될 수 있습니다. setResourceTimingBufferSize는 이 제한 변경을 요청하기 위해 호출될 수 있습니다.

각 ECMAScript 글로벌 환경은 다음을 가집니다:

• A resource timing buffer size limit 은 초기값이 250 이상이어야 합니다.
• A resource timing buffer current size 은 초기값이 0입니다.
• A resource timing buffer full event pending flag 은 초기값이 false입니다.
• A resource timing secondary buffer current size 은 초기값이 0입니다.
• A resource timing secondary buffer 는 PerformanceResourceTiming 객체를 저장하기 위한 보조 버퍼로 초기에는 비어 있습니다.

partial interface Performance {
      undefined clearResourceTimings ();
      undefined setResourceTimingBufferSize (unsigned long maxSize);
      attribute EventHandler onresourcetimingbufferfull;
    };

Performance 인터페이스는 [HR-TIME]에서 정의되어 있습니다.

clearResourceTimings 메서드는 다음 단계를 실행합니다:

1. Performance entry buffer에 있는 모든 PerformanceResourceTiming 객체를 제거합니다.
2. resource timing buffer current size를 0으로 설정합니다.

setResourceTimingBufferSize 메서드는 다음 단계를 실행합니다:

1. resource timing buffer size limit을 maxSize 인수로 설정합니다. maxSize가 현재 resource timing buffer current size보다 작으면, performance entry buffer에서 어떤 PerformanceResourceTiming 객체도 제거되지 않습니다.

onresourcetimingbufferfull 속성은 아래에 설명된 resourcetimingbufferfull 이벤트에 대한 이벤트 핸들러입니다.

리소스 타이밍 엔트리를 추가할 수 있는지 확인하려면, 다음 단계를 실행한다:

1. 리소스 타이밍 버퍼 현재 크기 가 리소스 타이밍 버퍼 크기 제한 보다 작으면, true를 반환한다.
2. false 반환.

PerformanceResourceTiming 엔트리 추가를 위해서 new entry 를 퍼포먼스 엔트리 버퍼에 추가하려면, 다음 단계를 실행한다:

1. 리소스 타이밍 엔트리를 추가할 수 있는지 가 true를 반환하고, 리소스 타이밍 버퍼 가득참 이벤트 보류 플래그가 false이면, 다음 하위 단계를 실행한다:
   1. new entry를 퍼포먼스 엔트리 버퍼에 추가한다.
   2. 리소스 타이밍 버퍼 현재 크기를 1 증가시킨다.
   3. Return.
2. 리소스 타이밍 버퍼 가득참 이벤트 보류 플래그가 false면, 다음 하위 단계를 실행한다:
   1. 리소스 타이밍 버퍼 가득참 이벤트 보류 플래그를 true로 설정한다.
   2. 태스크를 큐에 추가한다, 퍼포먼스 타임라인 태스크 소스에서 버퍼 가득참 이벤트 발생을 실행한다.
3. new entry를 리소스 타이밍 세컨더리 버퍼에 추가한다.
4. 리소스 타이밍 세컨더리 버퍼 현재 크기를 1 증가시킨다.

세컨더리 버퍼 복사를 위해, 다음 단계를 수행한다:

1. 리소스 타이밍 세컨더리 버퍼가 비어 있지 않고, 리소스 타이밍 엔트리를 추가할 수 있는지 가 true를 반환하는 동안, 다음 하위 단계를 반복 수행한다:
   1. entry를 가장 오래된 PerformanceResourceTiming 으로 한다, 리소스 타이밍 세컨더리 버퍼에서.
   2. entry를 퍼포먼스 엔트리 버퍼 마지막에 추가한다.
   3. 리소스 타이밍 버퍼 현재 크기를 1 증가시킨다.
   4. entry를 리소스 타이밍 세컨더리 버퍼에서 제거한다.
   5. 리소스 타이밍 세컨더리 버퍼 현재 크기를 1 감소시킨다.

버퍼 가득참 이벤트 발생을 위해, 다음 단계를 수행한다:

1. 리소스 타이밍 세컨더리 버퍼가 비어 있지 않은 동안, 다음 하위 단계를 반복 수행한다:
   1. number of excess entries before를 리소스 타이밍 세컨더리 버퍼 현재 크기로 한다.
   2. 리소스 타이밍 엔트리를 추가할 수 있는지 가 false면, 이벤트 발생 resourcetimingbufferfull 이름으로, Performance 객체에서 한다.
   3. 세컨더리 버퍼 복사를 실행한다.
   4. number of excess entries after를 리소스 타이밍 세컨더리 버퍼 현재 크기로 한다.
   5. number of excess entries before가 number of excess entries after 이하이면, 리소스 타이밍 세컨더리 버퍼의 모든 엔트리를 제거하고, 리소스 타이밍 세컨더리 버퍼 현재 크기를 0으로 설정하고, 이 단계들을 중단한다.
2. 리소스 타이밍 버퍼 가득참 이벤트 보류 플래그를 false로 설정한다.

   이는 resourcetimingbufferfull 이벤트 핸들러가 버퍼에 공간을 확보한 것보다 많은 리소스를 추가하면, 초과 엔트리가 버퍼에서 삭제될 수 있음을 의미한다. 개발자는 resourcetimingbufferfull 이벤트 핸들러에서 clearResourceTimings를 호출하거나 setResourceTimingBufferSize로 버퍼 크기를 충분히 늘려야 한다.

3.5. 교차 출처 리소스

3.6. 리소스 타이밍 속성

이 절은 비규범적입니다.

다음 도표는 PerformanceResourceTiming 인터페이스에서 정의된 타이밍 속성들을 보여줍니다. 괄호 안의 속성은 교차 출처 리소스를 가져올 때 사용 불가능할 수 있습니다. 사용자 에이전트는 타이밍들 사이에 내부 처리를 수행할 수 있으며, 이는 타이밍 사이에 비규범적 간격을 유발할 수 있습니다.