Skip to content

Check whether a package name is available on npm

License

Notifications You must be signed in to change notification settings

kgoodridge/npm-name

 
 

Repository files navigation

npm-name Build Status

Check whether a package name is available on npm

Install

$ npm install npm-name

Usage

const npmName = require('npm-name');

(async () => {
	console.log(await npmName('chalk'));
	//=> false

	const result = await npmName.many(['chalk', '@sindresorhus/is', 'abc123']);
	console.log(result.get('chalk'));
	//=> false
	console.log(result.get('@sindresorhus/is'));
	//=> false
	console.log(result.get('abc123'));
	//=> true

	try {
		await npmName('_ABC');
	} catch (error) {
		console.log(error.message);
		// Invalid package name: _ABC
		// - name cannot start with an underscore
		// - name can no longer contain capital letters
	}
})();

API

npmName(name)

Returns a Promise<boolean> of whether the given name is available.

name

Type: string

Name to check.

npmName.many(names)

Returns a Promise<Map> of name and status.

names

Type: string[]

Multiple names to check.

Related

License

MIT © Sindre Sorhus

About

Check whether a package name is available on npm

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 86.9%
  • TypeScript 13.1%