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