Seleniet has grown from a small command line utility for local selenium based testing into a full blown web and shell test automation tool with integration to external test case management tools and detailed test result reporting. With this extension comes a plethora of command lin eswitches that can be used to tailor the execution.
You can either supply these parameters directly via command line or save thme in a *.selexprof file and run seleniet specifying the profile file to read the params from:
seleniet.bat run --profile XXXX.selexprof
The following parameters are available:
mandatory parameters are marked with one asterisk “*”, parameter sets where one of a group of is mandatory are marked with two asterisks “**”
Browser parameters
For web based tests one of the two following parameters need to be supplied:
–browser [firefox|chrome|ie|marionette|android] **
Starts the specified browser. marionette and android are experimental features and are not recommended for productive use
The firefox specific parameters –ffprofile or –ffprofdir allow to specify which firefox profile should be used by the to be started firefox browser.
–grid gridfile gridhub **
Starts an browser instance specified via grid properties on the gridhub server
example gridfile:
browserName=firefox
example gridhub: http://gridserver:4444
–xywh XPOSxYPOSxWIDTHxHEIGHT
Specifies the position and size of the browser window (in pixels)
–screenon / screenoff
Flag whether to save a screenshot after each step or not, default is –screenoff
–timeoutgui timeoutsec
Number of seconds to wait for web / DOM elements to appear before throwing a timeout error, defaults to 20 seconds
–url http(s)://starturl.test *
URL of the application under test / URL opened at the start of the test run
External system / test case parameters
–zephyr projectname cyclename **
Reads test case definitions from external Jira/Zephyr system for given cycle of given project
–folder filefolder **
Reads test case definitions from the local file system starting from the given folder
–trac catalog testplan **
Reads test case definitions from external TRAC system (TestMgr plugin) for given catalog and test plan
–xls excelfile ** DEPRECATED
Reads test case definitions from an Ecel sheet (XLS 2007), DEPRECATED
–testlink xmlexportfile cfgfile ** DEPRECATED
Reads test case definitions from an TestLink server, DEPRECATED
–objrepo urlfilerepo
Specifies where to read the obj repo from. Can be XLS or CSV file /url. Defaults to “ObjRepository.xls”
–update
Flag whether the test results shall be updated to the external system (if applicable) or not
–startTC testcasekey
Name/key of the test case to perform. If supplied only THIS test case (and all of its sub tests) will be performed.
Miscellaneous parameters
–testdir folder
Name of the folder to store test results and artefacts to. Defaults to “tests”
–gui
Flag whether to start interactive gui mode. Failures will be reported by a popup and need to be clicked to continue test execution. This allows to analyse test failures in more detail.
–batch
Flag whether to start non interactive console batch mode.
Flag whether to create a local test report based on JUnit report template in local test dir folder
–timeout
Number of seconds the test run must not exceed. After this timeout the test execution will be aborted as soon as possible.
–pauseonerror
Deprecated flag whether to pause on test failures. Now subsumed in the –gui flag
Screenrecording parameters (experimental)
–screenrec
Flag whether to record browser window or not
–recrate picspersec
Number of frames per second (minimo 3, up to 20 depending on your hardware)
–recarea XPOSxYPOSxWIDTHxHEIGHT
Area to record
–recfile videofilename
Name of the file to store the screen recording to
Selexprof Files
To store command line parameters into a selexprof file each of the parameters and each of its arguments need to be written to a new line.
E.g.:
--testdir folder
shall be written to the file as
--testdir folder