CORS プリフライト (Preflight)

OPTIONS プリフライトがいつ発生しどのヘッダーを検査するかをステップ可視化。Access-Control-Request-* とサーバーの Allow-* の対応が分かります。

シナリオプリセット

リクエスト — ブラウザ(ページ)側

Method

Content-Type

カスタムヘッダー

Access-Control-Request-Headers: content-type, x-api-key

レスポンス — サーバーが返すヘッダー

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

リクエストに必要なヘッダー+よく使う値 — クリックで切替

ブラウザの処理ステップ

→

ページから fetch リクエスト発生

•

単純リクエストではない — OPTIONS プリフライトが必要

→

OPTIONS プリフライト送信

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, x-api-key
←

サーバーのプリフライト応答が到着

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST, PUT
Access-Control-Allow-Headers: content-type, x-api-key
✓

Allow-Origin がオリジンと一致 — 通過

✓

メソッドが Allow-Methods に含まれる — 通過

✓

リクエストヘッダーが Allow-Headers にすべて含まれる — 通過

—

credentials 未使用 — 検査スキップ

✓

プリフライト通過 — 本リクエストへ

→

本リクエスト送信

POST /data HTTP/1.1
Origin: https://myapp.example.com
Content-Type: application/json
X-Api-Key: s3cr3t
←

サーバーの本応答が到着

HTTP/1.1 200 OK
Access-Control-Allow-Origin: https://myapp.example.com

{"status": "ok"}
✓

Allow-Origin がオリジンと一致 — 通過

✓

応答が JavaScript に渡された — 成功

ブラウザコンソール

▸ レスポンスが JavaScript コードに正常に渡されました。

値を変えると下のステップが即座に再計算されます。「credentials + *」シナリオでワイルドカードがなぜ失敗するか確かめてみてください。

リクエストが「単純」の条件を外れると、ブラウザは本リクエスト前に OPTIONS プリフライトを送ります。Access-Control-Request-Method/Headers で「このメソッド・ヘッダーを使う予定」と事前確認する手順です。

サーバーは3つのヘッダーで応答します:Allow-Origin(オリジン許可)、Allow-Methods(メソッド一覧)、Allow-Headers(ヘッダー一覧)。1つでも不足すれば本リクエスト自体が送られません。

プリフライトは毎回の遅延になるので Access-Control-Max-Age を返してブラウザにキャッシュさせるのが定番です。PUT/DELETE や Authorization を使う API では必須級です。 CORS シミュレーター

よくある質問

どんなときにプリフライトが出る?
GET/HEAD/POST 以外のメソッド、safelist 外ヘッダー(Authorization、X-カスタム)、application/json のような非単純 Content-Type のいずれか。
OPTIONS がサーバーで 404 になります
ルーターが OPTIONS を処理していません。CORS ミドルウェアを使えば自動応答します。自前なら OPTIONS ルートを開けて Allow-* と 204 を返してください。

他のシナリオ