WebDriver UDF (W3C compliant version) - 2024/09/21

[Danp2]

@MusashiThe "unofficial" version of the CHM is available elsewhere on this forum. I will start including it in the official release once @water makes the new CHM creation tool available.

[Danp2]

Latest update just released. See below for change log.

Quote

    v0.5.0.2
    - Added: CHM help file (water)
    - Changed (_WD_Capabilities): Added support for "binary" option (mLipok)
    - Changed (_WD_Startup): Detect webdriver console exiting with error when launched
    - Chore: Updated function headers (water)
    - Chore: Updated wd_demo.au3
        - Added DemoSleep routine (mLipok)
        - Changed GUI background color for better visibility in Windows 11 (mLipok)
        - Disable "Run Demo" button during demo execution

 

[Danp2]

Latest update just released. See below for change log.

Quote

    v0.5.0.3
    - Changed (_WD_ExecuteScript): Optionally return value node instead of raw JSON (mLipok)
    - Changed (_WD_ElementActionEx): Added support for "check" and "uncheck" commands (TheDcoder)
    - Changed (_WD_GetElementFromPoint): Added support for frames
    - Fixed (_WD_ElementAction): Return raw response for 'shadow' command
    - Fixed (_WD_GetShadowRoot): Use shadow root identifier

 

[Danp2]

Latest update just released. See below for change log.

Quote

    v0.5.1.1
    - Added: _WD_JsonActionKey, _WD_JsonActionPause, and _WD_JsonActionPointer functions
    - Changed (_WD_ElementActionEx): Added support for 'click' action
    - Changed (_WD_UpdateDriver): Attempts to identify current architecture if $bFlag64 is Default.
    - Changed (__WD_DetectError): Detect "no such alert"
    - Changed (_WD_ElementSelectAction): Performance of "Options" significantly improved by reducing Webdriver calls
    - Fixed (_WD_Alert): Improve alert detection
    - Fixed (_WD_UpdateDriver): $bForce / $KEYWORD_NULL implementation (again)
    - Chore: Updated wd_demo.au3
        - Improved console output in DemoScript
        - Display screenshots in DemoWindows
        - Improved console output & in DemoAlerts
        - Corrected 'sendtext' coding in DemoAlerts
        - Added "update" option
        - Added "headless" option
        - Added DemoPrint routine

 

[Danp2]

Latest update just released. See below for change log.

Quote

0.5.2 - 2022-02-11

Changed

• REVISIONS.md renamed to CHANGELOG.md and format updated
• _WD_HighlightElements: Refactored for speed; now supports single or multiple elements
• _WD_UpdateDriver: Adjusted URL to match revised Github repo name

Deprecated

• _WD_HighlightElement: Flagged as Deprecated and will be removed in a future release

 

[Danp2]

Latest update just released. See below for change log.

Quote

0.6.0 - 2022-02-22

### Added

- _WD_JsonCookie (mLipok)
- _WD_GetDevicePixelRatio (mLipok)
- _WD_Cookies: Added DeleteAll option (mLipok)
- _WD_ElementSelectAction: Added SelectedIndex option (mLipok)

### Changed

- _WD_ElementSelectAction: Options array expanded to include additional columns (index, selected) (mLipok)
- _WD_Option: Logging can use a custom function or be completely disabled (mLipok)
- wd_capabilities.au3 now uses internal function __WD_ConsoleWrite
- wd_demo.au3
    - Updated DemoCookies
    - Enhanced logging options

### Fixed

- _WD_UpdateDriver: Detect error during download and additional error handling

### Project

- Rename project (repository) to au3WebDriver
- README.md restructuring
- Added files to fulfill the community standards
    - bug_report.md and feature_request.md
    - CODE_OF_CONDUCT.md file
    - PULL_REQUEST_TEMPLATE.md file
- CONTRIBUTING.md file now contains references to bug report template and feature request template

 

 

[mLipok]

Hey, Au3WebDriver users.
Please check out wd_demo.au3 and review them as it has changed a lot in the last few months.
There are now new DEMOs, new OPTIONS, new COMMENTS.

If you want new demos in this file, or functionality, don't hesitate to ask.

If the request will be approved, I will treat it as a challenge

 

[Danp2]

Latest update just released. See below for change log.

Quote

0.7.0 - 2022-03-03

Added

• Support for Opera browser
• _WD_GetBrowserPath

