mirror of
https://github.com/nodejs/node.git
synced 2025-05-15 14:41:29 +00:00
a7c7c703af
PR-URL: https://github.com/nodejs/node/pull/30533 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Jiawen Geng <technicalcute@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
---
|
|
section: cli-commands
|
|
title: npm-unpublish
|
|
description: Remove a package from the registry
|
|
---
|
|
|
|
# npm-unpublish(1)
|
|
|
|
## Remove a package from the registry
|
|
|
|
### Synopsis
|
|
|
|
```bash
|
|
npm unpublish [<@scope>/]<pkg>[@<version>]
|
|
```
|
|
|
|
### Warning
|
|
|
|
**It is generally considered bad behavior to remove versions of a library
|
|
that others are depending on!**
|
|
|
|
Consider using the `deprecate` command
|
|
instead, if your intent is to encourage users to upgrade.
|
|
|
|
There is plenty of room on the registry.
|
|
|
|
### Description
|
|
|
|
This removes a package version from the registry, deleting its
|
|
entry and removing the tarball.
|
|
|
|
If no version is specified, or if all versions are removed then
|
|
the root package entry is removed from the registry entirely.
|
|
|
|
Even if a package version is unpublished, that specific name and
|
|
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.
|
|
|
|
With the default registry (`registry.npmjs.org`), unpublish is
|
|
only allowed with versions published in the last 72 hours. If you
|
|
are trying to unpublish a version published longer ago than that,
|
|
contact support@npmjs.com.
|
|
|
|
The scope is optional and follows the usual rules for [`scope`](/using-npm/scope).
|
|
|
|
### See Also
|
|
|
|
* [npm deprecate](/cli-commands/npm-deprecate)
|
|
* [npm publish](/cli-commands/npm-publish)
|
|
* [npm registry](/using-npm/registry)
|
|
* [npm adduser](/cli-commands/npm-adduser)
|
|
* [npm owner](/cli-commands/npm-owner)
|