Priority ヘッダー

構文

Priority: u=<priority>
Priority: i
Priority: u=<priority>, i

ディレクティブ

u=<priority>

「緊急度」 (u) 引数は、リソースの優先度値 <priority> を指定します。 この値は 0 以上 7 以下の整数であり、優先度の高い順に並んでいます（0 が最も緊急度が高い）。 リクエストのデフォルトの優先度値は 3 です。 レスポンスにはデフォルトの優先度値はありません。レスポンスにこのヘッダーが含まれていない場合は、サーバーがクライアントの優先度を変更しないことを選択したことを示します。 優先度 7 は、バックグラウンドタスクやソフトウェア更新の配信など、使い勝手に影響を与える可能性が低いリソースに対してのみ使用すべきです。

ブラウザーは、他のリソースを使用する可能性が高い文書については、デフォルトの優先度でリクエストを行うべきです。 その後、参照されるリソースについては、その到着時間が使い勝手に与える相対的な影響を反映した値を用いてリクエストを行う必要があります。

サーバーは、クライアントとは異なる優先順位の解釈を持つことができる場合があり、中間サーバーに優先順位のヒントを与えるために、異なる値をレスポンスとして返すことがあります。 中間サーバーは、この値を元のリクエストの優先順位と併せて考慮する場合があります。 レスポンスに Priority ヘッダーが持たれていない場合は、サーバーがクライアントの優先順位を変更しないことを選択したことを示しています。

i

インクリメンタル (i) ディレクティブが存在する場合、HTTP レスポンスを段階的に処理することが可能であることを示します。

段階的に処理できるリソースとは、リソース全体が利用できるのを待つのではなく、チャンクが届き次第、受信側がすぐに何か有益な処理を行えるようなリソースのことです。

ブラウザーでこのディレクティブが設定された場合、サーバーは、同じ優先度を持つすべての増分リクエストを並行して処理することを選択できます。 これにより、複数のリクエストが接続帯域幅全体に分散されるため、すべてのリクエストの処理開始は早くなりますが、完了までの総所要時間は長くなります。

ブラウザーがこのディレクティブを設定していない場合、そのリソースを段階的に処理しないことを示しています。 この場合、サーバーは、関連付けられたリクエストが生成された順序に従って、同じ緊急度を持つレスポンスを 1 つずつ送信する必要があります。

例

リソースの緊急度の設定

次の例は、HTML ファイルに対するリクエストを示しています。 緊急度は設定されていないため、デフォルト値の 3 となり、i は false となります。 これは、他のリソースを所有する文書に対する通常の設定です。

:method = GET
:scheme = https
:authority = example.net
:path = /index.html

下記のリクエストは、HTML で使用されている CSS ファイルに対する、可能性のある追跡リクエストです。 緊急度は 2 に設定されており、ブラウザーがこのリクエストをかなり高い優先度と見なしていることを示していますが、CSS ファイルは増分処理ができないため、i は設定されていません。

:method = GET
:scheme = https
:authority = example.net
:path = /style.css
priority = u=2

GET /style.css HTTP/1.1
Host: example.net
Priority: u=2

レスポンスは、下記のように表示される場合があります。 なお、この場合 priority が指定されていません。これは、サーバーが中間サーバーの優先順位を変更する必要はないと判断したことを示しています。

:status: 200
content-type: text/css
content-length: 610
date: [current date]

インクリメンタルディレクティブの設定

下記ヘッダーは、段階的にレンダリング可能な画像に対するブラウザーのリクエストを示しています。 この場合、優先度は 4（デフォルトの 3 より低い値）に設定されており、i が設定されていることで、クライアントが JPG ファイルを段階的に処理可能であることが示されています。

:method = GET
:path = /image.jpg
:scheme = https
:authority = example.net
priority = u=4, i

サーバーからは、下記のようなレスポンスが返されることがあります。 この場合、優先度は 1 に設定されており、サーバーはその具体的な画像を高い優先度で送信すべきであると認識していることを示しています。

:status: 200
content-type = image/jpeg
content-length = 610
...
priority = u=1, i

仕様書

ブラウザーの互換性

関連情報

• Cache-Control
• Vary