브라우저 지원
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
Chrome팀은 사용자가 이동할 가능성이 있는 향후 페이지에 대한 완전한 사전 렌더링을 다시 도입했습니다.
사전 렌더링의 간략한 기록
이전에는 Chrome에서 <link rel="prerender" href="/next-page">
리소스 힌트를 지원했지만 Chrome 외에 광범위하게 지원되지 않았으며 그다지 표현력이 좋은 API도 아니었습니다.
링크 rel=prerender
힌트를 사용하는 이 기존 사전 렌더링은 지원 중단되었으며 NoState Prefetch로 대체되었습니다. NoState Prefetch는 대신 향후 페이지에 필요한 리소스를 가져왔지만 페이지를 완전히 사전 렌더링하거나 JavaScript를 실행하지는 않았습니다. NoState 미리 가져오기는 리소스 로드를 개선하여 페이지 성능을 개선하는 데 도움이 되지만, 전체 사전 렌더링처럼 즉각적인 페이지 로드를 제공하지는 않습니다.
이제 Chrome팀은 전체 사전 렌더링을 Chrome에 다시 도입했습니다. 기존 사용으로 인한 복잡성을 방지하고 향후 사전 렌더링을 확장할 수 있도록 이 새로운 사전 렌더링 메커니즘은 NoState 미리 가져오기에 남아 있는 <link rel="prerender"...>
문법을 사용하지 않으며 향후 사용 중지될 예정입니다.
페이지는 어떻게 사전 렌더링되나요?
페이지는 다음 네 가지 방법 중 하나로 사전 렌더링할 수 있으며 모두 더 빠르게 탐색하는 것을 목표로 합니다.
- Chrome 주소 표시줄('검색주소창'이라고도 함)에 URL을 입력하면 Chrome은 사용자의 이전 방문 기록을 토대로 해당 페이지를 방문할 것이라고 확신하는 경우 해당 페이지를 자동으로 사전 렌더링할 수 있습니다.
- 북마크바를 사용하면 Chrome에서 포인터를 북마크 버튼 중 하나에 올려놓으면 페이지를 자동으로 사전 렌더링할 수 있습니다.
- Chrome 주소 표시줄에 검색어를 입력하면 검색엔진의 지시에 따라 Chrome에서 자동으로 검색결과 페이지를 사전 렌더링할 수 있습니다.
- 사이트에서 Speculation Rules API를 사용하여 사전 렌더링할 페이지를 프로그래매틱 방식으로 Chrome에 알릴 수 있습니다. 이는
<link rel="prerender"...>
에서 사용하던 작업을 대체하며 사이트에서 페이지의 추측 규칙에 따라 페이지를 사전에 미리 렌더링할 수 있습니다. 이러한 객체는 페이지에 정적으로 존재할 수도 있고, 페이지 소유자가 적합하다고 판단하는 경우 JavaScript에 의해 동적으로 삽입될 수도 있습니다.
이러한 각각의 경우에 사전 렌더링은 페이지가 보이지 않는 배경 탭에서 열린 것처럼 동작하고 '활성화'된 것처럼 작동합니다. 포그라운드 탭을 사전 렌더링된 페이지로 바꿉니다. 페이지가 완전히 사전 렌더링되기 전에 활성화되면 현재 상태가 '포그라운드'가 됩니다. 계속 로드되므로 처음부터 쉽게 시작할 수 있습니다.
를 탭합니다. 사전 렌더링된 페이지가 숨겨진 상태에서 열릴 때 방해하는 동작 (예: 메시지)을 유발하는 여러 API가 이 상태에서 활성화되지 않고 페이지가 활성화될 때까지 지연됩니다. 아직 이 작업이 불가능한 소수의 경우에는 사전 렌더링이 취소됩니다. Chrome팀은 사전 렌더링 취소 이유를 API로 노출하고, 이러한 예외적인 사례를 더 쉽게 식별할 수 있도록 DevTools 기능을 향상하기 위해 노력하고 있습니다.
사전 렌더링의 영향
다음 동영상과 같이 사전 렌더링을 사용하면 페이지를 거의 즉각적으로 로드할 수 있습니다.
<ph type="x-smartling-placeholder">예시 사이트는 이미 빠른 사이트이지만, 이 경우에도 사전 렌더링이 사용자 환경을 어떻게 개선하는지 확인할 수 있습니다. 따라서 LCP가 거의 0에 가깝고 CLS가 감소하고 (모든 로드 CLS가 초기 보기 전에 발생하므로), INP (사용자가 상호작용하기 전에 로드가 완료되어야 함)가 개선되어 사이트의 코어 웹 바이탈에도 직접적인 영향을 미칠 수 있습니다.
페이지가 완전히 로드되기 전에 활성화되더라도 페이지 로드를 미리 시작하면 로드 환경이 개선됩니다. 사전 렌더링이 진행 중일 때 링크가 활성화되면 사전 렌더링 페이지가 기본 프레임으로 이동하여 계속 로드됩니다.
그러나 사전 렌더링은 추가 메모리 및 네트워크 대역폭을 사용합니다. 과도한 사전 렌더링을 피해야 하므로 사용자 리소스를 대신 사용해야 합니다. 페이지로 이동할 가능성이 높은 경우에만 사전 렌더링합니다.
분석에서 실제 성능에 미치는 영향을 측정하는 방법에 대한 자세한 내용은 성능 측정 섹션을 참조하세요.
Chrome 주소 표시줄 예상 검색어 보기
첫 번째 사용 사례의 경우 chrome://predictors
페이지에서 Chrome의 URL 예측을 볼 수 있습니다.
![Chrome 예측자 페이지가 입력된 텍스트를 기준으로 낮음 (회색), 중간 (황색), 높음 (녹색) 예상 검색어를 표시하도록 필터링되었습니다.](https://developer.chrome.google.cn/static/docs/web-platform/prerender-pages/image/screenshot-the-chrome-pr-ec7e1506f8378.png?authuser=0000&hl=ko)
녹색 선은 사전 렌더링을 트리거할 만큼의 신뢰도를 나타냅니다. 이 예에서는 's'를 어느 정도 신뢰감을 줄 수 있지만 (황색) 일단 'sh'를 입력하면 그러면 Chrome은 거의 항상 https://sheets.google.com
로 이동할 수 있습니다.
이 스크린샷은 비교적 최근에 Chrome을 설치하여 0으로 신뢰도가 예측되는 예측을 필터링한 상태에서 촬영되었지만, 자체 예측 변수를 보면 훨씬 더 많은 항목을 볼 수 있고, 충분히 높은 신뢰도에 도달하기 위해 더 많은 문자가 필요할 수 있습니다.
또한 이러한 예측자는 사용자가 확인했을 수도 있는 주소 표시줄 추천 옵션을 구동하는 역할을 합니다.
<ph type="x-smartling-placeholder">![Chrome 주소 표시줄 'Typeahead' 특성](https://developer.chrome.google.cn/static/docs/web-platform/prerender-pages/image/screenshot-the-address-b-7938093dbbc3c.png?authuser=0000&hl=ko)
Chrome은 사용자의 입력과 선택사항에 따라 예측자를 지속적으로 업데이트합니다.
- 신뢰도가 50% 이상인 경우 (황색으로 표시됨) Chrome은 사전에 도메인에 미리 연결하지만 페이지를 사전 렌더링하지는 않습니다.
- 80% 이상의 신뢰도 수준 (녹색으로 표시)의 경우 Chrome은 URL을 사전 렌더링합니다.
Speculation Rules API
Speculation Rules API 사전 렌더링 옵션의 경우 웹 개발자는 페이지에 JSON 안내를 삽입하여 사전 렌더링할 URL을 브라우저에 알릴 수 있습니다.
<script type="speculationrules">
{
"prerender": [
{
"urls": ["next.html", "next2.html"]
}
]
}
</script>
또는 href
선택기 (URL 패턴 API 기반) 또는 CSS 선택자를 기반으로 문서에서 찾은 링크를 사전 렌더링하는 문서 규칙 (Chrome 121에서 사용 가능)을 통해 다음을 실행합니다.
<script type="speculationrules">
{
"prerender": [{
"where": {
"and": [
{ "href_matches": "/*" },
{ "not": {"href_matches": "/wp-admin"}},
{ "not": {"href_matches": "/*\\?*(^|&)add-to-cart=*"}},
{ "not": {"selector_matches": ".do-not-prerender"}},
{ "not": {"selector_matches": "[rel~=nofollow]"}}
]
}
}]
}
</script>
Chrome팀에서 사이트에 추측 규칙을 추가하는 방법을 안내하는 추측 규칙 Codelab을 준비했습니다.
열망
브라우저 지원
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
eagerness
설정은 추측이 실행되어야 하는 시점을 나타내는 데 사용되며, 문서 규칙에 특히 유용합니다.
immediate
: 가능한 한 빨리, 즉 추측 규칙이 적용되는 즉시 추론하는 데 사용됩니다.eager
:immediate
설정과 동일하게 작동하지만 향후immediate
와moderate
사이에 배치할 예정입니다.moderate
: 링크 위에 포인터를 200밀리초 동안 (또는 이 시간이 더 빠른 경우pointerdown
이벤트에서,hover
이벤트가 없는 경우 모바일에서) 추측을 실행합니다.conservative
: 포인터 또는 터치 다운을 추측합니다.
list
규칙의 기본 eagerness
는 immediate
입니다. moderate
및 conservative
옵션을 사용하여 list
규칙을 사용자가 특정 목록으로 상호작용하는 URL로 제한할 수 있습니다. 하지만 대부분의 경우 적절한 where
조건이 있는 document
규칙이 더 적절할 수 있습니다.
document
규칙의 기본 eagerness
는 conservative
입니다. 문서가 여러 URL로 구성될 수 있으므로 document
규칙에 immediate
또는 eager
를 사용할 때는 주의해야 합니다 (다음의 Chrome 제한 섹션 참고).
사용할 eagerness
설정은 사이트에 따라 다릅니다. 가볍고 정적인 사이트의 경우 좀 더 열심히 추측하는 것은 비용이 거의 들지 않고 사용자에게 도움이 될 수 있습니다. 더 복잡한 아키텍처와 무거운 페이지 페이로드를 사용하는 사이트는 사용자들로부터 낭비를 제한하라는 긍정적인 신호를 얻을 때까지 추측을 줄여 낭비를 줄이는 편을 선호할 수 있습니다.
moderate
옵션은 중간값이며, 많은 사이트는 포인터를 링크 위에 200밀리초 동안 또는 포인터다운 이벤트를 기본(하지만 강력한 추측 규칙) 구현으로 유지할 때 링크를 사전 렌더링하는 다음과 같은 추측 규칙의 이점을 누릴 수 있습니다.
<script type="speculationrules">
{
"prerender": [{
"where": {
"href_matches": "/*"
},
"eagerness": "moderate"
}]
}
</script>
프리페치
추측 규칙은 전체 사전 렌더링 없이 페이지를 미리 가져오는 데 사용할 수도 있습니다. 이는 종종 사전 렌더링으로 가는 좋은 첫걸음이 될 수 있습니다.
<script type="speculationrules">
{
"prefetch": [
{
"urls": ["next.html", "next2.html"]
}
]
}
</script>
Chrome 한도
Chrome에는 Speculation Rules API의 남용을 방지하기 위해 다음과 같은 제한이 있습니다.
열의 | 프리페치 | 사전 렌더링 |
---|---|---|
immediate /eager |
50 | 10 |
moderate /conservative |
2 (FIFO) | 2 (FIFO) |
사용자 상호작용에 의존하는 moderate
및 conservative
설정은 선입 선출 (FIFO) 방식으로 작동합니다. 한도에 도달한 후 새 추측이 가장 오래된 추측을 취소하고 새 추측으로 교체하여 메모리를 보존합니다. 취소된 추측이 다시 트리거될 수 있습니다(예: 해당 링크 위로 마우스를 다시 가져가면). 그러면 해당 URL이 다시 추측되어 가장 오래된 추측이 푸시됩니다. 이 경우 이전 예측은 해당 URL에 대한 HTTP 캐시의 캐시 가능한 모든 리소스를 캐시하므로 추가 시간을 예측하면 비용이 절감됩니다. 이러한 이유로 한도가 적당한 기준값인 2로 설정됩니다. 정적 목록 규칙은 사용자 작업에 의해 트리거되지 않으므로 브라우저에서 필요한 항목과 시기를 알 수 없기 때문에 한도가 더 높습니다.
immediate
및 eager
한도도 동적이므로 list
URL 스크립트 요소를 삭제하면 삭제된 추측을 취소하여 용량이 생성됩니다.
또한 Chrome은 다음과 같은 특정 조건에서 추측이 사용되는 것을 방지합니다.
- 데이터 저장.
- 에너지 절약 모드(사용 설정되었으며 배터리가 부족할 때)
- 메모리 제약.
- '페이지 미리 로드' 설정이 사용 중지되어 있는지 확인합니다 (uBlock Origin과 같은 Chrome 확장 프로그램에서도 명시적으로 사용 중지함).
- 페이지가 백그라운드 탭에서 열려 있습니다.
또한 Chrome은 활성화될 때까지 사전 렌더링된 페이지에서 교차 출처 iframe을 렌더링하지 않습니다.
이러한 모든 조건은 과잉 추측이 사용자에게 해를 끼칠 때 그 영향을 줄이는 것을 목표로 합니다.
페이지에 추측 규칙을 포함하는 방법
추측 규칙은 페이지의 HTML에 정적으로 포함되거나 자바스크립트를 통해 페이지에 동적으로 삽입될 수 있습니다.
- 정적으로 포함된 추측 규칙: 예를 들어 뉴스 미디어 사이트나 블로그가 최신 기사를 사전 렌더링할 수 있습니다(많은 사용자에게 다음 탐색 규칙인 경우). 또는
moderate
또는conservative
가 있는 문서 규칙을 사용하여 사용자가 링크와 상호작용할 때 추측할 수 있습니다. - 동적으로 삽입된 추측 규칙: 애플리케이션 로직, 사용자에게 맞춤설정되거나 다른 휴리스틱을 기반으로 할 수 있습니다.
이전에 <link rel=prefetch>
를 사용하여 많은 라이브러리가 그랬던 것처럼 마우스 오버 또는 링크 클릭과 같은 작업을 기반으로 동적 삽입을 선호하는 개발자는 브라우저에서 많은 사용 사례를 처리할 수 있도록 문서 규칙을 살펴보는 것이 좋습니다.
추측 규칙은 메인 프레임의 <head>
또는 <body>
에 추가할 수 있습니다. 하위프레임의 추측 규칙은 처리되지 않으며, 사전 렌더링된 페이지의 추측 규칙은 해당 페이지가 활성화된 후에만 적용됩니다.
Speculation-Rules
HTTP 헤더
브라우저 지원
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
추측 규칙은 문서의 HTML에 직접 포함하는 대신 Speculation-Rules
HTTP 헤더를 사용하여 전달할 수도 있습니다. 따라서 문서 콘텐츠를 직접 변경하지 않고도 CDN에서 더 쉽게 배포할 수 있습니다.
Speculation-Rules
HTTP 헤더는 문서와 함께 반환되며 추측 규칙이 포함된 JSON 파일의 위치를 가리킵니다.
Speculation-Rules: "/speculationrules.json"
이 리소스는 올바른 MIME 유형을 사용해야 하며 교차 출처 리소스인 경우 CORS 검사를 통과해야 합니다.
Content-Type: application/speculationrules+json
Access-Control-Allow-Origin: *
상대 URL을 사용하려면 추측 규칙에 "relative_to": "document"
키를 포함하는 것이 좋습니다. 그렇지 않으면 상대 URL이 예측 규칙 JSON 파일의 URL을 기준으로 합니다. 이는 출처가 동일한 링크의 일부 또는 전체를 선택해야 하는 경우 특히 유용합니다.
추측 규칙 및 SPA
추측 규칙은 브라우저에서 관리하는 전체 페이지 탐색에만 지원되며 단일 페이지 앱 (SPA) 또는 앱 셸 페이지에서는 지원되지 않습니다. 이러한 아키텍처는 문서 가져오기를 사용하지 않고 대신 데이터나 페이지의 API 또는 부분 가져오기를 실행합니다. 그런 다음 처리되어 현재 페이지에 표시됩니다. 이 기능에 필요한 데이터를 '소프트 탐색'이라고 하며 예측 규칙 외부에서 앱이 미리 가져올 수 있지만 사전 렌더링할 수는 없습니다.
예측 규칙은 이전 페이지에서 애플리케이션 자체를 사전 렌더링하는 데 사용할 수 있습니다. 이는 일부 SPA에서 발생하는 추가 초기 로드 비용을 상쇄하는 데 도움이 될 수 있습니다. 하지만 앱 내의 경로 변경사항은 사전 렌더링할 수 없습니다.
추측 규칙 디버그
이 새로운 API를 보고 디버깅하는 데 도움이 되는 새로운 Chrome DevTools 기능은 예측 규칙 디버깅 전용 게시물을 참고하세요.
여러 추측 규칙
여러 추측 규칙을 동일한 페이지에 추가할 수도 있으며 기존 규칙에 추가할 수 있습니다. 따라서 다음과 같은 다양한 방식에서는 모두 one.html
및 two.html
사전 렌더링이 발생합니다.
URL 목록:
<script type="speculationrules">
{
"prerender": [
{
"urls": ["one.html", "two.html"]
}
]
}
</script>
여러 speculationrules
스크립트:
<script type="speculationrules">
{
"prerender": [
{
"urls": ["one.html"]
}
]
}
</script>
<script type="speculationrules">
{
"prerender": [
{
"urls": ["two.html"]
}
]
}
</script>
한 speculationrules
세트에 여러 목록 포함
<script type="speculationrules">
{
"prerender": [
{
"urls": ["one.html"]
},
{
"urls": ["two.html"]
}
]
}
</script>
No-Vary-Search
지원
브라우저 지원
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
-
<ph type="x-smartling-placeholder">
페이지를 미리 가져오거나 사전 렌더링할 때 특정 URL 매개변수 (엄밀히 말해 검색 매개변수라고 함)는 실제로 서버에서 제공하고 클라이언트 측 JavaScript에서만 사용할 수 있는 페이지에 중요하지 않을 수 있습니다.
예를 들어 UTM 매개변수는 Google 애널리틱스에서 캠페인 측정에 사용되지만 일반적으로 서버에서 다른 페이지가 전송되지는 않습니다. 즉, page1.html?utm_content=123
및 page1.html?utm_content=456
는 서버에서 동일한 페이지를 제공하므로 캐시에서 동일한 페이지를 재사용할 수 있습니다.
마찬가지로 애플리케이션은 클라이언트 측에서만 처리되는 다른 URL 매개변수를 사용할 수 있습니다.
No-Vary-Search 제안을 사용하면 전달된 리소스에 차이를 일으키지 않는 매개변수를 서버에서 지정할 수 있으므로, 브라우저에서 이러한 매개변수에만 차이가 나는 문서의 이전에 캐시된 버전을 재사용할 수 있습니다. 이는 Chrome (및 Chromium 기반 브라우저)에서 미리 가져오기 탐색 추측을 위해 지원됩니다 (사전 렌더링에도 지원될 예정임).
추측 규칙은 No-Vary-Search
HTTP 헤더가 반환될 것으로 예상되는 위치를 나타내기 위해 expects_no_vary_search
사용을 지원합니다. 이렇게 하면 불필요한 다운로드를 방지하는 데 도움이 됩니다.
<script type="speculationrules">
{
"prefetch": [{
"urls": ["/products*"],
"expects_no_vary_search": "params=(\"id\")"
}]
}
</script>
<a href="/products?id=123">Product 123</a>
<a href="/products?id=124">Product 124</a>
이 예에서 /products
초기 페이지 HTML은 제품 ID 123
및 124
에서 동일합니다. 하지만 페이지 콘텐츠는 id
검색 매개변수를 사용하여 제품 데이터를 가져오는 JavaScript를 사용하는 클라이언트 측 렌더링에 따라 달라집니다. 따라서 이 URL을 빠르게 미리 가져오면 페이지가 모든 id
검색 매개변수에 사용할 수 있음을 보여주는 No-Vary-Search
HTTP 헤더가 반환되어야 합니다.
하지만 미리 가져오기가 완료되기 전에 사용자가 링크를 클릭했다면 브라우저에서 /products
페이지를 수신하지 못했을 수 있습니다. 이 경우 브라우저는 No-Vary-Search
HTTP 헤더가 포함되는지 알 수 없습니다. 그런 다음 브라우저에 링크를 다시 가져올지 아니면 미리 가져오기가 완료될 때까지 기다린 후 No-Vary-Search
HTTP 헤더가 포함되는지 여부를 선택할 수 있습니다. expects_no_vary_search
설정을 사용하면 브라우저에서 페이지 응답에 No-Vary-Search
HTTP 헤더가 포함될 것으로 예상된다는 것을 인지하고 미리 가져오기가 완료될 때까지 기다릴 수 있습니다.
추측 규칙 제한사항 및 향후 개선사항
추측 규칙은 동일한 탭 내에서 열리는 페이지로 제한되지만, Google은 이러한 제한을 줄이기 위해 노력하고 있습니다.
기본적으로 추측은 동일한 출처 페이지로 제한됩니다. 추측 동일 사이트 교차 출처 페이지 (예: https://a.example.com
, https://b.example.com
에서 페이지를 사전 렌더링할 수 있음) 이를 사용하려면 추측된 페이지 (이 예시에서는 https://b.example.com
)가 Supports-Loading-Mode: credentialed-prerender
HTTP 헤더를 포함하여 선택해야 합니다. 그렇지 않으면 Chrome에서 추측을 취소합니다.
사전 렌더링된 페이지에 쿠키가 없고 사전 렌더링된 페이지가 유사한 Supports-Loading-Mode: uncredentialed-prerender
HTTP 헤더를 사용하는 경우 향후 버전에서 동일 사이트, 교차 출처 페이지도 사전 렌더링을 허용할 수 있습니다.
추측 규칙은 교차 출처 미리 가져오기를 이미 지원하지만, 이 경우에도 교차 출처 도메인의 쿠키가 존재하지 않는 경우에만 지원됩니다. 이전에 해당 사이트를 방문한 적이 있는 사용자에게 쿠키가 존재하는 경우 추측이 트리거되지 않고 DevTools에 실패가 표시됩니다.
이러한 현재의 한계를 감안할 때, 가능한 경우 내부 링크와 외부 링크 모두의 사용자 경험을 개선할 수 있는 패턴은 동일 출처 URL을 사전 렌더링하고 교차 출처 URL을 미리 가져오려고 시도하는 것입니다.
<script type="speculationrules">
{
"prerender": [
{
"where": { "href_matches": "/*" },
"eagerness": "moderate"
}
],
"prefetch": [
{
"where": { "not": { "href_matches": "/*" } },
"eagerness": "moderate"
}
]
}
</script>
기본적으로 보안을 위해서는 교차 출처 링크에 대한 교차 출처 추측을 차단하는 제한이 필요합니다. 이는 쿠키를 전송하지 않지만 미리 가져오기를 시도하는 교차 출처 대상의 경우 <link rel="prefetch">
를 개선한 것으로, 다시 전송해야 하는 미리 가져오기가 낭비되거나, 더 심각한 경우 잘못된 페이지 로드가 발생합니다.
를 탭합니다. 서비스 워커가 제어하는 페이지의 미리 가져오기에는 추측 규칙이 지원되지 않습니다. 이 지원을 추가하기 위해 노력하고 있습니다. 업데이트는 이 지원 서비스 워커 문제를 따르세요. 서비스 워커가 제어하는 페이지에서는 사전 렌더링이 지원됩니다.
Detect Speculation Rules API 지원
표준 HTML 검사를 통해 Speculation Rules API 지원 기능을 감지할 수 있습니다.
if (HTMLScriptElement.supports && HTMLScriptElement.supports('speculationrules')) {
console.log('Your browser supports the Speculation Rules API.');
}
JavaScript를 통해 동적으로 예측 규칙 추가
다음은 JavaScript를 사용하여 prerender
추측 규칙을 추가하는 예입니다.
if (HTMLScriptElement.supports &&
HTMLScriptElement.supports('speculationrules')) {
const specScript = document.createElement('script');
specScript.type = 'speculationrules';
specRules = {
prerender: [
{
urls: ['/next.html'],
},
],
};
specScript.textContent = JSON.stringify(specRules);
console.log('added speculation rules to: next.html');
document.body.append(specScript);
}
이 사전 렌더링 데모 페이지에서 JavaScript 삽입을 사용한 Speculation Rules API 사전 렌더링 데모를 볼 수 있습니다.
innerHTML
를 사용하여 DOM에 직접 <script type = "speculationrules">
요소를 삽입해도 보안상의 이유로 예측 규칙이 등록되지 않으며 이전에 표시된 대로 추가해야 합니다. 하지만 새 링크가 포함된 innerHTML
를 사용하여 동적으로 삽입된 콘텐츠는 페이지의 기존 규칙에 따라 선택됩니다.
마찬가지로 Chrome DevTools에서 Elements 패널을 직접 수정하여 <script type = "speculationrules">
요소를 추가하면 추측 규칙이 등록되지 않으며 대신 이를 DOM에 동적으로 추가하는 스크립트를 콘솔에서 실행하여 규칙을 삽입해야 합니다.
태그 관리자를 통해 추측 규칙 추가
Google 태그 관리자 (GTM)와 같은 태그 관리자를 사용하여 예측 규칙을 추가하려면 이전에 언급한 것과 같은 이유로 <script type = "speculationrules">
요소를 GTM을 통해 직접 추가하는 대신 자바스크립트를 통해 삽입해야 합니다.
![Google 태그 관리자의 맞춤 HTML 태그 구성](https://developer.chrome.google.cn/static/docs/web-platform/prerender-pages/image/adding-speculation-rules-via-gtm.png?authuser=0000&hl=ko)
GTM에서 const
를 지원하지 않으므로 이 예에서는 var
를 사용합니다.
추측 규칙 취소
예측 규칙을 삭제하면 사전 렌더링이 취소되지만 이 시점이 되면 사전 렌더링을 시작하는 데 리소스가 이미 사용되었을 가능성이 있으므로 사전 렌더링을 취소할 가능성이 있다면 사전 렌더링을 하지 않는 것이 좋습니다.
추측 규칙 및 콘텐츠 보안 정책
추측 규칙은 <script>
요소를 사용하므로 JSON만 포함하더라도 사이트에서 해시 또는 nonce를 사용하여 script-src
Content-Security-Policy에 이를 포함해야 합니다.
새 inline-speculation-rules
를 script-src
에 추가하여 해시 또는 nonce 스크립트에서 삽입된 <script type="speculationrules">
요소를 지원할 수 있습니다. 이는 초기 HTML에 포함된 규칙을 지원하지 않으므로 엄격한 CSP를 사용하는 사이트의 경우 JavaScript에서 규칙을 삽입해야 합니다.
사전 렌더링 감지 및 사용 중지
사전 렌더링은 빠른 페이지 렌더링(보통 즉각적으로)을 지원하므로 일반적으로 사용자에게 긍정적인 경험을 제공합니다. 사전 렌더링된 페이지는 다른 방법으로는 달성하기 어려운 더 나은 사용자 환경을 제공하기 때문에 이는 사용자와 사이트 소유자 모두에게 유익합니다.
하지만 페이지의 상태가 변경되는 경우(예: 초기 요청 또는 페이지에서 실행 중인 JavaScript에 따라) 페이지 사전 렌더링이 발생하지 않도록 하는 경우가 있을 수 있습니다.
Chrome에서 사전 렌더링 사용 설정 및 사용 중지
사전 렌더링은 '페이지 미리 로드' 기능이 있는 Chrome 사용자에게만 사용 설정됩니다. chrome://settings/performance/
에서 설정 또한 메모리가 부족한 기기에서나 운영체제가 데이터 저장 또는 에너지 절약 모드인 경우에도 사전 렌더링이 사용 중지됩니다. Chrome 한도 섹션을 참고하세요.
사전 렌더링 서버 측 감지 및 사용 중지
사전 렌더링된 페이지는 Sec-Purpose
HTTP 헤더와 함께 전송됩니다.
Sec-Purpose: prefetch;prerender
Speculation Rules API를 사용하여 미리 가져온 페이지의 경우 다음 헤더가 prefetch
로 설정됩니다.
Sec-Purpose: prefetch
서버는 이 헤더를 기반으로 응답하여 추측 요청을 로깅하거나 다른 콘텐츠를 반환하거나 사전 렌더링이 발생하는 것을 방지할 수 있습니다. 비성공 응답 코드가 반환되면 (즉, 200 또는 304가 아닌) 페이지는 사전 렌더링되지 않으며 미리 가져오기 페이지는 모두 삭제됩니다.
특정 페이지가 사전 렌더링되지 않도록 하려면 사전 렌더링이 발생하지 않도록 하는 가장 좋은 방법입니다. 하지만 최상의 환경을 제공하려면 사전 렌더링을 허용하는 것이 좋지만, 실제로 페이지가 표시되어야 하는 작업은 자바스크립트를 사용하여 지연하는 것이 좋습니다.
JavaScript에서 사전 렌더링 감지
document.prerendering
API는 페이지가 사전 렌더링되는 동안 true
를 반환합니다. 이는 페이지가 실제로 활성화될 때까지 사전 렌더링 중에 특정 활동을 방지하거나 지연하기 위해 페이지에서 사용할 수 있습니다.
사전 렌더링된 문서가 활성화되면 PerformanceNavigationTiming
의 activationStart
도 사전 렌더링이 시작된 시점과 문서가 실제로 활성화된 시점 사이의 시간을 나타내는 0이 아닌 시간으로 설정됩니다.
다음과 같이 사전 렌더링 및 사전 렌더링된 페이지를 확인하는 함수를 사용할 수 있습니다.
function pagePrerendered() {
return (
document.prerendering ||
self.performance?.getEntriesByType?.('navigation')[0]?.activationStart > 0
);
}
페이지의 전체 또는 일부가 사전 렌더링되었는지 확인하는 가장 쉬운 방법은 페이지가 활성화된 후 DevTools를 열고 콘솔에 performance.getEntriesByType('navigation')[0].activationStart
를 입력하는 것입니다. 0이 아닌 값이 반환되면 페이지가 사전 렌더링된 것입니다.
![페이지가 사전 렌더링되었음을 나타내는 긍정적인 활성화 시작을 보여주는 Chrome DevTools의 콘솔](https://developer.chrome.google.cn/static/docs/web-platform/prerender-pages/image/console-chrome-devtools-7d567e77e3ca6.png?authuser=0000&hl=ko)
페이지를 보는 사용자가 페이지를 활성화하면 document
에서 prerenderingchange
이벤트가 전달됩니다. 그러면 이전에 페이지 로드 시 기본적으로 시작되었지만 사용자가 실제로 페이지를 볼 때까지 지연하려는 활동을 사용 설정하는 데 사용할 수 있습니다.
이러한 API를 사용하여 프런트엔드 JavaScript는 사전 렌더링된 페이지를 적절히 감지하고 조치를 취할 수 있습니다.
분석에 미치는 영향
애널리틱스는 Google 애널리틱스를 사용하여 페이지 조회수와 이벤트를 측정하는 등 웹사이트 사용량을 측정하는 데 사용됩니다. 또는 RUM (실제 사용자 모니터링)을 사용하여 페이지의 성능 측정항목을 측정할 수도 있습니다.
사용자가 페이지를 로드할 가능성이 높은 경우에만 페이지를 사전 렌더링해야 합니다. 이러한 이유로 Chrome 주소 표시줄 사전 렌더링 옵션은 가능성이 80% 이상인 경우에만 발생합니다.
하지만 특히 Speculation Rules API를 사용할 때 사전 렌더링된 페이지가 분석에 영향을 미칠 수 있고, 모든 분석 제공업체가 기본적으로 이를 수행하는 것은 아니므로 사이트 소유자가 활성화 시 사전 렌더링된 페이지에 대한 분석만 사용 설정하기 위해 코드를 추가해야 할 수도 있습니다.
이렇게 하려면 문서가 사전 렌더링 중인 경우 prerenderingchange
이벤트를 기다리거나 현재인 경우 즉시 확인되는 Promise
를 사용하면 됩니다.
// Set up a promise for when the page is activated,
// which is needed for prerendered pages.
const whenActivated = new Promise((resolve) => {
if (document.prerendering) {
document.addEventListener('prerenderingchange', resolve, {once: true});
} else {
resolve();
}
});
async function initAnalytics() {
await whenActivated;
// Initialise your analytics
}
initAnalytics();
대안은 페이지가 처음 표시될 때까지 분석 활동을 지연하는 것입니다. 이는 사전 렌더링 사례와 탭이 백그라운드에서 열리는 경우 (예: 마우스 오른쪽 버튼을 클릭하고 새 탭에서 열 때)를 모두 포함합니다.
// Set up a promise for when the page is first made visible
const whenFirstVisible = new Promise((resolve) => {
if (document.hidden) {
document.addEventListener('visibilitychange', resolve, {once: true});
} else {
resolve();
}
});
async function initAnalytics() {
await whenFirstVisible;
// Initialise your analytics
}
initAnalytics();
분석 및 유사한 사용 사례에 적합할 수 있지만, 다른 경우에는 이러한 경우에 더 많은 콘텐츠를 로드해야 할 수 있으므로 document.prerendering
및 prerenderingchange
를 사용하여 특별히 사전 렌더링 페이지를 타겟팅하는 것이 좋습니다.
사전 렌더링 중에 다른 콘텐츠 보류
앞서 설명한 것과 동일한 API를 사용하여 사전 렌더링 단계에서 다른 콘텐츠를 보류할 수 있습니다. 이는 사전 렌더링 단계에서 실행하지 않으려는 JavaScript의 특정 부분 또는 전체 스크립트 요소일 수 있습니다.
예를 들어 다음 스크립트가 있다고 가정해 보겠습니다.
<script src="https://example.com/app/script.js" async></script>
이를 이전 whenActivated
함수를 기반으로만 삽입하는 동적으로 삽입된 스크립트 요소로 변경할 수 있습니다.
async function addScript(scriptUrl) {
await whenActivated;
const script = document.createElement('script');
script.src = 'scriptUrl';
document.body.appendChild(script);
}
addScript('https://example.com/app/script.js');
이는 분석을 포함하는 개별 스크립트를 보류하거나, 방문 시 변경될 수 있는 상태 또는 기타 변수에 따라 콘텐츠를 렌더링하는 데 유용할 수 있습니다. 예를 들어 최신 정보가 표시되도록 추천, 로그인 상태, 장바구니 아이콘 등이 모두 보류될 수 있습니다.
사전 렌더링을 사용하면 이러한 상황이 더 자주 발생할 가능성이 높지만 앞서 언급한 백그라운드 탭에 로드된 페이지에도 이러한 조건이 적용됩니다 (따라서 whenActivated
대신 whenFirstVisible
함수를 사용할 수 있음).
대부분의 경우 일반적인 visibilitychange
변경사항에 관해서도 상태를 확인하는 것이 좋습니다. 예를 들어 백그라운드로 전환된 페이지로 돌아갈 때 장바구니 카운터는 장바구니에 있는 최신 항목 수로 업데이트되어야 합니다. 따라서 이는 사전 렌더링에 국한된 문제가 아니며, 사전 렌더링은 기존 문제를 더 분명하게 만드는 것뿐입니다.
Chrome에서 스크립트나 함수를 수동으로 래핑할 필요성을 일부 완화할 수 있는 한 가지 방법은 앞서 언급한 것처럼 특정 API가 보류되고 서드 파티 iframe도 렌더링되지 않는 것입니다. 따라서 수동으로 보류해야 하는 콘텐츠는 위에 있는 콘텐츠뿐입니다.
성능 측정
성능 측정항목을 측정하려면 애널리틱스는 브라우저 API가 보고하는 페이지 로드 시간보다 활성화 시간을 기준으로 측정하는 것이 더 나은지 여부를 고려해야 합니다.
Core Web Vitals(Chrome에서 Chrome 사용자 환경 보고서를 통해 측정)의 경우 사용자 환경을 측정하기 위한 것입니다. 활성화 시간을 기준으로 측정됩니다. 예를 들어 LCP가 0초인 경우가 많으며, 이는 Core Web Vitals를 개선하는 좋은 방법임을 보여줍니다.
버전 3.1.0부터 Chrome이 Core Web Vitals를 측정하는 것과 동일한 방식으로 사전 렌더링된 탐색을 처리하도록 web-vitals
라이브러리가 업데이트되었습니다. 또한 이 버전은 페이지가 전체 또는 부분적으로 사전 렌더링된 경우 Metric.navigationType
속성에서 이러한 측정항목에 사전 렌더링된 탐색에 플래그를 지정합니다.
사전 렌더링 측정
페이지가 사전 렌더링되었는지 여부를 PerformanceNavigationTiming
의 0이 아닌 activationStart
항목으로 볼 수 있습니다. 그러면 맞춤 측정기준을 사용하거나, 페이지 조회수를 기록할 때 이와 유사한 정보를 사용할 수 있습니다(예: 앞서 설명한 pagePrerendered
함수 사용).
// Set Custom Dimension for Prerender status
gtag('set', { 'dimension1': pagePrerendered() });
// Initialise GA - including sending page view by default
gtag('config', 'G-12345678-1');
이렇게 하면 애널리틱스에서 다른 탐색 유형과 비교하여 사전 렌더링된 탐색의 수를 표시할 수 있으며, 실적 측정항목 또는 비즈니스 측정항목을 이러한 다양한 탐색 유형과 연관시킬 수 있습니다. 페이지 속도가 빨라지면 사용자의 만족도가 높아지며, 이는 Google의 우수사례에 나온 것처럼 비즈니스 조치에 실질적인 영향을 미칠 수 있습니다.
인스턴트 탐색을 위한 사전 렌더링 페이지가 비즈니스에 미치는 영향을 측정하면 더 많은 탐색을 사전 렌더링하기 위해 이 기술을 사용하는 데 더 많은 노력을 기울일 가치가 있는지 또는 페이지가 사전 렌더링되지 않는 이유를 조사할 가치가 있는지 결정할 수 있습니다.
적중률 측정
사전 렌더링 후에 방문한 페이지의 영향을 측정하는 것 외에도 사전 렌더링되었지만 이후에 방문하지 않은 페이지를 측정하는 것도 중요합니다. 이는 사전 렌더링이 너무 많아 사용자의 귀중한 리소스를 거의 이익 없이 사용하고 있음을 암시할 수 있습니다.
이는 예측 규칙이 삽입될 때(브라우저에서 HTMLScriptElement.supports('speculationrules')
를 사용한 사전 렌더링 지원 여부를 확인한 후) 사전 렌더링이 요청되었음을 나타내는 애널리틱스 이벤트를 실행하여 측정할 수 있습니다. (참고로, 사전 렌더링이 요청되었다고 해서 사전 렌더링이 시작되었거나 완료되었음을 의미하지는 않습니다. 앞서 언급한 것처럼 사전 렌더링은 브라우저에 대한 힌트이며 사용자 설정, 현재 메모리 사용량 또는 기타 휴리스틱에 관한 페이지를 사전 렌더링하지 않도록 선택할 수 있기 때문입니다.)
그런 다음 이러한 이벤트 수를 실제 사전 렌더링 페이지 조회수와 비교할 수 있습니다. 또는 활성화 시 다른 이벤트를 실행하기만 하면 비교하기 쉽다면 다른 이벤트를 실행할 수도 있습니다.
'성공 적중률' 이 두 그림의 차이를 보고 근사치를 구할 수 있습니다. Speculation Rules API를 사용하여 페이지를 사전 렌더링하는 페이지의 경우 규칙을 적절하게 조정하여 높은 적중률을 유지하여 사용자를 지원하는 데 사용자 리소스를 사용하는 것과 불필요하게 사용하는 것 사이의 균형을 유지할 수 있습니다.
추측 규칙뿐만 아니라 주소 표시줄 사전 렌더링으로 인해 일부 사전 렌더링이 발생할 수 있습니다. 이를 구분하려면 document.referrer
(사전 렌더링된 주소 표시줄 탐색 포함)를 확인하면 됩니다.
사전 렌더링이 없는 페이지도 확인해야 합니다. 이는 주소 표시줄에서도 이러한 페이지가 사전 렌더링에 적합하지 않음을 나타낼 수 있기 때문입니다. 이는 이 성능 향상의 이점을 활용하지 못하고 있다는 뜻일 수 있습니다. Chrome팀은 bfcache 테스트 도구와 유사한 사전 렌더링 적합성 테스트를 위한 도구를 추가하고, 사전 렌더링이 실패한 이유를 노출하는 API를 추가할 계획입니다.
확장 프로그램에 미치는 영향
확장 프로그램 작성자가 사전 렌더링된 페이지와 관련하여 고려해야 하는 몇 가지 추가 고려사항에 대해 자세히 알아보려면 Chrome 확장 프로그램: 인스턴트 탐색을 지원하도록 API 확장에 관한 전용 게시물을 참고하세요.
의견
Chrome팀은 사전 렌더링을 활발히 개발하고 있으며 Chrome 108 출시에서 제공되는 기능의 범위를 확장하기 위한 다양한 계획이 있습니다. GitHub 저장소 또는 Issue Tracker를 사용하여 의견을 보내주세요. 이 새롭고 흥미로운 API에 관한 우수사례를 듣고 공유해 주시기 바랍니다.
관련 링크
- 추측 규칙 Codelab
- 예측 규칙 디버깅
- NoState 미리 가져오기 소개
- Speculation Rules API 사양
- 탐색 추측 GitHub 저장소
- Chrome 확장 프로그램: 빠른 탐색을 지원하도록 API 확장
감사의 말씀
Unsplash에 마크-올리비에 조두인님의 썸네일 이미지