# coverage-istanbul-loader
> A Webpack loader that uses Istanbul to add code coverage instrumentation
Latest version **3.0.5** (published 2020-07-16) · MIT license · 0 weekly downloads
## Install
```sh
npm install coverage-istanbul-loader
pnpm add coverage-istanbul-loader
yarn add coverage-istanbul-loader
bun add coverage-istanbul-loader
```
## Health
**Score 20/100 (F)** — status: abandoned.
Positive: has types; no vulnerabilities.
Warnings: low downloads; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 3.0.5 |
| Published | 2020-07-16 |
| First published | 2019-02-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10 |
| Dependencies | 1 |
| Unpacked size | 8.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 33 |
| Author | James Messinger |
| Maintainers | jamesmessinger |
| Keywords | webpack-loader, webpack, loader, istanbul, coverage, code coverage, instrumentation, instrumenter, sourcemap, source-map, sourcemaps, source-maps |
## Links
- npm: https://www.npmjs.com/package/coverage-istanbul-loader
- Repository: https://github.com/JS-DevTools/coverage-istanbul-loader
- Homepage: https://jstools.dev/coverage-istanbul-loader
- Issues: https://github.com/JS-DevTools/coverage-istanbul-loader/issues
- npm.io page: https://npm.io/package/coverage-istanbul-loader
## Dependencies (1)
- [@jsdevtools/coverage-istanbul-loader](https://npm.io/package/@jsdevtools/coverage-istanbul-loader.md) 3.0.5
## Alternatives
- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads
## Recent versions
- 3.0.5 (latest) — 2020-07-16
- 3.0.4 — 2020-07-11
- 3.0.3 — 2020-03-16
- 3.0.2 — 2020-03-16
- 3.0.1 — 2020-03-16
- 3.0.0 — 2020-03-06
- 2.0.3 — 2019-12-29
- 2.0.2 — 2019-11-02
- 2.0.1 — 2019-08-25
- 2.0.0 — 2019-08-09
- 1.0.1 — 2019-02-20
- 1.0.0 — 2019-02-03
- 0.1.0 — 2019-02-02
- 0.0.1 — 2019-02-02
## README
Istanbul code coverage loader for Webpack
==============================================
[](https://github.com/JS-DevTools/coverage-istanbul-loader/actions)
[](https://github.com/JS-DevTools/coverage-istanbul-loader/actions)
[](https://coveralls.io/github/JS-DevTools/coverage-istanbul-loader?branch=master)
[](https://david-dm.org/JS-DevTools/coverage-istanbul-loader)
[](https://www.npmjs.com/package/@jsdevtools/coverage-istanbul-loader)
[](LICENSE)
[](https://plant.treeware.earth/JS-DevTools/coverage-istanbul-loader)
This is a [Webpack loader](https://webpack.js.org/loaders/) that uses [Istanbul](https://istanbul.js.org/) to add code coverage instrumentation to your code. This is especially useful for in-browser testing, in a tool like [Karma](https://karma-runner.github.io/3.0/index.html), where you can use [karma-coverage-istanbul-reporter](https://github.com/mattlewis92/karma-coverage-istanbul-reporter) to output code coverage data in a variety of formats that are supported by services like [Coveralls](https://coveralls.io/) or [Codacy](https://www.codacy.com/).
Coverage Istanbul Loader is based on [Istanbul Instrumenter Loader](https://github.com/webpack-contrib/istanbul-instrumenter-loader), but uses a newer version of the [Istanbul API](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-lib-instrument) and has better support for source maps.
Usage
--------------------------
See [the examples folder](examples) for usage examples for various use cases.
- **["hello, world" example](examples/hello-world)**
This is the most simplistic example. It just uses coverage-istanbul-loader with its default options to produce an output bundle that contains code coverage instrumentation.
- **[TypeScript example](examples/typescript)**
This example demonstrates using coverage-istanbul-loader with transpiled code. It correctly maps the instrumented JavaScript code back to the original TypeScript source code.
- **[Karma example](examples/karma)**
This example demonstrates using coverage-istanbul-loader with [Karma](https://karma-runner.github.io/3.0/index.html) and [karma-coverage-istanbul-reporter](https://github.com/mattlewis92/karma-coverage-istanbul-reporter) to produce code coverage reports for browser tests.
- **[Example with options](examples/options)**
This example demonstrates passing options to coverage-istanbul-loader. The options are passed-on to [istanbul-lib-instrument](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-lib-instrument), so [all the same options](https://github.com/istanbuljs/istanbuljs/blob/25509c7ff31f114e7036a940ed799d6d0548b706/packages/istanbul-lib-instrument/src/instrumenter.js#L11-L33) are supported.
Contributing
--------------------------
Contributions, enhancements, and bug-fixes are welcome! [Open an issue](https://github.com/JS-DevTools/coverage-istanbul-loader/issues) on GitHub and [submit a pull request](https://github.com/JS-DevTools/coverage-istanbul-loader/pulls).
#### Building/Testing
To build/test the project locally on your computer:
1. __Clone this repo__
`git clone https://github.com/JS-DevTools/coverage-istanbul-loader.git`
2. __Install dependencies__
`npm install`
3. __Build the code__
`npm run build`
4. __Run the tests__
`npm test`
License
--------------------------
coverage-istanbul-loader is 100% free and open-source, under the [MIT license](LICENSE). Use it however you want.
This package is [Treeware](http://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/JS-DevTools/coverage-istanbul-loader) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
Big Thanks To
--------------------------
Thanks to these awesome companies for their support of Open Source developers ❤
[](https://travis-ci.com)
[](https://saucelabs.com)
[](https://coveralls.io)
---
_Source: https://npm.io/package/coverage-istanbul-loader · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._