biome/packages/@biomejs/js-api

Biome JavaScript Bindings

Official JavaScript bindings for Biome

Warning

The API is currently in alpha. It is not yet ready for production use. We appreciate your support and feedback as we work to make it ready for everyone.

Installation

npm i @biomejs/js-api
npm i @biomejs/wasm-<dist>

You need to install one of the @biomejs/wasm-* package as a peer dependency for this package to work correctly, out of the following distributions:

• @biomejs/wasm-bundler: Install this package if you're using a bundler that supports importing *.wasm files directly
• @biomejs/wasm-nodejs: Install this package if you're using Node.js to load the WebAssembly bundle use the fs API
• @biomejs/wasm-web: Install this package if you're targeting the web platform to load the WASM bundle using the fetch API

Usage

import { Biome } from "@biomejs/js-api/nodejs";
// Or:
// import { Biome, Distribution } from "@biomejs/js-api/bundler";
// import { Biome, Distribution } from "@biomejs/js-api/web";

const biome = new Biome();
const { projectKey } = biome.openProject("path/to/project/dir");

// Optionally apply a Biome configuration (instead of biome.json)
biome.applyConfiguration(projectKey, {...});

const formatted = biome.formatContent(
  projectKey,
  "function f   (a, b) { return a == b; }",
  {
    filePath: "example.js",
  },
);

console.log("Formatted content: ", formatted.content);

const result = biome.lintContent(projectKey, formatted.content, {
  filePath: "example.js",
});

const html = biome.printDiagnostics(result.diagnostics, {
  filePath: "example.js",
  fileSource: formatted.content,
});

console.log("Lint diagnostics: ", html);

Philosophy

The project philosophy can be found on our website.

Community

Contribution and development instructions can be found in Contributing.

Additional project coordination and real-time discussion happens on our Discord server. Remember that all activity on the Discord server is still moderated and will be strictly enforced under the project's Code of Conduct.