Blog.

npm tips and tricks

MF

Marco Franssen /

9 min read1680 words

Cover Image for npm tips and tricks

In my previous post I showed you how easily you can create a simple webserver using Node.js. In this post I want to show you how to make more advanced usage of node package manager.

npm init

Using node package manager you can get an even quicker start of your project by using the npm init command. So let's get started by opening a command prompt (on windows open the Node.js command prompt). Then create a new folder and navigate into this newly created folder. In the folder execute following command and answer the questions or press enter for the defaults.

Your environment has been set up for using Node.js 0.10.17 (x64) and npm.
Press any key to continue . . .

C:\Users\Marco> mkdir NodeJsPackageExample
C:\Users\Marco> cd NodeJsPackageExample
C:\Users\Marco\NodeJsPackageExample> npm init
This utility will walk you through creating a package.json file.
It only covers the most common items, and tries to guess sane defaults.

See `npm help json` for definitive documentation on these fields
and exactly what they do.

Use `npm install  --save` afterwards to install a package and
save it as a dependency in the package.json file.

Press ^C at any time to quit.
name: (NodeJsPackageExample) node-js-package-example
version: (0.0.0) 0.0.1
description: Total package awesomeness
entry point: (index.js)
test command:
git repository:
keywords: package,  awesomeness
author: Marco Franssen
license: (BSD-2-Clause) MIT
About to write to C:\Users\Marco\NodeJsPackageExample\package.json:

{
  "name": "node-js-package-example",
  "version": "0.0.1",
  "description": "Total package awesomeness",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "package",
    "awesomeness"
  ],
  "author": "Marco Franssen",
  "license": "MIT"
}

Is this ok? (yes) yes

After answering the questions the result should be something like above. As you can see I have changed the default name. By default node package manager uses the folder name. Play around yourself to get the desired result. You can also change the package.json after it is created.

Why do we need this package.json file?

The answer is simple… When we put our code in source control (GIT, SVN, TFS) we don't want to commit all our third party packages. We want to leave them out of the source control. Another reason is we also don't want to ship all dependencies as part of our own package when we release our package to the npm registry. All team members or users of your package who checkout your code or download your package are simply missing all the dependency packages and this is where the packages.json comes in. After downloading the package, they simply execute npm install. This will download all dependencies etc. based on your package.json file.

npm install

So let's continue with some more npm tips and tricks. The second thing you may already have seen by executing npm init is the npm install --save command. npm install --save will install your package and saves it in the package.json file. Skipping the --save option will simply not add the package to your package.json file. Let's start by adding the express package, which we also used in previous post.

C:\Users\Marco\NodeJsPackageExample> npm install --save express
npm WARN package.json [email protected] No repository field.
npm WARN package.json [email protected] No README data
npm http GET https://registry.npmjs.org/express
...
...
left for brevity
...
...
[email protected] node_modules\express
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected])
└── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected]
.1, [email protected], [email protected])

As you can see the package express is installed including all dependencies. In our package.json we can see the dependency added.

{
  "name": "node-js-package-example",
  "version": "0.0.1",
  "description": "Total package awesomeness",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["package", "awesomeness"],
  "author": "Marco Franssen",
  "license": "MIT",
  "dependencies": {
    "express": "~3.4.6"
  }
}

Now you know how to install a package and save it to the package.json. To uninstall a package and remove it from your package file just execute the npm uninstall --save command.

repository and readme.md

When you just like me skipped the repository during npm init, you just have seen two warnings. Let's solve both by adding a repository in the package.json file and a Readme.md file in the root of our package.

"repository": {
    "type": "git",
    "url": "https://github.com/marcofranssen/NodeJsPackageExample.git"
}

Do not forget to add some contents in your Readme.md file, otherwise npm won't be satisfied. A title and a short description should be ok.

npm install dev package

When deploying a package on a server you don't want your development packages published on the server. An example of such a development package is grunt. So we want to save such package in a different way so our colleague developers can install the development packages, but our production server can skip them.

`C:\Users\Marco\NodeJsPackageExample> npm install --save-dev grunt
    npm http GET https://registry.npmjs.org/grunt
    ...
    ...
    left for brevity
    ...
    ...
    [email protected] node_modules\grunt
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected]
    ├── [email protected] ([email protected])
    ├── [email protected] ([email protected])
    ├── [email protected] ([email protected])
    ├── [email protected] ([email protected], [email protected])
    ├── [email protected] ([email protected], [email protected])
    └── [email protected] ([email protected], [email protected])`

As you can see all dependencies of grunt are automatically installed and a new property is added to your packages.json file.

"devDependencies": {
    "grunt": "~0.4.2"
}

With grunt installed you can speed up your development even more by automating a lot of tasks. These are tasks like running tests, minifying, compiling Less/Sass etc. I would like to challenge you and share your grunt scripts with me and the rest of the developer community by posting a reaction on this post. For more help on _grunt _ visit http://gruntjs.com/.

private package

If your package is not intended to be shared or reused on the _npm registry _make sure to protect yourself by adding the following setting in your package.json.

"private": true

This will prevent you from accidentally publish your package to the npm registry.

npm update

While working on your awesome package you probably want to update your dependencies before you publish your package so you are running the latest code of all packages.

To check if there are any package updates available you can run the following command.

