내비게이션 타이밍 레벨 2

<html>
<head>
<script type="text/javascript">
var start = new Date().getTime();
function onLoad() {
  var now = new Date().getTime();
  var latency = now - start;
  alert("page loading time: " + latency);
}
</script>
</head>
<body onload="onLoad()">
<!- Main page body goes from here. -->
</body>
</html>

startTime:           0.000  // 내비게이션 요청의 시작 시간
responseEnd:       100.000  // 마지막 바이트가 수신된 고해상도 시간

<script>
function showNavigationDetails() {
  // 첫 번째 엔트리 가져오기
  const [entry] = performance.getEntriesByType("navigation");
  // 개발자 콘솔에서 표로 보기
  console.table(entry.toJSON());
}
</script>
<body onload="showNavigationDetails()">

[Exposed=Window]
interface PerformanceNavigationTiming : PerformanceResourceTiming {
    readonly        attribute DOMHighResTimeStamp  unloadEventStart;
    readonly        attribute DOMHighResTimeStamp  unloadEventEnd;
    readonly        attribute DOMHighResTimeStamp  domInteractive;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventStart;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventEnd;
    readonly        attribute DOMHighResTimeStamp  domComplete;
    readonly        attribute DOMHighResTimeStamp  loadEventStart;
    readonly        attribute DOMHighResTimeStamp  loadEventEnd;
    readonly        attribute NavigationTimingType type;
    readonly        attribute unsigned short       redirectCount;
    readonly        attribute DOMHighResTimeStamp  criticalCHRestart;
    readonly        attribute NotRestoredReasons?  notRestoredReasons;
    readonly        attribute PerformanceTimingConfidence confidence;
    [Default] object toJSON();
};

enum NavigationTimingType {
    "navigate",
    "reload",
    "back_forward"
};

[Exposed=Window]
interface PerformanceTimingConfidence {
    readonly attribute double randomizedTriggerRate;
    readonly attribute PerformanceTimingConfidenceValue value;
    object toJSON();
};

enum PerformanceTimingConfidenceValue {
  "high",
  "low"
};

8. 폐기됨

이 섹션은 [NAVIGATION-TIMING] 1레벨에서 도입되었던 속성과 인터페이스를 하위 호환성 유지를 위해 정의합니다. 저자는 아래 인터페이스 사용을 피해야 하며, 새로운 PerformanceNavigationTiming 인터페이스 사용을 권장합니다 ― 변경점 및 개선 요약 참조.

8.1. PerformanceTiming 인터페이스

[Exposed=Window]
interface PerformanceTiming {
  readonly attribute unsigned long long navigationStart;
  readonly attribute unsigned long long unloadEventStart;
  readonly attribute unsigned long long unloadEventEnd;
  readonly attribute unsigned long long redirectStart;
  readonly attribute unsigned long long redirectEnd;
  readonly attribute unsigned long long fetchStart;
  readonly attribute unsigned long long domainLookupStart;
  readonly attribute unsigned long long domainLookupEnd;
  readonly attribute unsigned long long connectStart;
  readonly attribute unsigned long long connectEnd;
  readonly attribute unsigned long long secureConnectionStart;
  readonly attribute unsigned long long requestStart;
  readonly attribute unsigned long long responseStart;
  readonly attribute unsigned long long responseEnd;
  readonly attribute unsigned long long domLoading;
  readonly attribute unsigned long long domInteractive;
  readonly attribute unsigned long long domContentLoadedEventStart;
  readonly attribute unsigned long long domContentLoadedEventEnd;
  readonly attribute unsigned long long domComplete;
  readonly attribute unsigned long long loadEventStart;
  readonly attribute unsigned long long loadEventEnd;
  [Default] object toJSON();
};

본 섹션에서 정의된 모든 시간 값은 1970년 1월 1일 자정 (UTC) 이후 경과한 밀리초 단위로 측정됩니다.

navigationStart

이 속성은 사용자 에이전트가 이전 문서를 언로드할지 묻는 작업을 완료한 직후의 시간을 반환해야 합니다. 이전 문서가 없으면 이 속성은 현재 문서가 생성된 시간을 반환해야 합니다.

이 속성은 PerformanceNavigationTiming에 대해 정의되지 않습니다. 대신 작성자는 timeOrigin을 사용하여 이에 상응하는 타임스탬프를 얻을 수 있습니다.

unloadEventStart

이전 문서와 현재 문서의 출처가 같으면, 이 속성은 사용자 에이전트가 이전 문서의 unload 이벤트를 시작하기 직전의 시간을 반환해야 합니다. 이전 문서가 없거나 이전 문서의 출처가 현재 문서와 다르면, 이 속성은 0을 반환해야 합니다.

unloadEventEnd

이전 문서와 현재 문서가 동일 출처이면, 이 속성은 사용자 에이전트가 이전 문서의 unload 이벤트를 완료한 직후의 시간을 반환해야 합니다. 이전 문서가 없거나 이전 문서의 출처가 현재 문서와 다르거나 unload가 아직 완료되지 않았다면, 이 속성은 0을 반환해야 합니다.

