browsingData.settings()

Браузеры имеют встроенную функцию «Очистить историю», которая позволяет пользователю очищать различные типы данных просмотра. Она имеет интерфейс, который позволяет пользователю выбрать тип данных для удаления (например, историю, загрузки, …) и период времени для удаления данных.

Эта функция возвращает текущее значение этих настроек.

Обратите внимание, что не все типы данных всегда можно удалить через интерфейс, и некоторые параметры интерфейса могут соответствовать нескольким типам данных.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let getSettings = browser.browsingData.settings()

Параметры

Нет.

Значение возврата

A Promise, который будет выполнен с объектом, содержащим информацию о настройках. Этот объект имеет три свойства:

options: browsingData.RemovalOptions. Объект, описывающий параметры удаления, которые в настоящее время выбраны.
dataToRemove: browsingData.DataTypeSet. Он будет содержать свойство для каждого типа данных, который можно переключать в пользовательском интерфейсе браузера. Каждое свойство будет иметь значение true , если этот тип выбран для удаления, и false в противном случае.
dataRemovalPermitted: browsingData.DataTypeSet. Этот объект будет содержать свойство для каждого типа данных, которые можно переключать в пользовательском интерфейсе браузера. Каждое будет иметь значение true , если администратор устройства разрешил пользователю удалить этот тип, и false в противном случае.

Если возникнет ошибка, обещание будет отклонено с сообщением об ошибке.

Совместимость с браузером

	Рабочий стол						Мобильный
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`settings`	Да	79	53	?	Да	Нет	?	?	8556–79	?	Нет	?

Примеры

Вывести текущие настройки:

function onGotSettings(settings) {
  console.log(settings.options);
  console.log(settings.dataToRemove);
  console.log(settings.dataRemovalPermitted);
}

function onError(error) {
  console.error(error);
}

browser.browsingData.settings().then(onGotSettings, onError);

Примечание: Этот 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/settings