Difference between revisions of "WebDriver Capabilities"

From AutoIt Wiki
Jump to navigation Jump to search
(List of Chromium Command Line Switches)
(Advanced Capabilities example)
Line 69: Line 69:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
== Advanced Capabilities example ==
+
== Capabilities comlpex example ==
...WorkInProgress...
 
  
 
<syntaxhighlight lang="autoit">
 
<syntaxhighlight lang="autoit">
 
#include <MsgBoxConstants.au3>
 
#include <MsgBoxConstants.au3>
 +
 +
#include "wd_capabilities.au3"
 
#include "wd_helper.au3"
 
#include "wd_helper.au3"
#include "wd_capabilities.au3"
 
  
Global Const $_EXAMPLE_DRIVER_FIREFOX = @ScriptDir & '\geckodriver.exe' ; CHANGE TO PROPER FILE FULL PATH
+
_Example()
Global Const $_EXAMPLE_DRIVER_CHROME = @ScriptDir & '\chromedriver.exe' ; CHANGE TO PROPER FILE FULL PATH
+
If @error Then ConsoleWrite("! ---> @error=" & @error & "  @extended=" & @extended & _
Global Const $_EXAMPLE_DRIVER_EDGE = @ScriptDir & '\msedgedriver.exe' ; CHANGE TO PROPER FILE FULL PATH
+
" : Error launching browser" & @CRLF)
  
Global Const $_EXAMPLE_PROFILE_FIREFOX = @LocalAppDataDir & '\Mozilla\Firefox\Profiles\WD_Testing_Profile' ; CHANGE TO PROPER DIRECTORY PATH
 
Global Const $_EXAMPLE_PROFILE_CHROME = @LocalAppDataDir & '\Google\Chrome\User Data\WD_Testing_Profile' ; CHANGE TO PROPER DIRECTORY PATH
 
Global Const $_EXAMPLE_PROFILE_EDGE = @LocalAppDataDir & '\MicrosoftEdge\User\\WD_Testing_Profile' ; CHANGE TO PROPER DIRECTORY PATH
 
  
Global Const $_EXAMPLE_DOWNLOAD_DIR = @UserProfileDir & '\Downloads\WD_Testing_download' ; CHANGE TO PROPER DIRECTORY PATH
+
Func _Example()
 +
Local $WD_SESSION = _WD_SetupChrome()
 +
If @error Then Return SetError(@error, @extended, $WD_SESSION)
  
Global Const $_EXAMPLE_OPTION_RUN_BROWSER = ( _
+
MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONINFORMATION, "Information #" & @ScriptLineNumber, "Waiting before _WD_Shutdown()")
$IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, 'Question', _
+
_WD_DeleteSession($WD_SESSION)
'Do you want to test with running browsers ?' & @CRLF & _
+
_WD_Shutdown()
'' & @CRLF & _
+
EndFunc  ;==>_Example
' [YES] = Run browser' & @CRLF & _
 
' [NO] = only put $s_Capabilities_JSON to console') _
 
)
 
  
Global Const $_EXAMPLE_OPTION_CHOOSEN_DRIVER = (($_EXAMPLE_OPTION_RUN_BROWSER) ? (_WD_Capabilities_Example_ChooseDriver()) : (''))
 
  
Global Const $_EXAMPLE_OPTION_HEADLESS = ($_EXAMPLE_OPTION_RUN_BROWSER And _
+
Func _WD_SetupChrome($s_DriverLocation = @ScriptDir & '\chromedriver.exe', $b_Headless = False, $s_Download_dir = Default, $_WD_DEBUG_LEVEL = Default, $s_Log_FileFullPath = Default)
($IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, 'Question', _
+
If $_WD_DEBUG_LEVEL = Default Then
'Do you want to test with headless mode ?' & @CRLF & _
+
$_WD_DEBUG = $_WD_DEBUG_Error
'' & @CRLF & _
+
If Not @Compiled Then $_WD_DEBUG = $_WD_DEBUG_Info
' [YES] = Run browser in headless mode' & @CRLF & _
+
EndIf
' [NO] = Run browser in "visible" mode') _
 
) _
 
)
 
  
Global Const $_EXAMPLE_OPTION_PROXY = _
+
_WD_Option('Driver', $s_DriverLocation)
($IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, 'Question', _
+
_WD_Option('Port', 9515)
'Do you want to test with connection buffered via Proxy server ?' & @CRLF & _
+
_WD_Option('DefaultTimeout', 1000)
'' & @CRLF & _
+
_WD_Option("Sleep", _My_Check_State)
' [YES] = use Proxy' & @CRLF & _
 
' [NO] = direct coonection') _
 
)
 
  
Global Const $_EXAMPLE_OPTION_ALLCAPS = _
+
If $s_Download_dir = Default Then $s_Download_dir = @ScriptDir & '\WD_Download'
($IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, 'Question', _
+
$s_Download_dir = ''
'Do you want to test with Capabilities for all "firstMatch" ?' & @CRLF & _
 
'' & @CRLF & _
 
' [YES] = test "firstMatch" Capabilites for all browser toogether' & @CRLF & _
 
' [NO] = test only "firstMatch" desired for specified browser') _
 
)
 
  
_WD_Capabilities_Example()
+
Local $bTest = _WD_Validate_Browser_Driver('chrome', 'chromedriver.exe')
Exit
+
If Not $bTest Then Return SetError(@error, @extended, $bTest)
 +
 
 +
