Difference between revisions of "WebDriver Capabilities"

From AutoIt Wiki
Jump to navigation Jump to search
(Capabilities comlpex example)
m (WD_Capabilities UDF)
Line 44: Line 44:
  
 
== Chrome Examples ==
 
== Chrome Examples ==
<syntaxhighlight lang="autoit">
 
_WD_CapabilitiesStartup()
 
_WD_CapabilitiesAdd('alwaysMatch', 'chrome')
 
_WD_CapabilitiesAdd('w3c', True)
 
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
 
Local $sCapabilities = _WD_CapabilitiesGet()
 
</syntaxhighlight>
 
 
== Firefox Examples ==
 
<syntaxhighlight lang="autoit">
 
_WD_CapabilitiesStartup()
 
_WD_CapabilitiesAdd('alwaysMatch', 'firefox')
 
_WD_CapabilitiesAdd('browserName', 'firefox')
 
_WD_CapabilitiesAdd('acceptInsecureCerts', True)
 
Local $sCapabilities = _WD_CapabilitiesGet()
 
</syntaxhighlight>
 
 
== Edge Examples ==
 
<syntaxhighlight lang="autoit">
 
_WD_CapabilitiesStartup()
 
_WD_CapabilitiesAdd('alwaysMatch', 'edge')
 
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
 
Local $sCapabilities = _WD_CapabilitiesGet()
 
</syntaxhighlight>
 
 
== A complete working example ==
 
 
 
<syntaxhighlight lang="autoit">
 
<syntaxhighlight lang="autoit">
 
#include <MsgBoxConstants.au3>
 
#include <MsgBoxConstants.au3>
Line 92: Line 65:
  
  
Func _WD_SetupChrome($s_DriverLocation = @ScriptDir & '\chromedriver.exe', $b_Headless = False, $s_Download_dir = Default, $_WD_DEBUG_LEVEL = Default, $s_Log_FileFullPath = Default)
+
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
 
If $_WD_DEBUG_LEVEL = Default Then
 
$_WD_DEBUG = $_WD_DEBUG_Error
 
$_WD_DEBUG = $_WD_DEBUG_Error
Line 98: Line 71:
 
EndIf
 
EndIf
  
_WD_Option('Driver', $s_DriverLocation)
+
_WD_Option("Driver", $s_DriverLocation)
_WD_Option('Port', 9515)
+
_WD_Option("Port", 9515)
_WD_Option('DefaultTimeout', 1000)
+
_WD_Option("DefaultTimeout", 1000)
 
_WD_Option("Sleep", _My_Check_State)
 
_WD_Option("Sleep", _My_Check_State)
  
If $s_Download_dir = Default Then $s_Download_dir = @ScriptDir & '\WD_Download'
+
If $s_Download_dir = Default Then $s_Download_dir = @ScriptDir & "\WD_Download"
$s_Download_dir = ''
+
$s_Download_dir = ""
  
Local $bTest = _WD_Validate_Browser_Driver('chrome', 'chromedriver.exe')
+
Local $bTest = _WD_Validate_Browser_Driver("chrome", "chromedriver.exe")
 
If Not $bTest Then Return SetError(@error, @extended, $bTest)
 
If Not $bTest Then Return SetError(@error, @extended, $bTest)
  
If $s_Log_FileFullPath = Default Then $s_Log_FileFullPath = @ScriptDir & '\Chrome-Testing.log'
+
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 IsString($s_Log_FileFullPath) And StringLen(($s_Log_FileFullPath)) Then
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: Log Path = ' & $s_Log_FileFullPath & @CRLF)
+
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & " WebDriver: Log Path = " & $s_Log_FileFullPath & @CRLF)
_WD_Option('DriverParams', '--log-path=' & '"' & $s_Log_FileFullPath & '"')
+
_WD_Option("DriverParams", "--log-path=" & """ & $s_Log_FileFullPath & """)
 
EndIf
 
EndIf
  
 
_WD_CapabilitiesStartup()
 
