The Selenium IDE Runner (called SIDE Runner here for short) is a command line tool that allows you to run a project .side file, created using Selenium IDE, on a Node.js platform. You can read how to use the SIDE Runner in the Selenium IDE documentation. This article, supplements that documentation, by describing how to pass the various SIDE Eyes options to the SIDE runner.
The following sections explain how to use the SIDE Runner. The first section describes how to run a project file using the default options, and the sections that follow describe how to specify various SIDE Eyes options. The description is generic and is followed by an example using a bash command line syntax. Command line for other platforms should be very similar.
$ selenium-side-runner /mypath/myproject.side
If your project uses branches, then you should copy the branch name and parent branch name in the SIDE Eyes menu (e.g. "myBranch", and "myParent") and assign them to the environment variables APPLITOOLS_BRANCH and APPLITOOLS_PARENT_BRANCH respectively :
$ APPLITOOLS_PARENT_BRANCH="myParent" $ APPLITOOLS_BRANCH="myBranch" $ selenium-side-runner /mypath/myproject.side
If you always work with the same branch, then obviously you can set these environment variables permanently.
$ selenium-side-runner --config "/downloads/visual-grid-config.yml" /mypath/myproject.side
If you want to run the test without visual checkpoints, then call the SIDE Runner as follows. Visual checkpoints are enabled by default; the example below shows how to disable visual checkpoints.
$ selenium-side-runner --params="eyesDisabled=true" /mypath/myproject.side
By default, the SIDE Runner sends DOM information required for Root cause analysis. If you want to disable sending DOM information then call the SIDE Runner as follows:
$ selenium-side-runner --params="eyesDomUploadEnabled=false" /mypath/myproject.side
If you enable this flag, the SIDE Runner outputs log information. The information displayed may help troubleshoot some types of problems. This option is disabled by default.
$ selenium-side-runner --params="eyesLogsEnabled=true" /mypath/myproject.side
If you want to pass the SIDE Runner multiple, setup options, then pass both parameters in the same --params argument as follows:
$ selenium-side-runner --params="eyesDisabled=true eyesDomUploadEnabled=false" /mypath/myproject.side