Description | Features | Getting started | Configuration | Contributing | License | Acknowledgements

The project "autoit-webdriver-boilerplate" can be used as quick entry point for the awesome au3WebDriver project by @Danp2 (and @mlipok). The intention is, give people a easy start with WebDriver for AutoIt.

The different kinds of examples, are (and will be) separated in different branches of the repository. In this overview you basically can see which branch contains which example of WebDriver actions. Some examples and their code could be implemented in a shorter way, but this is made by design and follows a educational purpose.

In file src/common/webdriver-actions-handler.au3 you can find the following functions which should help you in terms of browser automation actions. These functions are used in the different branches and especially in the _Steps() function and their subfunctions (entry point of the browser automation).

As assumption, your "browser" of choice which should be automated, have to be installed on your system. Not the "driver" (chromedriver.exe, geckodriver.exe etc.), your browser.

Fork or clone the repository. Alternatively you can download the latest release package. That should be all.

Open the project in your editor/IDE and navigate to folder src. Open main.au3, check and adjust the values of function _SetGlobalValues() and start the program. By default, in case you fulfill the preconditions, the driver should start and should execute some simple webdriver actions like described in the features section (for the specific branch).

Adjust the _Steps() function content in website-steps-handler.au3 to your requirements and goals, use the prepared wrapper functions in src\common\webdriver-actions-handler.au3 and in as best case, you also want to follow the POM (page object model) structure like prepared too.

Adjust the content/values of function _SetGlobalValues() in src\main.au3.

Func _SetGlobalValues(ByRef $mConfig)
    $mConfig.Driver            = 'firefox' ; chrome|firefox|msedge
    $mConfig.IsHeadlessMode    = False     ; False|True
    $mConfig.IgnoreSSLAndCerts = False     ; False|True
    $mConfig.Delay             = 300       ; delay for supporting a robust waiting behavior (page load, clicks, texts etc.)
    $mConfig.BrowserWidth      = 1600      ; or 1920, etc.
    $mConfig.BrowserHeight     = 900       ; or 1080, etc.
    $mConfig.LocatorStrategy   = Null      ; will be set in function "_SetLocatorStrategy()"
    $mConfig.BrowserMode       = 'size'    ; fullscreen|maximize|size (default is 'size' which applies .BrowserWidth and .BrowserHeight)

    ; This is the default installation path, change this in case it's another on your system.
    $mConfig.FirefoxBinary = 'C:\Program Files\Mozilla Firefox\firefox.exe'

    ; Shutdown webdriver on find element error (default is True).
    $mConfig.TeardownOnFindElementError = True

    ; do not change this
    $bAlreadyTeardown = False
EndFunc

To be defined [...]

Distributed under the MIT License. See LICENSE for more information.

• Opportunity by GitHub
• Badges by Shields
• Thanks to the authors, maintainers and contributers of the various projects and UDFs
  • lib/au3WebDriver/wd_*.au3 by @Danp2 and @mLipok (License: MIT)
  • lib/json/*.au3 by @Ward, @Jos and @TheXMan (License: Unlicense)
  • lib/winHttp/*.au3 by @trancexx/@dragana-r (License: Apache-2.0)

To the top