***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 `tns run [android|ios]`. This command will use already installed app on the device.
        For example: Open terminal1 and run: `tns 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`