# @cityssm/puppeteer-launch

> Launch Puppeteer, falling back to system browsers when the cached ones aren't working or aren't available.

Latest version **8.0.0** (published 2026-09-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @cityssm/puppeteer-launch
pnpm add @cityssm/puppeteer-launch
yarn add @cityssm/puppeteer-launch
bun add @cityssm/puppeteer-launch
```

Provides the commands `install-chrome`, `install-firefox`.

## Health

**Score 70/100 (B)** — status: active.

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 8.0.0 |
| Published | 2026-09-10 |
| First published | 2024-04-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=22.12.0 |
| Dependencies | 6 |
| Unpacked size | 47.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | The Corporation of the City of Sault Ste. Marie |
| Maintainers | dgowans |
| Keywords | chrome, chromium, firefox, puppeteer, web-browser |

## Links

- npm: https://www.npmjs.com/package/@cityssm/puppeteer-launch
- Repository: https://github.com/cityssm/puppeteer-launch
- Homepage: https://github.com/cityssm/puppeteer-launch#readme
- Issues: https://github.com/cityssm/puppeteer-launch/issues
- npm.io page: https://npm.io/package/@cityssm/puppeteer-launch

## Dependencies (6)

- [debug](https://npm.io/package/debug.md) ^4.4.3
- [exit-hook](https://npm.io/package/exit-hook.md) ^5.1.0
- [puppeteer](https://npm.io/package/puppeteer.md) ^25.10.0
- [async-sema](https://npm.io/package/async-sema.md) ^3.1.1
- [@puppeteer/browsers](https://npm.io/package/@puppeteer/browsers.md) ^3.2.2
- [@cityssm/has-package](https://npm.io/package/@cityssm/has-package.md) ^1.0.0

## 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

- 8.0.0 (latest) — 2026-09-10
- 7.2.0 — 2026-08-21
- 7.1.0 — 2026-08-14
- 7.0.1 — 2026-04-01
- 7.0.0 — 2026-04-01
- 6.0.0 — 2026-02-20
- 5.2.1 — 2026-01-07
- 5.2.0 — 2025-10-15
- 5.1.0 — 2025-08-26
- 5.0.0 — 2025-08-11
- 4.1.2 — 2025-08-01
- 4.1.1 — 2025-08-01
- 4.1.0 — 2025-08-01
- 4.0.0 — 2025-01-14
- 3.2.0 — 2024-12-20
- … 10 more at https://npm.io/package/@cityssm/puppeteer-launch/versions

## README

# Puppeteer Launch

[![npm (scoped)](https://img.shields.io/npm/v/@cityssm/puppeteer-launch)](https://www.npmjs.com/package/@cityssm/puppeteer-launch)
[![DeepSource](https://app.deepsource.com/gh/cityssm/puppeteer-launch.svg/?label=active+issues&show_trend=true&token=uZJ-emVRMecP7RWObivU3uT9)](https://app.deepsource.com/gh/cityssm/puppeteer-launch/)
[![codecov](https://codecov.io/gh/cityssm/puppeteer-launch/graph/badge.svg?token=K55LQ4IX7T)](https://codecov.io/gh/cityssm/puppeteer-launch)
[![Coverage Testing](https://github.com/cityssm/puppeteer-launch/actions/workflows/coverage.yml/badge.svg)](https://github.com/cityssm/puppeteer-launch/actions/workflows/coverage.yml)

A helper for `puppeteer.launch()`,
for when cached Puppeteer browsers aren't available or aren't compatible.

A drop-in replacement the falls back to system browsers automatically!

## Installation

```sh
npm install @cityssm/puppeteer-launch
```

## Usage

```javascript
import puppeteerLaunch from '@cityssm/puppeteer-launch'

// Launch the default cached browser (likely Chrome).
// Will fallback to a system browser (either Chrome, Chromium, or Firefox)
// if no cached browser is available.
const browser = await puppeteerLaunch()

// Launch a Firefox web browser.
// Will use a system Firefox if no Firefox in the Puppeteer cache.
const firefoxBrowser = await puppeteerLaunch({
  browser: 'firefox'
})
```

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