История
Используйте API history для взаимодействия с историей браузера.
Если вам нужна информация об истории сеанса браузера, см. интерфейс History.
Примечание: Загрузки обрабатываются как объекты HistoryItem. Поэтому такие события, как history.onVisited, срабатывают и для загрузок.
История браузера — это хронологический список страниц, которые посетил пользователь. API истории позволяет вам:
- поиск страниц, которые появляются в истории браузера
- удаление отдельных страниц из истории браузера
- добавление страниц в историю браузера
- удаление всех страниц из истории браузера.
Однако пользователь может посещать одну страницу несколько раз, поэтому API также имеет понятие «посещения». Поэтому вы также можете использовать этот API для:
- получение полного набора посещений, которые пользователь совершил на конкретной странице
- удаление посещений любых страниц, совершенных в течение заданного периода времени
Для использования этого API расширение должно запросить разрешение «history» в своем файле разрешения manifest.json.
Типы
history.TransitionType-
Описывает, как браузер перешел на конкретную страницу.
history.HistoryItem-
Предоставляет информацию о конкретной странице в истории браузера.
history.VisitItem-
Описывает одно посещение страницы.
Функции
history.search()-
Ищет в истории браузера объекты
history.HistoryItem, соответствующие заданным критериям. history.getVisits()-
Получает информацию о посещениях данной страницы.
history.addUrl()-
Добавляет запись в историю браузера о посещении данной страницы.
history.deleteUrl()-
Удаляет все посещения данного URL из истории браузера.
history.deleteRange()-
Удаляет все посещения страниц, которые пользователь совершил в течение заданного диапазона времени.
history.deleteAll()-
Удаляет все посещения из истории браузера.
События
history.onTitleChanged-
Срабатывает, когда записывается заголовок страницы, посещенной пользователем.
history.onVisited-
Срабатывает каждый раз, когда пользователь посещает страницу, предоставляя данные
history.HistoryItemдля этой страницы. history.onVisitRemoved-
Срабатывает, когда URL полностью удаляется из истории браузера.
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
HistoryItem |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
TransitionType |
Да | 79 | 50 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
VisitItem |
Да | 79 | 50 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
addUrl |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
deleteAll |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
deleteRange |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
deleteUrl |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
getVisits |
Да | 79 | 50 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
onTitleChanged |
Нет | Нет | 55 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
onVisitRemoved |
Да | 79 | 50 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
onVisited |
Да | 79 | 50До версии 56, свойство 'title' объекта результата всегда было пустой строкой. Начиная с версии 56, оно устанавливается на последний известный заголовок, если он доступен, или на пустую строку в противном случае. |
? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
search |
Да | 79 | 49 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры расширений
Примечание: Этот API основан на API chrome.history от Chromium. Данная документация получена из history.json в коде Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/history