If $s_Log_FileFullPath = Default Then $s_Log_FileFullPath = @ScriptDir & '\Chrome-Testing.log'
 +
If IsString($s_Log_FileFullPath) And StringLen(($s_Log_FileFullPath)) Then
 +
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: Log Path = ' & $s_Log_FileFullPath & @CRLF)
 +
_WD_Option('DriverParams', '--log-path=' & '"' & $s_Log_FileFullPath & '"')
 +
EndIf
  
Func _WD_Capabilities_Example()
 
 
_WD_CapabilitiesStartup()
 
_WD_CapabilitiesStartup()
ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
 
#Region - _WD_Capabilities_Example() ... "alwaysMatch" section
 
 
_WD_CapabilitiesAdd('alwaysMatch')
 
_WD_CapabilitiesAdd('alwaysMatch')
 
_WD_CapabilitiesAdd('acceptInsecureCerts', True)
 
_WD_CapabilitiesAdd('acceptInsecureCerts', True)
_WD_CapabilitiesAdd('timeouts', 'script', 300) ; https://www.w3.org/TR/webdriver/#timeouts
+
_WD_CapabilitiesAdd('platformName', 'windows')
_WD_CapabilitiesAdd('timeouts', 'pageLoad', 30000) ; https://www.w3.org/TR/webdriver/#timeouts
+
_WD_CapabilitiesAdd('firstMatch', 'chrome')
_WD_CapabilitiesAdd('timeouts', 'implicit', 4) ; https://www.w3.org/TR/webdriver/#timeouts
+
_WD_CapabilitiesAdd('browserName', 'chrome')
If $_EXAMPLE_OPTION_PROXY Then
+
_WD_CapabilitiesAdd('w3c', True)
_WD_CapabilitiesAdd('proxy', 'proxyType', 'manual')
+
_WD_CapabilitiesAdd('args', 'user-data-dir', 'C:\Users\' & @UserName & '\AppData\Local\Google\Chrome\User Data\WD_Testing')
_WD_CapabilitiesAdd('proxy', 'proxyAutoconfigUrl', '127.0.0.1') ; change '127.0.0.1' to your own 'proxyAutoconfigUrl' host
+
_WD_CapabilitiesAdd('args', 'user-agent', 'Mozilla/5.0 (Windows NT 10.0; Win' & StringReplace(@OSArch, 'X', '') & '; ' & @CPUArch & ') AppleWebKit/537.36 (KHTML, like Gecko) Chrome/' & _WD_GetBrowserVersion('chrome') & ' Safari/537.36')
_WD_CapabilitiesAdd('proxy', 'ftpProxy', '127.0.0.1') ; change '127.0.0.1' to your own 'ftpProxy' host
+
_WD_CapabilitiesAdd('args', '--profile-directory', Default)
_WD_CapabilitiesAdd('proxy', 'httpProxy', '127.0.0.1') ; change '127.0.0.1' to your own 'httpProxy' host
+
_WD_CapabilitiesAdd('args', 'start-maximized')
_WD_CapabilitiesAdd('proxy', 'noProxy', 'www.w3.org') ; an example url which should not to bo opened via proxy server
+
_WD_CapabilitiesAdd('args', 'disable-infobars')
_WD_CapabilitiesAdd('proxy', 'noProxy', 'www.autoitscript.com') ; an example url which should not to bo opened via proxy server
+
_WD_CapabilitiesAdd('args', '--no-sandbox')
_WD_CapabilitiesAdd('proxy', 'noProxy', 'www.google.com') ; an example url which should not to bo opened via proxy server
+
_WD_CapabilitiesAdd('args', '--disable-blink-features=AutomationControlled')
_WD_CapabilitiesAdd('proxy', 'noProxy', 'www.google.pl') ; an example url which should not to bo opened via proxy server
+
_WD_CapabilitiesAdd('args', '--disable-web-security')
_WD_CapabilitiesAdd('proxy', 'sslProxy', '127.0.0.1') ; change '127.0.0.1' to your own 'sslProxy' host
+
_WD_CapabilitiesAdd('args', '--allow-running-insecure-content')
_WD_CapabilitiesAdd('proxy', 'socksProxy', '127.0.0.1') ; change '127.0.0.1' to your own 'socksProxy' host
+
_WD_CapabilitiesAdd('args', '--ignore-certificate-errors')
_WD_CapabilitiesAdd('proxy', 'socksVersion', 1)
+
If $b_Headless Then _
EndIf
+
_WD_CapabilitiesAdd('args', '--headless')
#TODO check why 'WIN10' have issue when using FireFox - with the commented following line
+
If $s_Download_dir Then _
;~ _WD_CapabilitiesAdd('platformName', 'WIN10') ; https://stackoverflow.com/a/45621125/5314940
+
_WD_CapabilitiesAdd('prefs', 'download.default_directory', $s_Download_dir)
_WD_CapabilitiesDump(@ScriptLineNumber)
+
_WD_CapabilitiesAdd('excludeSwitches', 'disable-popup-blocking')
#EndRegion - _WD_Capabilities_Example() ... "alwaysMatch" section
+
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
 +
_WD_CapabilitiesAdd('excludeSwitches', 'load-extension')
  
#Region - _WD_Capabilities_Example() ... "firstMatch" section for Microsoft Edge
+
_WD_CapabilitiesDump(@ScriptLineNumber & ' test 1')
If $_EXAMPLE_OPTION_ALLCAPS Or $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_EDGE Then
+
Local $s_Capabilities = _WD_CapabilitiesGet()
; https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/capabilities-edge-options
 
ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
 
_WD_CapabilitiesAdd('firstMatch', 'edge')
 
_WD_CapabilitiesDump(@ScriptLineNumber)
 
#TODO CHECK .... "invalid argument: entry 0 of 'firstMatch' is invalid\nfrom invalid argument: unrecognized capability: browsername"
 
;~ _WD_CapabilitiesAdd('browsername', 'edge')
 
#TODO CHECK .... How to use 'WIN10'
 
;~ _WD_CapabilitiesAdd('platformName', 'WIN10')
 
_WD_CapabilitiesAdd('w3c', True)
 
#TODO CHECK .... How to use 'maxInstances'
 
;~ _WD_CapabilitiesAdd('maxInstances', 1) ; https://stackoverflow.com/a/45621125/5314940
 
If $_EXAMPLE_OPTION_HEADLESS Then _
 
_WD_CapabilitiesAdd('args', '--headless')
 
_WD_CapabilitiesAdd('prefs', 'plugins.always_open_pdf_externally', True) ; https://www.autoitscript.com/forum/topic/205553-webdriver-udf-help-support-iii/?do=findComment&comment=1482786
 
_WD_CapabilitiesAdd('prefs', 'edge.sleeping_tabs.enabled', False) ; https://www.autoitscript.com/forum/topic/205553-webdriver-udf-help-support-iii/?do=findComment&comment=1482798
 
_WD_CapabilitiesDump(@ScriptLineNumber)
 
EndIf
 
#EndRegion - _WD_Capabilities_Example() ... "firstMatch" section for Microsoft Edge
 
  
#Region - _WD_Capabilities_Example() ... "firstMatch" section for Microsoft Google Chrome
+
_WD_Startup()
If $_EXAMPLE_OPTION_ALLCAPS Or $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_CHROME Then
+
If @error Then Return SetError(@error, @extended, '')
ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
+
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: StartUp via chrome' & @CRLF)
_WD_CapabilitiesAdd('firstMatch', 'chrome')
 
#TODO ADD REMARK about:  "firstMatch key shadowed a value in alwaysMatch"
 
_WD_CapabilitiesAdd('browserName', 'chrome')
 
_WD_CapabilitiesAdd('w3c', True)
 
_WD_CapabilitiesAdd('binary', 'C:\Program Files (x86)\Google\Chrome\Application\chrome.exe')
 
_WD_CapabilitiesAdd('args', 'user-data-dir', $_EXAMPLE_PROFILE_CHROME)
 
_WD_CapabilitiesAdd('args', '--profile-directory', Default)
 
_WD_CapabilitiesAdd('args', 'user-agent', 'Mozilla/5.0 (Windows NT 10.0; Win' & StringReplace(@OSArch, 'X', '') & '; ' & @CPUArch & ') AppleWebKit/537.36 (KHTML, like Gecko) Chrome/' & _WD_GetBrowserVersion('chrome') & ' Safari/537.36')
 
_WD_CapabilitiesAdd('args', 'start-maximized')
 
_WD_CapabilitiesAdd('args', 'disable-infobars')
 
_WD_CapabilitiesAdd('args', '--no-sandbox')
 
_WD_CapabilitiesAdd('args', '--disable-blink-features=AutomationControlled')
 
_WD_CapabilitiesAdd('args', '--disable-web-security')
 
_WD_CapabilitiesAdd('args', '--allow-running-insecure-content') ; https://stackoverflow.com/a/60409220
 
_WD_CapabilitiesAdd('args', '--ignore-certificate-errors') ; https://stackoverflow.com/a/60409220
 
If $_EXAMPLE_OPTION_HEADLESS Then _
 
_WD_CapabilitiesAdd('args', '--headless')
 
_WD_CapabilitiesAdd('excludeSwitches', 'disable-popup-blocking') ; https://help.applitools.com/hc/en-us/articles/360007189411--Chrome-is-being-controlled-by-automated-test-software-notification
 
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
 
_WD_CapabilitiesAdd('excludeSwitches', 'load-extension')
 
_WD_CapabilitiesDump(@ScriptLineNumber)
 
EndIf
 
#EndRegion - _WD_Capabilities_Example() ... "firstMatch" section for Microsoft Google Chrome
 
 
 
#Region - _WD_Capabilities_Example() ... "firstMatch" section for FireFox
 
If $_EXAMPLE_OPTION_ALLCAPS Or $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_FIREFOX Then
 
ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
 
_WD_CapabilitiesAdd('firstMatch', 'firefox')
 
_WD_CapabilitiesAdd('browserName', 'firefox')
 
_WD_CapabilitiesAdd('binary', 'c:\Program Files (x86)\Mozilla Firefox\firefox.exe')
 
If $_EXAMPLE_OPTION_HEADLESS Then _
 
_WD_CapabilitiesAdd('args', '--headless')
 
_WD_CapabilitiesAdd('args', '-profile')
 
_WD_CapabilitiesAdd('args', $_EXAMPLE_PROFILE_FIREFOX)
 
_WD_CapabilitiesAdd('prefs', 'download.default_directory', @ScriptDir)
 
_WD_CapabilitiesAdd('prefs', 'dom.ipc.processCount', 8)
 
_WD_CapabilitiesAdd('prefs', 'javascript.options.showInConsole', False)
 
_WD_CapabilitiesAdd('prefs', 'browser.toolbars.bookmarks.visibility', 'always') ; check    about:config
 
_WD_CapabilitiesAdd('prefs', 'app.update.download.attempts', 0) ; check    about:config
 
_WD_CapabilitiesAdd('prefs', 'browser.safebrowsing.downloads.enabled', False) ; check    about:config
 
_WD_CapabilitiesAdd('prefs', 'browser.safebrowsing.downloads.enabled', False) ; check    about:config
 
; https://tarunlalwani.com/post/change-profile-settings-at-runtime-firefox-selenium/
 
# 0 means to download to the desktop, 1 means to download to the default "Downloads" directory, 2 means to use the directory
 
_WD_CapabilitiesAdd('prefs', 'browser.download.folderList', 2)
 
_WD_CapabilitiesAdd('prefs', 'browser.download.manager.showWhenStarting', False)
 
_WD_CapabilitiesAdd('prefs', 'browser.download.dir', $_EXAMPLE_DOWNLOAD_DIR)
 
_WD_CapabilitiesAdd('prefs', 'browser.helperApps.neverAsk.saveToDisk', 'application/x-gzip')
 
_WD_CapabilitiesAdd('prefs', 'browser.helperApps.neverAsk.saveToDisk', 'application/zip')
 
 
 
_WD_CapabilitiesAdd('log', 'level', 'trace')
 
  
_WD_CapabilitiesAdd('env', 'MOZ_LOG', 'nsHttp:5')
+
Local $WD_SESSION = _WD_CreateSession($s_Capabilities)
_WD_CapabilitiesAdd('env', 'MOZ_LOG_FILE', $_EXAMPLE_PROFILE_FIREFOX & '\log')
+
Return SetError(@error, @extended, $WD_SESSION)
_WD_CapabilitiesDump(@ScriptLineNumber)
+
EndFunc  ;==>_WD_SetupChrome
EndIf
 
#EndRegion - _WD_Capabilities_Example() ... "firstMatch" section for FireFox
 
  
_WD_CapabilitiesDisplay(@ScriptLineNumber)
+
Func _WD_Validate_Browser_Driver($s_Browser_name, $s_Driver_name)
  
If Not $_EXAMPLE_OPTION_RUN_BROWSER Then Return
+
Local $s_GetBrowserVersion = _WD_GetBrowserVersion($s_Browser_name)
 +
If @error Then Return SetError(@error, @extended, $s_GetBrowserVersion)
 +
If Not @Compiled Then ConsoleWrite("Browser version = " & $s_GetBrowserVersion & @CRLF)
 +
Local $s_GetBrowserVersion_main_number = Number(StringLeft($s_GetBrowserVersion, 2))
  
_WD_Option('Driver', $_EXAMPLE_OPTION_CHOOSEN_DRIVER)
+
Local $s_GetWebDriverVersion = _WD_GetWebDriverVersion(@ScriptDir, $s_Driver_name)
If $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_FIREFOX Then _WD_Option('Port', 4444)
+
If @error Then Return SetError(@error, @extended, $s_GetWebDriverVersion)
If $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_CHROME Then _WD_Option('Port', 9515)
+
If Not @Compiled Then ConsoleWrite("WEBDRIVER version = " & $s_GetWebDriverVersion & @CRLF)
If $_EXAMPLE_OPTION_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_EDGE Then _WD_Option('Port', 9515)
+
Local $s_GetWebDriverVersion_main_number = Number(StringLeft($s_GetWebDriverVersion, 2))
_WD_Startup()
 
  
Local $s_Capabilities_JSON = _WD_CapabilitiesGet()
+
Local $bTest = ($s_GetBrowserVersion_main_number = $s_GetWebDriverVersion_main_number)
;~ Local $s_Capabilities_JSON = _WD_CapabilitiesGet()
+
Return SetError($s_GetBrowserVersion_main_number, $s_GetWebDriverVersion_main_number, $bTest)
ConsoleWrite("! $s_Capabilities_JSON = " & $s_Capabilities_JSON & @CRLF)
+
EndFunc  ;==>_WD_Validate_Browser_Driver
  
Local $WD_SESSION = _WD_CreateSession($s_Capabilities_JSON)
+
Func _My_Check_State($iSleep)
If Not @Compiled Then MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONINFORMATION, "Information #" & @ScriptLineNumber, "Waiting before _WD_Shutdown()")
+
If Not @Compiled Then ConsoleWrite('Sleeping ' & $iSleep & ' ms' & @CRLF)
_WD_DeleteSession($WD_SESSION)
+
Sleep($iSleep)
_WD_Shutdown()
+
EndFunc  ;==>_My_Check_State
 
 
EndFunc  ;==>_WD_Capabilities_Example
 
 
 
