Spec-Zone.ru › Web Extensions

privacy.network

Свойство privacy.network содержит настройки сети, связанные с конфиденциальностью. Каждое свойство — это объект types.BrowserSetting.

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

Свойства

networkPredictionEnabled

Объект types.BrowserSetting, основное значение которого — булево. Если true, браузер пытается ускорить веб-серфинг, предварительно разрешая записи DNS, предварительно рендеринга сайтов (например, используя <link rel='prefetch' …>) и предварительно открывая TCP и SSL соединения с серверами.

peerConnectionEnabled

Объект types.BrowserSetting, основное значение которого — булево. Если false, интерфейс RTCPeerConnection отключён. Обратите внимание, что getUserMedia() не затронут этим параметром.

webRTCIPHandlingPolicy

Объект types.BrowserSetting, основное значение которого — строка. Этот параметр позволяет пользователям указать компромисс между производительностью и конфиденциальностью медиа, что влияет на то, как трафик WebRTC будет маршрутизироваться и сколько локальной информации об адресах будет раскрыто. Может принимать любое из следующих значений, от наименее конфиденциального до наиболее конфиденциального:

  • default
  • default_public_and_private_interfaces
  • default_public_interface_only
  • disable_non_proxied_udp
  • proxy_only (разрешены только соединения, использующие TURN по TCP-соединению через прокси)
httpsOnlyMode

Этот параметр позволяет вашей расширенной программе определить, включил ли пользователь режим HTTPS-только. Это свойство является только для чтения на всех платформах. Его значение — строка, которая может принимать одно из трёх значений:

  • "always": Режим HTTPS-только включён.
  • "never": Режим HTTPS-только выключен.
  • "private_browsing": Режим HTTPS-только включён только в окнах приватного просмотра.
globalPrivacyControl

Этот параметр позволяет вашей расширенной программе определить, включил ли пользователь Глобальный контроль конфиденциальности. Это свойство является только для чтения на всех платформах. Его значение — булево: true указывает, что браузер отправляет сигналы Глобального контроля конфиденциальности, а false указывает, что браузер не отправляет сигналы.

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

Рабочий стол Мобильный
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
globalPrivacyControl Нет Нет 95 ? Нет Нет ? ? 95 ? Нет ?
httpsOnlyMode Да Да 84 ? Да Нет ? ? 84 ? Нет ?
networkPredictionEnabled Да 79 54 ? Да Нет ? ? 54 ? Нет ?
peerConnectionEnabled Нет Нет 55 ? Нет Нет ? ? 55 ? Нет ?
webRTCIPHandlingPolicy Да 79
54Начиная с Firefox 70, значение disable_non_proxied_udp требует прокси, если он настроен, но позволяет соединениям проходить, если прокси не установлен. Ранее в этом режиме WebRTC мог использоваться только при настройке прокси и наличии TURN через TCP; это поведение теперь показано как proxy_only.
? Да Нет ? ? 54 ? Нет ?

Примеры

Установите свойство webRTCIPHandlingPolicy:

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

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

  let getting = browser.privacy.network.webRTCIPHandlingPolicy.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.network.webRTCIPHandlingPolicy.set({
        value: "default_public_interface_only"
      });
      setting.then(onSet);
    } else {
      console.log("Not able to set webRTCIPHandlingPolicy");
    }
  });

});

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

Spec-Zone.ru

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