interface ICoreWebView2ExperimentalEnvironmentOptions2
Note
This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.
Note
This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.
interface ICoreWebView2ExperimentalEnvironmentOptions2
: public IUnknown
Additional options used to create WebView2 Environment to manage tracking prevention feature.
Summary
Members | Descriptions |
---|---|
get_EnableTrackingPrevention | The EnableTrackingPrevention property is used to enable/disable tracking prevention feature in WebView2. |
put_EnableTrackingPrevention | Sets the EnableTrackingPrevention property. |
Applies to
Product | Introduced |
---|---|
WebView2 Win32 | N/A |
WebView2 Win32 Prerelease | 1.0.1414 |
Members
get_EnableTrackingPrevention
The EnableTrackingPrevention
property is used to enable/disable tracking prevention feature in WebView2.
public HRESULT get_EnableTrackingPrevention(BOOL * value)
This property enable/disable tracking prevention for all the WebView2's created in the same environment. By default this feature is enabled to block potentially harmful trackers and trackers from sites that aren't visited before and set to COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_BALANCED
or whatever value was last changed/persisted on the profile.
You can set this property to false to disable the tracking prevention feature if the app only renders content in the WebView2 that is known to be safe. Disabling this feature when creating environment also improves runtime performance by skipping related code.
You shouldn't disable this property if WebView2 is being used as a "full browser" with arbitrary navigation and should protect end user privacy.
There is ICoreWebView2ExperimentalProfile5::PreferredTrackingPreventionLevel
property to control levels of tracking prevention of the WebView2's associated with a same profile. However, you can also disable tracking prevention later using ICoreWebView2ExperimentalProfile5::PreferredTrackingPreventionLevel
property and COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_NONE
value but that doesn't improves runtime performance.
See ICoreWebView2ExperimentalProfile5::PreferredTrackingPreventionLevel
for more details.
Tracking prevention protects users from online tracking by restricting the ability of trackers to access browser-based storage as well as the network. See Tracking prevention.
put_EnableTrackingPrevention
Sets the EnableTrackingPrevention
property.
public HRESULT put_EnableTrackingPrevention(BOOL value)