Func _WD_Capabilities_Example_ChooseDriver()
 
Local $_CHOOSEN_DRIVER = ''
 
If $IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, "Question", _
 
"Do you want to use FireFox browser") Then
 
$_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_FIREFOX
 
ElseIf $IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, "Question", _
 
"Do you want to use Google Chrome browser") Then
 
$_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_CHROME
 
ElseIf $IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, "Question", _
 
"Do you want to use Miscrosoft Edge browser") Then
 
$_CHOOSEN_DRIVER = $_EXAMPLE_DRIVER_EDGE
 
EndIf
 
If Not FileExists($_CHOOSEN_DRIVER) Then
 
MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONERROR, "! Error occurred", _
 
"WebDriver file:" & @CRLF & _
 
$_CHOOSEN_DRIVER & @CRLF & _
 
"Not exist !" & @CRLF & _
 
"")
 
Exit
 
EndIf
 
ConsoleWrite("> USING: " & $_CHOOSEN_DRIVER & @CRLF)
 
Return $_CHOOSEN_DRIVER
 
EndFunc  ;==>_WD_Capabilities_Example_ChooseDriver
 
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 22:51, 9 December 2021

This page is still a work in progress.

WebDriver Capabilities

What are Capabilities?

A good description can be found here:
Not all server implementations will support every WebDriver feature. Therefore, the client and server should use JSON objects with the properties listed below when describing which features a user requests that a session support. If a session cannot support a capability that is requested in the desired capabilities, no error is thrown; a read-only capabilities object is returned that indicates the capabilities the session actually supports.

  • Capabilities are options that you can use to customize and configure a Browser session
  • The capabilities you want to set are passed as a formatted string to function _WD_CreateSession
  • The WebDriver UDF uses the Capabilities class to pass the capabilities string to the WebDriver Exe
  • Format and content of the capabilities string differ from Browser to Browser
  • Some capabilities are read-only, some are read-write

