mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-05 21:53:56 +00:00
61c0976cd2
* Add 'Debugging tests on macOS' notes * Add 'Debugging tests on macOS' notes (2) * Add 'Debugging tests on macOS' notes (3)
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# Contributing to Nuxt.js
|
|
|
|
1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device.
|
|
2. Run `npm install` to install the dependencies.
|
|
|
|
> _Note that both **npm** and **yarn** have been seen to miss installing dependencies. To remedy that, you can either delete the `node_modules` folder in your example app and install again or do a local install of the missing dependencies._
|
|
|
|
3. Add an example app to `examples/` before writing any code.
|
|
4. Create a fixture app under `test/fixtures/`. See others for examples.
|
|
|
|
To run an example or fixture app with your copy of Nuxt, do:
|
|
|
|
```sh
|
|
bin/nuxt examples/your-app
|
|
bin/nuxt test/fixtures/your-fixture-app
|
|
```
|
|
|
|
> `npm link` could also (and does, to some extent) work for this, but it has been known to exhibit some issues. That is why we recommend calling `bin/nuxt` directly to run examples.
|
|
|
|
Once you've modified Nuxt and seen your modifications reflected correctly in your example app and fixture, add `unit` and, if necessary, `e2e` tests that can ensure its functionality and future maintanability. Study other tests carefully for reference.
|
|
|
|
## Running specific tests
|
|
|
|
```sh
|
|
npm install jest -g
|
|
jest test/unit/test.js
|
|
```
|
|
|
|
## Running test suites
|
|
|
|
```sh
|
|
yarn test
|
|
```
|
|
|
|
Or, per group:
|
|
|
|
```sh
|
|
yarn test:fixtures
|
|
yarn test:unit
|
|
yarn test:e2e
|
|
```
|
|
|
|
## Debugging tests on macOS
|
|
|
|
Searching for `getPort()` will reveal it's used to start new Nuxt processes during tests. It's been seen to stop working on macOS at times and may require you to manually set a port for testing.
|
|
|
|
Another common issue is Nuxt processes that may hang in memory when running fixture tests. A ghost process will often prevent subsequent tests from working. Run `ps aux | grep -i node` to inspect any hanging test processes if you suspect this is happening.
|
|
|
|
## Opening PRs
|
|
|
|
- Please make sure your PR passes the lint test (`npm run lint`).
|
|
- Please wait for tests to run and verify potential failures.
|