@browser-compat/runtime

Small browser runtime for the Browser Compat toolkit.

Browser Compat helps applications generate browser compatibility manifests from their own browserslist targets, check those manifests in CI, and use the result at runtime through small framework adapters.

What This Package Does

@browser-compat/runtime reads a compatibility manifest, validates it, detects declared features, injects compat-* classes, and can report the resulting state asynchronously.

Use this package directly when your application does not use React. React apps usually use @browser-compat/react, which depends on this package.

Installation

npm install @browser-compat/runtime

Usage

import { initCompatRuntime } from "@browser-compat/runtime";
import manifest from "../generated/browser-compat.manifest.json";

const state = await initCompatRuntime({ manifest });

if (state.decision.status === "unsupported") {
  // Render an unsupported-browser fallback.
}

You can also load the manifest by URL:

const state = await initCompatRuntime({
  manifestUrl: "/browser-compat.manifest.json"
});

Related Packages

• @browser-compat/cli generates manifests and reports.
• @browser-compat/react exposes runtime state to React apps.
• @browser-compat/core provides shared manifest types and validation.

Full documentation: https://github.com/relaxcloud-cn/browser-compat-package