prettier-oxc-parser

Use oxc as a Prettier parser for JavaScript and TypeScript.

Requires Prettier >= 3.5.3

Installation

$ npm install -D prettier-oxc-parser
$ yarn add -D prettier-oxc-parser
$ pnpm install -D prettier-oxc-parser
$ bun add -D prettier-oxc-parser

Add the plugin to your Prettier config:

{
  "plugins": ["prettier-oxc-parser"]
}

Why?

oxc is a fast, really fast. And with the addition of raw transfer, the cost of passing the AST from Rust to JavaScript is close to 0. Raw transfer is only available in Node >= 22.

While Prettier with this plugin is far from the performances of pure native formatters like Biome, it give a significant performance improvement for large TS projects while keeping one tool to format all files types.

Benchmark

For full benchmark results see benchmark/report.md or run it yourself with bun benchmark.

Keep in mind that the timing are for "parse + format". When using oxc as a parser, ~90% of the time is spent of the format part.

An interesting thing is that you can get a part of the performance boost for TS files by using babel-ts via overrides.

Averages when running on Apple M1 Pro with node 23.11.

JS(X)

TS(X)

Caveats

Flow inside .js files via @flow pragma is not supported.

Few remaining AST issues, which are prioritized by the oxc team, will make updates to your code if you use decorators in JS files oxc#10921 or /** @type {number} */ (parent[prop]) = 1 oxc#10929.

Some subtitle differences can appear in JS files and are inconsistencies in Prettier that will be fixed in the next release of Prettier:

• Line breaks for multi-assginement statements prettier#17437
• Comments in if/else blocks without brackets prettier#17449
• Line breaks for optional call statements prettier#17457