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 будет маршрутизироваться и сколько локальной информации об адресах будет раскрыто. Может принимать любое из следующих значений, от наименее конфиденциального до наиболее конфиденциального:defaultdefault_public_and_private_interfacesdefault_public_interface_onlydisable_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