리소스 타이밍

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

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 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는 initiator type에 해당하는 DOMString을 가집니다.

PerformanceResourceTiming는 delivery type에 해당하는 DOMString을 가집니다.

PerformanceResourceTiming는 requested URL에 해당하는 DOMString을 가집니다.

PerformanceResourceTiming는 cache mode (빈 문자열, "local", 또는 "validated")에 해당하는 DOMString을 가집니다.

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

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로 버퍼를 충분히 확장해야 합니다.

서버측 애플리케이션은 Timing-Allow-Origin HTTP 응답 헤더를 반환하여, 명시된 문서 출처(origin)에 대해 교차 출처 제한으로 인해 0이 되었을 속성 값을 완전히 노출하도록 User Agent에 허용할 수 있습니다.

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

아래 그래프는 PerformanceResourceTiming 인터페이스에서 정의된 타이밍 속성을 보여줍니다. 괄호로 표시된 속성은 교차 출처 리소스 fetch 시 제공되지 않을 수 있습니다. 사용자 에이전트는 타이밍 사이에 내부 처리를 수행할 수 있으므로, 타이밍 간 비규범적 간격이 존재할 수 있습니다.

리소스 타이밍 마킹을 수행하려면 fetch timing info timingInfo, DOMString requestedURL, DOMString initiatorType, global object global, 문자열 cacheMode, response body info bodyInfo, status responseStatus, 그리고 선택적으로 string deliveryType (기본값은 빈 문자열)로, 다음 단계를 수행합니다:

1. PerformanceResourceTiming 객체 entry를 global의 realm에서 생성합니다.
2. 리소스 타이밍 항목 설정을 entry에 대해, initiatorType, requestedURL, timingInfo, cacheMode, bodyInfo, responseStatus, deliveryType를 사용하여 수행합니다.
3. Queue entry를 수행합니다.
4. Add entry를 global의 performance entry buffer에 추가합니다.

리소스 타이밍 항목 설정을 PerformanceResourceTiming entry에 대해, DOMString initiatorType, DOMString requestedURL, fetch timing info timingInfo, DOMString cacheMode, response body info bodyInfo, status responseStatus, 그리고 선택적 DOMString deliveryType(기본값은 빈 문자열)으로, 다음 단계를 수행합니다:

1. cacheMode가 빈 문자열, "local", 또는 "validated"임을 단언합니다.
2. global을 entry의 관련 글로벌 객체로 설정합니다.
3. Initialize entry를, 타임스탬프 변환으로 얻은 timingInfo의 start time과 global, "resource", requestedURL 및 타임스탬프 변환으로 얻은 timingInfo의 end time과 global을 사용하여 초기화합니다.
4. entry의 initiator type을 initiatorType으로 설정합니다.
5. entry의 requested URL을 requestedURL로 설정합니다.
6. entry의 timing info를 timingInfo로 설정합니다.
7. entry의 response body info를 bodyInfo로 설정합니다.
8. entry의 cache mode를 cacheMode로 설정합니다.
9. entry의 response status를 responseStatus로 설정합니다.
10. deliveryType이 빈 문자열이고 cacheMode가 빈 문자열이 아니면, deliveryType을 "cache"로 설정합니다.
11. entry의 delivery type을 deliveryType으로 설정합니다.

fetch 타임스탬프 변환을 DOMHighResTimeStamp ts와 global object global에 대해 수행하려면 다음을 실행합니다:

1. ts가 0이면 0을 반환합니다.
2. 그 밖에는, 상대 고해상도 시간을 ts와 global로 계산하여 반환합니다.