리소스 타이밍

이 섹션은 비규범적입니다.

non-null client에 의해 Request가 fetch될 경우, 해당 리소스는 PerformanceResourceTiming 객체로 global object의 Performance Timeline에 포함됩니다. 단, fetch 과정에서 타임라인에 포함되지 않도록 제외된 경우는 예외입니다. HTTP 캐시에서 가져온 리소스도 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다. fetch가 시작됐으나 이후 중단된(예: 네트워크 오류) 리소스도 시작/종료 타이밍과 함께 PerformanceResourceTiming 객체로 Performance Timeline에 포함됩니다.

예시:

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

WebIDL[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 초기자 유형을 가진다.

PerformanceResourceTiming은 관련된 DOMString 전달 유형을 가진다.

PerformanceResourceTiming은 관련된 DOMString 요청된 URL을 가진다.

PerformanceResourceTiming은 관련된 DOMString 캐시 모드 (빈 문자열, "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 단계는 initiator type을 this에 대해 반환합니다.

deliveryType getter 단계는 delivery type을 this에 대해 반환합니다.

workerStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final service worker start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP fetch를 참조하세요.

redirectStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 redirect start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP-redirect fetch를 참조하세요.

redirectEnd getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 redirect end time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP-redirect fetch를 참조하세요.

fetchStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 post-redirect start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP fetch를 참조하세요.

domainLookupStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final connection timing info의 domain lookup start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

domainLookupEnd getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final connection timing info의 domain lookup end time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

connectStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final connection timing info의 connection start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

connectEnd getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final connection timing info의 connection end time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

secureConnectionStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final connection timing info의 secure connection start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

nextHopProtocol getter 단계는 isomorphic decode를 this의 timing info의 final connection timing info의 ALPN negotiated protocol에 적용합니다. 자세한 내용은 연결 타이밍 정보 기록를 참조하세요.

requestStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final network-request start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP fetch를 참조하세요.

firstInterimResponseStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 first interim network-response start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP fetch를 참조하세요.

finalResponseHeadersStart getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 final network-response start time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 HTTP fetch를 참조하세요.

responseStart getter 단계는 this의 firstInterimResponseStart 값이 0이 아니면 해당 값을 반환하고, 그렇지 않으면 this의 finalResponseHeadersStart 값을 반환합니다.

responseEnd getter 단계는 fetch 타임스탬프 변환을 this의 timing info의 end time과 관련 글로벌 객체에 대해 실행합니다. 자세한 내용은 fetch를 참조하세요.

encodedBodySize getter 단계는 this의 resource info의 encoded size 값을 반환합니다.

decodedBodySize getter 단계는 this의 resource info의 decoded size 값을 반환합니다.

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

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

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

3. this의 response body info의 encoded size에 300을 더한 값을 반환합니다.

   참고

   transferSize에 더해지는 상수 값은 HTTP 헤더의 총 바이트 크기 노출을 대체합니다. 이는 특정 쿠키의 존재를 노출할 수 있기 때문입니다. 자세한 내용은 이 이슈를 참조하세요.

responseStatus getter 단계는 this의 response status 값을 반환합니다.

contentType getter 단계는 this의 resource info의 content type 값을 반환합니다.

contentEncoding getter 단계는 this의 resource info의 content encoding 값을 반환합니다.

renderBlockingStatus getter 단계는 blocking을 반환합니다. 만약 this의 timing info의 render-blocking이 true이면, 그렇지 않으면 non-blocking을 반환합니다.

workerRouterEvaluationStart getter 단계는 this의 timing info의 service worker timing info의 worker router evaluation start를 반환하는 것이다.

workerCacheLookupStart getter 단계는 this의 timing info의 service worker timing info의 worker cache lookup start를 반환하는 것이다.

workerMatchedRouterSource getter 단계는 this의 timing info의 service worker timing info의 worker matched router source를 반환하는 것이다.

workerFinalRouterSource getter 단계는 return this의 timing info의 service worker timing info의 worker final router source를 반환하는 것이다.

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

사용자 에이전트는 MAY PerformanceResourceTiming 객체가 Performance Timeline [PERFORMANCE-TIMELINE-2]에 포함되는 리소스 개수를 제한할 수 있습니다. 본 섹션은 Performance 인터페이스를 확장하여 PerformanceResourceTiming 객체 저장 개수에 대한 제어 기능을 제공합니다.

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

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

• 리소스 타이밍 버퍼 크기 제한(초기값은 250 이상이어야 함)
• 리소스 타이밍 버퍼 현재 크기(초기값 0)
• 리소스 타이밍 버퍼 가득 참 이벤트 대기 플래그(초기값 false)
• 리소스 타이밍 보조 버퍼 현재 크기(초기값 0)
• 리소스 타이밍 보조 버퍼(초기값 비어 있음) PerformanceResourceTiming 객체를 저장

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

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

clearResourceTimings 메서드는 다음 단계로 실행됩니다:

1. PerformanceResourceTiming 객체를 performance entry buffer에서 모두 제거합니다.
2. 리소스 타이밍 버퍼 현재 크기를 0으로 설정합니다.

setResourceTimingBufferSize 메서드는 다음 단계로 실행됩니다:

1. 리소스 타이밍 버퍼 크기 제한을 maxSize 파라미터 값으로 설정합니다. maxSize가 리소스 타이밍 버퍼 현재 크기 값보다 작을 경우, PerformanceResourceTiming 객체는 performance entry buffer에서 제거하지 않습니다.

onresourcetimingbufferfull 속성은 아래에서 설명하는 resourcetimingbufferfull 이벤트의 이벤트 핸들러입니다.

리소스 타이밍 엔트리 추가 가능 여부를 확인하려면 다음 단계를 실행합니다:

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

PerformanceResourceTiming 엔트리 추가 new entry를 performance entry buffer에 추가하려면 다음 단계를 실행합니다:

1. 리소스 타이밍 엔트리 추가 가능 여부가 true이고, 리소스 타이밍 버퍼 가득 참 이벤트 대기 플래그가 false이면 다음 하위 단계를 실행합니다:
   1. new entry를 performance entry buffer에 추가합니다.
   2. 리소스 타이밍 버퍼 현재 크기를 1 증가시킵니다.
   3. 반환합니다.
2. 리소스 타이밍 버퍼 가득 참 이벤트 대기 플래그가 false이면 다음 하위 단계를 실행합니다:
   1. 리소스 타이밍 버퍼 가득 참 이벤트 대기 플래그를 true로 설정합니다.
   2. 태스크 큐에 추가를 performance timeline task source에 대해 실행하여 버퍼 가득 참 이벤트 발생를 실행합니다.
3. new entry를 리소스 타이밍 보조 버퍼에 추가합니다.
4. 리소스 타이밍 보조 버퍼 현재 크기를 1 증가시킵니다.

보조 버퍼 복사를 실행하려면 다음 단계로 진행합니다:

1. 리소스 타이밍 보조 버퍼가 비어 있지 않고, 리소스 타이밍 엔트리 추가 가능 여부가 true이면 다음 하위 단계를 반복합니다:
   1. entry를 리소스 타이밍 보조 버퍼에서 가장 오래된 PerformanceResourceTiming로 설정합니다.
   2. entry를 performance entry buffer 끝에 추가합니다.
   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로 버퍼를 충분히 확장해야 합니다.

서버 측 애플리케이션은 지정된 문서 출처(들)에 대해 교차 출처 제한으로 인해 0이 되었을 속성 값들을 사용자 에이전트가 완전히 노출할 수 있도록 Timing-Allow-Origin HTTP 응답 헤더를 반환할 수 있습니다.

Timing-Allow-Origin HTTP 응답 헤더 필드는 교차 출처 제한으로 인해 0이 되었을 속성 값들을 볼 수 있도록 허용될 수 있는 출처(들)를 나타내는 정책을 전달하는 데 사용할 수 있습니다. 헤더의 값은 다음 ABNF로 표현됩니다 [RFC5234] (List Extension 사용, [RFC9110]):

발신자는 여러 개의 Timing-Allow-Origin 헤더 필드를 생성할 수도 있습니다. 수신자는 여러 개의 Timing-Allow-Origin 헤더 필드를 각 후속 필드 값을 결합된 필드 값 뒤에 순서대로 덧붙이고 쉼표로 구분하여 결합할 수도 있습니다.

사용자 에이전트는 Timing-Allow-Origin HTTP 응답 헤더 필드가 있더라도 여전히 교차 출처 제한을 강제하고 transferSize, encodedBodySize, decodedBodySize 속성을 0으로 설정할 수도 있습니다. 그렇게 한다면 deliveryType도 ""로 설정할 수도 있습니다.

Timing-Allow-Origin 헤더는 FETCH에서 처리되어 그에 따라 속성을 계산합니다.

이 절은 Timing-Allow-Origin을 임시 메시지 헤더로 등록합니다.

헤더 필드 이름:

Timing-Allow-Origin

적용 가능한 프로토콜:

http

상태:

provisional

작성자/변경 컨트롤러:

W3C

사양 문서:

4.6 Timing-Allow-Origin 응답 헤더