history.getVisits()
Retrieves information about all visits to the given URL.
This is an asynchronous function that returns a Promise
.
Syntax
js
let getting = browser.history.getVisits(
details // object
)
Parameters
Return value
A Promise
will be fulfilled with an array of
objects each representing a visit to the given URL. Visits are sorted in reverse chronological order.history.VisitItem
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
getVisits |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Examples
List all visits to the most recently-visited page:
js
function gotVisits(visits) {
console.log(`Visit count: ${visits.length}`);
for (const visit of visits) {
console.log(visit.visitTime);
}
}
function listVisits(historyItems) {
if (historyItems.length) {
console.log(`URL ${historyItems[0].url}`);
const gettingVisits = browser.history.getVisits({
url: historyItems[0].url,
});
gettingVisits.then(gotVisits);
}
}
let searching = browser.history.search({
text: "",
startTime: 0,
maxResults: 1,
});
searching.then(listVisits);
Note:
This API is based on Chromium's chrome.history
API. This documentation is derived from history.json
in the Chromium code.