# conventional-commits-filter

> Filter out reverted commits parsed by conventional-commits-parser.

Latest version **6.0.1** (published 2026-07-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install conventional-commits-filter
pnpm add conventional-commits-filter
yarn add conventional-commits-filter
bun add conventional-commits-filter
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 6.0.1 |
| Published | 2026-07-04 |
| First published | 2015-07-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 0 |
| Unpacked size | 15.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8511 |
| Author | Steve Mao |
| Maintainers | bcoe, oss-bot, dangreen, stevemao, tapppi |
| Keywords | filter, conventional, changelog, commits |

## Links

- npm: https://www.npmjs.com/package/conventional-commits-filter
- Repository: https://github.com/conventional-changelog/conventional-changelog
- Homepage: https://conventional-changelog.js.org/commits-filter/
- Issues: https://github.com/conventional-changelog/conventional-changelog/issues
- npm.io page: https://npm.io/package/conventional-commits-filter

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 6.0.1 (latest) — 2026-07-04
- 2.0.7 (next) — 2020-11-05
- 6.0.0 — 2026-06-26
- 5.0.0 — 2024-05-03
- 4.0.0 — 2023-08-27
- 3.0.0 — 2023-06-06
- 2.0.6 — 2020-05-08
- 2.0.2 — 2019-04-10
- 2.0.1 — 2018-11-01
- 2.0.0 — 2018-05-29
- 1.1.6 — 2018-03-22
- 1.1.5 — 2018-02-24
- 1.1.4 — 2018-02-20
- 1.1.3 — 2018-02-13
- 1.1.2 — 2018-02-13
- … 7 more at https://npm.io/package/conventional-commits-filter/versions

## README

# conventional-commits-filter

[![ESM-only package][package]][package-url]
[![NPM version][npm]][npm-url]
[![Node version][node]][node-url]
[![Dependencies status][deps]][deps-url]
[![Install size][size]][size-url]
[![Build status][build]][build-url]
[![Coverage status][coverage]][coverage-url]

[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
[package-url]: https://nodejs.org/api/esm.html

[npm]: https://img.shields.io/npm/v/conventional-commits-filter.svg
[npm-url]: https://npmjs.com/package/conventional-commits-filter

[node]: https://img.shields.io/node/v/conventional-commits-filter.svg
[node-url]: https://nodejs.org

[deps]: https://img.shields.io/librariesio/release/npm/conventional-commits-filter
[deps-url]: https://libraries.io/npm/conventional-commits-filter

[size]: https://packagephobia.com/badge?p=conventional-commits-filter
[size-url]: https://packagephobia.com/result?p=conventional-commits-filter

[build]: https://img.shields.io/github/actions/workflow/status/conventional-changelog/conventional-changelog/tests.yaml?branch=master
[build-url]: https://github.com/conventional-changelog/conventional-changelog/actions

[coverage]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master

Filter out reverted commits parsed by conventional-commits-parser.

## Install

```bash
# pnpm
pnpm add conventional-commits-filter
# yarn
yarn add conventional-commits-filter
# npm
npm i conventional-commits-filter
```

## Usage

```js
import { filterRevertedCommitsSync } from 'conventional-commits-filter'

// commits parsed by conventional-commits-parser,
// where one commit reverts another
const commits = [/* ... */]

for (const commit of filterRevertedCommitsSync(commits)) {
  console.log(commit) // reverted commits are filtered out
}
```

## Documentation

For streams and async iterables helpers and API reference, visit the [documentation website](https://conventional-changelog.js.org/commits-filter/).

## License

MIT © [Steve Mao](https://github.com/stevemao)

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