# detect-package-manager

> Detect which package manager you're using (yarn or npm)

Latest version **3.0.2** (published 2024-05-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install detect-package-manager
pnpm add detect-package-manager
yarn add detect-package-manager
bun add detect-package-manager
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.2 |
| Published | 2024-05-05 |
| First published | 2017-08-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=12 |
| Dependencies | 1 |
| Unpacked size | 10.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 90 |
| Author | egoist |
| Maintainers | egoist, rem |
| Keywords | npm, yarn, package-manager, detect, check, pnpm |

## Links

- npm: https://www.npmjs.com/package/detect-package-manager
- Repository: https://github.com/egoist/detect-package-manager
- Homepage: https://github.com/egoist/detect-package-manager#readme
- Issues: https://github.com/egoist/detect-package-manager/issues
- npm.io page: https://npm.io/package/detect-package-manager

## Dependencies (1)

- [execa](https://npm.io/package/execa.md) ^5.1.1

## Recent versions

- 3.0.2 (latest) — 2024-05-05
- 3.0.1 — 2023-09-04
- 3.0.0 — 2023-09-04
- 2.0.1 — 2021-10-24
- 2.0.0 — 2021-10-24
- 1.1.0 — 2017-08-11
- 1.0.1 — 2017-08-11
- 1.0.0 — 2017-08-11

## README

# detect-package-manager

[![NPM version](https://img.shields.io/npm/v/detect-package-manager.svg?style=flat)](https://npmjs.com/package/detect-package-manager) [![NPM downloads](https://img.shields.io/npm/dm/detect-package-manager.svg?style=flat)](https://npmjs.com/package/detect-package-manager) [![CircleCI](https://circleci.com/gh/egoist/detect-package-manager/tree/master.svg?style=shield)](https://circleci.com/gh/egoist/detect-package-manager/tree/master) [![donate](https://img.shields.io/badge/$-donate-ff69b4.svg?maxAge=2592000&style=flat)](https://github.com/egoist/donate)

## How does this work?

1. When there's `yarn.lock`, `package-lock.json`, `pnpm-lock.yaml`, or `bun.lockb` in current working directory, it will skip other operations and directly resolve `yarn`, `npm`, `pnpm`, or `bun`.
2. When there's no lockfile found, it checks if `yarn`, `pnpm`, or `bun` command exists. If so, it resolves `yarn`, `pnpm`, or `bun` otherwise `npm`.
3. Results are cached.

## Install

```bash
yarn add detect-package-manager
```

## Usage

```js
const { detect } = require("detect-package-manager");

detect().then((pm) => {
  console.log(pm);
  //=> 'yarn', 'npm', or 'pnpm', 'bun'
});
```

## API

### detect([opts])

- Arguments:
  - `opts.cwd`: `string` Optional, defaults to `.`, the directory to look up `yarn.lock`, `package-lock.json`, or `pnpm-lock.yaml`.
  - `opts.includeGlobalBun`: `boolean` Optional, defaults to `false`, whether to check if `bun` exists in PATH.
- Returns: `Promise<PM>`

It returns a Promise resolving the name of package manager, could be `npm`, `yarn`, or `pnpm`, `bun`.

### getNpmVersion([pm])

- Arguments:
  - `pm`: `string` Optional, defaults to `npm`, could be `npm`, `yarn`, or `pnpm`, `bun`
- Returns: `Promise<string>`

It returns a Promise resolving the version of npm or the package manager you specified.

### clearCache()

- Returns: `void`

Clear cache.

## Contributing

1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request :D

## Author

**detect-package-manager** © [EGOIST](https://github.com/egoist), Released under the [MIT](./LICENSE) License.<br>
Authored and maintained by EGOIST with help from contributors ([list](https://github.com/egoist/detect-package-manager/contributors)).

> [github.com/egoist](https://github.com/egoist) · GitHub [@EGOIST](https://github.com/egoist) · Twitter [@\_egoistlily](https://twitter.com/_egoistlily)

---
_Source: https://npm.io/package/detect-package-manager · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._