This page was translated from English by the community.Learn more and join the MDN Web Docs community.
cookies
Позволяет расширениям получать и устанавливать куки, а также сообщать об их изменении.
Для использования этого API,вам нужно предоставить доступAPI permission в вашем файлеmanifest.json,а такжеhost permissions для тех сайтов чьи куки вам нужны для доступа.Смотритеcookie Permissions.
Types
cookies.CookieПредоставляет информацию о HTTP cookie
cookies.CookieStoreRepresents a cookie store in the browser.
cookies.OnChangedCauseRepresents the reason a cookie changed.
Methods
cookies.get()Запрашивает информацию об одном кукис.
cookies.getAll()Выдаёт все кукис которые подходят установленному фильтру.
cookies.set()Устанавливает кукис с заданной информацией;в том случае если подобный кукис был информация будет перезаписана.
cookies.remove()Удаляет кукис по имени.
cookies.getAllCookieStores()Список всех существующих куки
Event handlers
cookies.onChangedПроисходит когда кукис задаётся или меняется.
Permissions
In order to use this API, an add-on must specify the "cookies"API permission in its manifest, along withhost permissions for any sites for which it wishes to access cookies. The add-on may read or write any cookies which could be read or written by a URL matching the host permissions. For example:
http://*.example.com/An add-on with this host permission may:
- Read a non-secure cookie for
www.example.com, with any path. - Write a secure or non-secure cookie for
www.example.com, with any path.
It maynot:
- Read a secure cookie for
www.example.com.
- Read a non-secure cookie for
http://www.example.com/An add-on with this host permission may:
- Read a non-secure cookie for
www.example.com, with any path. - Read a non-secure cookie for
.example.com, with any path. - Write a secure or non-secure cookie for
www.example.comwith any path. - Write a secure or non-secure cookie for
.example.comwith any path.
It maynot:
- Read or write a cookie for
foo.example.com. - Read or write a cookie for
foo.www.example.com.
- Read a non-secure cookie for
*://*.example.com/An add-on with this host permission may:
- Read or write a secure or non-secure cookie for
www.example.comwith any path.
- Read or write a secure or non-secure cookie for
Совместимость с браузерами
Example extensions
Примечание:Этот API основан на Chromium APIchrome.cookies. Эта документация основана наcookies.json из кода Chromium.