Тип Cookie из cookies API представляет собой информацию об HTTP cookie.

Тип

Значения этого типа - объекты, которые могут содержать следующие свойства:

name
string - содержит имя cookie.
value
string - содержит значение cookie.
domain
string - содержит домен, которому принадлежит cookie (например, "www.google.com", "example.com").
hostOnly
boolean - true если cookie является host-only (то есть запрашивающий хост должен в точности совпадать с доменом cookie), в ином случае false.
path
string - содержит path cookie.
secure
boolean - true, если cookie помечен как secure (то есть его область действия ограничена безопасными каналами, обычно HTTPS), в ином случае false.
httpOnly
boolean - true если cookie помечен как HttpOnly (то есть он недоступен для клиентских скриптов), иначе false.
session
boolean - true если cookie является сессионным, false если cookie является постоянным с указанным временем жизни.
expirationDateНеобязательный
number - содержит срок годности cookie, который представляется количеством секунд с начала UNIX-эры. Отсутствует для сессионных cookie.
storeId
string - представляет собой ID хранилища, в котором хранится данный cookie, как указано в соответствии с cookies.getAllCookieStores().

Совместимость с браузерами

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxOperaFirefox для Android
Базовая поддержкаChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45Opera Полная поддержка ДаFirefox Android Полная поддержка 48
firstPartyDomainChrome Нет поддержки НетEdge Нет поддержки НетFirefox Полная поддержка 59Opera Нет поддержки НетFirefox Android Полная поддержка 59

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки

Примеры

В большинстве методов из cookies API объекты типа Cookie используются как входные параметры методов, либо же как возвращаемые значения. К примеру, вызов cookies.getAll() возвращает массив объектов типа Cookie.

В примере ниже мы запрашиваем все cookie, а затем выводим в лог некоторые из полей полученных Cookie объектов:

function logCookies(cookies) {
  for (cookie of cookies) {
    console.log(`Domain: ${cookie.domain}`);
    console.log(`Name: ${cookie.name}`);
    console.log(`Value: ${cookie.value}`);
    console.log(`Persistent: ${!cookie.session}`);
  }
}

var gettingAll = browser.cookies.getAll({});
gettingAll.then(logCookies);

Примечание

Это API основано на API Chromiumа chrome.cookies. Эта документация основана на cookies.json из кода Chromium.

Информация о совместимости Microsoft Edge предоставлена корпорацией Microsoft и включена здесь под лицензией Creative Commons Attribution 3.0 United States License.

Метки документа и участники

Внесли вклад в эту страницу: anastasiya-solodkaya
Обновлялась последний раз: anastasiya-solodkaya,