Файлы cookie

Для использования этого API дополнение должно указать разрешение на использование API «cookies» API-разрешение в своём файле manifest.json, а также разрешения на доступ к хосту для всех сайтов, к файлам cookie которых оно хочет получить доступ. Дополнение может читать или записывать любые файлы cookie, которые можно прочитать или записать с помощью URL-адреса, соответствующего разрешениям на доступ к хосту. Например:

http://*.example.com/

Дополнение с этим разрешением на доступ к хосту может:

• Считывать незащищённый файл cookie для www.example.com, с любым путём.
• Записывать защищённый или незащищённый файл cookie для www.example.com, с любым путём.

Оно не может:

• Считывать защищённый файл cookie для www.example.com.

http://www.example.com/

Дополнение с этим разрешением на доступ к хосту может:

• Считывать незащищённый файл cookie для www.example.com, с любым путём.
• Считывать незащищённый файл cookie для .example.com, с любым путём.
• Записывать защищённый или незащищённый файл cookie для www.example.com с любым путём.
• Записывать защищённый или незащищённый файл cookie для .example.com с любым путём.

Оно не может:

• Читать или записывать файл cookie для foo.example.com.
• Читать или записывать файл cookie для foo.www.example.com.

*://*.example.com/

Дополнение с этим разрешением на доступ к хосту может:

• Читать или записывать защищённый или незащищённый файл cookie для www.example.com с любым путём.

Трекеры используют файлы cookie третьих сторон, то есть файлы cookie, установленные веб-сайтом, отличным от того, на котором вы находитесь, чтобы идентифицировать посещаемые вами веб-сайты. Например:

1. Вы посещаете a-shopping-site.com, который использует ad-tracker.com для доставки своих объявлений в сети. ad-tracker.com устанавливает файл cookie, связанный с доменом ad-tracker.com. Пока вы находитесь на a-shopping-site.com, ad-tracker.com получает информацию о просматриваемых вами товарах.
2. Теперь вы посещаете a-news-site.com, который использует ad-tracker.com для доставки объявлений. ad-tracker.com считывает свой файл cookie и использует полученную информацию от a-shopping-site.com для определения того, какие объявления отображать вам.

Firefox включает функции для предотвращения отслеживания. Эти функции разделяют файлы cookie, чтобы трекеры не могли установить связь между посещаемыми сайтами. Таким образом, в приведенном выше примере ad-tracker.com не может увидеть файл cookie, созданный на a-news-site.com при посещении a-shopping-site.com. Первая итерация этой защиты была изоляцией первого уровня, которая теперь заменяется динамическим разделением.

При использовании динамического разделения Firefox разделяет хранилище, доступное JavaScript-API, по верхнему уровню сайта, обеспечивая при этом соответствующий доступ к неразделённому хранилищу для обеспечения распространённых вариантов использования. Эта функция вводится постепенно. Подробнее об реализации см. в Статус разделения в Firefox.

Разделы хранилища определяются схемой URL верхнего уровня сайта и, когда динамическое разделение активно, значение ключа доступно через свойство partitionKey.topLevelSite в API файлов cookie, например, partitionKey: {topLevelSite: "http://site"}.

В общем случае верхнеуровневые документы находятся в неразделённом хранилище, а фреймы третьих сторон — в разделённом хранилище. Если ключ раздела определить нельзя, используется значение по умолчанию (неразделённое хранилище). Например, все сайты HTTP(S) могут использоваться в качестве ключа раздела, а URL-адреса moz-extension:- — нет. Поэтому фреймы в документах расширений Firefox не используют разделённое хранилище.

По умолчанию cookies.get(), cookies.getAll(), cookies.set() и cookies.remove() работают с файлами cookie в неразделённом хранилище. Чтобы работать с файлами cookie в разделённом хранилище в этих API, topLevelSite в partitionKey должен быть установлен. Исключение составляет getAll где установка partitionKey без topLevelSite возвращает файлы cookie в разделённом и неразделённом хранилище. cookies.onChanged срабатывает для любого файла cookie, к которому расширение может получить доступ, включая файлы cookie в разделённом хранилище. Чтобы убедиться, что изменяется правильный файл cookie, расширения должны прочитать свойство cookie.partitionKey из события и передать его значение в cookies.set() и cookies.remove().

При включённой изоляции первого уровня файлы cookie квалифицируются по домену исходной страницы, которую посетил пользователь (по существу, домен, отображаемый пользователю в строке URL, также известный как «домен первого уровня»).

Изоляцию первого уровня можно включить пользователю путём настройки конфигурации браузера и установить расширениям, используя параметр firstPartyIsolate в privacy API. Обратите внимание, что изоляция первого уровня включена по умолчанию в Tor Browser.

В API cookies домен первого уровня представлен атрибутом firstPartyDomain. Все файлы cookie, установленные при включённой изоляции первого уровня, имеют этот атрибут, установленный на домен исходной страницы. В приведенном выше примере это a-shopping-site.com для одного файла cookie и a-news-site.com для другого. При выключенной изоляции первого уровня все файлы cookie, установленные веб-сайтами, имеют это свойство, установленное на пустую строку.

API cookies.get(), cookies.getAll(), cookies.set() и cookies.remove() все принимают опцию firstPartyDomain.

При включённой изоляции первого уровня вы должны указать эту опцию, иначе вызов API завершится ошибкой и вернёт отклонение от обещания. Для get(), set(), и remove() вы должны передать строковое значение. Для getAll(), вы также можете передать null здесь, и это получит все файлы cookie, независимо от того, есть ли у них ненулевое значение для firstPartyDomain.

При выключенной изоляции первого уровня параметр firstPartyDomain является необязательным и по умолчанию равен пустой строке. Непустую строку можно использовать для получения или изменения файлов cookie изоляции первого уровня. Аналогично, передача null в качестве firstPartyDomain в getAll() вернёт все файлы cookie.

cookies.Cookie

Представляет информацию об HTTP-cookie.

cookies.CookieStore

Представляет хранилище файлов cookie в браузере.

cookies.OnChangedCause

Представляет причину изменения файла cookie.

cookies.SameSiteStatus

Представляет состояние «same-site» файла cookie.

cookies.get()

Получает информацию об одном файле cookie.

cookies.getAll()

Получает все файлы cookie, которые соответствуют заданному набору фильтров.

cookies.set()

Устанавливает файл cookie с заданными данными файла cookie; может перезаписывать эквивалентные файлы cookie, если они существуют.

cookies.remove()

Удаляет файл cookie по имени.

cookies.getAllCookieStores()

Перечисляет все существующие хранилища файлов cookie.

cookies.onChanged

Срабатывает при установке или удалении файла cookie.

• cookie-bg-picker
• list-cookies