Данные о просмотре
Разрешает расширениям очищать данные, накапливаемые во время просмотра пользователем.
В API browsingData данные о просмотре разделяются на типы:
- кеш браузера
- куки
- загрузки
- история
- локальное хранилище
- данные плагинов
- сохранённые данные форм
- сохранённые пароли
Вы можете использовать функцию browsingData.remove() для удаления любой комбинации этих типов. Также есть специализированные функции для удаления каждого конкретного типа данных, такие как removePasswords(), removeHistory() и так далее.
Все browsingData.remove[X]() функции принимают объект browsingData.RemovalOptions, который вы можете использовать для управления двумя дополнительными аспектами удаления данных:
- удаление данных за определённый промежуток времени
- удаление данных только с обычных веб-страниц или также из размещённых веб-приложений и дополнений. Обратите внимание, что эта опция пока не поддерживается в Firefox.
Наконец, этот API предоставляет функцию browsingData.settings(), которая возвращает текущие значения настроек для встроенной функции браузера "Очистить историю".
Для использования этого API необходимо разрешение "browsingData" API-разрешение.
Типы
browsingData.DataTypeSet-
Объект, используемый для указания типа данных для удаления: например, история, загрузки, пароли и так далее.
browsingData.RemovalOptions-
Объект, используемый для указания, за какой промежуток времени удалять данные и удалять ли данные, добавленные с помощью обычного веб-просмотра, размещённых приложений или дополнений.
Методы
browsingData.remove()-
Удаляет данные о просмотре для указанных типов данных.
browsingData.removeCache()-
Очищает кеш браузера.
-
Удаляет куки.
browsingData.removeDownloads()-
Удаляет список загруженных файлов.
browsingData.removeFormData()-
Очищает сохранённые данные форм.
browsingData.removeHistory()-
Очищает историю браузера.
browsingData.removeLocalStorage()-
Очищает любое локальное хранилище, созданное веб-сайтами.
browsingData.removePasswords()-
Очищает сохранённые пароли.
browsingData.removePluginData()-
Очищает данные, связанные с плагинами.
browsingData.settings()-
Получает текущее значение настроек в функции браузера "Очистить историю".
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | |
remove |
Да | 79 | 53УказаниеdataTypes.history также удалит историю загрузок и сервисные рабочие процессы. |
? | Да | Нет | ? | ? |
85УказаниеdataTypes.history также удалит историю загрузок и сервисные рабочие процессы.57–79УказаниеdataTypes.history также удалит историю загрузок и сервисные рабочие процессы. |
? | Нет | ? |
removeCache |
Да | 79 | 53removalOptions.since не поддерживается. |
? | Да | Нет | ? | ? |
85removalOptions.since не поддерживается.57–79removalOptions.since не поддерживается. |
? | Нет | ? |
removeCookies |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 8556–79 | ? | Нет | ? |
removeDownloads |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 57–79 | ? | Нет | ? |
removeFormData |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 57–79 | ? | Нет | ? |
removeHistory |
Да | 79 | 53Эта функция также удаляет историю загрузок и сервисные рабочие процессы. |
? | Да | Нет | ? | ? | 85 | ? | Нет | ? |
removeLocalStorage |
Да | 79 | 57removalOptions.since не поддерживается. |
? | Да | Нет | ? | ? | 85removalOptions.since не поддерживается. |
? | Нет | ? |
removePasswords |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 85 | ? | ? | ? |
removePluginData |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 85 | ? | Нет | ? |
settings |
Да | 79 | 53 | ? | Да | Нет | ? | ? | 8556–79 | ? | Нет | ? |
Примеры расширений
Примечание: Этот API основан на API chrome.browsingData 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/browsingData