The IESettings
object provides a scripting interface to Internet Explorer settings. The object properties correspond to the Internet Explorer settings displayed on the Advanced tabbed page of Internet Explorer’s Internet Options dialog (to display it, select Tools | Internet Options from Internet Explorer’s menu).
To obtain the object in scripts, use the IESettings
property of the Options
object.
Below is a list of object properties with brief descriptions. The properties are ordered by the Internet Explorer setting groups’ and settings’ names.
Beside properties, the IESettings object also contains three methods:
Method | Description |
---|---|
GetInternetExplorerMajorVersion |
Returns an integer value that specifies the major version number of Internet Explorer installed on your computer (for example, 10 or 11). |
GetInternetExplorerVersion |
Returns a string containing the full version number of Internet Explorer installed on your computer (for instance, 11.0.9600.18858). |
SendSettingChangeMessage |
Applies settings made to properties of the IESettings object to all Internet Explorer instances that are currently running in the system. If you do not call the method, the changes will be applied to Internet Explorer instances that are launched after the changes have been done. |
Two notes:
-
Changes made to the properties of the
IESettings
object will have effect on Internet Explorer instances that are launched after the changes have been made. To only apply changes to currently running Internet Explorer instances, call theSendSettingChangeMessage
method. -
Changes made to some options only take effect after Internet Explorer is restarted.
Here is a list of Internet Explorer settings and corresponding properties:
Accessibility
Always expand ALT text for images
ExpandAltText
. Boolean. Read/Write.Enable Caret Browsing for new windows and tabs
EnableCaretBrowsingOnStartup
. Boolean. Read/Write.
Move system caret with focus/selection changes
MoveSystemCaret
. Boolean. Read/Write.Reset text size to medium for new windows and tabs
ResetTextSizeOnStartup
. Boolean. Read/Write.
Reset text size to medium while zooming
ResetTextSizeOnZoom
. Boolean. Read/Write.
Reset User Zoom to 100% for new windows and tabs
ResetZoomOnStartup
. Boolean. Read/Write.
Reset zoom level for new windows and tabs
ResetZoomOnStartupIE8
. Boolean. Read/Write.
Browsing
Automatically check for Internet Explorer updates
UpdatesCheck
. Boolean. Read/Write.
Always send URLs as UTF-8
UrlEncoding
. Boolean. Read/Write.
Requires Internet Explorer restart.
Automatically recover from page layout errors with Compatibility View
AutomaticLayoutRecovery
. Boolean. Read/Write.
Close unused folders in History and Favorites
CloseUnusedFolders
. Boolean. Read/Write.
Requires Internet Explorer restart.
Disable Script Debugging (Other)
DisableScriptDebugger
. Boolean. Read/Write.Disable Script Debugging (Internet Explorer)
DisableScriptDebuggerIE
. Boolean. Read/Write.Display Accelerator button on selection
DisplayAcceleratorButtonOnSelection
. Boolean. Read/Write.
Display a notification on every script error
ErrorDlgDisplayedOnEveryError
. Boolean. Read/Write.Display enhanced security configuration dialog
DisplayTrustAlertDlg
. Boolean. Read/Write.
Enable automatic crash recovery
EnableAutomaticCrashRecovery
. Boolean. Read/Write.
Enable folder view for FTP sites
FolderViewForFTP
. Boolean. Read/Write.Enable Install On Demand (Internet Explorer)
SetupOnDemandIE
. Boolean. Read/Write.
Enable Install On Demand (Other)
SetupOnDemandWeb
. Boolean. Read/Write.
Enable offline items to be synchronized on a schedule
ScheduledUpdates
. Boolean. Read/Write.
Enable page transitions
PageTransitions
. Boolean. Read/Write.
Enable Personalized Favorites Menu
PersonalizedFavMenu
. Boolean. Read/Write.
Enable Suggested Sites
EnableSuggestedSites
. Boolean. Read/Write.
Requires Internet Explorer restart.
Enable third-party browser extensions
BrowserExtensions
. Boolean. Read/Write.
Requires Internet Explorer restart.
Enable websites to use the search pane
EnableSearchPane
. Boolean. Read/Write.
Requires Internet Explorer restart.
Enable visual styles on buttons and controls in web pages
VisualThemes
. Boolean. Read/Write.Force offscreen compositing even under Terminal Server
ForceOffscreenComposition
. Boolean. Read/Write.
Requires Internet Explorer restart.
Notify when downloads complete
NotifyDownloadComplete
. Boolean. Read/Write.Reuse windows for launching shortcuts
AllowWindowReuse
. Boolean. Read/Write.Show friendly HTTP error messages
ShowFriendlyHTTPErrors
. Boolean. Read/Write.Show friendly URLs
ShowFriendlyURLs
.
Show Go button in Address bar
ShowGoButton
.
Underline links
UnderlineLinks
. Integer. Read/Write. The property can be one of the following values:
- 0 - Never
- 1 - Always
- 2 - Hover
Use inline AutoComplete
UseAutoComplete
. Boolean. Read/Write.Use most recent order when switching tabs with Ctrl+Tab
UseMostRecentOrderTabSwitching
. Boolean. Read/Write.
Use Passive FTP
UsePasssiveFTP
. Boolean. Read/Write.Use smooth scrolling
UseSmoothScrolling
. Boolean. Read/Write.HTTP 1.1 Settings
Use HTTP 1.1
HTTP11Enabled
. Boolean. Read/Write.Use HTTP 1.1 through proxy connections
HTTP11ProxyEnabled
. Boolean. Read/Write.International
Always show encoded addresses
AlwaysShowEncodedAddresses
. Boolean. Read/Write.
Requires Internet Explorer restart.
Send IDN server names
SendIDNServerNames
. Boolean. Read/Write.
Requires Internet Explorer restart.
Send IDN server names for Intranet addresses
SendIDNServerNamesForIntranet
. Boolean. Read/Write.
Requires Internet Explorer restart.
Show Information Bar for encoded addresses
ShowIDNPrompt
. Boolean. Read/Write.
Requires Internet Explorer restart.
Use UTF-8 for mailto links
UseUTF8ForMailtoLinks
. Boolean. Read/Write.
Multimedia
Always use ClearType for HTML
UseClearType
. Boolean. Read/Write.
Enable Automatic Image Resizing
AutoImageResize
. Boolean. Read/Write.Enable Image Toolbar
ShowImageToolbar
. Boolean. Read/Write.
Requires Internet Explorer restart.
Play animations in web pages
PlayAnimations
. Boolean. Read/Write.Play sounds in web pages
PlaySounds
. Boolean. Read/Write.Play videos in web pages
PlayVideos
. Boolean. Read/Write.
Show image download placeholders
ShowImagePlaceHolders
. Boolean. Read/Write.Show pictures
ShowPictures
. Boolean. Read/Write.Smart image dithering
SmartDithering
. Boolean. Read/Write.
Printing
Print background colors and images
PrintBackground
. Boolean. Read/Write.
Search from the Address bar
Search from the Address bar
AddressBarAutoSearch
. Integer. Read/Write. The property can be one of the following values:
- 0 - Do not search from the Address bar
- 1 - Just display the results in the main window
- 2 - Just go to the most likely site
- 3 - Display results, and go to the most likely site
Security
Allow active content from CDs to run on My Computer
AllowActiveContentFromCDs
. Boolean. Read/Write.Allow active content to run in files on My Computer
AllowActiveContentInFiles
. Boolean. Read/Write.Allow software to run or install even if the signature is invalid
RunInvalidSignatures
. Boolean. Read/Write.Check for signatures on downloaded programs
CheckProgramSignatures
. Boolean. Read/Write.Check for publisher's certificate revocation
CheckPublisherCertificateRevocation
. Boolean. Read/Write.Check for server certificate revocation
CheckServerCertificateRevocation
. Boolean. Read/Write.
Requires Internet Explorer restart.
Do not save encrypted pages on disk
DoNotCacheEncryptedPages
. Boolean. Read/Write.Empty Temporary Internet Files folder when browser is closed
EmptyCacheOnClose
. Boolean. Read/Write.Enable DOM Storage
EnableDOMStorage
. Boolean. Read/Write.
Enable Integrated Windows Authentication
IntegratedWindowsAuthentication
. Boolean. Read/Write.
Requires Internet Explorer restart.
Enable native XMLHTTP support
XMLHTTPEnabled
. Boolean. Read/Write.
Enable Profile Assistant
ProfileAssistantEnabled
. Boolean. Read/Write.
Enable SmartScreen Filter
EnableSmartScreenFilter
. Boolean. Read/Write.
Phishing Filter
PhishingFilter
. Boolean. Read/Write. The property can be one of the following values:
- 0 - Disable Phishing Filter
- 1 - Turn off automatic website checking
- 2 - Turn on automatic website checking
Use SSL 2.0
SSL2Enabled
. Boolean. Read/Write.Use SSL 3.0
SSL3Enabled
. Boolean. Read/Write.Use TLS 1.0
TLS1Enabled
. Boolean. Read/Write.Warn about invalid site certificates
WarnOnBadCertificates
. Boolean. Read/Write.Warn if forms submittal is being redirected
WarnOnPostRedirect
. Boolean. Read/Write.Warn if changing between secure and non secure mode
WarnOnZoneCrossing
. Boolean. Read/Write.Example
The code below obtains the full version of the Internet Explorer browser installed on your computer and then posts this version to the test log.
JavaScript, JScript
function IEVerDemo()
{
// Obtains information about the browser
var IE = Options.IESettings;
// Obtains Internet Explorer's version
var Ver = IE.GetInternetExplorerVersion();
// Posts this version to the test log
Log.Message(Ver);
}
Python
def IEVerDemo():
# Obtains information about the browser
IE = Options.IESettings
# Obtains Internet Explorer's version
Ver = IE.GetInternetExplorerVersion()
# Posts this version to the test log
Log.Message(Ver)
VBScript
Sub IEVerDemo()
' Obtains information about the browser
Set IE = Options.IESettings
' Obtains Internet Explorer's version
Ver = IE.GetInternetExplorerVersion()
' Posts this version to the test log
Log.Message(Ver)
End Sub
DelphiScript
function IEVerDemo;
var IE, Ver;
begin
// Obtains information about the browser
IE := Options.IESettings;
// Obtains Internet Explorer's version
Ver := IE.GetInternetExplorerVersion();
// Posts this version to the test log
Log.Message(Ver);
end;
C++Script, C#Script
function IEVerDemo()
{
// Obtains information about the browser
var IE = Options["IESettings"];
// Obtains Internet Explorer's version
var Ver = IE["GetInternetExplorerVersion"]();
// Posts this version to the test log
Log["Message"](Ver);
}