# karma-firefox-launcher > A Karma plugin. Launcher for Firefox. Latest version **2.1.3** (published 2024-03-03) · MIT license · 0 weekly downloads ## Install ```sh npm install karma-firefox-launcher pnpm add karma-firefox-launcher yarn add karma-firefox-launcher bun add karma-firefox-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 | 2.1.3 | | Published | 2024-03-03 | | First published | 2013-03-19 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | separate (@types/karma-firefox-launcher) | | Module format | CommonJS | | Dependencies | 2 | | Unpacked size | 27 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 106 | | Author | Vojta Jina | | Maintainers | dignifiedquire, zzo, vojtajina, karmarunnerbot | | Keywords | karma, testing, karma-plugin, karma-launcher, firefox | ## Links - npm: https://www.npmjs.com/package/karma-firefox-launcher - Repository: https://github.com/karma-runner/karma-firefox-launcher - Homepage: https://github.com/karma-runner/karma-firefox-launcher#readme - Issues: https://github.com/karma-runner/karma-firefox-launcher/issues - npm.io page: https://npm.io/package/karma-firefox-launcher ## Dependencies (2) - [which](https://npm.io/package/which.md) ^3.0.0 - [is-wsl](https://npm.io/package/is-wsl.md) ^2.2.0 ## Alternatives - [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads - [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads - [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads - [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads - [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads ## Recent versions - 2.1.3 (latest) — 2024-03-03 - 2.1.2 — 2021-11-02 - 2.1.1 — 2021-06-02 - 2.1.0 — 2020-11-03 - 2.0.0 — 2020-10-20 - 1.3.0 — 2020-01-08 - 1.2.0 — 2019-08-09 - 1.1.0 — 2017-12-07 - 1.0.1 — 2017-03-04 - 1.0.0 — 2016-05-04 - 0.1.7 — 2015-11-12 - 0.1.6 — 2015-05-11 - 0.1.5 — 2015-05-09 - 0.1.4 — 2014-12-29 - 0.1.3 — 2013-12-26 - … 6 more at https://npm.io/package/karma-firefox-launcher/versions ## README # karma-firefox-launcher [![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/karma-runner/karma-firefox-launcher) [![npm version](https://img.shields.io/npm/v/karma-firefox-launcher.svg?style=flat-square)](https://www.npmjs.com/package/karma-firefox-launcher) [![npm downloads](https://img.shields.io/npm/dm/karma-firefox-launcher.svg?style=flat-square)](https://www.npmjs.com/package/karma-firefox-launcher) [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) [![Build Status](https://img.shields.io/travis/karma-runner/karma-firefox-launcher/master.svg?style=flat-square)](https://travis-ci.org/karma-runner/karma-firefox-launcher) [![Dependency Status](https://img.shields.io/david/karma-runner/karma-firefox-launcher.svg?style=flat-square)](https://david-dm.org/karma-runner/karma-firefox-launcher) [![devDependency Status](https://img.shields.io/david/dev/karma-runner/karma-firefox-launcher.svg?style=flat-square)](https://david-dm.org/karma-runner/karma-firefox-launcher#info=devDependencies) > Launcher for Mozilla Firefox. ## `karma-firefox-launcher` is deprecated and is not accepting new features or general bug fixes. See [deprecation notice for `karma`](https://github.com/karma-runner/karma#karma-is-deprecated-and-is-not-accepting-new-features-or-general-bug-fixes). [Web Test Runner](https://modern-web.dev/docs/test-runner/overview/), [`jasmine-browser-runner`](https://github.com/jasmine/jasmine-browser-runner), and [`playwright-test`](https://github.com/hugomrdias/playwright-test) provide browser-based unit testing solutions which can be used as a direct alternative. ## Installation The easiest way is to keep `karma-firefox-launcher` as a devDependency in your `package.json`. You can simple do it by: ```bash npm install karma-firefox-launcher --save-dev ``` ## Configuration ```js // karma.conf.js module.exports = function (config) { config.set({ plugins: [require("karma-firefox-launcher")], browsers: [ "Firefox", "FirefoxDeveloper", "FirefoxAurora", "FirefoxNightly", ], }); }; ``` You can pass list of browsers as a CLI argument too: ```bash karma start --browsers Firefox,Chrome ``` To run Firefox in headless mode, append `Headless` to the version name, e.g. `FirefoxHeadless`, `FirefoxNightlyHeadless`. ### Environment variables You can specify the location of the Firefox executable using the following environment variables: - `FIREFOX_BIN` (for browser `Firefox` or `FirefoxHeadless`) - `FIREFOX_DEVELOPER_BIN` (for browser `FirefoxDeveloper` or `FirefoxDeveloperHeadless`) - `FIREFOX_AURORA_BIN` (for browser `FirefoxAurora` or `FirefoxAuroraHeadless`) - `FIREFOX_NIGHTLY_BIN` (for browser `FirefoxNightly` or `FirefoxNightlyHeadless`) ### Custom Firefox location In addition to Environment variables you can specify location of the Firefox executable in a custom launcher: ```js browsers: ['Firefox68', 'Firefox78'], customLaunchers: { Firefox68: { base: 'Firefox', name: 'Firefox68', command: '/firefox.exe' }, Firefox78: { base: 'Firefox', name: 'Firefox78', command: '/firefox.exe' } } ``` ### Custom Preferences To configure preferences for the Firefox instance that is loaded, you can specify a custom launcher in your Karma config with the preferences under the `prefs` key: ```js browsers: ['FirefoxAutoAllowGUM'], customLaunchers: { FirefoxAutoAllowGUM: { base: 'Firefox', prefs: { 'media.navigator.permission.disabled': true } } } ``` ### Loading Firefox Extensions If you have extensions that you want loaded into the browser on startup, you can specify the full path to each extension in the `extensions` key: ```js browsers: ['FirefoxWithMyExtension'], customLaunchers: { FirefoxWithMyExtension: { base: 'Firefox', extensions: [ path.resolve(__dirname, 'helpers/extensions/myCustomExt@suchandsuch.xpi'), path.resolve(__dirname, 'helpers/extensions/myOtherExt@soandso.xpi') ] } } ``` **Please note**: the extension name must exactly match the 'id' of the extension. You can discover the 'id' of your extension by extracting the .xpi (i.e. `unzip XXX.xpi`) and opening the install.RDF file with a text editor, then look for the `em:id` tag under the `Description` tag. If your extension manifest looks something like this: ```xml myCustomExt@suchandsuch 1.0 2 true false [...] ``` Then you should name your extension `myCustomExt@suchandsuch.xpi`. --- For more information on Karma see the [homepage]. [homepage]: https://karma-runner.github.io --- _Source: https://npm.io/package/karma-firefox-launcher · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._