Урок 222 минуты чтения
Что делает document.cookie?
На этой странице
Кратко
document.cookie позволяет читать и записывать cookies текущей страницы, но API работает как строка и требует аккуратности.
Вопрос
Что делает document.cookie и чем cookies отличаются от localStorage?
Определение
Cookie - небольшая строка данных, связанная с сайтом. Cookies часто используются для сессий, пользовательских настроек и серверной идентификации.
document.cookie дает JavaScript доступ к cookies, если они не помечены флагом HttpOnly.
Запись cookie
document.cookie = 'theme=dark; path=/; max-age=3600';Это установит cookie theme на один час.
Чтение cookie
console.log(document.cookie);
// "theme=dark; lang=ru"При чтении document.cookie возвращает одну строку со всеми доступными cookies.
Полезные параметры
| Параметр | Что делает |
|---|---|
path=/ | область действия по пути |
max-age=3600 | срок жизни в секундах |
expires=... | дата истечения |
secure | отправлять только по HTTPS |
samesite=strict | ограничить отправку с других сайтов |
Cookie vs localStorage
| Критерий | Cookie | localStorage |
|---|---|---|
| Отправка на сервер | автоматически с запросами | не отправляется автоматически |
| Размер | небольшой | обычно больше |
| 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Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.