Changed

• __WD_ConsoleWrite: Updated to preserve @error and @extended.
• _WD_Startup: Added display of webdriver bit level (32 / 64).
• _WD_UpdateDriver: Support alternate browser location.
• _WD_UpdateDriver: Extract webdriver executable located in a subfolder
• _WD_CapabilitiesAdd: Must use 'msedge' instead of 'edge' when for browser name. Script breaking change

Fixed

• _WD_UpdateDriver: Unpacking webdriver executable failed on some workstations; Better error handling
• _WD_GetWebDriverVersion: Resolve error Subscript used on non-accessible variable

 

[Danp2]

Latest update just released. See below for change log.

Quote

## [0.9.0]

### Added

- _WD_LastHTTPResponse
- _WD_CapabilitiesDefine

### Removed

_WD_CapabilitiesDisplay

### Fixed

- _WD_WaitElement: Prevent premature exit when $_WD_OPTION_NoMatch is True
- __WD_GetLatestWebdriverInfo: Log correct function name
- __WD_UpdateExtractor: Correct detection of executable located in subfolder
- _WD_Startup: Check result of _WinAPI_GetBinaryType

### Changed

- _WD_Startup: Detect missing webdriver executable
- __WD_ConsoleWrite: Added conditional logging via new optional $iDebugLevel parameter
- Support additional debugging level ($_WD_DEBUG_Full)
- _WD_CapabilitiesAdd
    - Support browser specific / vendor capabilities
    - Capability names are case sensitive
- wd_demo
    - Detect / abort on failure to approve cookies
    - Update DemoScript() examples + descriptions

### Project

- Remove unused WinHTTP request object

 

[Danp2]

Latest update just released. See below for change log.

Quote

## [0.9.1]

### Fixed

- _WD_ElementAction: Correct action names (CompRole >> ComputedRole & CompLabel >> ComputedLabel)
- _WD_GetWebDriverVersion: Update regex for extracting version number
- Help file search functionality

 

[mLipok]

@Danp2 why in 0.9.1 there are not all commits merged, form 0.9.0 till now ?

[Danp2]

@mLipok0.9.1 is an interim bug fix where I cherry picked a few commits, mostly to address the recent issue with _WD_GetWebDriverVersion & MS Edge. The other commits already in the master branch will be in the next "full" release (most likely 0.10.0).

[Danp2]

Latest update just released. See below for change log.

Quote

## [0.10.0]

### Added

- _WD_GetElementByRegEx (@TheDcoder)
- _WD_ElementStyle     (@mLipok)
- _WD_Storage

### Changed

- __WD_DetectError: Detect Javascript and Invalid Selector errors
- _WD_SetElementValue: Advanced mode now triggers Change event
- _WD_Startup: Improve logging when existing webdriver instance is reused
- _WD_ElementSelectAction: Disabled option detection
- Logging
    - Reduced detail of messages associated with $_WD_DEBUG_Info
    - Webdriver responses are now only shown with $__WD_DEBUG_Full and they are no longer trimmed by default
- wd_demo
    - Added DemoStyles(), DemoSelectOptions(), UserTesting()
    - Improved demo selection

### Fixed

- _WD_UpdateDriver: Revise URL used to determine latest matching version of Edgedriver

### Removed

- _WD_HighlightElement

 

[Danp2]

Latest update just released. See below for change log.

Quote

## [0.10.1]

### Added

- _WD_CapabilitiesAdd: Support `webSocketUrl` capability

### Changed

- _WD_ElementSelectAction: Hidden option detection

### Fixed

- _WD_CDPExecuteCommand: Missing $ prefix in variable name
- _WD_CapabilitiesAdd: Support keys containing colons
- _WD_ElementSelectAction: Altering selection now triggers Change event

 

[Danp2]

Latest update just released. See below for change log.

Quote

## [ 0.11.0]

### Added

- _WD_FrameList (@mLipok)
- _WD_DispatchEvent

### Changed

- _WD_CapabilitiesAdd: Support `mobileEmulation>deviceMetrics` capability
- _WD_ElementSelectAction
    - Added `singleSelect` command
    - Revised columns returned by `options` and `selectedOptions` commands
    - Refactored Javascript coding
- _WD_FrameEnter: Added support for _WD_FrameList style paths
- _WD_FrameLeave: Refactored for improved functionality
- _WD_LinkClickByText: Added ability to specify the starting element
- _WD_LoadWait
    - Improved error handling / logging
    - Added ability to specify minimally acceptable page loading status

