Add support for Opera browser (#213)

* Array of supported browsers

* _WD_GetBrowserVersion: Eliminate hardcoding

* _WD_UpdateDriver: Partial elimination of hardcoding

* wd_demo.au3 Opera first commit (#214)

* Expand and move Support Browsers array

* Implement $_WD_BROWSER* enum

* Utilize $_WD_BROWSER_Name

* __WD_CapabilitiesInitialize + 'operaOptions' (#217)

* __WD_CapabilitiesInitialize + 'operaOptions'

* using $_WD_SupportedBrowsers

* 'edge' >> 'msedge' ScriptBreakingChange

* Readme update for opera (#216)

* wd_core.au3 - operaOptions > goog:chromeOptions (#221)

related to @Danp2  findings:
#220 (comment)

* added _WD_GetBrowserPath() with Opera path support (#223)

* _WD_GetBrowserPath: Eliminate browser specific code

* _WD_UpdateDriver: Support alternate browser location (#226)

* wd_demo.au3 - SetupOpera() suplemented + fixes (#218)

* Update change log (#230)

* Fix [Unreleased] header

* Update CHANGELOG.md

* _WD_UpdateDriver: Eliminate remaining hardcoding (#231)

* Expand $_WD_SupportedBrowsers
* Add __WD_GetLatestWebdriverInfo
* _WD_UpdateDriver: Use __WD_GetLatestWebdriverInfo

* OPERA:  _WD_GetBrowserVersion/Path refactoring (#235)

* $_WD_ERROR_NotSupported 

* using $iIndex = @Extended

* OPERA: _WD_UpdateDriver + __WD_UpdateExtractor (#236)

* Opera final proposals (#237)

Co-authored-by: Michał Lipok <mlipok@users.noreply.github.com>

Author: Danp2

CHANGELOG.md

@@ -9,6 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Go to [legend](#legend---types-of-changes) for further information about the types of changes.
 
+## [Unreleased]
+
+### 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 
+
+### Deprecated
+
+### Fixed
+
+- _WD_UpdateDriver: Unpacking webdriver executable failed on some workstations; Better error handling
+- _WD_GetWebDriverVersion: Resolve error `Subscript used on non-accessible variable`
+
+### Removed
+### Security
+### Project
+
 ## [0.6.0] - 2022-02-22
 
 ### Added

README.md

@@ -5,8 +5,8 @@
     <h2 align="center">Welcome to <code>au3WebDriver</code></h2>
 </p>
 
-[![license](https://img.shields.io/badge/license-MIT-ff69b4.svg?style=flat-square&logo=spdx)](https://github.com/Danp2/au3WebDriver/blob/master/LICENSE)
-[![contributors](https://img.shields.io/github/contributors/Danp2/au3WebDriver.svg?style=flat-square&logo=github)](https://github.com/Danp2/au3WebDriver/graphs/contributors)
+[![license](https://img.shields.io/badge/license-MIT-ff69b4.svg?style=flat-square&logo=spdx)][license]
+[![contributors](https://img.shields.io/github/contributors/Danp2/au3WebDriver.svg?style=flat-square&logo=github)][Contributors]
 ![repo size](https://img.shields.io/github/repo-size/Danp2/au3WebDriver.svg?style=flat-square&logo=github)
 [![last commit](https://img.shields.io/github/last-commit/Danp2/au3WebDriver.svg?style=flat-square&logo=github)](https://github.com/Danp2/au3WebDriver/commits/master)
 [![release](https://img.shields.io/github/release/Danp2/au3WebDriver.svg?style=flat-square&logo=github)](https://github.com/Danp2/au3WebDriver/releases/latest)
@@ -17,24 +17,23 @@
 
 ## Description
 
-This au3WebDriver UDF (project) allows to interact with any browser that supports the [W3C WebDriver specifications](https://www.w3.org/TR/webdriver/).  Supporting multiple browsers via the same code base is now possible with just a few configuration settings.
+This au3WebDriver UDF (project) allows to interact with any browser that supports the [W3C WebDriver specifications][W3C Webdriver].  Supporting multiple browsers via the same code base is now possible with just a few configuration settings.
 
 ## Documentation
 
 |                                                                                                                      | Reference                                                     | Description                                                                                            |
 | :---:                                                                                                                | :---                                                          | :---                                                                                                   |
-| <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/5/5e/W3C_icon.svg/212px-W3C_icon.svg.png" width="20"> | [W3C WebDriver](https://www.w3.org/TR/webdriver/)             | Official W3C WebDriver standard/specification.                                                         |
-| 📚                                                                                                                   | [WebDriver Wiki](https://www.autoitscript.com/wiki/WebDriver) | Further information about this UDF (project) like big picture, capabilities, troubleshooting and more. |
+| <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/5/5e/W3C_icon.svg/212px-W3C_icon.svg.png" width="20"> | [W3C WebDriver]             | Official W3C WebDriver standard/specification.                                                         |
+| 📚                                                                                                                   | [WebDriver Wiki] | Further information about this UDF (project) like big picture, capabilities, troubleshooting and more. |
 | 📖                                                                                                                   | Webdriver.chm                                                 | Function CHM help file that comes with this UDF (project) download.                                    |
 
 ## Features
 
 ### *Browser support*
 
-| Chrome                                                                                            | Edge                                                                                        | Firefox                                                                                              |
-| :---                                                                                              | :---                                                                                        | :---                                                                                                 |
-| ![Chrome48] | ![Edge48] | ![Firefox48] |
-
+| Chrome      | Edge    | Firefox        | Opera      |
+|-------------|---------|----------------|------------|
+| ![Chrome48] | ![Edge48] | ![Firefox48] | ![Opera48] |
 
 ### *Functions*
 
@@ -149,24 +148,26 @@ This au3WebDriver UDF (project) allows to interact with any browser that support
 Download and add the following mandatory Third-Party UDFs to your project folder (independent of the browser you want to automate).
 
 - Mandatory ✔
-  - [Json UDF](https://www.autoitscript.com/forum/topic/148114-a-non-strict-json-udf-jsmn) - Archive includes *Json.au3* & *BinaryCall.au3*.
-  - [WinHTTP UDF](https://github.com/dragana-r/autoit-winhttp/releases/latest) - Archive includes *WinHttp.au3* & *WinHttpConstants.au3*.
+  - [Json UDF] - Archive includes *Json.au3* & *BinaryCall.au3*.
+  - [WinHTTP UDF] - Archive includes *WinHttp.au3* & *WinHttpConstants.au3*.
 - Optional ⚠
-  - [HtmlTable2Array UDF](https://www.autoitscript.com/forum/topic/167679-read-data-from-html-tables-from-raw-html-source/) - Extraction of data from HTML tables to an array.
-  - [WinHttp_WebSocket UDF](https://github.com/Danp2/autoit-websocket) - Needed for websocket CDP functionality.
+  - [HtmlTable2Array UDF] - Extraction of data from HTML tables to an array.
+  - [WinHttp_WebSocket UDF] - Needed for websocket CDP functionality.
 
-Download and install one of the following WebDriver (depending on the browser type and version you want to automate).
+Download and install one of the following WebDrivers (depending on the browser type and version you want to automate).
 
-| Browser                                                                                              | Download                                                                      | WebDriver specification status                                                                                   |
-| :---:                                                                                                | :---                                                                          | :---                                                                                                             |
-| ![Chrome16]    | [Chrome](https://sites.google.com/chromium.org/driver/downloads)              | [Status](https://chromium.googlesource.com/chromium/src/+/master/docs/chromedriver_status.md)                    |
-| ![Edge16]          | [Edge](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/) | [Status](https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/)  |
-| ![Firefox16] | [Firefox](https://github.com/mozilla/geckodriver/releases/latest)             | [Status](https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette/WebDriver/status) [^1]                                  |
+|    Browser   | Download             | Implementation status        |
+|:------------:|----------------------|------------------------------|
+|  ![Chrome16] | [Chrome][ChromeDL]   | [Status][ChromeStatus]       |
+|   ![Edge16]  | [Edge][EdgeDL]       | [Status][EdgeStatus]         |
+| ![Firefox16] | [Firefox][FirefoxDL] | [Status][FirefoxStatus] [^1] |
+|  ![Opera16]  | [Opera][OperaDL]     | [^2]                         |
 
-Limitation notice. [^2]
+Limitation notice. [^3]
 
 [^1]: Login Required
-[^2]: Not all WebDriver functions have been implemented by each browser. Keep that in mind and check the "WebDriver specification status" for your desired WebDriver of choice.
+[^2]: Derived from ChromeDriver per project [ReadMe][Opera ReadMe]
+[^3]: Not all WebDriver functions have been fully implemented by each browser. Keep that in mind and check the "Implementation status" for your desired WebDriver of choice.
 
 #### *Installation*
 
@@ -176,14 +177,11 @@ To automate your browser, follow the following steps.
 2. Move the UDFs to your project folder or to a directory where AutoIt can find them.
     - All *wd_\*.au3* files and the Third-Party UDFs *\*.au3* should be placed in the same directory.
     - Otherwise you have to adjust the `#include` statements in the files.
-3. Move your desired WebDriver of choice to directory of the *wd_\*.au3* files.
-    - chromedriver.exe (Chrome)
-    - geckodriver.exe (Firefox)
-    - msedgedriver.exe (Edge, chromium based)
+3. Move your desired WebDriver of choice to the directory containing the *wd_\*.au3* files.
 
 #### *Usage*
 
-Run [wd_demo.au3](https://github.com/Danp2/au3WebDriver/blob/master/wd_demo.au3), choose your "Browser" from the dropdown and press the "Run Demo!" button that will perform the "DemoNavigation" demo to validate your installation.
+Run `wd_demo.au3`, choose your "Browser" from the dropdown and press the "Run Demo!" button that will perform the "DemoNavigation" demo to validate your installation.
 
 <details>
 <summary><i>Result example</i></summary>
@@ -211,11 +209,11 @@ Useful information about possible configurations following soon.<br>
 
 ## Contributing
 
-Just look at [CONTRIBUTING](https://github.com/Danp2/au3WebDriver/blob/master/docs/CONTRIBUTING.md), thank you!
+Just look at [CONTRIBUTING], thank you!
 
 ## License
 
-Distributed under the MIT License. See [LICENSE](https://github.com/Danp2/au3WebDriver/blob/master/LICENSE) for more information.
+Distributed under the MIT License. See [LICENSE] for more information.
 
 ## Acknowledgements
 
@@ -230,7 +228,7 @@ Distributed under the MIT License. See [LICENSE](https://github.com/Danp2/au3Web
   - Thanks to [@Danp2](https://github.com/Danp2) for the project idea, creation and maintenance
   - Thanks to [@mLipok](https://github.com/mLipok) for his *wd_capabilities.au3*
   - Thanks to [@Sven-Seyfert](https://github.com/Sven-Seyfert) for the project logo
-  - **Big thanks** to all the hard-working [contributors](https://github.com/Danp2/au3WebDriver/graphs/contributors)
+  - **Big thanks** to all the hard-working [contributors]
 
 ##
 
@@ -241,4 +239,23 @@ Distributed under the MIT License. See [LICENSE](https://github.com/Danp2/au3Web
 [Edge48]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_48x48.png
 [Edge16]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_16x16.png
 [Firefox48]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_48x48.png
-[Firefox16]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_16x16.png
+[Firefox16]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_16x16.png
+[Opera48]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_48x48.png
+[Opera16]: https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_16x16.png
+[ChromeDL]: https://sites.google.com/chromium.org/driver/downloads
+[ChromeStatus]: https://chromium.googlesource.com/chromium/src/+/master/docs/chromedriver_status.md
+[EdgeStatus]: https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium/
+[EdgeDL]: https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/
+[FirefoxStatus]: https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette/WebDriver/status
+[FirefoxDL]: https://github.com/mozilla/geckodriver/releases/latest
+[OperaDL]: https://github.com/operasoftware/operachromiumdriver/releases/latest
+[License]: https://github.com/Danp2/au3WebDriver/blob/master/LICENSE
+[Contributors]: https://github.com/Danp2/au3WebDriver/graphs/contributors
+[W3C WebDriver]: https://www.w3.org/TR/webdriver/
+[WebDriver Wiki]: https://www.autoitscript.com/wiki/WebDriver
+[Opera ReadMe]: https://github.com/operasoftware/operachromiumdriver/blob/master/README.md
+[Json UDF]: https://www.autoitscript.com/forum/topic/148114-a-non-strict-json-udf-jsmn
+[WinHTTP UDF]: https://github.com/dragana-r/autoit-winhttp/releases/latest
+[HtmlTable2Array UDF]: https://www.autoitscript.com/forum/topic/167679-read-data-from-html-tables-from-raw-html-source/
+[WinHttp_WebSocket UDF]: https://github.com/Danp2/autoit-websocket
+[CONTRIBUTING]: https://github.com/Danp2/au3WebDriver/blob/master/docs/CONTRIBUTING.md

wd_capabilities.au3

@@ -15,7 +15,7 @@
 ; Author ........: mLipok
 ; Modified ......:
 ; URL ...........:
-; Date ..........: 2021/12/07
+; Date ..........: 2022/02/23
 ; ================================================================================
 
 #Region - wd_capabilities.au3 - Copyright
@@ -258,13 +258,9 @@ EndFunc   ;==>_WD_CapabilitiesGet
 ; #INTERNAL_USE_ONLY# ===========================================================================================================
 ; Name ..........: __WD_CapabilitiesInitialize
 ; Description ...: Initialize $_WD_CAPS__API and presets for 'alwaysMatch' Or 'firstMatch'
-; Syntax ........: __WD_CapabilitiesInitialize($s_MatchType[, $s_BrowserType = ''])
+; Syntax ........: __WD_CapabilitiesInitialize($s_MatchType[, $s_BrowserName = ''])
 ; Parameters ....: $s_MatchType         - a string value. 'alwaysMatch' Or 'firstMatch'.
-;                  $s_BrowserType      - [optional] a string value. Default is ''. One of:
-;                               | 'chrome'
-;                               | 'firefox'
-;                               | 'edge'
-;                               | '' an empty string
+;                  $s_BrowserName - [optional] The browser name as defined in $_WD_SupportedBrowsers. Default is ''
 ; Return values .: None, or set @error
 ; Author ........: mLipok
 ; Modified ......:
@@ -273,25 +269,25 @@ EndFunc   ;==>_WD_CapabilitiesGet
 ; Link ..........:
 ; Example .......: No
 ; ===============================================================================================================================
-Func __WD_CapabilitiesInitialize($s_MatchType, $s_BrowserType = '') ; $s_MatchType = 'alwaysMatch' Or 'firstMatch'
+Func __WD_CapabilitiesInitialize($s_MatchType, $s_BrowserName = '') ; $s_MatchType = 'alwaysMatch' Or 'firstMatch'
 	#Region - parameters validation
 ;~ 	__WD_ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
 	If Not StringInStr('alwaysMatch|firstMatch', $s_MatchType) Then _
 			Return SetError(1)
 ;~ 	__WD_ConsoleWrite("! @ScriptLineNumber = " & @ScriptLineNumber & @CRLF)
 
-;~ 	MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONINFORMATION, "Information #" & @ScriptLineNumber, "$s_BrowserType = " & $s_BrowserType & @CRLF & "$s_MatchType = " & $s_MatchType)
+;~ 	MsgBox($MB_OK + $MB_TOPMOST + $MB_ICONINFORMATION, "Information #" & @ScriptLineNumber, "$s_BrowserName = " & $s_BrowserName & @CRLF & "$s_MatchType = " & $s_MatchType)
 	Local $s_SpecificOptions_KeyName = ''
-	If StringInStr($s_BrowserType, 'chrome') Then
-		$s_SpecificOptions_KeyName = 'goog:chromeOptions'
-	ElseIf StringInStr($s_BrowserType, 'firefox') Then
-		$s_SpecificOptions_KeyName = 'moz:firefoxOptions'
-	ElseIf StringInStr($s_BrowserType, 'edge') Then
-		$s_SpecificOptions_KeyName = 'ms:edgeOptions'
-	ElseIf $s_MatchType = 'alwaysMatch' And $s_BrowserType = '' Then
+
+	If $s_BrowserName <> '' Then
+		Local $iIndex = _ArraySearch($_WD_SupportedBrowsers, StringLower($s_BrowserName), Default, Default, Default, Default, Default, $_WD_BROWSER_Name)
+		$s_SpecificOptions_KeyName = $_WD_SupportedBrowsers[$iIndex][$_WD_BROWSER_OptionsKey]
+	ElseIf $s_MatchType = 'alwaysMatch' And $s_BrowserName = '' Then
 		$s_SpecificOptions_KeyName = ''
-	ElseIf $s_MatchType = 'firstMatch' And $s_BrowserType = '' Then
+	ElseIf $s_MatchType = 'firstMatch' And $s_BrowserName = '' Then
 		Return SetError(2)
+;~ 	Else
+;~ 		Return SetError(3) ; this should be tested/reviewed later (@mLipok 23-02-2022)
 	EndIf
 	#EndRegion - parameters validation
 
@@ -324,7 +320,7 @@ Func __WD_CapabilitiesInitialize($s_MatchType, $s_BrowserType = '') ; $s_MatchTy
 
 	#Region - FOR TESTING ONLY
 	Local $s_Information = _
-			"$s_BrowserType = " & $s_BrowserType & @CRLF & _
+			"$s_BrowserName = " & $s_BrowserName & @CRLF & _
 			"$s_MatchType = " & $s_MatchType & @CRLF & _
 			"$s_SpecificOptions_KeyName = " & $s_SpecificOptions_KeyName & @CRLF & _
 			"$i_FirstMatch_Counter = " & $i_FirstMatch_Counter & @CRLF & _