Skip to content

docs(testing): describe ns test watch-mode defaults #205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
NathanWalker wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(testing): describe ns test watch-mode defaults #205

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions content/guide/testing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -291,6 +291,8 @@ To execute your test suite in CI make sure to add `--justlaunch`. This parameter
ns test ios --emulator --justlaunch
```

Recent versions of the NativeScript CLI also turn watch mode off automatically when the `CI` or `JENKINS_HOME` environment variable is set, so `ns test` exits once the tests finish.

Each execution of `ns test` consists of the following steps, performed automatically.

1. The CLI starts a Karma server on the development machine.
Expand All @@ -306,15 +308,17 @@ Each execution of `ns test` consists of the following steps, performed automatic

The NativeScript can continuously monitor your code for changes and when such changes occur, it can deploy those changes to your testing devices and re-run your tests.

To enable this behavior, run your `ns test` command with the `--watch` flag. For example:
This behavior is on by default: the NativeScript CLI remains active and re-runs tests on code change. To unlock the console, press `Ctrl+C` to stop the process.

To run the tests once and exit instead, pass `--no-watch`:

```bash
ns test android --watch
ns test ios --watch
ns test ios --emulator --watch
ns test android --no-watch
ns test ios --no-watch
ns test ios --emulator --no-watch
```

The NativeScript CLI remains active and re-runs tests on code change. To unlock the console, press `Ctrl+C` to stop the process.
In CI environments (when the `CI` or `JENKINS_HOME` environment variable is set), watch mode is off by default. Pass `--watch` to turn it back on.

#### Configure the Karma Server

Expand Down
Loading