Browse files

deps: upgrade npm to 4.5.0

PR-URL: #12480
Reviewed-By: Jeremiah Senkpiel <>
  • Loading branch information...
iarna authored and Fishrock123 committed Apr 13, 2017
1 parent 061c5da commit 00842604483e4c2e622dfdb3a97440e07646158f
Showing 1,229 changed files with 67,108 additions and 31,294 deletions.
@@ -40,10 +40,10 @@
before submitting your issue.
- Please check if there's a solution in the troubleshooting wiki:
- Also ensure that your new issue conforms to npm's contribution guidelines:
- Participation in this open source project is subject to the npm Code of Conduct:
@@ -53,6 +53,7 @@ Ryan Emery <>
Sam Mikes <>
Stephanie Snopek <>
Takaya Kobayashi <>
Ted Yavuzkurt <> <>
Thomas Reggi <>
Timo Weiß <timoweiss@Timo-MBP.local>
Tony <>
@@ -28,6 +28,8 @@ notifications:
- $HOME/.npm
- html/doc
- man
- node_modules/.bin
- node_modules/.cache
- node_modules/deep-equal
@@ -450,3 +450,12 @@ Daijirō Wachi <>
Dmitry Litvinchenko <>
chocolateboy <>
Henry Zhu <>
Nate Goldman <>
Ted Yavuzkurt <>
Arseniy Maximov <>
Joshua Bennett <>
Evgeny Kulikov <>
Сковорода Никита Андреевич <>
Carol (Nichols || Goulding) <>
Jarid Margolin <>
David Cook <>

Large diffs are not rendered by default.

