# karma-chrome-launcher

> A Karma plugin. Launcher for Chrome and Chrome Canary.

Latest version **3.2.0** (published 2023-04-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install karma-chrome-launcher
pnpm add karma-chrome-launcher
yarn add karma-chrome-launcher
bun add karma-chrome-launcher
```

## Health

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

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 3.2.0 |
| Published | 2023-04-20 |
| First published | 2013-03-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/karma-chrome-launcher) |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 29 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 474 |
| Author | Vojta Jina |
| Maintainers | dignifiedquire, zzo, vojtajina, karmarunnerbot |
| Keywords | karma-plugin, karma-launcher, chrome |

## Links

- npm: https://www.npmjs.com/package/karma-chrome-launcher
- Repository: https://github.com/karma-runner/karma-chrome-launcher
- Homepage: https://github.com/karma-runner/karma-chrome-launcher#readme
- Issues: https://github.com/karma-runner/karma-chrome-launcher/issues
- npm.io page: https://npm.io/package/karma-chrome-launcher

## Dependencies (1)

- [which](https://npm.io/package/which.md) ^1.2.1

## Recent versions

- 3.2.0 (latest) — 2023-04-20
- 3.1.1 — 2022-03-09
- 3.1.0 — 2019-08-13
- 3.0.0 — 2019-07-12
- 2.2.0 — 2017-06-23
- 2.1.1 — 2017-05-05
- 2.1.0 — 2017-05-02
- 2.0.0 — 2016-08-18
- 1.0.1 — 2016-05-02
- 0.2.3 — 2016-03-22
- 0.2.2 — 2015-12-01
- 0.2.1 — 2015-10-07
- 0.2.0 — 2015-06-23
- 0.1.12 — 2015-05-13
- 0.1.11 — 2015-05-12
- … 13 more at https://npm.io/package/karma-chrome-launcher/versions

## README

# karma-chrome-launcher

[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/karma-runner/karma-chrome-launcher)
 [![npm version](https://img.shields.io/npm/v/karma-chrome-launcher.svg?style=flat-square)](https://www.npmjs.com/package/karma-chrome-launcher) [![npm downloads](https://img.shields.io/npm/dm/karma-chrome-launcher.svg?style=flat-square)](https://www.npmjs.com/package/karma-chrome-launcher)

[![Build Status](https://img.shields.io/travis/karma-runner/karma-chrome-launcher/master.svg?style=flat-square)](https://travis-ci.org/karma-runner/karma-chrome-launcher) [![Dependency Status](https://img.shields.io/david/karma-runner/karma-chrome-launcher.svg?style=flat-square)](https://david-dm.org/karma-runner/karma-chrome-launcher) [![devDependency Status](https://img.shields.io/david/dev/karma-runner/karma-chrome-launcher.svg?style=flat-square)](https://david-dm.org/karma-runner/karma-chrome-launcher#info=devDependencies)

> Launcher for Google Chrome, Google Chrome Canary and Google Chromium.

## Installation

The easiest way is to keep `karma-chrome-launcher` as a devDependency in your `package.json`,
by running

```bash
$ npm i -D karma-chrome-launcher
```

## Configuration

```js
// karma.conf.js
module.exports = function(config) {
  config.set({
    browsers: ['Chrome', 'Chrome_without_security'], // You may use 'ChromeCanary', 'Chromium' or any other supported browser

    // you can define custom flags
    customLaunchers: {
      Chrome_without_security: {
        base: 'Chrome',
        flags: ['--disable-web-security', '--disable-site-isolation-trials']
      }
    }
  })
}
```

The `--user-data-dir` is set to a temporary directory but can be overridden on a custom launcher as shown below.
One reason to do this is to have a permanent Chrome user data directory inside the project directory to be able to
install plugins there (e.g. JetBrains IDE Support plugin).

```js
customLaunchers: {
  Chrome_with_debugging: {
    base: 'Chrome',
    chromeDataDir: path.resolve(__dirname, '.chrome')
  }
}
```

You can pass list of browsers as a CLI argument too:

```bash
$ karma start --browsers Chrome,Chrome_without_security
```

## Headless Chromium with Puppeteer

The Chrome DevTools team created [Puppeteer](https://github.com/GoogleChrome/puppeteer) - it will automatically install Chromium for all
platforms and contains everything you need to run it from within your CI.

### Available Browsers
*Note: Headless mode requires a browser version >= 59*

- Chrome (CHROME_BIN)
- ChromeHeadless (CHROME_BIN)
- Chromium (CHROMIUM_BIN)
- ChromiumHeadless (CHROMIUM_BIN)
- ChromeCanary (CHROME_CANARY_BIN)
- ChromeCanaryHeadless (CHROME_CANARY_BIN)
- Dartium (DARTIUM_BIN)

#### Usage
```bash
$ npm i -D puppeteer karma-chrome-launcher
```

```js
// karma.conf.js
process.env.CHROME_BIN = require('puppeteer').executablePath()

module.exports = function(config) {
  config.set({
    browsers: ['ChromeHeadless']
  })
}
```

----

For more information on Karma see the [homepage].

[homepage]: https://karma-runner.github.io

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