Skip to main content


Electron is a framework for building desktop applications using JavaScript, HTML, and CSS. By embedding Chromium and Node.js into its binary, Electron allows you to maintain one JavaScript codebase and create cross-platform apps that work on Windows, macOS, and Linux — no native development experience is required.

WebdriverIO provides an integrated service that simplifies the interaction with your Electron app and makes testing it very simple. The advantages of using WebdriverIO for testing Electron applications are:

  • 🚗 auto-setup of required Chromedriver
  • 📦 automatic path detection of your Electron application - supports Electron Forge and Electron Builder
  • 🧩 access Electron APIs within your tests
  • 🕵️ mocking of Electron APIs via a Vitest-like API

You just need a few simple steps to get started. Watch this simple step-by-step getting started video tutorial from the WebdriverIO YouTube channel:

Or follow the guide in the following section.

Getting Started

To initiate a new WebdriverIO project, run:

npm create wdio@latest ./

An installation wizard will guide you through the process. Ensure you select "Desktop Testing - of Electron Applications" when it asks you what type of testing you'd like to do. Afterwards provide the path to your compiled Electron application, e.g. ./dist, then just keep the defaults or modify based on your preference.

The configuration wizard will install all required packages and create a wdio.conf.js or wdio.conf.ts with the necessary configuration to test your application. If you agree to autogenerate some test files you can run your first test via npm run wdio.

That's it 🎉

Welcome! How can I help?

WebdriverIO AI Copilot