Spec-Zone.ru › Web Extensions

privacy.websites

Свойство privacy.websites содержит настройки конфиденциальности, управляющие взаимодействием браузера с веб-сайтами. Каждое свойство — это объект types.BrowserSetting.

Значения по умолчанию для этих свойств могут отличаться в разных браузерах.

Свойства

cookieConfig

Объект types.BrowserSetting, основой которого является объект.

Объект имеет два свойства:

  • behavior: строка, которая может принимать следующие значения:
    • "allow_all": разрешить все cookie
    • "reject_all": отклонить все cookie
    • "reject_third_party": отклонить все cookie третьих сторон
    • "allow_visited": разрешить cookie третьей стороны только в том случае, если домен верхнего уровня cookie уже содержит хотя бы одно cookie.
    • "reject_trackers": отклонить отслеживающие cookie
    • "reject_trackers_and_partition_foreign": отклонить отслеживающие cookie и разделить cookie третьих сторон.
  • nonPersistentCookies Устаревшее : логическое значение. Если истинно, все cookie будут рассматриваться как cookie сеанса.
firstPartyIsolate

Объект types.BrowserSetting, основой которого является логическое значение.

Если true, предпочтение firstPartyIsolate заставляет браузер связывать все данные (включая cookie, данные HSTS, кэшированные изображения и многое другое) для доменов третьих сторон с доменом в адресной строке. Это предотвращает использование данными трекеров третьих сторон для идентификации пользователя на разных веб-сайтах, но может нарушить работу веб-сайтов, где пользователь входит в систему с учетной записью третьей стороны (например, Facebook или Google).

Значение по умолчанию false.

hyperlinkAuditingEnabled

Объект types.BrowserSetting, основой которого является логическое значение. Если true, браузер отправляет сигналы аудита, когда веб-сайт использует атрибут ping для их запроса.

protectedContentEnabled

Объект types.BrowserSetting, основой которого является логическое значение. Доступно только в Windows. Если true, браузер предоставляет уникальный идентификатор для плагинов, чтобы выполнить загрузку защищенного контента.

referrersEnabled

Объект types.BrowserSetting, основой которого является логическое значение. При включенном значении браузер отправляет заголовки referer с запросами.

resistFingerprinting

Объект types.BrowserSetting, основой которого является логическое значение.

Отпечатывание браузера — это практика, при которой веб-сайты используют веб-API для сбора данных о состоянии или конфигурации браузера или устройства, на котором он работает. Таким образом, они могут создать цифровой отпечаток, который они могут использовать для идентификации и отслеживания конкретного пользователя.

Если true, предпочтение resistFingerprinting заставляет браузер сообщать обобщенную поддельную информацию для данных, обычно используемых для отпечатывания. К таким данным относятся количество ядер процессора, точность таймеров JavaScript и местное часовое пояство. Также будут отключены функции, используемые в отпечатывании, такие как поддержка GamePad, и API WebSpeech и Navigator.

Значение по умолчанию false.

thirdPartyCookiesAllowed

Объект types.BrowserSetting, основой которого является логическое значение. Если false, браузер блокирует cookie третьих сторон.

trackingProtectionMode

«Защита от отслеживания» — это функция браузера, которая блокирует запросы к доменам, которые, как известно, участвуют в межсайтовом отслеживании пользователей. Веб-сайты, которые отслеживают пользователей, чаще всего являются рекламными и аналитическими сайтами третьих сторон. Эта настройка — объект types.BrowserSetting, определяющий, следует ли включать защиту от отслеживания в браузере. Его базовое значение — строка, которая может принимать одно из трех значений:

  • "always": защита от отслеживания включена.
  • "never": защита от отслеживания выключена.
  • "private_browsing": защита от отслеживания включена только в окнах инкогнито.

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
cookieConfig Нет Нет
59["Значение свойства behavior \"reject_trackers_and_partition_foreign\" было добавлено в версии 78.", "Значение свойства behavior \"reject_trackers\" было добавлено в версии 64."]
? Нет Нет ? ?
59Значение свойства behavior "reject_trackers" было добавлено в версии 64.
? Нет ?
firstPartyIsolate Нет Нет 58 ? Нет Нет ? ? 58 ? Нет ?
hyperlinkAuditingEnabled Да 79 54 ? Да Нет ? ? 54 ? Нет ?
protectedContentEnabled Да 79 Нет ? Да Нет ? ? Нет ? Нет ?
referrersEnabled Да 79 56 ? Да Нет ? ? 56 ? Нет ?
resistFingerprinting Нет Нет 58 ? Нет Нет ? ? 58 ? Нет ?
thirdPartyCookiesAllowed Да 79 Нет ? Да Нет ? ? Нет ? Нет ?
trackingProtectionMode Нет Нет 57 ? Нет Нет ? ? 57 ? Нет ?

Примеры

Установите свойство hyperlinkAuditingEnabled.

function onSet(result) {
  if (result) {
    console.log("success");
  } else {
    console.log("failure");
  }
}

browser.browserAction.onClicked.addListener(() => {

  let getting = browser.privacy.websites.hyperlinkAuditingEnabled.get({});
  getting.then((got) => {
    console.log(got.value);
    if ((got.levelOfControl === "controlled_by_this_extension") ||
        (got.levelOfControl === "controllable_by_this_extension")) {
      let setting = browser.privacy.websites.hyperlinkAuditingEnabled.set({
        value: true
      });
      setting.then(onSet);
    } else {
      console.log("Not able to set hyperlinkAuditingEnabled");
    }
  });

});

Примечание: Этот API основан на API chrome.privacy Chromium. Данная документация взята из privacy.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/privacy/websites

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API