re:re:actable
Урок 072 минуты чтения

Как браузер отправляет cookies и credentials?

На этой странице
Кратко

Browser отправляет cookies автоматически, если совпадают правила cookie и настройки request. Для fetch на cross-origin запросах важно явно указать credentials: 'include', а server должен корректно настроить CORS.

Вопрос

Когда браузер отправляет cookies в fetch? Что делают режимы credentials и что должен вернуть сервер для cross-origin запроса с cookies?

Same-origin request

Если frontend и API на одном origin:

https://app.example.com -> https://app.example.com/api/me

Browser обычно отправит подходящие cookies автоматически.

Cross-origin request

Если frontend и API на разных origins:

https://app.example.com -> https://api.example.com/me

Для fetch нужно:

fetch('https://api.example.com/me', {
  credentials: 'include',
});

Без этого browser может не отправить cookies в cross-origin request.

Что должен вернуть server?

Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Credentials: true

Если используются credentials, нельзя ставить:

Access-Control-Allow-Origin: *

Нужно указать конкретный origin.

Credentials - это не только cookies

В browser context credentials могут включать:

  • cookies;
  • TLS client certificates;
  • HTTP authentication credentials.

Bearer token в Authorization header ты обычно добавляешь вручную, но CORS все равно может потребовать preflight.

Что важно помнить

  • У fetch три режима: omit (никогда), same-origin (по умолчанию, только свой origin) и include (всегда).
  • В axios аналог — withCredentials: true, в XHR — xhr.withCredentials = true.
  • Даже с credentials: 'include' cookie не уйдет, если ее не пропускают атрибуты SameSite, Secure, Domain или блокировка third-party cookies.
  • Ответ без Access-Control-Allow-Credentials: true будет заблокирован для JS, хотя сервер мог уже выполнить запрос.

Мини-шпаргалка

  • Browser сам решает, какие cookies подходят request.
  • Для cross-origin fetch с cookies нужен credentials: 'include'.
  • Server должен вернуть Access-Control-Allow-Credentials: true.
  • С credentials нельзя использовать wildcard * для allowed origin.
  • SameSite=None требует Secure.

Документация

MDN: Request.credentials, MDN: Access-Control-Allow-Credentials.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам