2020-02-26 17:11:08 -08:00
|
|
|
.TH "NPM\-UNPUBLISH" "1" "February 2020" "" ""
|
2011-11-26 09:21:03 -08:00
|
|
|
.SH "NAME"
|
2019-11-18 21:01:39 +02:00
|
|
|
\fBnpm-unpublish\fR \- Remove a package from the registry
|
2019-11-05 14:55:08 -05:00
|
|
|
.SS Synopsis
|
2014-09-24 14:41:07 -07:00
|
|
|
.P
|
|
|
|
.RS 2
|
2014-11-04 15:08:12 -08:00
|
|
|
.nf
|
2015-10-09 23:13:57 -07:00
|
|
|
npm unpublish [<@scope>/]<pkg>[@<version>]
|
2014-11-04 15:08:12 -08:00
|
|
|
.fi
|
2014-09-24 14:41:07 -07:00
|
|
|
.RE
|
2019-11-05 14:55:08 -05:00
|
|
|
.SS Warning
|
2014-09-24 14:41:07 -07:00
|
|
|
.P
|
2011-11-26 09:21:03 -08:00
|
|
|
\fBIt is generally considered bad behavior to remove versions of a library
|
|
|
|
that others are depending on!\fR
|
|
|
|
.P
|
2015-07-24 15:09:52 -07:00
|
|
|
Consider using the \fBdeprecate\fP command
|
2011-11-26 09:21:03 -08:00
|
|
|
instead, if your intent is to encourage users to upgrade\.
|
|
|
|
.P
|
|
|
|
There is plenty of room on the registry\.
|
2019-11-05 14:55:08 -05:00
|
|
|
.SS Description
|
2014-09-24 14:41:07 -07:00
|
|
|
.P
|
2011-11-26 09:21:03 -08:00
|
|
|
This removes a package version from the registry, deleting its
|
|
|
|
entry and removing the tarball\.
|
|
|
|
.P
|
|
|
|
If no version is specified, or if all versions are removed then
|
|
|
|
the root package entry is removed from the registry entirely\.
|
2014-03-19 09:25:40 -07:00
|
|
|
.P
|
|
|
|
Even if a package version is unpublished, that specific name and
|
2018-08-29 12:03:09 -07:00
|
|
|
version combination can never be reused\. In order to publish the
|
|
|
|
package again, a new version number must be used\. Additionally,
|
|
|
|
new versions of packages with every version unpublished may not
|
|
|
|
be republished until 24 hours have passed\.
|
2014-09-24 14:41:07 -07:00
|
|
|
.P
|
2017-04-12 21:47:49 -07:00
|
|
|
With the default registry (\fBregistry\.npmjs\.org\fP), unpublish is
|
2018-08-29 12:03:09 -07:00
|
|
|
only allowed with versions published in the last 72 hours\. If you
|
|
|
|
are trying to unpublish a version published longer ago than that,
|
2019-07-24 23:00:03 -07:00
|
|
|
contact support@npmjs\.com\|\.
|
2017-04-12 21:47:49 -07:00
|
|
|
.P
|
2019-11-18 21:01:39 +02:00
|
|
|
The scope is optional and follows the usual rules for npm help \fBscope\fP\|\.
|
2019-11-05 14:55:08 -05:00
|
|
|
.SS See Also
|
2014-09-24 14:41:07 -07:00
|
|
|
.RS 0
|
|
|
|
.IP \(bu 2
|
2019-11-18 21:01:39 +02:00
|
|
|
npm help deprecate
|
2014-09-24 14:41:07 -07:00
|
|
|
.IP \(bu 2
|
2019-11-18 21:01:39 +02:00
|
|
|
npm help publish
|
2014-09-24 14:41:07 -07:00
|
|
|
.IP \(bu 2
|
2019-11-05 14:55:08 -05:00
|
|
|
npm help registry
|
2014-09-24 14:41:07 -07:00
|
|
|
.IP \(bu 2
|
2019-11-18 21:01:39 +02:00
|
|
|
npm help adduser
|
2014-09-24 14:41:07 -07:00
|
|
|
.IP \(bu 2
|
2019-11-18 21:01:39 +02:00
|
|
|
npm help owner
|
2014-09-24 14:41:07 -07:00
|
|
|
|
|
|
|
.RE
|