Oops, something went wrong.
@@ -1,12 +1,82 @@
## Before you submit a new issue
* Check if there's a simple solution in the
* [Search for similar
* Ensure your new issue conforms to the [Contributing
Participation in this open source project is subject to the [npm Code
of Conduct](
# npm CLI Contributor Roles and Responsibilities
## Table of Contents
* [Introduction](#introduction)
* [Roles](#roles)
* [Community Members](#community-members)
* [Collaborators](#collaborators)
* [npm, Inc Employeees](#npm-inc-employees)
## Introduction
Welcome to the npm CLI Contributor Guide! This document outlines the npm CLI repository's process for community interaction and contribution. This includes the issue tracker, pull requests, wiki pages, and, to a certain extent, outside communication in the context of the npm CLI. It defines roles, responsibilities, and procedures, and is an entry point for anyone wishing to contribute their time and effort to making npm a better tool for the JavaScript community!
All interactions in the npm repository are covered by the [npm Code of Conduct](
## Roles
There are three main roles for people participating in the npm issue tracker. Each has a specific set of abilities and responsibilities: [Community members](#community-members), [Collaborators](#collaborators), and [npm, Inc employees](#npm-inc-employees).
Failure to comply with the expected responsibilities of each role, or violating the Code of Conduct will result in punitive action relative to the transgression, ranging from a warning to full removal from the project, at the discretion of npm employees.
### Community Members
This includes anyone who may show up to the npm/npm repo with issues, PRs, comments etc. They may not have any other involvement with npm.
#### Abilities
* Open issues and PRs
* Comment on issues and PRs
#### Responsibilities
* Comment on issues when they have a reference to the answer.
* If community members aren't sure they are correct and don't have a reference to the answer, please leave the issue and try another one.
* Defer to collaborators and npm employees for answers.
* Make sure to search for [the troubleshooting doc](./ and search on the issue tracker for similar issues before opening a new one.
* Any users with urgent support needs are welcome to email, and our dedicated support team will be happy to help.
PLEASE don't @ collaborators or npm employees on issues. The CLI team is small, and has many outstanding commitments to fulfill.
### Collaborators
These are folks who have the ability to label and close issues. The role of collaborators may expand over time, but for now it is a limited (& important) role. This is an excellent way to contribute to npm without writing code.
Community members may become collaborators by showing consistent, proven track record of quality contributions to the project, a reasonable level of proficiency with the CLI, and regular participation through the tracker and other related mediums, including regular contact with the CLI team itself. This role entails a higher level of responsibility than community member, so we ask for a higher level of understanding and commitment.
Collaborators who become inactive for 3 months or longer may have their collaborator privileges removed until they are ready to return.
#### Abilities
* Label/triage new issues
* Respond to ongoing issues
* Close resolved issues.
#### Responsibilities
* Only answer questions when they know the answer, and provide a reference to the answer.
* If collaborators aren't totally confident about their answer, please leave the issue and try another one.
* If they've responded to an issue, it becomes their responsibility to see it to resolution.
* Close issues if there's no response within a month.
* Defer to fellow Collaborators & npm employees for answers (Again, please don't @ collaborators or npm employees, thank you!)
* Make sure to search for [the troubleshooting doc](./ and search on the issue tracker for similar issues before opening a new one.
### npm, Inc Employees
Folks who work at npm, Inc, who have a responsibility to ensure the stability and functionality of the tools npm offers.
#### Abilities
* Label/triage new issues
* Respond to ongoing issues
* Close resolved issues
* Land PRs
Please note that this is a living document, and the CLI team will put up PRs to it as needed.
#### Responsibilities
* Preserve and promote the health of the CLI, the registry, the website, etc.
In special cases, [Collaborators](#collaborators) may request time to speak with an npm employee directly, by contacting them and coordinating a time/place.
@@ -1,6 +1,8 @@
npm(1) -- a JavaScript package manager
[![Build Status](](
This is just enough info to get you up and running.
@@ -86,7 +88,7 @@ experience if you run a recent version of npm. To upgrade, either use [Microsoft
upgrade tool](,
[download a new version of Node](,
or follow the Windows upgrade instructions in the
[npm Troubleshooting Guide](
[npm Troubleshooting Guide](./
If that's not fancy enough for you, then you can fetch the code with
git, and mess with it directly.
@@ -0,0 +1,192 @@
# Troubleshooting Common Issues
## Using this Document
Search for the error message you're getting and see if there's a match, or skim the [table of contents](#table-of-contents) below for topics that seem relevant to the issue you're having. Each issue section has steps to work around or fix the particular issue, and have examples of common error messages.
If you do not find the issue below, try searching the issue tracker itself for potential duplicates before opening a new issue.
If you're reading this document because you noticed an issue with npm's web site, please let the [web team]( know.
### Updating this Document
If you think something should be added here, make a PR that includes the following:
0. a summary
0. one or more example errors
0. steps to debug and fix
0. links to at least one related issue from the tracker
For more details of the content and formatting of these entries, refer to examples below.
## Table of Contents
* [Upgrading npm](#upgrading-npm)
* [Proxies and Networking](#proxy-and-networking-issues)
* [Cannot find module](#cannot-find-module)
* [Shasum Check Fails](#shasum-check-fails)
* [No Git](#no-git)
## Upgrading npm
Whenever you get npm errors, it's a good idea to first check your npm version and upgrade to latest whenever possible. We still see people running npm@1 (!) and in those cases, installing the latest version of npm usually solves the problem.
You can check your npm version by running `npm -v`.
### Steps to Fix
* Upgrading on \*nix (OSX, Linux, etc.)
(You may need to prefix these commands with sudo, especially on Linux, or OS X if you installed Node using its default installer.)
You can upgrade to the latest version of npm using:
`npm install -g npm@latest`
Or upgrade to the most recent LTS release:
`npm install -g npm@lts`
* Upgrading on Windows
We have a [detailed guide]( for upgrading on windows on our wiki.
## Proxy and Networking Issues
npm might not be able to connect to the registry for various reasons. Perhaps your machine is behind a firewall that needs to be opened, or you require a corporate proxy to access the npm registry. This issue can manifest in a wide number of different ways. Usually, strange network errors are an instance of this specific problem.
Sometimes, users may have install failures due to Git/Github access issues. Git/GitHub access is separate from npm registry access. For users in some locations (India in particular), problems installing packages may be due to connectivity problems reaching GitHub and not the npm registry.
If you believe your network is configured and working correctly, and you're still having problems installing, please let the [registry team]( know you're having trouble.
### Steps to Fix
0. Make sure you have a working internet connection. Can you reach Can you reach other sites? If other sites are unreachable, this is not a problem with npm.
0. Check for any potential current service outages.
0. If your company has a process for domain whitelisting for developers, make sure is a whitelisted domain.
0. If you're in China, consider using as a registry, which sits behind the Firewall.
0. On Windows, npm does not access proxies configured at the system level, so you need to configure them manually in order for npm to access them. Make sure [you have added the appropriate proxy configuration to `.npmrc`](
0. If you already have a proxy configured, it might be configured incorrectly or use the wrong credentials. Verify your credentials, test the specific credentials with a separate application.
0. The proxy itself, on the server, might also have a configuration error. In this case, you'll need to work with your system administrator to verify that the proxy, and HTTPS, are configured correctly. You may test it by running regular HTTPS requests.
### Example Errors
This error can manifest in a wide range of different ways:
npm ERR! unable to verify the first certificate
npm ERR! unable to get local issuer certificate
npm ERR! self signed certificate
124 error code ECONNREFUSED
125 error errno ECONNREFUSED
126 error syscall connect
136 error Unexpected token <
136 error <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "">
136 error <HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
136 error <TITLE>ERROR: Cache Access Denied</TITLE>
31 verbose stack Error: connect ETIMEDOUT
108 error code EAI_AGAIN
109 error errno EAI_AGAIN
110 error syscall getaddrinfo
111 error getaddrinfo EAI_AGAIN
npm ERR! Error: getaddrinfo ESRCH
npm ERR! at errnoException (dns.js:37:11)
npm ERR! at Object.onanswer as oncomplete
35 error Unexpected token u
35 error function FindProxyForURL(url, host) {
### Related issues
* [#14318](
* [#15059](
* [#14336](
## Cannot find module
If *when running npm* (not your application), you get an error about a module not being found, this almost certainly means that there's something wrong with your npm installation.
If this happens when trying to start your application, you might not have installed your package's dependencies yet.
### Steps to Fix
0. If this happens when you try to start your application, try running `npm install` to install the app's dependencies. Make sure all its actual dependencies are listed in `package.json`
0. If this happens on any npm command, please reinstall.
### Examples
throw err;
Error: Cannot find module
### Related Issues
* [#14699](
## Shasum Check Fails
This is a common issue which used to be caused by caching issues. Nowadays, the cache has been improved, so it's likely to be an install issue, which can be caused by network problems (sometimes even [proxy issues](#proxy-and-networking-issues)), a node bug, or possibly some sort of npm bug.
### Steps to Fix
0. Try running `npm install` again. It may have been a momentary hiccup or corruption during package download.
0. Check for any potential current service outages.
0. If the shasum error specifically has `Actual: da39a3ee5e6b4b0d3255bfef95601890afd80709`, with this exact shasum, it means the package download was empty, which is certainly a networking issue.
0. Make sure your [network connection and proxy settings](#proxy-and-networking-issues) are ok.
0. Update your node version to the latest stable version.
### Examples
npm ERR! shasum check failed for C:\Users\some-user\AppData\Local\Temp\npm-9356-7
npm ERR! Expected: 652294c14651db29fa93bd2d5ff2983a4f08c636
npm ERR! Actual: c45474b40e6a7474633ec6f2b0315feaf15c61f2
npm ERR! From:
### Related Issues
* [#14720](
* [#13405](
## No Git
If your install fails and you see a message saying you don't have git installed, it should be resolved by installing git.
### Steps to Fix
0. [Install git]( following the instructions for your machine.
### Examples
npm ERR! not found: git
### Related Issues
* [#11095](
@@ -25,10 +25,17 @@
if (!unsupported.checkVersion(process.version).unsupported) {
var updater = require('update-notifier')
var pkg = require('../package.json')
updater({pkg: pkg}).notify({defer: true})
var path = require('path')
var npm = require('../lib/npm.js')
var npmconf = require('../lib/config/core.js')
var errorHandler = require('../lib/utils/error-handler.js')
var output = require('../lib/utils/output.js')
var configDefs = npmconf.defs
var shorthands = configDefs.shorthands
@@ -74,6 +81,12 @@
conf._exit = true
npm.load(conf, function (er) {
if (er) return errorHandler(er)
npm.commands[npm.command](npm.argv, errorHandler)
npm.commands[npm.command](npm.argv, function (err) {
if (!err && npm.config.get('ham-it-up')) {
output('\n 🎵 I Have the Honour to Be Your Obedient Servant,🎵 ~ npm 📜🖋\n')
errorHandler.apply(this, arguments)
Oops, something went wrong.

0 comments on commit 0084260

Please sign in to comment.