C:\Users\Marco\NodeJsPackageExample> npm outdated
npm http GET https://registry.npmjs.org/express
npm http 200 https://registry.npmjs.org/express
npm http GET https://registry.npmjs.org/express/-/express-3.4.7.tgz
npm http 200 https://registry.npmjs.org/express/-/express-3.4.7.tgz
[email protected] node_modules\express current=3.4.6`

As you can see there is a new release of the express package. Since it is a patch release (increment of 3th number) I decide to update this package.

C:\Users\Marco\NodeJsPackageExample> npm update --save express
npm http GET https://registry.npmjs.org/express
npm http 304 https://registry.npmjs.org/express
npm http GET https://registry.npmjs.org/express/3.4.7
...
...
left for brevity
...
...
[email protected] node_modules\express
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected])
└── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected],
 [email protected], [email protected], [email protected])

Node package manager uses semantic versioning and it is up to the package creator/publisher to follow these guidelines. So always double check what has changed and see if your package still works after upgrading the dependencies. Usually you should be safe when installing patch releases. Be more carefull when you upgrade minor or major releases. More information about versioning can be found here. Make sure your package satisfies these guidelines when publishing new and updated packages since this will help other developers during the update process.

npm publish

Creating a package is one thing, but the second thing is you probably want to share it with the community. Sharing a package with the community is pretty straight forward.

First of all we need to set our npm author info if you haven't already done so. This can be done by executing following commands.

C:\Users\Marco\NodeJsPackageExample> npm set init.author.name "Marco Franssen"
C:\Users\Marco\NodeJsPackageExample> npm set init.author.email "[email protected]"
C:\Users\Marco\NodeJsPackageExample> npm set init.author.url "http://marcofranssen.nl"
C:\Users\Marco\NodeJsPackageExample> npm adduser

Username: marcofranssen
marcofranssen
Password:
Password:
Email: [email protected]
npm http PUT https://registry.npmjs.org/-/user/org.couchdb.user:marcofranssen
npm http 409 https://registry.npmjs.org/-/user/org.couchdb.user:marcofranssen
...
...
npm http PUT https://registry.npmjs.org/-/user/org.couchdb.user:marcofranssen/-r
ev/4-84c649f53b8faf80bc10b02a190bcb64
npm http 201 https://registry.npmjs.org/-/user/org.couchdb.user:marcofranssen/-r
ev/4-84c649f53b8faf80bc10b02a190bcb64

Now your user account is created and you're able to publish packages to the npm registry.

The last thing waiting for us is to publish the actual package. Which can be done using following command.

C:\Users\Marco\NodeJsPackageExample> npm publish ./

Since I have put the private flag on true in my package.json.

"private": true

I got following error:

npm ERR! Error: This package has been marked as private
npm ERR! Remove the 'private' field from the package.json to publish it.

So when I remove this from my package.json and execute the npm publish command again it should succeed and your package will be listed in the npm registry.

C:\Users\Marco\NodeJsPackageExample> npm publish ./
npm http PUT https://registry.npmjs.org/node-js-package-example
npm http 201 https://registry.npmjs.org/node-js-package-example
...
...
...
npm http 201 https://registry.npmjs.org/node-js-package-example/0.0.1/-tag/latest
+ [email protected]

unpublish

Since the package I just published won't be of any value I removed it using following command.

C:\Users\Marco\NodeJsPackageExample> npm unpublish ./ --force
npm WARN using --force I sure hope you know what you are doing.
...
...
npm http DELETE https://registry.npmjs.org/node-js-package-example/-rev/3-366120337d
9f89cd2ca7fc0c4489281d
...
...

I hope this article showed you some of the nice stuff you can do to quickly build your first node package and get it published in the npm registry. Using npm you should get better control over your dependencies and it should become easier for you and your team to keep track on those dependencies.

Also have a look at https://npmjs.org/doc/developers.html to learn even more about the Node Package Manager.

Thanks for reading.

You have disabled cookies. To leave me a comment please allow cookies at functionality level.

More Stories

Cover Image for Using Mocha Chai Sinon to test Node.js

Using Mocha Chai Sinon to test Node.js

MF

Marco Franssen /

In this article I'm going to show you how to write tests for your NodeJS application using Mocha, Chai and Sinon. Mocha is a feature-rich JavaScript test framework running on node.js and the browser, making asynchronous testing simple and fun. Mocha tests run serially, allowing for flexible and accurate reporting, while mapping uncaught exceptions to the correct test cases. One of the cool things is you can choose your own assertion style when writing Mocha tests. In this article I will use Ch…

Cover Image for Automate your development tasks using Grunt

Automate your development tasks using Grunt

MF

Marco Franssen /

Grunt is an extremely useful Node.js package to automate lots of development and continuous integration tasks. The Grunt eco-system has lots of packages available on npm. This enables us to quickly setup our development/continuous integration environment. Grunt tasks mostly have two required properties. An files array, which is used to configure on what files the tasks is executed, and an options property which configures some task specific settings. The files array supports the globbing and mi…

Cover Image for Starting with a Node.js webserver

Starting with a Node.js webserver

MF

Marco Franssen /

UPDATE: updated the console output to latest Node.js version and updated the express.js example to latest version. Before starting to explain how you start your first Node.js project for building a simple web server I will first explain you what Node.js is. To do so I just include a quote of the Node.js themself, because I don't like to reinvent the wheel. Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications. Node.js uses an event-d…

Cover Image for CI with Jenkins, MSBuild, Nuget and Git part 4

CI with Jenkins, MSBuild, Nuget and Git part 4

MF

Marco Franssen /

In part 1, 2 and 3 I showed you how to create a simple MSBuild script and how to execute it from the command line. We had a look at how to clean your output directories, download the Nuget packages, compile your code, run MSpec tests and creating a code coverage report. In this last part of this series I will show you how to integrate it with Jenkins. First of all we want Jenkins to pull the latest code from Github as soon as somebody has pushed new code to Github. To do this we need to install…