리소스 타이밍

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

이 절은 비규범적입니다.

비-널 클라이언트에 의해 요청(Request)된 리소스는 해당 클라이언트의 Performance Timeline에 PerformanceResourceTiming 객체로 포함됩니다. 다만 fetching 과정의 일부로 타임라인에서 제외된 경우는 예외입니다. HTTP 캐시에서 검색된 리소스도 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다. 가져오기가 시작되었지만 이후 중단된 리소스(예: 네트워크 오류로 인한)는 시작 및 종료 타이밍과 함께 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 속성으로 요청된 리소스만 포함됩니다. 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 게터 단계는 initiator type을 이 객체(this)에 대해 반환하도록 합니다.

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

deliveryType 게터 단계는 이 객체(this)에 대한 delivery type을 반환하도록 합니다.

workerStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 서비스 워커 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP fetch를 참조.

redirectStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 리다이렉트 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP-redirect fetch를 참조.

redirectEnd getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 리다이렉트 종료 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP-redirect fetch를 참조.

fetchStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 리다이렉트 후 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP fetch를 참조.

domainLookupStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 연결 타이밍 정보의 도메인 조회 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

domainLookupEnd getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 연결 타이밍 정보의 도메인 조회 종료 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

connectStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 연결 타이밍 정보의 연결 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

connectEnd getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 연결 타이밍 정보의 연결 종료 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

secureConnectionStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 연결 타이밍 정보의 보안 연결 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

nextHopProtocol getter 단계는 isomorphic decode를 this의 timing info의 최종 연결 타이밍 정보의 ALPN 협상 프로토콜에 대해 수행한다. 자세한 내용은 연결 타이밍 정보 기록를 참조.

Issue 221은 nextHopProtocol 지원을 제거할 것을 제안하는데, 이는 사용자의 네트워크 구성 정보를 노출할 수 있기 때문이다.

requestStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 네트워크 요청 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP fetch를 참조.

firstInterimResponseStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 첫 번째 임시 네트워크 응답 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP fetch를 참조.

finalResponseHeadersStart getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 최종 네트워크 응답 시작 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 HTTP fetch를 참조.

responseStart getter 단계는 this의 firstInterimResponseStart 가 0이 아니면 해당 값을 반환한다; 아니면 this의 finalResponseHeadersStart 값을 반환한다.

responseEnd getter 단계는 가져오기 타임스탬프 변환을 this의 timing info의 종료 시간과 해당 글로벌 객체를 this에 대해 수행한다. 자세한 내용은 fetch를 참조.

encodedBodySize getter 단계는 this의 resource info의 인코딩된 크기를 반환한다.

decodedBodySize getter 단계는 this의 resource info의 디코딩된 크기를 반환한다.

transferSize getter 단계는:

1. 이 객체(this)의 cache mode가 "local"이면 0을 반환합니다.

2. 이 객체(this)의 cache mode가 "validated"이면 300을 반환합니다.

3. 이 객체(this)의 resource info의 encoded size에 300을 더한 값을 반환합니다.

   transferSize에 더해지는 상수는 HTTP 헤더의 전체 바이트 크기를 노출하는 대신 사용됩니다. 헤더를 노출하면 특정 쿠키의 존재를 드러낼 수 있기 때문입니다. 자세한 내용은 이 이슈를 참조하십시오.

responseStatus 게터 단계는 이 객체(this)의 response status를 반환하도록 합니다.

responseStatus는 Fetch에서 결정됩니다. 교차 출처의 no-cors 요청의 경우 응답이 opaque filtered response가 되어 0이 됩니다.

contentType 게터 단계는 이 객체(this)의 resource info의 content type을 반환하도록 합니다.

contentEncoding 게터 단계는 이 객체(this)의 resource info의 content encoding을 반환하도록 합니다.

renderBlockingStatus 게터 단계는 이 객체(this)의 timing info의 render-blocking이 true이면 blocking을 반환하고; 그렇지 않으면 non-blocking을 반환합니다.

workerRouterEvaluationStart 게터 단계는 이 객체(this)의 timing info의 service worker timing info의 worker router evaluation start를 반환하도록 합니다.

workerCacheLookupStart 게터 단계는 이 객체(this)의 timing info의 service worker timing info의 worker cache lookup start를 반환하도록 합니다.

workerMatchedRouterSource 게터 단계는 이 객체(this)의 timing info의 service worker timing info의 worker matched router source를 반환하도록 합니다.

workerFinalRouterSource 게터 단계는 이 객체(this)의 timing info의 service worker timing info의 worker final router source를 반환하도록 합니다.

PerformanceResourceTiming 를 구현하는 사용자 에이전트는 "resource"를 supportedEntryTypes에 포함해야 합니다. 이를 통해 개발자들은 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 인터페이스에서 정의된 타이밍 속성들을 보여줍니다. 괄호 안의 속성은 교차 출처 리소스를 가져올 때 사용 불가능할 수 있습니다. 사용자 에이전트는 타이밍들 사이에 내부 처리를 수행할 수 있으며, 이는 타이밍 사이에 비규범적 간격을 유발할 수 있습니다.