interface ICoreWebView2EnvironmentOptions5

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

interface ICoreWebView2EnvironmentOptions5
  : public IUnknown

Additional options used to create WebView2 Environment to manage tracking prevention.

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.1619

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 ICoreWebView2Profile3::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 ICoreWebView2Profile3::PreferredTrackingPreventionLevel property and COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_NONE value but that doesn't improves runtime performance.

See ICoreWebView2Profile3::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)