Selenium-Side Runner is a command-line tool that allows you to run Selenium IDE test cases in different browsers and environments. Selenium IDE is a browser automation tool that records and plays back user interactions with a web application. Selenium-Side Runner extends its functionality by enabling you to execute these recorded test cases outside of the Selenium IDE interface.
Here's an example of how to use Selenium-Side Runner:
1. Install Selenium-Side Runner:
You can install Selenium-Side Runner globally using npm (Node Package Manager) if you haven't already:
```
npm install -g selenium-side-runner
```
2. Create a Selenium IDE Test Case:
Use Selenium IDE to record a test case and save it as a .side file. You can install Selenium IDE as a browser extension or use the standalone version.
3. Run Selenium-Side Runner:
Open your terminal and navigate to the directory where your .side test case file is located. Then, use the following command to run the test case:
```
selenium-side-runner your-test-case.side
```
Replace `your-test-case.side` with the name of your .side file.
4. Specify Browser and Configuration:
By default, Selenium-Side Runner uses the Firefox browser. If you want to use a different browser or specify other configurations, you can use command-line options. For example, to run the test case in Chrome:
```
selenium-side-runner --browser chrome your-test-case.side
```
You can explore other options, such as specifying the base URL, setting a custom timeout, and more in the official Selenium-Side Runner documentation.
5. View Test Results:
Selenium-Side Runner will execute your test case and display the results in the terminal. You'll see information about which tests passed or failed, along with any error messages.
Here's a simple example of a Selenium IDE test case (.side file) that opens a website and verifies the page title:
```json
{
"type": "test",
"name": "Open and Verify Page",
"commands": [
{
"command": "open",
"target": "https://example.com",
"value": ""
},
{
"command": "assertTitle",
"target": "Example Domain",
"value": ""
}
]
}
```
After creating this test case, you can run it using Selenium-Side Runner as described earlier.
Selenium-Side Runner is a powerful tool for automating web testing and can be integrated into your continuous integration (CI) pipelines to ensure that your web application functions correctly across different browsers and environments.