npm-name

What is npm-name?

The npm-name package is used to check the availability of package names on the npm registry. It helps developers to determine if a particular package name is already taken or if it is available for use.

What are npm-name's main functionalities?

Check single package name

This feature allows you to check if a single package name is available on the npm registry. The code sample demonstrates how to use the npm-name package to check the availability of 'some-package-name'.

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

(async () => {
  const isAvailable = await npmName('some-package-name');
  console.log(isAvailable ? 'Available' : 'Taken');
})();

Check multiple package names

This feature allows you to check the availability of multiple package names at once. The code sample shows how to check the availability of 'package-one' and 'package-two' using the npm-name package.

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

(async () => {
  const result = await npmName.many(['package-one', 'package-two']);
  console.log(result);
})();

Check scoped package name

This feature allows you to check the availability of a scoped package name. The code sample demonstrates how to check if '@scope/some-package-name' is available on the npm registry.

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

(async () => {
  const isAvailable = await npmName('@scope/some-package-name');
  console.log(isAvailable ? 'Available' : 'Taken');
})();

Other packages similar to npm-name

npm-name-cli

The npm-name-cli package is a command-line interface tool for checking the availability of npm package names. While npm-name is a library that can be integrated into other Node.js applications, npm-name-cli is specifically designed for use in the terminal, making it a good choice for developers who prefer command-line tools.

README

npm-name

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 for a boolean.

name

Type: String

Name to check.

npmName.many(names)

Returns a promise for a Map of name/status.

names

Type: Array

Multiple names to check.

Related

• npm-name-cli - CLI for this module

License

MIT © Sindre Sorhus