서버 타이밍

비규범적으로 표시된 섹션뿐만 아니라, 이 명세서의 모든 저작 지침, 도표, 예시, 참고 사항도 비규범적입니다. 그 외의 모든 내용은 규범적입니다.

이 문서에서 MAY, MUST, SHOULD NOT과 같은 핵심 용어는 BCP 14 [RFC2119] [RFC8174] 에서 설명된 대로 해석되어야 하며, 이러한 용어가 모두 대문자로 표시될 때만 적용됩니다.

Server-Timing 헤더 필드는 해당 요청-응답 사이클에 대한 하나 이상의 메트릭과 설명을 전달하는 데 사용됩니다. RFC5234에서 정의된 ABNF(확장된 바커스-나우어 형식) 문법은 다음과 같습니다:

  Server-Timing             = #server-timing-metric
  server-timing-metric      = metric-name *( OWS ";" OWS server-timing-param )
  metric-name               = token
  server-timing-param       = server-timing-param-name OWS "=" OWS server-timing-param-value
  server-timing-param-name  = token
  server-timing-param-value = token / quoted-string

RFC7230에서 #, *, OWS, token, quoted-string에 대한 정의를 참고하세요.

응답에는 동일한 metric-name을 갖는 server-timing-metric 항목이 여러 개 있을 수 있으며(MAY), 사용자 에이전트는 이러한 모든 항목을 처리 및 노출해야 합니다(MUST).

사용자 에이전트는 제공된 메트릭을 임의의 순서로 노출할 수 있습니다(MAY)—즉, HTTP 헤더 필드에서의 메트릭 순서는 중요하지 않습니다.

이 헤더 필드는 향후 파라미터를 위해 확장 가능한 문법으로 정의되었습니다. 응답의 Server-Timing 헤더 필드에 인식할 수 없는 server-timing-param-name이 있으면, 사용자 에이전트는 해당 토큰을 무시하고 오류 신호 없이 계속 처리해야 합니다(MUST).

모호성을 방지하기 위해, 각 server-timing-param-name은 하나의 server-timing-metric 내에서 한 번만 나타나야 합니다(SHOULD NOT). 동일한 이름이 여러 번 지정되면, 첫 번째 인스턴스만 고려되며, 이후의 모든 인스턴스는 오류 신호 없이 무시되어야 합니다(MUST). 이 경우에만 server-timing-metric 내에서 파라미터의 순서가 중요합니다.

사용자 에이전트는 server-timing-param-value 뒤에서 다음 server-timing-param이나 현재 server-timing-metric의 끝 이전에 발견된 불필요한 문자를 무시해야 합니다(MUST).

사용자 에이전트는 metric-name 뒤에서 첫 번째 server-timing-param이나 다음 server-timing-metric 이전에 발견된 불필요한 문자를 무시해야 합니다(MUST).

이 명세는 server-timing-param-names "dur"(duration)과 "desc"(description)을 server-timing-params로 규정하며, 둘 다 선택적입니다.

서버 타이밍 헤더 필드 파싱 알고리즘은 문자열 field가 주어졌을 때 다음과 같이 동작합니다:

1. position을 position 변수로, field의 시작을 가리키도록 설정합니다.

2. name을 시퀀스 코드 포인트 수집을 field에서 U+003B(;)가 아닌 값에 대해, position을 기준으로 실행한 결과로 설정합니다.

3. ASCII 공백 앞뒤 제거를 name에 적용합니다.

4. name이 빈 문자열이면 null을 반환합니다.

5. metric을 새로운 PerformanceServerTiming로 생성하고, metric name을 name으로 설정합니다.

6. params를 빈 순서가 지정된 맵으로 설정합니다.

7. position이 field의 끝에 도달하지 않은 동안:

   1. position을 1 증가시킵니다.

   2. paramName을 시퀀스 코드 포인트 수집을 field에서 U+003D(=)가 아닌 값에 대해, position을 기준으로 실행한 결과로 설정합니다.

   3. ASCII 공백 앞뒤 제거를 paramName에 적용합니다.

   4. paramName이 빈 문자열이거나 params[paramName]이 존재하면, 다음으로 진행합니다.

   5. position을 1 증가시킵니다.

   6. paramValue를 빈 문자열로 설정합니다.

   7. ASCII 공백 건너뛰기를 field에서 position 기준으로 실행합니다.

   8. field의 position 위치에 있는 코드 포인트가 U+0022(")이면:

      1. paramValue를 HTTP 쿼티드 스트링 수집을 field에서 position 기준으로, extract-value flag를 설정하여 실행한 결과로 설정합니다.

      2. 시퀀스 코드 포인트 수집을 field에서 U+003B(;)가 아닌 값에 대해, position 기준으로 실행합니다(결과는 사용하지 않음).

   9. 그 외의 경우:

      1. rawParamValue를 시퀀스 코드 포인트 수집을 field에서 U+003B(;)가 아닌 값에 대해, position 기준으로 실행한 결과로 설정합니다.

      2. paramValue를 앞뒤 ASCII 공백 제거를 rawParamValue에 적용한 결과로 설정합니다.

8. 설정을 통해 metric의 params를 params로 지정합니다.

9. metric을 반환합니다.

WebIDL[Exposed=(Window,Worker)]
interface PerformanceServerTiming {
  readonly attribute DOMString name;
  readonly attribute DOMHighResTimeStamp duration;
  readonly attribute DOMString description;
  [Default] object toJSON();
};

toJSON가 호출되면, [WEBIDL]의 default toJSON steps를 실행합니다.

PerformanceResourceTiming 인터페이스(이 명세가 부분적으로 확장함)는 [RESOURCE-TIMING]에서 정의됩니다.

WebIDL[Exposed=(Window,Worker)]
partial interface PerformanceResourceTiming {
  readonly attribute FrozenArray<PerformanceServerTiming> serverTiming;
};

영구 메시지 헤더 필드 등록부는 아래 등록 정보로 업데이트되어야 합니다 ([RFC3864] 참고):