Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Позволяет  WebExtensions получить и установить куки ,а также сообщить об их изменении.

Для использования этого API,вам нужно предоставить доступ  API permission в вашем файле manifest.json,а также  host permissions для тех сайтов чьи куки вам нужны для доступа.Смотрите cookie Permissions.

Types

cookies.Cookie
Предоставляет информацию о HTTP cookie
cookies.CookieStore
Represents a cookie store in the browser.
cookies.OnChangedCause
Represents the reason a cookie changed.

Methods

cookies.get()
Запрашивает информацию об одном кукис.
cookies.getAll()
Выдает все кукис которые подходят установленному фильтру.
cookies.set()
Устанавливает кукис с заданной информацией;в том случае если подобный кукис был информация будет перезаписана.
cookies.remove()
Удаляет кукис по имени.
cookies.getAllCookieStores()
Lists all existing cookie stores.

Event handlers

cookies.onChanged
Происходит когда кукис задаеться или меняеться.

Permissions

In order to use this API, an add-on must specify the "cookies" API permission in its manifest, along with host 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 may not:

  • Read a secure cookie for www.example.com.
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.com with any path.
  • Write a secure or non-secure cookie for .example.com with any path.

It may not:

  • Read or write a cookie for foo.example.com.
  • Read or write a cookie for foo.www.example.com.
*://*.example.com/

An add-on with this host permission may:

  • Read or write a secure or non-secure cookie for www.example.com with any path.

Browser compatibility

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxOperaFirefox для Android
CookieChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45Opera Полная поддержка ДаFirefox Android Полная поддержка 48
CookieStoreChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45Opera Полная поддержка ДаFirefox Android Полная поддержка 48
OnChangedCauseChrome Полная поддержка ДаEdge Нет поддержки НетFirefox Полная поддержка 45Opera Полная поддержка ДаFirefox Android Полная поддержка 48
getChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45
Замечания
Полная поддержка 45
Замечания
Замечания Provides access to cookies from private browsing mode and container tabs since version 52.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
getAllChrome Полная поддержка ДаEdge Полная поддержка 14
Замечания
Полная поддержка 14
Замечания
Замечания If no URL is provided, cookies are retrieved only for URLs in currently opened tabs. In Chrome, this gets all cookies on a user's machine.
Firefox Полная поддержка 45
Замечания
Полная поддержка 45
Замечания
Замечания Before version 52, the 'tabIds' list was empty and only cookies from the default cookie store were returned. From version 52 onwards, this has been fixed and the result includes cookies from private browsing mode and container tabs.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
getAllCookieStoresChrome Полная поддержка ДаEdge Полная поддержка 14
Замечания
Полная поддержка 14
Замечания
Замечания Always returns the same default cookie store with ID 0. All cookies belong to this store.
Firefox Полная поддержка 45
Замечания
Полная поддержка 45
Замечания
Замечания Before version 52, only the default cookie store was visible. From version 52 onwards, the cookie stores for private browsing mode and container tabs are also readable.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
onChangedChrome Полная поддержка ДаEdge Нет поддержки НетFirefox Полная поддержка 45Opera Полная поддержка ДаFirefox Android Полная поддержка 48
removeChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45
Замечания
Полная поддержка 45
Замечания
Замечания Before version 56, this function did not remove cookies from private browsing mode. From version 56 onwards this is fixed.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
Замечания
Полная поддержка 48
Замечания
Замечания Before version 56, this function did not remove cookies from private browsing mode. From version 56 onwards this is fixed.
setChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 45
Замечания
Полная поддержка 45
Замечания
Замечания Before version 56, this function did not modify cookies in private browsing mode. From version 56 onwards this is fixed.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
Замечания
Полная поддержка 48
Замечания
Замечания Before version 56, this function did not modify cookies in private browsing mode. From version 56 onwards this is fixed.

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Смотрите замечания реализации.
Смотрите замечания реализации.

Edge incompatibilities

Promises are not supported in Edge. Use callbacks instead.

Chrome incompatibilities

None.

Example extensions

Acknowledgements

This API is based on Chromium's chrome.cookies API. This documentation is derived from cookies.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

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

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