Take a look at remark about Legacy capabilities.

Chrome

Link to the documentation of Capabilities for Chrome.

Link to List of Chromium Command Line Switches.

Examples

$sCapabilities = '{"capabilities": {"alwaysMatch": {"goog:chromeOptions": {"w3c": true, "excludeSwitches": [ "enable-automation"]}}}}'

Firefox

Link to the documentation of Capabilities for Firefox.

Examples

$sCapabilities = '{"capabilities": {"alwaysMatch": {"browserName": "firefox", "acceptInsecureCerts":true}}}'

Edge

Link to the documentation of Capabilities for Edge.

Examples

$sCapabilities = '{"capabilities": {"alwaysMatch": {"ms:edgeOptions": {"excludeSwitches": [ "enable-automation"]}}}}'

WD_Capabilities UDF

examples with the full capabilities string and the WD_Capabilites functions to create it

Chrome Examples

_WD_CapabilitiesStartup()
_WD_CapabilitiesAdd('alwaysMatch', 'chrome')
_WD_CapabilitiesAdd('w3c', True)
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
Local $sCapabilities = _WD_CapabilitiesGet()

Firefox Examples

_WD_CapabilitiesStartup()
_WD_CapabilitiesAdd('alwaysMatch', 'firefox')
_WD_CapabilitiesAdd('browserName', 'firefox')
_WD_CapabilitiesAdd('acceptInsecureCerts', True)
Local $sCapabilities = _WD_CapabilitiesGet()

