# find-chrome-bin

> Finds local Chromium binary to use it with puppeteer-core

Latest version **2.0.4** (published 2025-09-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install find-chrome-bin
pnpm add find-chrome-bin
yarn add find-chrome-bin
bun add find-chrome-bin
```

## Health

**Score 40/100 (D)** — status: maintenance-mode.

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

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.4 |
| Published | 2025-09-17 |
| First published | 2021-12-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.0.0 |
| Dependencies | 1 |
| Unpacked size | 17.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 12 |
| Author | mbalabash |
| Maintainers | mbalabash |
| Keywords | chrome, chromium, headless, find-chrome, puppeteer-core, browser-fetcher, puppeteer |

## Links

- npm: https://www.npmjs.com/package/find-chrome-bin
- Repository: https://github.com/mbalabash/find-chrome-bin
- Homepage: https://github.com/mbalabash/find-chrome-bin#readme
- Issues: https://github.com/mbalabash/find-chrome-bin/issues
- npm.io page: https://npm.io/package/find-chrome-bin

## Dependencies (1)

- [@puppeteer/browsers](https://npm.io/package/@puppeteer/browsers.md) 2.10.10

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 2.0.4 (latest) — 2025-09-17
- 2.0.3 — 2025-07-26
- 2.0.2 — 2024-02-25
- 2.0.1 — 2023-12-06
- 2.0.0 — 2023-11-21
- 1.0.5 — 2023-03-27
- 1.0.4 — 2023-03-25
- 1.0.3 — 2023-03-25
- 1.0.2 — 2022-07-01
- 1.0.1 — 2022-04-03
- 1.0.0 — 2022-01-25
- 0.1.0 — 2021-12-09

## README

# Finds local Chromium to use it with puppeteer-core

- **Cross-platform.** Works on win, mac and linux.

- **Small.** Only 2.4 kB.

## Usage

By default, it tries to find Chromium v85+ binary with you can then use for launching puppeteer-core for your needs.

Respects `CHROMIUM_EXECUTABLE_PATH` and `PUPPETEER_EXECUTABLE_PATH` environment variables for CI purposes.

```js
import { findChrome } from 'find-chrome-bin'
const chromeInfo = await findChrome()
console.log(chromeInfo)
// { browser: "Google Chrome 96.0.4664.45", executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" }
```

### Specifying `min` and/or `max` Chromium versions

You can configure a suitable version using `min` and `max` options.

```js
import { findChrome } from 'find-chrome-bin'
const chromeInfo = await findChrome({ min: 95, max: 97 })
console.log(chromeInfo)
// { browser: "Google Chrome 96.0.4664.45", executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" }
```

### With fallback to download suitable Chromium revision

It can also download suitable Chromium revision as fallback (you have to provide puppeteer-core entity and Chromium revision to `download` option).

```js
import { join } from 'path'
import puppeteer from 'puppeteer-core'
import { PUPPETEER_REVISIONS } from 'puppeteer-core/lib/cjs/puppeteer/revisions.js'
import { findChrome } from 'find-chrome-bin'

let chromeInfo = await findChrome({
  max: 95,
  download: {
    puppeteer,
    path: join('.', 'chrome'),
    revision: PUPPETEER_REVISIONS.chromium
  }
})
console.log(chromeInfo)
// { browser: "Chromium 94.0.4606.0", executablePath: "/Users/mbalabash/Projects/opensource/find-chrome-bin/example/chrome/mac-911515/chrome-mac/Chromium.app/Contents/MacOS/Chromium" }
```

## Install

```js
npm i find-chrome-bin
```

or

```js
yarn add find-chrome-bin
```

## License

MIT

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