Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Istanbul

istanbul.js.org

  • Free plan
  • API
6.9 Club score Visit istanbul.js.org

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.