e2e tests execution

1. Local setup

   • install appium and all requirements related to nativescript-dev-appium plugin usage

   • download images:

     npm run load-images Emulator-Api23-Default "iPhone X 12"

     or load multiple folders:

     npm run load-images Emulator-Api23-Default Emulator-Google-Api28 "iPhone X 12"

     or load all folders:

     npm run load-images all

     This command will download https://github.com/NativeScript/functional-tests-images/tree/master/uitestsapp and sparse all passed directories [emulator-name|simulator-name]

   • rename/ create your device so that it matches folder name, respectively api level and density of emulators.

     You can also use scripts:

     npm run update-emulators to update your emulator density.

     If you need to download system image and create emulator use:

     npm run update-emulators -- --update-system-images

2. Test execution

   • Run test compilation in separate terminal and don't kill it.

     npm run test-watch

   • It is highly recommended during the development to use

     npm run test [android|ios] along with ns run [android|ios]. This command will use already installed app on the device. For example: Open terminal1 and run: ns run android and open new terminal2 and run: npm run test android

3. Debug test.

   • Run:

     npm run e2e-debug [android|ios] run in separate console and don't kill it. This command will start appium server and driver and use the installed app on the device, but it will not execute tests.

   • Go to vs code debugging and use a config like:

       {
           "type": "node",
           "request": "launch",
           "name": "Debug Tests",
           "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
           "args": [
               "-u",
               "tdd",
               "--colors",
               "--opts",
               "../config/mocha.opts",
               "--attachToDebug",
               "--grpe",
               "button"
           ],
           "internalConsoleOptions": "openOnSessionStart"
       }
   
   

mocha options

mocha opt file is located at "../config/mocha.opts".

   --timeout 999999
   --recursive e2e
   --reporter mochawesome
   --reporter-options quiet=true,html=true,inline=true,autoOpen=true
   --exit

grep particular suit or test

npm run e2e ios -- --grep=tabs-tab(s-\\w+)-suite