Navigation: Learn About All Features  > Application Settings > Rendering Engine >

Customize the WebView2 Browser options

 

 

 

 

Customize the WebView2 Browser options

 

In HTML Executable, choose Application Settings => Rendering Engine.

 

 

A lot of Chromium (WebView2) options can be configured there.

 

AdditionalChromiumArgs

 

Lets you add some custom Chromium command-line arguments. For example, if you want to disable the GPU accelerated video display, add `--disable-accelerated-video`. To add multiple arguments, separate each two arguments by space.

 

AutofillEnabled

Determines if autofill functionality is enabled.

 

AutoOpenExtensions

 

Allows a compiled file within the eBook or application to be opened in its dedicated application when the associated link is visited by the end user. HTML Executable determines this behavior based on the file extension; if the file extension is included in the list for this property, then the file will be directly opened in its dedicated application.

 

Please note that this action temporarily extracts the file onto the user's hard drive, making it potentially vulnerable to unauthorized copying. Therefore, it is essential to consider the security aspects before using this property.

 

The list of extensions in the AutoOpenExtensions property should be separated by semicolons. For example, if you want to open .docx and .xlsx files in their dedicated applications, the property value should be set as .Docx;.xlsx.

 

Custom404Error

 

Indicates whether the custom error page defined in Dialog Boxes should be used to display missing pages (404 file not found). If True, a 200 OK status will be returned to the web browser. If False, a 404 error will be returned to the web browser and the standard 404 error page will be shown.

 

CustomUserAgent

 

Lets you specify a custom User-Agent for the web browser.

 

DefLocale

 

Defines which locale (language) should be used by the Chromium engine (useful for localization of default buttons and menus for instance). List of values are available in the `CEFRuntime\locales` subfolder of the HTML Executable's location.

 

For instance, to use the French locale, enter `fr`.

 

DeveloperTools

 

Indicates whether Chomium Developer Tools should be enabled or not. End users can access these tools with the context-menu of the internal browser.

 

DisableDragDrop

 

Controls whether drag/drop of external resources is allowed or not.

 

DisableFindText

 

Lets you disable the "Find Text" menu command.

 

DisableImgDragDrop

 

Lets you disable the drag/drop feature for images. For instance, if the end user drags and drops an image onto Windows Explorer, the Chromium engine will save the image as a file into the folder. It's a possible leak for your compiled image files. So, to avoid this leak, activate this property.

 

DisableLocalCache

 

Allows your application and Chromium engine to store cache and temporary files onto the end user's computer. By default, it will be a subfolder in the User Data directory as explained here.

 

ForbidDownloadMimeType

 

Prevents downloads of internal resources (for instance, on default video player).

 

The Chromium engine allows end users to download a played video (or audio) resource using the context menu. If you cannot disable this menu from HTML, it is still possible to prevent the download of the audio or video file using this option.

 

For instance, if you enter `audio/mp3;audio/ogg`, HTML Executable will prevent .MP3 and .OGG files from being downloaded, but not played back by the video or audio player.

 

Muted

 

If enabled, no audio will be played.

 

PinchZoomEnabled

 

Determines if pinch to zoom functionality is enabled.

PrivateMode

Determines if private mode is enabled. Default is False.

SingleSignOn

Determines if single sign-on is enabled. Default is False.

 

SwipeNavigationEnabled

 

Determines if swipe navigation is enabled.

TrackingPrevention

Determines if tracking prevention is enabled. Default is True.

 

Troubleshooting CORS problems

 

If the console (in Developer Tools) shows navigation errors such as "Uncaught DOMException: Blocked a frame with origin "null" from accessing a cross-origin frame.", you can disable CORS checks in WebView2 by adding the --disable-web-security to the AdditionalChromiumArgs field (see above).