탐색할 때 HTTP 리디렉션이 있고 모든 리디렉션이 동일한 출처에서 발생한 것이 아니라면, unloadEventStart와 unloadEventEnd는 모두 0을 반환해야 합니다.

redirectStart

탐색할 때 HTTP 리디렉션이 있고 모든 리디렉션이 동일한 출처에서 발생한 경우, 이 속성은 리디렉션을 시작하는 fetch 시작 시간을 반환해야 합니다. 그렇지 않으면 이 속성은 0을 반환해야 합니다.

redirectEnd

탐색할 때 HTTP 리디렉션이 있고 모든 리디렉션이 동일한 출처에서 발생한 경우, 이 속성은 마지막 리디렉션 응답의 마지막 바이트를 수신한 직후의 시간을 반환해야 합니다. 그렇지 않으면 이 속성은 0을 반환해야 합니다.

fetchStart

새 리소스를 "GET" 요청 메서드를 사용하여 fetch해야 하는 경우, fetchStart는 사용자 에이전트가 HTTP 캐시 [RFC9111]를 확인하기 시작하기 직전의 시간을 반환해야 합니다. 그렇지 않으면 사용자 에이전트가 리소스를 fetch하기 시작한 시간을 반환해야 합니다.

domainLookupStart

이 속성은 사용자 에이전트가 현재 문서에 대한 도메인 이름 조회를 시작하기 직전의 시간을 반환해야 합니다. 지속 연결 [RFC9112]을 사용하거나 현재 문서를 HTTP 캐시 [RFC9111] 또는 로컬 리소스에서 가져온 경우, 이 속성은 fetchStart와 동일한 값을 반환해야 합니다.

domainLookupEnd

이 속성은 사용자 에이전트가 현재 문서에 대한 도메인 이름 조회를 완료한 직후의 시간을 반환해야 합니다. 지속 연결 [RFC9112]을 사용하거나 현재 문서를 HTTP 캐시 [RFC9111] 또는 로컬 리소스에서 가져온 경우, 이 속성은 fetchStart와 동일한 값을 반환해야 합니다.

HTTP 캐시 [RFC9111]에서 콘텐츠를 확인하고 가져오는 작업은 fetching 프로세스의 일부입니다. 이는 requestStart, responseStart 및 responseEnd 속성에 포함됩니다.

사용자 에이전트가 이미 도메인 정보를 캐시에 가지고 있는 경우, domainLookupStart와 domainLookupEnd는 사용자 에이전트가 캐시에서 도메인 데이터를 가져오기 시작하고 끝내는 시간을 나타냅니다.

connectStart

이 속성은 사용자 에이전트가 문서를 가져오기 위해 서버에 대한 연결을 설정하기 시작하기 직전의 시간을 반환해야 합니다. 지속 연결 [RFC9112]을 사용하거나 현재 문서를 HTTP 캐시 [RFC9111] 또는 로컬 리소스에서 가져온 경우, 이 속성은 domainLookupEnd의 값을 반환해야 합니다.

connectEnd

이 속성은 사용자 에이전트가 현재 문서를 가져오기 위해 서버에 대한 연결 설정을 완료한 직후의 시간을 반환해야 합니다. 지속 연결 [RFC9112]을 사용하거나 현재 문서를 HTTP 캐시 [RFC9111] 또는 로컬 리소스에서 가져온 경우, 이 속성은 domainLookupEnd의 값을 반환해야 합니다.

전송 연결에 실패하여 사용자 에이전트가 연결을 다시 열면, connectStart와 connectEnd는 새 연결에 해당하는 값을 반환해야 합니다.

connectEnd에는 전송 연결을 설정하는 데 걸린 시간 간격뿐 아니라 SSL 핸드셰이크 및 SOCKS 인증과 같은 다른 시간 간격도 포함되어야 합니다.

secureConnectionStart

이 속성은 선택 사항입니다. 이 속성을 사용할 수 없는 사용자 에이전트는 이를 undefined로 설정해야 합니다. 이 속성을 사용할 수 있는 경우, 현재 페이지의 스킴 [URL]이 "https"라면, 이 속성은 사용자 에이전트가 현재 연결을 보호하기 위한 핸드셰이크 프로세스를 시작하기 직전의 시간을 반환해야 합니다. 이 속성을 사용할 수 있지만 HTTPS가 사용되지 않는 경우, 이 속성은 0을 반환해야 합니다.

requestStart

이 속성은 사용자 에이전트가 서버, HTTP 캐시 [RFC9111] 또는 로컬 리소스에 현재 문서를 요청하기 시작하기 직전의 시간을 반환해야 합니다.

요청을 보낸 후 전송 연결에 실패하여 사용자 에이전트가 연결을 다시 열고 요청을 다시 보내는 경우, requestStart는 새 요청에 해당하는 값을 반환해야 합니다.

이 인터페이스에는 요청 전송의 완료를 나타내는 속성(예: requestEnd)이 포함되지 않습니다.

• 사용자 에이전트에서 요청 전송이 완료되었다고 해서 네트워크 전송에서 이에 대응하는 완료 시간을 항상 나타내는 것은 아니므로, 그러한 속성을 두는 것의 이점 대부분이 사라집니다.
• 일부 사용자 에이전트는 HTTP 계층 캡슐화로 인해 실제 요청 전송 완료 시간을 확인하는 데 높은 비용이 듭니다.