### Fixed

- _WD_Alert: Set correct error code when 'status' no alert present
- Improved error detection in winhttp routines

 

[mLipok]

_WD_FrameList still have some issues in specific cases.

But this is very handy function.

[mLipok]

@Danp2 should'nt you change topic title ?

 

[Danp2]

20 minutes ago, mLipok said:

_WD_FrameList still have some issues in specific cases.

I'm sure you will eventually resolve them. Maybe we should add some details in the function header in the interim.

Quote

should'nt you change topic title ?

Maybe I'm being extra obtuse today, but I'm not sure what you are expecting since I already changed the date. 🤔

[mLipok]

58 minutes ago, Danp2 said:

I already changed the date.

Oops, you use US date notation.

My fault.

Please consider to use ISO or AutoIt format.

[noellarkin]

I came back to this UDF after a year or so, and updated the files required (Json UDF, WinHTTP UDF, WD UDF and the latest geckodriver.exe) to use it with Firefox. Getting this error:
 

expandcollapse popup

_WD_Option ==> Success [0] : Parameters:   Option=errormsgbox   Value=False
_WD_Option ==> Success [0] : Parameters:   Option=OutputDebug   Value=False
_WD_GetBrowserPath ==> Success [0 / 1] : Parameters:    Browser=Firefox
_WD_GetBrowserVersion ==> Success [0 / 1] : Parameters:    Browser=Firefox
_WD_GetWebDriverVersion ==> Success [0 / 0] : Parameters:    Dir=C:\Program Files (x86)\AutoIt3\Include\    EXE=geckodriver.exe
__WD_GetLatestWebdriverInfo ==> Success [0 / 0]
_WD_UpdateDriver ==> Success [0 / 0] : DriverCurrent = 0.31.0 : DriverLatest = 0.31.0
> UpdateResult = False
_WD_Option ==> Success [0] : Parameters:   Option=Driver   Value=geckodriver.exe
_WD_Option ==> Success [0] : Parameters:   Option=DriverParams   Value=--log trace
_WD_Option ==> Success [0] : Parameters:   Option=Port   Value=4444
_WD_CapabilitiesStartup: #148 : > {"capabilities":"{}"} > IsObj = 1
_WD_CapabilitiesAdd: #177 :      $key = alwaysMatch     $value1 = firefox     $value2 = 
_WD_CapabilitiesAdd: #205 :  $_WD_NOTATION__MATCHTYPE = [capabilities][alwaysMatch] $_WD_NOTATION__SPECIFICVENDOR = ["moz:firefoxOptions"]
_WD_CapabilitiesAdd ==> Success [0] : Successfully used [alwaysMatch]  with specified browser: firefox
_WD_CapabilitiesAdd: #177 :      $key = browserName     $value1 = firefox     $value2 = 
_WD_CapabilitiesAdd: #217 #275 :      $key = browserName     $value1 = firefox     $value2 =     $s_Notation = [capabilities][alwaysMatch]["browserName"]   <<<<  firefox
_WD_CapabilitiesAdd ==> Success [0] : Successfully added capability
_WD_CapabilitiesAdd: #177 :      $key = acceptInsecureCerts     $value1 = True     $value2 = 
_WD_CapabilitiesAdd: #217 #275 :      $key = acceptInsecureCerts     $value1 = True     $value2 =     $s_Notation = [capabilities][alwaysMatch]["acceptInsecureCerts"]   <<<<  True
_WD_CapabilitiesAdd ==> Success [0] : Successfully added capability
_WD_CapabilitiesDump: JSON structure starts below: 1141
{
    "capabilities":{
        "alwaysMatch":{
            "browserName":"firefox",
            "acceptInsecureCerts":true
        }
    }
}
_WD_CapabilitiesDump: JSON structure ends above.
> wd_demo.au3: _WD_Startup
_WD_Startup ==> File issue [18] : Non-existent Web Driver: geckodriver.exe
! Error = 18 occurred on: Demo
! _WD_LastHTTPResult = 0
_WD_GetSession ==> Success [0]
! _WD_GetSession =

I've put geckodriver.exe in C:\Program Files (x86)\AutoIt3\Include so it ought to be able to find it. I'm wondering where I may have messed anything up...?