Skip to content

readme debugging section: link to devtools recipe #1117

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

Closed
mightyiam wants to merge 2 commits into from
Closed

readme debugging section: link to devtools recipe #1117

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8dc6cc0
Readme: explain how to debug
mightyiam Nov 18, 2016
09f5d3f
readme debugging section: link to devtools recipe
mightyiam Nov 18, 2016
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
26 changes: 18 additions & 8 deletions readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ Translations: [Español](https://github.com/avajs/ava-docs/blob/master/es_ES/rea

- [Usage](#usage)
- [CLI Usage](#cli)
- [Debugging](#debugging)
- [Reporters](#reporters)
- [Configuration](#configuration)
- [Documentation](#documentation)
Expand Down Expand Up @@ -169,6 +170,23 @@ Directories are recursed, with all `*.js` files being treated as test files. Dir

When using `npm test`, you can pass positional arguments directly `npm test test2.js`, but flags needs to be passed like `npm test -- --verbose`.

## Debugging

The AVA CLI runs tests in child processes.
Thus to debug one must bypass it:

``` console
$ node --inspect node_modules/ava/profile.js some/test/file.js
```

In the future this bypass may not be required;
See #874.

### Debugger-Specific Tips

* [Chrome DevTools](docs/recipes/debugging-with-chrome-devtools.md)
* [WebStorm](docs/recipes/debugging-with-webstorm.md)

## Reporters

### Mini-reporter
Expand Down Expand Up @@ -972,14 +990,6 @@ Running tests concurrently comes with some challenges, doing file IO is one.

Usually, serial tests create temp directories in the current test directory and clean them up at the end. This won't work when you run tests concurrently as tests will conflict with each other. The correct way to do it is to use a new temp directory for each test. The [`tempfile`](https://github.com/sindresorhus/tempfile) and [`temp-write`](https://github.com/sindresorhus/temp-write) modules can be helpful.

### Debugging

AVA runs tests concurrently by default, which is suboptimal when you need to debug something. Instead, run tests serially with the `--serial` option:

```console
$ ava --serial
```

### Code coverage

You can't use [`istanbul`](https://github.com/gotwarlost/istanbul) for code coverage as AVA [spawns the test files](#process-isolation). You can use [`nyc`](https://github.com/bcoe/nyc) instead, which is basically `istanbul` with support for subprocesses.
Expand Down