Istanbul
istanbul.js.org
- Free plan
- API
What Istanbul is
Istanbul is an open-source JavaScript and TypeScript code-coverage tool. It instruments ES5 and ES2015+ JavaScript so teams can see how tests exercise statements, lines, functions, and branches. Reports can be produced as text, HTML, or lcov output, and coverage gates are supported. The nyc command-line interface can instrument subprocesses and works with JavaScript testing frameworks including tap, mocha, and AVA. Listed integrations include nyc, c8, Jest, and node-tap; c8 uses Istanbul reports to display V8 coverage. The quick start installs nyc as a development dependency and runs it before a mocha test command. Documentation covers source instrumentation, process-tree information, reports from a __coverage__ object, and alternative reporters. Source-mapped coverage is listed for Babel and TypeScript projects, and reporters can be built in or supplied through an npm package. Istanbul uses the Revised BSD License. The project does not provide pull-request annotations.
Who it suits
Istanbul suits JavaScript and TypeScript teams that need coverage measurements, report formats, and workflow gates. It is useful for projects using the listed test runners or nyc integrations.
Good to know, and what to watch
- Measures line, statement, function, and branch coverage
- Supports ES5 and ES2015+ JavaScript
- Outputs text, HTML, and lcov reports
- Works with several JavaScript test frameworks
- Supports coverage gates
- No pull-request annotations
- Setup uses command-line development dependencies
- Coverage tooling centers on JavaScript and TypeScript
The verdict
Istanbul provides open-source coverage instrumentation and reporting across common JavaScript workflows. Choose it when coverage categories, report formats, and gates matter more than pull-request annotations.
What the maker publishes
- Advanced features
- Advanced documentation links to source instrumentation, process tree information, reports from a __coverage__ object and alternative reporters. source
- CLI use
- The quick start installs nyc as a development dependency and shows running it before mocha in a test script. source
- Configurable reports
- The nyc README says reporters can be built in or supplied by an npm package, and defaults to text output. source
- ES2015+ support
- The site lists first-class ES6/ES2015+ support through babel-plugin-istanbul. source
- ES6 support
- The site lists first class ES6/ES2015+ support through babel-plugin-istanbul. source
- Integrations
- Listed integrations are nyc, c8, Jest and node-tap; c8 uses Istanbul reports to display V8 coverage. source
- JavaScript support
- The site says Istanbul instruments ES5 and ES2015+ JavaScript. source
- License
- The Istanbul site identifies the project as using the Revised BSD License. source
- License
- The Istanbul site identifies its license as Revised BSD License. source
- Open source project
- The Istanbul GitHub organization describes Istanbul as a JavaScript code coverage tool that computes statement, line, function and branch coverage. source
- Other framework support
- The homepage says nyc works with testing frameworks including tap, mocha, and AVA. source
- Purpose
- Istanbul instruments JavaScript code with line counters to show how unit tests exercise a codebase. source
- Purpose
- Istanbul instruments JavaScript code with line counters to track how well unit tests exercise a codebase. source
- Reports
- Istanbul provides reporters with terminal and HTML output. source
- Reports
- Istanbul provides reporters with terminal and HTML output. source
- Setup
- The quick start installs nyc as a development dependency with npm and shows using it before a mocha test command. source
- Source mapped coverage
- The nyc README lists source mapped coverage for Babel and TypeScript projects. source
- Subprocesses
- The site says the nyc command-line interface supports instrumenting subprocesses. source
- Subprocesses
- The site lists support for instrumenting subprocesses through the nyc command line interface. source
- Support
- The contributing page directs users to report bugs by opening an issue in the appropriate GitHub repository. source
- Supported JavaScript
- The site says Istanbul instruments ES5 and ES2015+ JavaScript. source
- Test frameworks
- The nyc client works with most JavaScript testing frameworks, and the site names tap, mocha and AVA as examples. source
- Testing integrations
- The integrations page lists nyc, c8, Jest, and node-tap as tools that integrate with Istanbul APIs for JavaScript test coverage. source
- Tutorials
- The tutorials cover AVA, ES2015+, Jest, mocha, Intern, IoT.js, tap and TypeScript. source
Checked against the maker's pages on 11 Oct 2026.