Speculation Rules API

Khái niệm và cách sử dụng

Quy tắc đầu cơ (speculation rules) có thể được chỉ định bên trong các phần tử <script type="speculationrules"> nội tuyến và các tệp văn bản bên ngoài được tham chiếu bởi header phản hồi Speculation-Rules. Các quy tắc được chỉ định dưới dạng cấu trúc JSON.

Ví dụ về script:

<script type="speculationrules">
  {
    "prerender": [
      {
        "where": {
          "and": [
            { "href_matches": "/*" },
            { "not": { "href_matches": "/logout" } },
            { "not": { "href_matches": "/*\\?*(^|&)add-to-cart=*" } },
            { "not": { "selector_matches": ".no-prerender" } },
            { "not": { "selector_matches": "[rel~=nofollow]" } }
          ]
        }
      }
    ],
    "prefetch": [
      {
        "urls": ["next.html", "next2.html"],
        "requires": ["anonymous-client-ip-when-cross-origin"],
        "referrer_policy": "no-referrer"
      }
    ]
  }
</script>

Các quy tắc đầu cơ sử dụng phần tử <script> cần được cho phép rõ ràng trong chỉ thị Content-Security-Policy script-src nếu trang bao gồm nó. Điều này được thực hiện bằng cách thêm một trong các nguồn 'inline-speculation-rules', hash-source, hoặc nonce-source.

Ví dụ HTTP header:

Speculation-Rules: "/rules/prefetch.json"

Tài nguyên văn bản chứa JSON quy tắc đầu cơ có thể có bất kỳ tên và phần mở rộng hợp lệ nào, nhưng phải được phục vụ với kiểu MIME application/speculationrules+json.

Giao diện

Speculation Rules API không định nghĩa bất kỳ giao diện nào của riêng nó.

Mở rộng cho các giao diện khác

Document.prerendering Thử nghiệm

Thuộc tính boolean trả về true nếu tài liệu đang trong quá trình prerendering.

prerenderingchange event Thử nghiệm

Được kích hoạt trên tài liệu prerendered khi nó được kích hoạt (tức là người dùng xem trang).

PerformanceNavigationTiming.activationStart Thử nghiệm

Một số đại diện thời gian giữa khi tài liệu bắt đầu prerendering và khi nó được kích hoạt.

PerformanceResourceTiming.deliveryType giá trị "navigational-prefetch" Thử nghiệm

Báo hiệu rằng loại mục performance là một prefetch.

Tiêu đề HTTP

Content-Security-Policy giá trị 'inline-speculation-rules' Thử nghiệm

Được dùng để cho phép sử dụng <script type="speculationrules"> để định nghĩa quy tắc đầu cơ trên tài liệu được fetch.

Clear-Site-Data các giá trị 'prefetchCache' và 'prerenderCache' Thử nghiệm

Dùng để xóa các đầu cơ. Ví dụ, khi trạng thái thay đổi làm cho đầu cơ cũ.

Speculation-Rules Thử nghiệm

Cung cấp danh sách URL trỏ đến tài nguyên văn bản chứa định nghĩa JSON quy tắc đầu cơ.

Supports-Loading-Mode Thử nghiệm

Được đặt bởi mục tiêu điều hướng để chọn sử dụng các chế độ tải rủi ro cao hơn.

HTML features

<script type="speculationrules"> Thử nghiệm

Dùng để định nghĩa một tập hợp quy tắc đầu cơ prefetch và/hoặc prerender bên trong tài liệu hiện tại.

Ví dụ

Xem ví dụ code tại Prerender pages in Chrome for instant page navigations trên developer.chrome.com (2025)

Thông số kỹ thuật

Tương thích trình duyệt

html.elements.script.type.speculationrules

http.headers.Speculation-Rules

Xem thêm

• Speculative loading để so sánh quy tắc đầu cơ và các tính năng cải thiện hiệu suất tương tự khác.