Geckofx Documentation

Welcome to the WebdriverIO documentation. It will help you to get started fast. If you run into problems, you can find help and answers on our Gitter Channel or you can hit me on Twitter.

The Gecko spectrograph and CAFE unit are both remotely controlled from the Control Room. The Gecko Session runs on a 3-screen display. The login and password will be given to the observers by the Support Astronomer at the beginning of their observing run. CefSharp is an easy way to embed a full-featured standards-compliant web browser into your C# or VB.NET app. CefSharp has browser controls for WinForms and WPF apps, and a headless (offscreen) version for automation projects too.

Note: These are the docs for the latest version (>=6.x) of WebdriverIO. If you are still using an older version, please visit the old documentation websites!

  • Stack Exchange network consists of 176 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share their knowledge, and build their careers.
  • V8 knows nothing about the DOM, the Document Object Model, as it is meant to just process the JavaScript. Blink contains the layout engine that decides how to display a site. It makes sense that.

The following short step-by-step introduction will help you get your first WebdriverIO script up and running:

Taking the first step

You’ll need Node.js installed.

  • Install at least v12.16.1 or higher as this is the oldest active LTS version
  • Only releases that are or will become an LTS release are officially supported

If you don't have Node installed, we recommend installing NVM to assist managing multiple active Node.js versions. If you are using the WDIO Testrunner in sync mode you also need Python v3 or higher installed.

Setup your project

Before installing dependencies, you’ll need to initialize a new NPM project. This will allow you to use the CLI to install dependencies in your project.


To do this, run:

The -y will answer 'yes' to all the prompts, giving you a standard NPM project. Feel free to omit the -y if you'd like to specify your own project details.

Geckofx Documentation

Install WebdriverIO CLI

If you want to use WebdriverIO in your project for integration testing, we recommend using the test runner. It comes with lots of useful features that makes your life easier.

Since WebdriverIO version 5, the testrunner is in the @wdio/cli NPM package.

Now, install the CLI:

Generate Configuration File

Next, you’ll generate a configuration file to store your WebdriverIO settings.

To do that, just run the configuration utility:

That's it! The configurator will install all required packages for you and create a config file called wdio.conf.js.

Create Spec Files

Now it's time to create your test file. You’re going to store all of your test files in a new folder.

Create the test folder like this:


Geckofx Documentation

Create a new file in that folder (we'll call it basic.js):

On Windows, touch will not work so you can simply go to the folder and create a plain text file and name is as 'basic.js'

Open that file, and write the following code in it:

Async Mode

Now save the file and return to your terminal. Learn more about the differences between Sync and Async Mode.

Start the Testrunner

Geckofx Api Documentation

Now, time to run your tests!

To do so, just run:

Hurray! The test should pass, and you can start writing integration tests with WebdriverIO.

If you ran into any issues, reach out in our Gitter Channel and post the error you're seeing, and which of the above steps you’re stuck on.

If you are interested in more in depth video on-boarding tutorials, feel free to check out our very own course called

Our community has also collected a lot of boilerplate projects that may help you to get started.