Edge Examples

_WD_CapabilitiesStartup()
_WD_CapabilitiesAdd('alwaysMatch', 'edge')
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
Local $sCapabilities = _WD_CapabilitiesGet()

Capabilities comlpex example

#include <MsgBoxConstants.au3>

#include "wd_capabilities.au3"
#include "wd_helper.au3"

_Example()
If @error Then ConsoleWrite("! ---> @error=" & @error & "  @extended=" & @extended & _
		" : Error launching browser" & @CRLF)


Func _Example()
	Local $WD_SESSION = _WD_SetupChrome()
	If @error Then Return SetError(@error, @extended, $WD_SESSION)

	MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONINFORMATION, "Information #" & @ScriptLineNumber, "Waiting before _WD_Shutdown()")
	_WD_DeleteSession($WD_SESSION)
	_WD_Shutdown()
EndFunc   ;==>_Example


Func _WD_SetupChrome($s_DriverLocation = @ScriptDir & '\chromedriver.exe', $b_Headless = False, $s_Download_dir = Default, $_WD_DEBUG_LEVEL = Default, $s_Log_FileFullPath = Default)
	If $_WD_DEBUG_LEVEL = Default Then
		$_WD_DEBUG = $_WD_DEBUG_Error
		If Not @Compiled Then $_WD_DEBUG = $_WD_DEBUG_Info
	EndIf

	_WD_Option('Driver', $s_DriverLocation)
	_WD_Option('Port', 9515)
	_WD_Option('DefaultTimeout', 1000)
	_WD_Option("Sleep", _My_Check_State)

	If $s_Download_dir = Default Then $s_Download_dir = @ScriptDir & '\WD_Download'
	$s_Download_dir = ''

	Local $bTest = _WD_Validate_Browser_Driver('chrome', 'chromedriver.exe')
	If Not $bTest Then Return SetError(@error, @extended, $bTest)

	If $s_Log_FileFullPath = Default Then $s_Log_FileFullPath = @ScriptDir & '\Chrome-Testing.log'
	If IsString($s_Log_FileFullPath) And StringLen(($s_Log_FileFullPath)) Then
		If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: Log Path = ' & $s_Log_FileFullPath & @CRLF)
		_WD_Option('DriverParams', '--log-path=' & '"' & $s_Log_FileFullPath & '"')
	EndIf

	_WD_CapabilitiesStartup()
	_WD_CapabilitiesAdd('alwaysMatch')
	_WD_CapabilitiesAdd('acceptInsecureCerts', True)
	_WD_CapabilitiesAdd('platformName', 'windows')
	_WD_CapabilitiesAdd('firstMatch', 'chrome')
	_WD_CapabilitiesAdd('browserName', 'chrome')
	_WD_CapabilitiesAdd('w3c', True)
	_WD_CapabilitiesAdd('args', 'user-data-dir', 'C:\Users\' & @UserName & '\AppData\Local\Google\Chrome\User Data\WD_Testing')
	_WD_CapabilitiesAdd('args', 'user-agent', 'Mozilla/5.0 (Windows NT 10.0; Win' & StringReplace(@OSArch, 'X', '') & '; ' & @CPUArch & ') AppleWebKit/537.36 (KHTML, like Gecko) Chrome/' & _WD_GetBrowserVersion('chrome') & ' Safari/537.36')
	_WD_CapabilitiesAdd('args', '--profile-directory', Default)
	_WD_CapabilitiesAdd('args', 'start-maximized')
	_WD_CapabilitiesAdd('args', 'disable-infobars')
	_WD_CapabilitiesAdd('args', '--no-sandbox')
	_WD_CapabilitiesAdd('args', '--disable-blink-features=AutomationControlled')
	_WD_CapabilitiesAdd('args', '--disable-web-security')
	_WD_CapabilitiesAdd('args', '--allow-running-insecure-content')
	_WD_CapabilitiesAdd('args', '--ignore-certificate-errors')
	If $b_Headless Then _
			_WD_CapabilitiesAdd('args', '--headless')
	If $s_Download_dir Then _
			_WD_CapabilitiesAdd('prefs', 'download.default_directory', $s_Download_dir)
	_WD_CapabilitiesAdd('excludeSwitches', 'disable-popup-blocking')
	_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
	_WD_CapabilitiesAdd('excludeSwitches', 'load-extension')

	_WD_CapabilitiesDump(@ScriptLineNumber & ' test 1')
	Local $s_Capabilities = _WD_CapabilitiesGet()

	_WD_Startup()
	If @error Then Return SetError(@error, @extended, '')
	If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: StartUp via chrome' & @CRLF)

	Local $WD_SESSION = _WD_CreateSession($s_Capabilities)
	Return SetError(@error, @extended, $WD_SESSION)
EndFunc   ;==>_WD_SetupChrome

Func _WD_Validate_Browser_Driver($s_Browser_name, $s_Driver_name)

	Local $s_GetBrowserVersion = _WD_GetBrowserVersion($s_Browser_name)
	If @error Then Return SetError(@error, @extended, $s_GetBrowserVersion)
	If Not @Compiled Then ConsoleWrite("Browser version = " & $s_GetBrowserVersion & @CRLF)
	Local $s_GetBrowserVersion_main_number = Number(StringLeft($s_GetBrowserVersion, 2))

	Local $s_GetWebDriverVersion = _WD_GetWebDriverVersion(@ScriptDir, $s_Driver_name)
	If @error Then Return SetError(@error, @extended, $s_GetWebDriverVersion)
	If Not @Compiled Then ConsoleWrite("WEBDRIVER version = " & $s_GetWebDriverVersion & @CRLF)
	Local $s_GetWebDriverVersion_main_number = Number(StringLeft($s_GetWebDriverVersion, 2))

	Local $bTest = ($s_GetBrowserVersion_main_number = $s_GetWebDriverVersion_main_number)
	Return SetError($s_GetBrowserVersion_main_number, $s_GetWebDriverVersion_main_number, $bTest)
EndFunc   ;==>_WD_Validate_Browser_Driver

Func _My_Check_State($iSleep)
	If Not @Compiled Then ConsoleWrite('Sleeping ' & $iSleep & ' ms' & @CRLF)
	Sleep($iSleep)
EndFunc   ;==>_My_Check_State