responseStart

이 속성은 사용자 에이전트가 서버, HTTP 캐시 [RFC9111] 또는 로컬 리소스로부터 응답의 첫 번째 바이트를 수신한 직후의 시간을 반환해야 합니다.

responseEnd

이 속성은 사용자 에이전트가 현재 문서의 마지막 바이트를 수신한 직후 또는 전송 연결이 닫히기 직전 중 먼저 발생한 시점의 시간을 반환해야 합니다. 여기서 문서는 서버, HTTP 캐시 [RFC9111] 또는 로컬 리소스에서 수신될 수 있습니다.

domLoading

이 속성은 사용자 에이전트가 현재 문서 준비 상태를 "loading"으로 설정하기 직전의 시간을 반환해야 합니다.

기존 사용자 에이전트에서 Document 객체가 생성되는 시점의 차이로 인해, domLoading이 반환하는 값은 구현에 따라 다르므로 의미 있는 메트릭에 사용해서는 안 됩니다.

domInteractive

이 속성은 사용자 에이전트가 현재 문서 준비 상태를 "interactive"로 설정하기 직전의 시간을 반환해야 합니다.

domContentLoadedEventStart

이 속성은 사용자 에이전트가 Document에서 DOMContentLoaded 이벤트를 발생시키기 직전의 시간을 반환해야 합니다.

domContentLoadedEventEnd

이 속성은 문서의 DOMContentLoaded 이벤트가 완료된 직후의 시간을 반환해야 합니다.

domComplete

이 속성은 사용자 에이전트가 현재 문서 준비 상태를 "complete"로 설정하기 직전의 시간을 반환해야 합니다.

현재 문서 준비 상태가 동일한 상태로 여러 번 변경되는 경우, domLoading, domInteractive, domContentLoadedEventStart, domContentLoadedEventEnd 및 domComplete는 해당 문서 준비 상태 변경이 처음 발생한 시간을 반환해야 합니다.

loadEventStart

이 속성은 현재 문서의 load 이벤트가 발생하기 직전의 시간을 반환해야 합니다. load 이벤트가 아직 발생하지 않았다면 0을 반환해야 합니다.

loadEventEnd

이 속성은 현재 문서의 load 이벤트가 완료된 시간을 반환해야 합니다. load 이벤트가 발생하지 않았거나 완료되지 않았다면 0을 반환해야 합니다.

toJSON()

this에 대해 기본 toJSON 단계를 실행합니다.

8.2. PerformanceNavigation 인터페이스

[Exposed=Window]
interface PerformanceNavigation {
  const unsigned short TYPE_NAVIGATE = 0;
  const unsigned short TYPE_RELOAD = 1;
  const unsigned short TYPE_BACK_FORWARD = 2;
  const unsigned short TYPE_RESERVED = 255;
  readonly attribute unsigned short type;
  readonly attribute unsigned short redirectCount;
  [Default] object toJSON();
};

TYPE_NAVIGATE

세션 기록 처리 동작이 "default" 또는 "replace"로 설정된 탐색입니다.

TYPE_RELOAD

세션 기록 처리 동작이 "reload"로 설정된 탐색입니다.

TYPE_BACK_FORWARD

세션 기록 처리 동작이 "entry update"로 설정된 탐색입니다.

TYPE_RESERVED

위의 값으로 정의되지 않은 모든 탐색 유형입니다.

type

이 속성은 마지막 비리디렉션 탐색의 유형을 반환해야 합니다. 다음 탐색 유형 값 중 하나여야 합니다.

Refresh pragma 지시문을 사용하는 것과 같은 클라이언트 측 리디렉션은 이 명세에서 HTTP 리디렉션으로 간주되지 않습니다. 이러한 경우 type 속성은 현재 페이지를 다시 로드하는 경우 TYPE_RELOAD와 같은 적절한 값을 반환해야 하며, 새 URL로 탐색하는 경우 TYPE_NAVIGATE를 반환해야 합니다.

redirectCount

이 속성은 마지막 비리디렉션 탐색 이후의 리디렉션 수를 반환해야 합니다. 리디렉션이 없거나 대상 문서와 동일 출처가 아닌 리디렉션이 하나라도 있으면, 이 속성은 0을 반환해야 합니다.

toJSON()

this에 대해 기본 toJSON 단계를 실행합니다.

8.3. Performance 인터페이스에 대한 확장

[Exposed=Window]
partial interface Performance {
  [SameObject]
  readonly attribute PerformanceTiming timing;
  [SameObject]
  readonly attribute PerformanceNavigation navigation;
};

Performance 인터페이스는 [PERFORMANCE-TIMELINE-2]에서 정의됩니다.

timing

timing 속성은 마지막 비-리다이렉트 내비게이션 이후의 타이밍 정보를 나타냅니다.
이 속성은 PerformanceTiming 인터페이스에서 정의됩니다.

navigation

navigation 속성은 PerformanceNavigation 인터페이스에서 정의됩니다.