chromex.app.permissions — binaryage/chromex 0.6.2

clj

Use the chrome.permissions API to request declared optional permissions at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary.

• available since Chrome 24
• https://developer.chrome.com/apps/permissions

api-table clj

contains clj/s macro

(contains permissions)

Checks if the extension has the specified permissions.

|permissions| - https://developer.chrome.com/apps/permissions#property-contains-permissions.

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 [result] where:

|result| - True if the extension has the specified permissions.

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/apps/permissions#method-contains.

contains* cljs

(contains* config permissions)

gen-call clj

gen-wrap clj/s macro

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

get-all clj/s macro

(get-all)

Gets the extension's current set of permissions.

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 [permissions] where:

|permissions| - The extension's active permissions.

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/apps/permissions#method-getAll.

get-all* cljs

(get-all* config)

on-added* cljs

(on-added* config channel & args)

on-removed* cljs

(on-removed* config channel & args)

remove clj/s macro

(remove permissions)

Removes access to the specified permissions. If there are any problems removing the permissions, 'runtime.lastError' will be set.

|permissions| - https://developer.chrome.com/apps/permissions#property-remove-permissions.

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 [removed] where:

|removed| - True if the permissions were removed.

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/apps/permissions#method-remove.

remove* cljs

(remove* config permissions)

request clj/s macro

(request permissions)

Requests access to the specified permissions. These permissions must be defined in the optional_permissions field of the manifest. If there are any problems requesting the permissions, 'runtime.lastError' will be set.

|permissions| - https://developer.chrome.com/apps/permissions#property-request-permissions.

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 [granted] where:

|granted| - True if the user granted the specified permissions.

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/apps/permissions#method-request.

request* cljs

(request* config permissions)

tap-all-events clj/s macro

(tap-all-events chan)

Taps all valid non-deprecated events in chromex.app.permissions namespace.

tap-on-added-events clj/s macro

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

Fired when the extension acquires new permissions.

Events will be put on the |channel| with signature [::on-added [permissions]] where:

|permissions| - The newly acquired permissions.

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

https://developer.chrome.com/apps/permissions#event-onAdded.

tap-on-removed-events clj/s macro

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

Fired when access to permissions has been removed from the extension.

Events will be put on the |channel| with signature [::on-removed [permissions]] where:

|permissions| - The permissions that have been removed.

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

https://developer.chrome.com/apps/permissions#event-onRemoved.