JSON-форматы cookies

Единого JSON-формата для кук не существует. В ходу четыре разных структуры, и они хранят разный объём информации. Вот как выглядит каждая и что она умеет.

Что какой формат умеет хранить

Формат	Домен	Срок жизни	Флаги
Cookie-Editor и EditThisCookie	Да	Да	Да
Puppeteer и Playwright	Да	Да	Да
Словарь key-value	Нет	Нет	Нет
Строка заголовка Cookie	Нет	Нет	Нет

Четыре структуры

Cookie-Editor и EditThisCookie

То, что экспортируют браузерные расширения. Самый полный из четырёх: хранит все атрибуты браузерной куки, включая hostOnly и флаг session. Для sameSite используются слова no_restriction, lax, strict и unspecified.

Где используется — Cookie-Editor, EditThisCookie, Cookie Quick Manager

Домен: Да
Срок жизни: Да
Флаги: Да

Пример

[
  {
    "domain": ".example.com",
    "expirationDate": 1798761600,
    "hostOnly": false,
    "httpOnly": false,
    "name": "session_id",
    "path": "/",
    "sameSite": "unspecified",
    "secure": true,
    "session": false,
    "storeId": "0",
    "value": "8f14e45fceea167a5a36dedd4bea2543"
  },
  {
    "domain": ".example.com",
    "expirationDate": 1798761600,
    "hostOnly": false,
    "httpOnly": true,
    "name": "auth_token",
    "path": "/",
    "sameSite": "unspecified",
    "secure": true,
    "session": false,
    "storeId": "0",
    "value": "eyJhbGciOiJIUzI1NiJ9.e30.ZRrHA1JJJW8opsbCGfG_HACGpVUMN_a9IV7pAx_Zmeo"
  },
  {
    "domain": "example.com",
    "expirationDate": 1798761600,
    "hostOnly": true,
    "httpOnly": false,
    "name": "theme",
    "path": "/account",
    "sameSite": "unspecified",
    "secure": false,
    "session": false,
    "storeId": "0",
    "value": "dark"
  },
  {
    "domain": ".example.com",
    "hostOnly": false,
    "httpOnly": false,
    "name": "cart_preview",
    "path": "/",
    "sameSite": "unspecified",
    "secure": false,
    "session": true,
    "storeId": "0",
    "value": "tmp-4471"
  }
]

Puppeteer и Playwright

То, что принимают page.setCookie() и context.addCookies(). Срок жизни называется expires, для сессионных кук используется -1. Для sameSite берётся HTTP-написание: None, Lax и Strict. Если sameSite опустить, браузер применит собственное значение по умолчанию, поэтому при unspecified мы поле не пишем вовсе.

Где используется — Puppeteer, Playwright, обёртки над Selenium

Домен: Да
Срок жизни: Да
Флаги: Да

Пример

[
  {
    "name": "session_id",
    "value": "8f14e45fceea167a5a36dedd4bea2543",
    "domain": ".example.com",
    "path": "/",
    "expires": 1798761600,
    "httpOnly": false,
    "secure": true
  },
  {
    "name": "auth_token",
    "value": "eyJhbGciOiJIUzI1NiJ9.e30.ZRrHA1JJJW8opsbCGfG_HACGpVUMN_a9IV7pAx_Zmeo",
    "domain": ".example.com",
    "path": "/",
    "expires": 1798761600,
    "httpOnly": true,
    "secure": true
  },
  {
    "name": "theme",
    "value": "dark",
    "domain": "example.com",
    "path": "/account",
    "expires": 1798761600,
    "httpOnly": false,
    "secure": false
  },
  {
    "name": "cart_preview",
    "value": "tmp-4471",
    "domain": ".example.com",
    "path": "/",
    "expires": -1,
    "httpOnly": false,
    "secure": false
  }
]

Словарь key-value

Плоский объект «имя — значение». Именно его передают в сессию requests или в конфиг axios. Больше он не хранит ничего: ни домена, ни срока жизни, ни флагов.

Где используется — Python requests, axios, обёртки над fetch

Домен: Нет
Срок жизни: Нет
Флаги: Нет

Пример

{
  "session_id": "8f14e45fceea167a5a36dedd4bea2543",
  "auth_token": "eyJhbGciOiJIUzI1NiJ9.e30.ZRrHA1JJJW8opsbCGfG_HACGpVUMN_a9IV7pAx_Zmeo",
  "theme": "dark",
  "cart_preview": "tmp-4471"
}

Строка заголовка Cookie

Формально это не JSON, но разговор тот же: дословное значение заголовка запроса Cookie. Пары через точку с запятой и пробел. Это то, что вставляют после curl -H или в Postman.

Где используется — curl, Postman, HTTPie, DevTools браузера

Домен: Нет
Срок жизни: Нет
Флаги: Нет

Пример

session_id=8f14e45fceea167a5a36dedd4bea2543; auth_token=eyJhbGciOiJIUzI1NiJ9.e30.ZRrHA1JJJW8opsbCGfG_HACGpVUMN_a9IV7pAx_Zmeo; theme=dark; cart_preview=tmp-4471

Конвертация между ними теряет информацию

Переход из полного формата в key-value или строку заголовка — дорога в одну сторону: домену, пути, сроку жизни и флагам негде сохраниться. Обратная конвертация даст сессионные куки с тем доменом, который вы укажете. Конвертер предупреждает, когда преобразование приведёт к потере данных.

Попробовать в конвертере

Конвертер

Нужна та же конвертация из скрипта? Netscape, Cookie-Editor, Puppeteer, key-value и Cookie-заголовок есть в публичном JSON API. Документация API