Skip to content

MSIE settings

Jump to bottom
cztomczak edited this page Feb 6, 2016 · 3 revisions

This are the settings for the "msie" section found in "settings.json" file (see the Settings wiki page). These options are available only in the MSIE engine.

Table of Contents generated with DocToc

error_page

Default value: "error_page.html"

When navigation error happens (404, 500 or other) browser will display contents of this static file, it must be an HTML file, PHP file is not allowed. In that html file you can use two template variables: {{status_code}} and {{navigate_url}}.

Possible status codes can be viewed here: http://msdn.microsoft.com/en-us/library/aa768365(v=vs.85).aspx

If the status code was not provided by a web-server (could not connect for example), then an HRESULT error code with negative value will be provideed, see INET_E_* constants at the link above.

If an empty string is set, a default Internet Explorer error message will be displayed.

smooth_scroll

Default value: false

Whether smooth scrolling should be enabled.

enable_f5_refresh

Default value: false

Enable F5 key to refresh the page.

show_context_menu

Default value: false

Whether to show mouse context menu.

disable_script_debugger

Default value: false

When this is false and there is a javascript error on a webpage, a dialog box appears asking whether to to launch a script debugger.

hide_dialog_boxes

Default value: false

Whether to hide dialog boxes and messages. Critical errors and security alerts are not suppressed.

silent_operations

Default value: false

The browsing component will behave silently, no user interface or user notification will occur.

When you set disable_script_debugger, hide_dialog_boxes and silent_operations to true, then you won't see any dialog boxes when javascript error occurs, or any other unexpected user interface controls or notifications. A recommended way for dealing with javascript errors is to use "window.onerror" event, see test_javascript_errors.php script.

use_themes

Default value: true

Specifies whether hosted browser should use themes for pages it displays.

autocomplete_forms

Default value: false

Whether to enable AutoComplete in forms.

windowed_select_control

Default value: true

Internet Explorer 7 or later.

Setting to true causes MSHTML to create standard Microsoft Win32 "windowed" select and drop-down controls.

Setting to false causes MSHTML to use the Document Object Model (DOM) to create native "windowless" select controls that can be visually layered under other elements.

disable_scrollbars

Default value: false

Disable scrollbars.

flat_scrollbars

Default value: false

Use flat scrollbars.

utf8_url_encoding

Default value: true

Whether to enable utf-8 encoding for urls.

dpi_aware

Default value: false

Internet Explorer 8 or later. When set to true, causes layout engine to calculate document pixels as 96 dots per inch (dpi). Normally, a document pixel is the same size as a screen pixel.

registry_settings_path

Default value: ""

Not yet implemented.

A path to registry (in HKEY_CURRENT_USER) where browser control settings are stored. An example path would be: "Software\\My Application Name\\WebBrowser2 Settings".

registry_settings

Default value: {}

Not yet implemented.

The default settings can be found in "HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main".

Example keys:

"Anchor Underline" "yes"
"Cache_Update_Frequency" "Once_Per_Session"
"CompatibilityFlags" 0
"Disable Script Debugger" "yes"
"Display Inline Images" "yes"
"Do404Search" 1
"Enable Browser Extensions" "yes"
"FullScreen" "no"
"Local Page" "C:\Windows\system32\blank.htm"
"Play_Animations" "yes"
"Play_Background_Sounds" "yes"
"Use_DlgBox_Colors" "yes"
"UseClearType" "no"
"XMLHTTP" 1

"Page_Transitions"
"CSS_Compat"
"Expand Alt Text"
"Display Inline Videos"
"Print_Background"
"Use Stylesheets"
"SmoothScroll"
"Show image placeholders"
"DisableScriptDebuggerIE"
"Move System Caret"
"Force Offscreen Composition"
"Enable AutoImageResize"
"UseThemes"
"UseHR"
"Disable_Local_Machine_Navigate"
"Cleanup HTCs"
"AlwaysAllowExecCommand"

Browser features can be also controlled through "HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl".

Example keys:

