UNPKG

3.76 kBMarkdownView Raw
1# ts-node-dev
2
3> Tweaked version of [node-dev](https://github.com/fgnass/node-dev) that uses [ts-node](https://github.com/TypeStrong/ts-node) under the hood.
4
5It restarts target node process when any of required files changes (as standard `node-dev`) but shares [Typescript](https://github.com/Microsoft/TypeScript/) compilation process between restarts. This significantly increases speed of restarting comparing to `node-dev -r ts-node/register ...`, `nodemon -x ts-node ...` variations because there is no need to instantiate `ts-node` compilation each time.
6
7## Install
8
9![npm (scoped)](https://img.shields.io/npm/v/ts-node-dev.svg?maxAge=86400) [![Build Status](https://travis-ci.org/whitecolor/ts-node-dev.svg?branch=master)](https://travis-ci.org/whitecolor/ts-node-dev)
10
11
12```
13yarn add ts-node-dev --dev
14```
15
16```
17npm i ts-node-dev --save-dev
18```
19
20`ts-node` dependency version is not fixed, so it will install the latest version by default.
21
22## Usage
23
24```
25ts-node-dev [node-dev|ts-node flags] [ts-node-dev flags] [node cli flags] [--] [script] [script arguments]
26```
27
28So you just combine [node-dev](https://github.com/fgnass/node-dev) and [ts-node](https://github.com/TypeStrong/ts-node) options (see docs of those packages):
29
30```
31ts-node-dev --respawn --transpile-only server.ts
32```
33
34There is also short alias `tsnd` for running `ts-node-dev`:
35
36```
37tsnd --respawn server.ts
38```
39
40
41Look up flags and options can be used [in ts-node's docs](https://github.com/TypeStrong/ts-node#cli-and-programmatic-options).
42
43
44**Also there are additional options specific to `ts-node-dev`:**
45
46- `--ignore-watch` - (default: []) - files/folders to be [ignored by `node-dev`](https://github.com/fgnass/node-dev#ignore-paths). **But also this behaviour enhanced:** it will also make up `new RegExp` of passed ignore string and check absolute paths of required files for match.
47
48- use `--deps` to watch `node_modules`, by default watching it turned off.
49
50
51- `--debug` - Some additional debug output.
52- `--interval` - Polling interval (ms)
53- `--debounce` - Debounce file change events (ms, non-polling mode)
54- `--clear` (`--cls`) Will clear screen on restart
55- `--watch` - Explicitly add arbitrary files or folders to watch and restart on change (list separated by commas, [chokidar](https://github.com/paulmillr/chokidar) patterns)
56- `--exit-child` - Adds 'SIGTERM' exit handler in a child process.
57- `--rs` - Allow to restart with "rs" line entered in stdio, disabled by default.
58- `--no-notify` - Do not display desktop-notifications (Notifications are only displayed if `node-notifier` is installed).
59
60**Caveats and points of notice:**
61
62- Especially for large code bases always consider running with `--transpile-only` flag which is normal for dev workflow and will speed up things greatly. Note, that `ts-node-dev` will not put watch handlers on TS files that contain only types/interfaces (used only for type checking) - this is current limitation by design.
63
64- `--ignore-watch` will NOT affect files ignored by TS compilation. Use `--ignore` option (or `TS_NODE_IGNORE` env variable) to pass **RegExp strings** for filtering files that should not be compiled, by default `/node_modules/` are ignored.
65
66- Unknown flags (`node` cli flags are considered to be so) are treated like string value flags by default. The right solution to avoid ambiguity is to separate script name from option flags with `--`, for example:
67
68 ```
69 ts-node-dev --inspect -- my-script.ts
70 ```
71
72- The good thing is that `ts-node-dev` watches used `tsconfig.json` file, and will reinitialize compilation on its change, but you have to restart the process manually when you update used version of `typescript` or make any other changes that may effect compilation results.
73
74## License
75
76WTF.
77
\No newline at end of file