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 シミュレーター