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

Что делает document.cookie?

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

document.cookie позволяет читать и записывать cookies текущей страницы, но API работает как строка и требует аккуратности.

Вопрос

Что делает document.cookie и чем cookies отличаются от localStorage?

Определение

Cookie - небольшая строка данных, связанная с сайтом. Cookies часто используются для сессий, пользовательских настроек и серверной идентификации.

document.cookie дает JavaScript доступ к cookies, если они не помечены флагом HttpOnly.

document.cookie = 'theme=dark; path=/; max-age=3600';

Это установит cookie theme на один час.

console.log(document.cookie);
// "theme=dark; lang=ru"

При чтении document.cookie возвращает одну строку со всеми доступными cookies.

Полезные параметры

ПараметрЧто делает
path=/область действия по пути
max-age=3600срок жизни в секундах
expires=...дата истечения
secureотправлять только по HTTPS
samesite=strictограничить отправку с других сайтов
КритерийCookielocalStorage
Отправка на серверавтоматически с запросамине отправляется автоматически
Размернебольшойобычно больше
APIстроковыйметоды getItem/setItem
HttpOnlyвозможнонет
Частый сценарийсессии, серверная авторизацияUI-настройки

Важный нюанс безопасности

JavaScript не может прочитать cookie с флагом HttpOnly. Это полезно для защиты session-cookie от XSS.

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

  • document.cookie возвращает только cookies без HttpOnly одной строкой a=1; b=2.
  • Запись document.cookie = "theme=dark; Max-Age=3600" добавляет или обновляет одну cookie.
  • Значения нужно кодировать через encodeURIComponent.
  • Асинхронный Cookie Store API (cookieStore.get/set) удобнее, но поддерживается не везде.

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

document.cookie = 'name=value; path=/; max-age=3600';
document.cookie; // строка доступных cookies

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

MDN: Document.cookie, MDN: Cookie Store API.

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

Поиск

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