validate-npm-package-name

What is validate-npm-package-name?

The validate-npm-package-name package is used to check if a given string is a valid npm package name. It ensures that the package name meets the npm naming constraints, such as length, format, and character restrictions. It is useful for developers who are creating new npm packages and want to validate their package names before publishing to the npm registry.

What are validate-npm-package-name's main functionalities?

Validation of package names

This feature allows you to validate a string to see if it would be a valid npm package name. It checks against rules for both new packages and old packages that were allowed before stricter rules were applied. The result object contains two boolean properties: 'validForNewPackages' and 'validForOldPackages'.

{"validForNewPackages": true, "validForOldPackages": true}

Error and warning messages

If the package name is invalid, the function will return an object with 'errors' and 'warnings' arrays that provide information about why the name is invalid. This is useful for giving feedback to users so they can correct their package names.

{"validForNewPackages": false, "validForOldPackages": false, "errors": ["name cannot start with a dot"], "warnings": ["name is discouraged"]}

Other packages similar to validate-npm-package-name

npm-name

The npm-name package checks whether a package name is available on the npm registry. It differs from validate-npm-package-name in that it specifically checks for name availability rather than just format validity.

package-name-regex

This package provides a regular expression to test if a string is a valid npm package name. It is similar to validate-npm-package-name but offers a lower-level approach using regex matching instead of a function that returns an object with details.

README

validate-npm-package-name

Give me a string and I'll tell you if it's a valid npm package name

Installation

Download node at nodejs.org and install it, if you haven't already.

npm install validate-npm-package-name --save

Usage

var valid = require("validate-npm-package-name")

validate("some-package")  // => {valid: true}
validate("example.com")   // => {valid: true}
validate("CAPITALS")      // => {valid: true}
validate("under_score")   // => {valid: true}
validate("123numeric")    // => {valid: true}
validate("crazy!")        // => {valid: true}
validate("@npm/thingy")   // => {valid: true}
validate("@jane/foo.js")  // => {valid: true}

validate("")              // => {valid: false, errors:["name length must be greater than zero"]}
validate("ca$h")          // => {valid: false, errors:["name can only contain URL-friendly characters"]}
validate("_flodash")      // => {valid: false, errors:["name cannot start with an underscore"]}

Tests

npm install
npm test

Dependencies

None

Dev Dependencies

• tap: A Test-Anything-Protocol library

License

ISC

Generated by package-json-to-readme