It turns out that runningĀ
ts-node-devĀ /Ā ts-node
Ā is constantly consuming hundreds of megabytes of RAM even for small and simple applications.In development, it is usually not a big concern, however, it can be, if your application is running inside a docker container with limited resources (for example, with Docker Desktop on Mac which allocates by default only 2GB of RAM to all the containers in total).
Typescript code should be transpiled to Javascript which can be done either before running the process (
tsc
), or in runtime (ts-node
).The most efficient way is transpiling before running, however, this isnāt as developer-friendly since it takes forever.Ā
ts-node-dev
Ā loads everything into memory then watches the changes the developer is making and transpiles the project fast on every change.We encountered the issue while building a demo application to showcase our product atĀ Aspecto.
We were running multiple typescript services with docker-compose and started seeing arbitraryĀ
ts-node-dev
Ā processes exiting without even running the application, displaying the message āDone in 79.06sā.This was due to a lack of memory. Each typescript service was using ~600MB of RAM out of the total 2GB available for all containers.
After digging a bit, we found a few possible solutions and wanted to share them.
Run ts-node-dev
with optionĀ --transpile-only
ts-node-dev
--transpile-only
In our case, adding theĀ
--transpile-only
Ā option toĀ ts-node-dev
Ā reduced the consumed RAM from ~600MB to ~170MB.The price was that the typescript code would only be transpiled, and typechecking would be skipped. Most modern IDEs (vscode, web storm), has built-in typescript IntelliSense which highlights errors, so for us, it was a fair price to pay.
If you useĀ
ts-node
Ā to run code in production that was already successfully compiled and tested in the CI, you can only benefit from setting this option.Compile the code with tsc
and monitor file changes with nodemon
tsc
nodemon
Instead of usingĀ
ts-node-dev
, which consumes a lot of memory, it is possible to compile the application directly withĀ tsc
Ā and then run it from dist/build like this:Ā node dist / index.jsĀ
.For automatic reload on source file changes,Ā
nodemonĀ /Ā node-dev
Ā can be used.This is our āstartā script in package.json:
"scripts": {
"start": "nodemon --watch src -e ts --exec \"(tsc && node dist/index.js) || exit 1\""
}
This approach reduced the RAM on our service from ~600MB to ~95MB (but there was still a spike in RAM to 600Mb for few seconds whileĀ
tsc
Ā was compiling).Unlink the previous option, this approach does check for typescript errors and warnings, and the service does not start if errors exist in the code.
The price to pay here is a longer compilation time. In our setup, itās about 10 seconds from saving the file until the service restarts.
Increase Docker desktop available RAM
This is the easiest fix. Just allocate more Memory to Docker Desktop by going to Preferences => Resources => Memory, and increase the value.
While it fixes the immediate problem, the containers still consume a lot of memory, and if you have plenty of them, it might be a problem soon enough.
In addition, changing the default configuration should be done by every user that wants to run the system with docker-compose, which introduces complexity in installation and usage.
Conclusion
If memory consumption is not an issue for you, just useĀ
ts-node
Ā in production andĀ ts-node-dev
Ā in development.However, if you do care about memory, then you have a tradeoff between fast restart time after modifications (but typechecking only in the IDE, setĀ
--transpileOnly
, or typechecking in compilation) and slower restart on each modification (directly useĀ tscĀ andĀ nodemon
Ā /Ā node-dev
Ā ).Also published on Medium