The npx Node Package Runner
npx is a very cool way to run Node code, and provides many useful features
In this post, I want to introduce a very powerful command that’s been available in npm starting version 5.2, released in July 2017: npx.
If you don’t want to install npm, you can install npx as a standalone package
npx lets you run code built with Node and published through the npm registry.
Easily run local commands
Node developers used to publish most of the executable commands as global packages, in order for them to be in the path and executable immediately.
This was a pain because you could not really install different versions of the same command.
npx commandname automatically finds the correct reference of the command inside the
node_modules folder of a project, without needing to know the exact path, and without requiring the package to be installed globally and in the user’s path.
Installation-less command execution
There is another great feature of
npm, which is allowing to run commands without first installing them.
This is pretty useful, mostly because:
- you don’t need to install anything
- you can run different versions of the same command, using the syntax @version
A typical demonstration of using
npx is through the
cowsay will print a cow saying what you wrote in the command. For example:
cowsay "Hello" will print
_______ < Hello > ------- \ ^__^ \ (oo)\_______ (__)\ )\/\ ||----w | || ||
Now, this if you have the
cowsay command globally installed from npm previously, otherwise you’ll get an error when you try to run the command.
npx allows you to run that npm command without having it installed locally:
npx cowsay "Hello"
will do the job.
Now, this is a funny useless command. Other scenarios include:
- running the
vueCLI tool to create new applications and run them:
npx vue create my-vue-app
- creating a new React app using
npx create-react-app my-react-app
and many more.
Once downloaded, the downloaded code will be wiped.
Run some code using a different Node version
@ to specify the version, and combine that with the
node npm package:
npx node@6 -v #v6.14.3 npx node@8 -v #v8.11.3
This helps to avoid tools like
nvm or the other Node version management tools.
Run arbitrary code snippets directly from a URL
npx does not limit you to the packages published on the npm registry.
You can run code that sits in a GitHub gist, for example:
Of course, you need to be careful when running code that you do not control, as with great power comes great responsibility.
THE VALLEY OF CODE
THE WEB DEVELOPER's MANUAL
You might be interested in those things I do:
- Learn to code in THE VALLEY OF CODE, your your web development manual
- Find a ton of Web Development projects to learn modern tech stacks in practice in THE VALLEY OF CODE PRO
- I wrote 16 books for beginner software developers, DOWNLOAD THEM NOW
- Every year I organize a hands-on cohort course coding BOOTCAMP to teach you how to build a complex, modern Web Application in practice (next edition February-March-April-May 2024)
- Learn how to start a solopreneur business on the Internet with SOLO LAB (next edition in 2024)
- Find me on X