FEATURE_RESTRICT_ABOUT_PROTOCOL_IE7
FEATURE_AJAX_CONNECTIONEVENTS
FEATURE_SHOW_APP_PROTOCOL_WARN_DIALOG
FEATURE_BROWSER_EMULATION
FEATURE_ENABLE_CLIPCHILDREN_OPTIMIZATION
FEATURE_MANAGE_SCRIPT_CIRCULAR_REFS
FEATURE_ENABLE_SCRIPT_PASTE_URLACTION_IF_PROMPT
FEATURE_BLOCK_SETCAPTURE_XDOMAIN
FEATURE_CROSS_DOMAIN_REDIRECT_MITIGATION
FEATURE_DOWNLOAD_INITIATOR_HTTP_HEADER
FEATURE_CFSTR_INETURLW_DRAGDROP_FORMAT
FEATURE_BLOCK_CROSS_PROTOCOL_FILE_NAVIGATION
FEATURE_IE6_DEFAULT_FRAME_NAVIGATION_BEHAVIOR
FEATURE_VIEWLINKEDWEBOC_IS_UNSAFE
FEATURE_GPU_RENDERING
FEATURE_MAXCONNECTIONSPER1_0SERVER
FEATURE_MAXCONNECTIONSPERSERVER
FEATURE_IFRAME_MAILTO_THRESHOLD
FEATURE_MIME_TREAT_IMAGE_AS_AUTHORITATIVE
FEATURE_SECURITYBAND
FEATURE_IVIEWOBJECTDRAW_DMLT9_WITH_GDI
FEATURE_NINPUT_LEGACYMODE
FEATURE_BLOCK_LMZ_IMG
FEATURE_BLOCK_LMZ_OBJECT
FEATURE_BLOCK_LMZ_SCRIPT
FEATURE_ISOLATE_NAMED_WINDOWS
FEATURE_DOWNLOAD_PROMPT_META_CONTROL
FEATURE_SCRIPTURL_MITIGATION
FEATURE_WARN_ON_SEC_CERT_REV_FAILED
FEATURE_LOAD_SHDOCLC_RESOURCES
FEATURE_SPELLCHECKING
FEATURE_STATUS_BAR_THROTTLING
FEATURE_RESTRICT_CDL_CLSIDSNIFF
FEATURE_SHIM_MSHELP_COMBINE
FEATURE_WEBOC_DOCUMENT_ZOOM
FEATURE_WEBOC_MOVESIZECHILD
FEATURE_WEBSOCKET
FEATURE_WEBSOCKET_AUTHPROMPT
FEATURE_WEBSOCKET_CLOSETIMEOUT
FEATURE_WEBSOCKET_MAXCONNECTIONSPERSERVER
FEATURE_WEBSOCKET_FOLLOWHTTPREDIRECT
FEATURE_RESTRICTED_ZONE_WHEN_FILE_NOT_FOUND

For a description of these features see:
http://msdn.microsoft.com/en-us/library/ee330720(v=vs.85).aspx

features_per_process

Not yet implemented.

These browser control settings are set per application process. It extends "registry_settings", but does not require creating registry keys to set them. Available per process features:

FEATURE_OBJECT_CACHING
FEATURE_ZONE_ELEVATION
FEATURE_MIME_HANDLING
FEATURE_MIME_SNIFFING
FEATURE_WINDOW_RESTRICTIONS
FEATURE_WEBOC_POPUPMANAGEMENT
FEATURE_BEHAVIORS
FEATURE_DISABLE_MK_PROTOCOL
FEATURE_SECURITYBAND
FEATURE_RESTRICT_ACTIVEXINSTALL
FEATURE_VALIDATE_NAVIGATE_URL
FEATURE_RESTRICT_FILEDOWNLOAD
FEATURE_ADDON_MANAGEMENT
FEATURE_HTTP_USERNAME_PASSWORD_DISABLE
FEATURE_SAFE_BINDTOOBJECT
FEATURE_UNC_SAVEDFILECHECK
FEATURE_GET_URL_DOM_FILEPATH_UNENCODED
FEATURE_TABBED_BROWSING
FEATURE_SSLUX
FEATURE_DISABLE_NAVIGATION_SOUNDS
FEATURE_DISABLE_LEGACY_COMPRESSION
FEATURE_FORCE_ADDR_AND_STATUS
FEATURE_XMLHTTP
FEATURE_DISABLE_TELNET_PROTOCOL
FEATURE_FEEDS
FEATURE_BLOCK_INPUT_PROMPTS

These features should not be set through "registry_settings", as they might be overwritten by per-process default values.

For a description of these features see: http://msdn.microsoft.com/en-us/library/ee330720(v=vs.85).aspx

Clone this wiki locally