cookies.Cookie
Тип 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()(en-US).
Совместимость с браузерами
BCD tables only load in the browser
Примеры
В большинстве методов из cookies API объекты типа Cookie используются как входные параметры методов, либо же как возвращаемые значения. К примеру, вызов cookies.getAll() (en-US) возвращает массив объектов типа Cookie.
В примере ниже мы запрашиваем все cookie, а затем выводим в лог некоторые из полей полученных Cookie объектов:
js
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.