Learn how to include and use a package that you have installed using npm into your Node.js code.
When you install a package using npm, it gets saved into your node_modules folder. But how do you actually use it in your code?
Let’s say you have installed the popular JavaScript utility library lodash using the following command:
npm install lodash
This command will install the lodash package in your local node_modules folder.
To use the package in your code, simply import it using the require statement:
const _ = require('lodash');
But what if the package you have installed is an executable? In that case, the executable file will be located under the node_modules/.bin/ folder.
Let’s take the example of the cowsay package, which provides a command-line program that makes a cow say something (and other animals too 🦊).
When you install the cowsay package using npm install cowsay, it will not only install the package itself, but also a few dependencies in your node_modules folder.
Here’s a snapshot of the contents of the node_modules folder after installing cowsay:
As you can see, there is a hidden .bin folder that contains symbolic links to the cowsay binaries:
So, how do you execute these binaries?
You can certainly use the direct path ./node_modules/.bin/cowsay to run it, and it will work. However, a better option is to use npx, which is included in the recent versions of npm (since 5.2). Simply run the following command:
npx cowsay
npx will automatically find the location of the package and execute it.
And there you have it! Now you know how to include and use a package installed using npm in your Node.js code.