_WD_CapabilitiesStartup()
_WD_CapabilitiesAdd('alwaysMatch')
+
_WD_CapabilitiesAdd("alwaysMatch")
_WD_CapabilitiesAdd('acceptInsecureCerts', True)
+
_WD_CapabilitiesAdd("acceptInsecureCerts", True)
_WD_CapabilitiesAdd('platformName', 'windows')
+
_WD_CapabilitiesAdd("platformName", "windows")
_WD_CapabilitiesAdd('firstMatch', 'chrome')
+
_WD_CapabilitiesAdd("firstMatch", "chrome")
_WD_CapabilitiesAdd('browserName', 'chrome')
+
_WD_CapabilitiesAdd("browserName", "chrome")
_WD_CapabilitiesAdd('w3c', True)
+
_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-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", "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", "--profile-directory", Default)
_WD_CapabilitiesAdd('args', 'start-maximized')
+
_WD_CapabilitiesAdd("args", "start-maximized")
_WD_CapabilitiesAdd('args', 'disable-infobars')
+
_WD_CapabilitiesAdd("args", "disable-infobars")
_WD_CapabilitiesAdd('args', '--no-sandbox')
+
_WD_CapabilitiesAdd("args", "--no-sandbox")
_WD_CapabilitiesAdd('args', '--disable-blink-features=AutomationControlled')
+
_WD_CapabilitiesAdd("args", "--disable-blink-features=AutomationControlled")
_WD_CapabilitiesAdd('args', '--disable-web-security')
+
_WD_CapabilitiesAdd("args", "--disable-web-security")
_WD_CapabilitiesAdd('args', '--allow-running-insecure-content')
+
_WD_CapabilitiesAdd("args", "--allow-running-insecure-content")
_WD_CapabilitiesAdd('args', '--ignore-certificate-errors')
+
_WD_CapabilitiesAdd("args", "--ignore-certificate-errors")
 
If $b_Headless Then _
 
If $b_Headless Then _
_WD_CapabilitiesAdd('args', '--headless')
+
_WD_CapabilitiesAdd("args", "--headless")
 
If $s_Download_dir Then _
 
If $s_Download_dir Then _
_WD_CapabilitiesAdd('prefs', 'download.default_directory', $s_Download_dir)
+
_WD_CapabilitiesAdd("prefs", "download.default_directory", $s_Download_dir)
_WD_CapabilitiesAdd('excludeSwitches', 'disable-popup-blocking')
+
_WD_CapabilitiesAdd("excludeSwitches", "disable-popup-blocking")
_WD_CapabilitiesAdd('excludeSwitches', 'enable-automation')
+
_WD_CapabilitiesAdd("excludeSwitches", "enable-automation")
_WD_CapabilitiesAdd('excludeSwitches', 'load-extension')
+
_WD_CapabilitiesAdd("excludeSwitches", "load-extension")
  
_WD_CapabilitiesDump(@ScriptLineNumber & ' test 1')
+
_WD_CapabilitiesDump(@ScriptLineNumber & " test 1")
 
Local $s_Capabilities = _WD_CapabilitiesGet()
 
Local $s_Capabilities = _WD_CapabilitiesGet()
  
 
_WD_Startup()
 
_WD_Startup()
If @error Then Return SetError(@error, @extended, '')
+
If @error Then Return SetError(@error, @extended, "")
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & ' WebDriver: StartUp via chrome' & @CRLF)
+
If Not @Compiled Then ConsoleWrite(@ScriptLineNumber & " WebDriver: StartUp via chrome" & @CRLF)
  
 
Local $WD_SESSION = _WD_CreateSession($s_Capabilities)
 
Local $WD_SESSION = _WD_CreateSession($s_Capabilities)
Line 168: Line 141:
  
 
Func _My_Check_State($iSleep)
 
Func _My_Check_State($iSleep)
If Not @Compiled Then ConsoleWrite('Sleeping ' & $iSleep & ' ms' & @CRLF)
+
If Not @Compiled Then ConsoleWrite("Sleeping " & $iSleep & " ms" & @CRLF)
 
Sleep($iSleep)
 
Sleep($iSleep)
 
EndFunc  ;==>_My_Check_State
 
EndFunc  ;==>_My_Check_State
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 23:06, 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

#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