dolibarr/test

#Run End-to-End Tests

###Run Selenium

Selenium has been used for automating the browser.

We can run selenium by two ways:

• Usually, for running tests using selenium we download selenium standalone server JAR file and chrome driver and start selenium server with a command which usually looks like:

  java -jar selenium-server-standalone-<selenium version>.jar -port <port-no>

• Run selenium in docker with

  docker run -d -p 4444:4444 -p 5900:5900 -v /dev/shm:/dev/shm selenium/standalone-chrome-debug

                                   OR
  

  docker run -d --network="host" -v /dev/shm:/dev/shm selenium/standalone-chrome-debug

                                   OR
  

  docker run -d --network host -v /dev/shm:/dev/shm selenium/standalone-chrome-debug

###Run the acceptance tests

• In nightwatch.conf.js file inside the root directory of the project and inside the configuration file following environment variable has been specified. We can change the default values according to our local configuration.

   const admin_username = process.env.ADMIN_USERNAME || 'dolibarr';
  
   const admin_password = process.env.ADMIN_PASSWORD || 'password';
  
   const launch_url = process.env.LAUNCH_URL || 'http://localhost/dolibarr/htdocs/';
  

• You can run test using following commands

  yarn run test:e2e test/acceptance/features/<feature_file>

  For example: yarn run test:e2e test/acceptance/features/addUsers.feature

                                OR 
  

  LAUNCH_URL='<launch_url>' ADMIN_USERNAME='<admin_username>' ADMIN_PASSWORD='<admin_password>' yarn run test:e2e test/acceptance/features/

  The full script to run the acceptance tests is specified in scripts object of package.json file inside the project's root directory as :

  "test:e2e": "node_modules/cucumber/bin/cucumber-js --require test/acceptance/index.js --require test/acceptance/stepDefinitions -f node_modules/cucumber-pretty"

  After you run the above command you can see the test running. For that :

  • open Remmina (Remmina is a Remote Desktop Client and comes installed with Ubuntu)

  • choose VNC and enter localhost on the address bar

  • enter secret as the password