# 公開しているパッケージを deprecated にする

公開している npm パッケージが何らかの理由で非推奨となった場合に deprecated 扱いにする方法です。

## npm-deprecate

公式サイトの [npm-deprecate](https://docs.npmjs.com/cli/deprecate.html) に書かれているとおり、npm にはパッケージが非推奨であること、そして理由を登録する方法が用意されています。

## パッケージを deprecated にする

`npm deprecate` コマンドを実行することで、パッケージ全体(全バージョン) を非推奨にできます。

```bash
$ npm deprecate ＜パッケージ名＞ "非推奨の理由"
```

非推奨となったパッケージは npm 上で以下のように deprecated であることがメッセージと共に表示されるようになります。

![image.png](/attachment/5ec6a73c49c5180049f3d453)

また、npm package をインストールした際にもコンソール上にメッセージが表示されます。

```bash
$ npm install --global @weseek/clf-date
npm WARN deprecated @weseek/clf-date@0.2.1: Because a bug in 'lludol/clf-date' has been fixed, this package will be removed soon. https://github.com/lludol/clf-date/pull/7
C:\Program Files\nodejs\clf-date -> C:\Program Files\nodejs\node_modules\@weseek\clf-date\bin\clf-date.js
+ @weseek/clf-date@0.2.1
added 1 package from 1 contributor in 1.235s
```

パッケージの特定のバージョンだけ非推奨にする場合はバージョンを指定することも可能です。  
バージョンは [semver](https://semver.org/lang/ja/) による範囲指定が可能です。

```bash
$ npm deprecate ＜パッケージ名＞@＜バージョン＞ "非推奨の理由"
```

## やり直す

非推奨にしたパッケージをやはり必要となって戻す場合は、deprecated メッセージを空にすれば ok です。

```bash
$ npm deprecate ＜パッケージ名＞ ""
```


---

## Page Navigation

- Canonical URL: https://tips.weseek.co.jp/Tips/npm/公開しているパッケージをdeprecatedにする
- Permalink: https://tips.weseek.co.jp/5ec6a73c49c5180049f3d451
- Parent: [npm](/65069da24603e7ff39a6b3dc.md)
- Children: 0 total
- Total descendants: 0
- Siblings: 1 total
  - [npm create](/65223b9029b0005c53744cd0.md)
- Last updated: 2020-05-21T16:20:58.994Z by ryu
- Full page listing (all children regardless of count): https://tips.weseek.co.jp/_api/v3/page-listing/children?id=5ec6a73c49c5180049f3d451