chromex.ext.history — binaryage/chromex 0.8.1

clj

Use the chrome.history API to interact with the browser's record of visited pages. You can add, remove, and query for URLs in the browser's history. To override the history page with your own version, see Override Pages.

• available since Chrome 30
• https://developer.chrome.com/extensions/history

add-url clj/s macro

(add-url details)

Adds a URL to the history at the current time with a transition type of 'link'.

|details| - https://developer.chrome.com/extensions/history#property-addUrl-details.

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 [].

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/history#method-addUrl.

add-url* cljs

(add-url* config details)

api-table clj

delete-all clj/s macro

(delete-all)

Deletes all items from the history.

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 [].

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/history#method-deleteAll.

delete-all* cljs

(delete-all* config)

delete-range clj/s macro

(delete-range range)

Removes all items within the specified date range from the history. Pages will not be removed from the history unless all visits fall within the range.

|range| - https://developer.chrome.com/extensions/history#property-deleteRange-range.

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 [].

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/history#method-deleteRange.

delete-range* cljs

(delete-range* config range)

delete-url clj/s macro

(delete-url details)

Removes all occurrences of the given URL from the history.

|details| - https://developer.chrome.com/extensions/history#property-deleteUrl-details.

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 [].

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/history#method-deleteUrl.

delete-url* cljs

(delete-url* config details)

gen-call clj

gen-wrap clj/s macro

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

get-visits clj/s macro

(get-visits details)

Retrieves information about visits to a URL.

|details| - https://developer.chrome.com/extensions/history#property-getVisits-details.

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

|results| - https://developer.chrome.com/extensions/history#property-callback-results.

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/history#method-getVisits.

get-visits* cljs

(get-visits* config details)

on-visit-removed* cljs

(on-visit-removed* config channel & args)

on-visited* cljs

(on-visited* config channel & args)

search clj/s macro

(search query)

Searches the history for the last visit time of each page matching the query.

|query| - https://developer.chrome.com/extensions/history#property-search-query.

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

|results| - https://developer.chrome.com/extensions/history#property-callback-results.

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/history#method-search.

search* cljs

(search* config query)

tap-all-events clj/s macro

(tap-all-events chan)

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

tap-on-visit-removed-events clj/s macro

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

Fired when one or more URLs are removed from the history service. When all visits have been removed the URL is purged from history.

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

|removed| - https://developer.chrome.com/extensions/history#property-onVisitRemoved-removed.

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

https://developer.chrome.com/extensions/history#event-onVisitRemoved.

tap-on-visited-events clj/s macro

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

Fired when a URL is visited, providing the HistoryItem data for that URL. This event fires before the page has loaded.

Events will be put on the |channel| with signature [::on-visited [result]] where:

|result| - https://developer.chrome.com/extensions/history#property-onVisited-result.

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

https://developer.chrome.com/extensions/history#event-onVisited.