chromex.ext.cookies — binaryage/chromex 0.6.4

clj

Use the chrome.cookies API to query and modify cookies, and to be notified when they change.

• available since Chrome 26
• https://developer.chrome.com/extensions/cookies

api-table clj

gen-call clj

gen-wrap clj/s macro

(gen-wrap kind item-id config & args)

get clj/s macro

(get details)

Retrieves information about a single cookie. If more than one cookie of the same name exists for the given URL, the one with the longest path will be returned. For cookies with the same path length, the cookie with the earliest creation time will be returned.

|details| - Details to identify the cookie being retrieved.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [cookie] where:

|cookie| - Contains details about the cookie. This parameter is null if no such cookie was found.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/extensions/cookies#method-get.

get* cljs

(get* config details)

get-all clj/s macro

(get-all details)

Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first.

|details| - Information to filter the cookies being retrieved.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [cookies] where:

|cookies| - All the existing, unexpired cookies that match the given cookie info.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/extensions/cookies#method-getAll.

get-all* cljs

(get-all* config details)

get-all-cookie-stores clj/s macro

(get-all-cookie-stores)

Lists all existing cookie stores.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [cookie-stores] where:

|cookie-stores| - All the existing cookie stores.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/extensions/cookies#method-getAllCookieStores.

get-all-cookie-stores* cljs

(get-all-cookie-stores* config)

on-changed* cljs

(on-changed* config channel & args)

remove clj/s macro

(remove details)

Deletes a cookie by name.

|details| - Information to identify the cookie to remove.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [details] where:

|details| - Contains details about the cookie that's been removed. If removal failed for any reason, this will be 'null', and 'chrome.runtime.lastError' will be set.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/extensions/cookies#method-remove.

remove* cljs

(remove* config details)

set clj/s macro

(set details)

Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.

|details| - Details about the cookie being set.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [cookie] where:

|cookie| - Contains details about the cookie that's been set. If setting failed for any reason, this will be 'null', and 'chrome.runtime.lastError' will be set.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/extensions/cookies#method-set.

set* cljs

(set* config details)

tap-all-events clj/s macro

(tap-all-events chan)

Taps all valid non-deprecated events in chromex.ext.cookies namespace.

tap-on-changed-events clj/s macro

(tap-on-changed-events channel & args)

Fired when a cookie is set or removed. As a special case, note that updating a cookie's properties is implemented as a two step process: the cookie to be updated is first removed entirely, generating a notification with 'cause' of 'overwrite' . Afterwards, a new cookie is written with the updated values, generating a second notification with 'cause' 'explicit'.

Events will be put on the |channel| with signature [::on-changed [change-info]] where:

|change-info| - https://developer.chrome.com/extensions/cookies#property-onChanged-changeInfo.

Note: |args| will be passed as additional parameters into Chrome event's .addListener call.

https://developer.chrome.com/extensions/cookies#event-onChanged.