Preflight CORS (OPTIONS)

Cuándo se envía el preflight OPTIONS y qué cabeceras se comprueban. Mira ACRM/ACRH contra los Allow-* del servidor.

Escenarios

Petición — lado del navegador (página)

Method

Content-Type

Cabecera personalizada

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

Respuesta — cabeceras que envía el servidor

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

Cabeceras que la petición necesita + comunes — clic para alternar

Pasos del navegador

→

La página lanza un fetch

•

No es petición simple — se requiere preflight OPTIONS

→

Preflight OPTIONS enviado

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

Llega la respuesta preflight del servidor

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 coincide con el origen — pasa

✓

El método está en Allow-Methods — pasa

✓

Todas las cabeceras están en Allow-Headers — pasa

—

Sin credenciales — comprobación omitida

✓

Preflight superado — continúa la petición real

→

Petición real enviada

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

Llega la respuesta real del servidor

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

{"status": "ok"}
✓

Allow-Origin coincide con el origen — pasa

✓

Respuesta entregada a JavaScript — éxito

Consola del navegador

▸ La respuesta llegó correctamente a tu código JavaScript.

Cambia cualquier valor y los pasos se recalculan al instante. Prueba «credentials + *» para ver por qué el comodín falla.

Cuando la petición no es «simple», el navegador primero envía un OPTIONS: Access-Control-Request-Method declara el método previsto y Access-Control-Request-Headers las cabeceras. Es un permiso previo a la petición real.

El servidor responde con tres cabeceras: Allow-Origin, Allow-Methods y Allow-Headers. Si alguna no cubre la petición, el navegador ni siquiera envía la petición real.

Los preflights añaden latencia — responde con Access-Control-Max-Age para que el navegador cachee el resultado. Imprescindible en APIs con PUT/DELETE o Authorization. Simulador CORS

Preguntas frecuentes

¿Qué dispara un preflight?
Un método distinto de GET/HEAD/POST, una cabecera fuera del safelist (Authorization, X-* personalizadas) o un Content-Type como application/json.
Mi servidor devuelve 404 en OPTIONS, ¿qué hago?
El router no maneja OPTIONS. Un middleware CORS lo responde solo, o añade una ruta OPTIONS que devuelva 204 con los Allow-*.

Otros escenarios