An integrated development environment for Selenium scripts Selenium IDE as an electron application written to enable recording and playback of selenium scripts.
Installation can be performed in a variety of ways:
- Prepackaged binaries will be able to be installed directly (ok not yet, but very soon)
- The application can be built manually using the below instructions.
No binaries are available currently, as we are in the process of obtaining signing certificates. Sorry, my bad.
To build manually, you must have the below prerequisites installed and follow the steps afterward.
git clone https://github.com/SeleniumHQ/selenium-ide
- Clone the IDE repocd selenium-ide
- Navigate into the IDE folderpnpm -r i
- Install dependenciespnpm run build
- Build the apppnpm run start
- Run the app
Here's a draft of the general tasks ahead. Feel free to pitch in and announce which you wish to take upon yourself:
- Selectors accuracy - an option is ranking selectors - we can optimize selectors correctness and test stability by collecting as many attributes as we can per user event. The most likely properties will be used for the selectors, with fallback to the others.
- Intelligent editing
- Export to selenium code in different languages
If you'd like to contribute to the codebase, start by building manually using the above commands. The below tips are meant to assist you as well.
- If you'd like to iterate more quickly,
yarn watch
will facilitate near-realtime rebuilding for rapid iteration (make change ->yarn start
-> test change) - To activate the devtools on an page,
CommandOrControl F12
orCommandOrControl Option I
will open the devtools. For your convenience, the React Developer Tools are pre-installed in the electron environment. - VSCode has a defined workspace structure and run command, as well as file mappings to allow for breakpoints to work across sourcemaps for the main process.
- The chrome dev tools are available at
localhost:8315
to use if the inline devtools are not enough, although I'd highly advocate for the in window dev tools, since they have the React Developer Tools installed as well.
If you have questions, check out our FAQ.
You can also find us on the #selenium IRC channel, which is also available on Slack.
The codebase is javascript, and relies heavily on the NodeJS, Electron, and React ecosystem. This is a collection of packages arranged in a monorepo config. Excepting the code-export packages, which are fully untyped, these packages are fully typed using Typescript.
These are the main packages. They're used to run the thing:
-
selenium-ide: Main Electron app. Built with webpack, react frontend. Communicates via the IPC protocols.
-
side-runner: NodeJS Task Runner. Built with typescript.
-
side-cli: Experimental cli using react and ink.
-
side-runtime: Playback system wrapper. Takes side files and executes them. Used by both selenium-ide and side-runner.
-
side-api: This is the api shape of selenium-ide. This is intended to be used to help share the api types with plugins in a lower footprint way.
-
side-model: This is used to provide metadata around the standard commands and argument types.
-
side-commons: This is like the typical utils/helpers folder, except meant to be shared across packages instead of just folders.
-
side-code-export: NodeJS transpiler for .side files. Used to export to other languages (csharp, java, javascript, python, ruby).
-
code-export-*: Code export format for various languages