validate-npm-package-name

WebJar for validate-npm-package-name

License	ISC
GroupId	org.webjars.npm
ArtifactId	validate-npm-package-name
Last Version	3.0.0
Release Date	Sep 15, 2017
Type	jar
Description	validate-npm-package-name WebJar for validate-npm-package-name
Project URL	http://webjars.org
Source Code Management	https://github.com/npm/validate-npm-package-name

Download validate-npm-package-name

Filename	Size
validate-npm-package-name-3.0.0.pom
validate-npm-package-name-3.0.0.jar	7 KB
validate-npm-package-name-3.0.0-sources.jar	22 bytes
validate-npm-package-name-3.0.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/validate-npm-package-name/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>validate-npm-package-name</artifactId>
    <version>3.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/validate-npm-package-name/
implementation 'org.webjars.npm:validate-npm-package-name:3.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/validate-npm-package-name/
implementation ("org.webjars.npm:validate-npm-package-name:3.0.0")

Apache Buildr

'org.webjars.npm:validate-npm-package-name:jar:3.0.0'

Apache Ivy

<dependency org="org.webjars.npm" name="validate-npm-package-name" rev="3.0.0">
  <artifact name="validate-npm-package-name" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='validate-npm-package-name', version='3.0.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "validate-npm-package-name" % "3.0.0"

Leiningen

[org.webjars.npm/validate-npm-package-name "3.0.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.webjars.npm : builtins	jar	[1.0.3,2)

Project Modules

There are no modules declared in this project.

validate-npm-package-name

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

This package exports a single synchronous function that takes a string as input and returns an object with two properties:

• validForNewPackages :: Boolean
• validForOldPackages :: Boolean

Contents

• Naming rules
• Examples
  • Valid Names
  • Invalid Names
• Legacy Names
• Tests
• License

Naming Rules

Below is a list of rules that valid npm package name should conform to.

• package name length should be greater than zero
• all the characters in the package name must be lowercase i.e., no uppercase or mixed case names are allowed
• package name can consist of hyphens
• package name must not contain any non-url-safe characters (since name ends up being part of a URL)
• package name should not start with . or _
• package name should not contain any leading or trailing spaces
• package name should not contain any of the following characters: ~)('!*
• package name cannot be the same as a node.js/io.js core module nor a reserved/blacklisted name. For example, the following names are invalid:
  • http
  • stream
  • node_modules
  • favicon.ico
• package name length cannot exceed 214

Examples

Valid Names

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

validate("some-package")
validate("example.com")
validate("under_score")
validate("123numeric")
validate("@npm/thingy")
validate("@jane/foo.js")

All of the above names are valid, so you'll get this object back:

{
  validForNewPackages: true,
  validForOldPackages: true
}

Invalid Names

validate("excited!")
validate(" leading-space:and:weirdchars")

That was never a valid package name, so you get this:

{
  validForNewPackages: false,
  validForOldPackages: false,
  errors: [
    'name cannot contain leading or trailing spaces',
    'name can only contain URL-friendly characters'
  ]
}

Legacy Names

In the old days of npm, package names were wild. They could have capital letters in them. They could be really long. They could be the name of an existing module in node core.

If you give this function a package name that used to be valid, you'll see a change in the value of validForNewPackages property, and a warnings array will be present:

validate("eLaBorAtE-paCkAgE-with-mixed-case-and-more-than-214-characters-----------------------------------------------------------------------------------------------------------------------------------------------------------")

returns:

{
  validForNewPackages: false,
  validForOldPackages: true,
  warnings: [
    "name can no longer contain capital letters",
    "name can no longer contain more than 214 characters"
  ]
}

Tests

npm install
npm test

License

ISC

npm

node package manager

Versions

Version
3.0.0 Sep 15, 2017
2.2.2 Apr 30, 2016