← Back to rules

react/invariant Restriction

What it does

Reports internal React Compiler invariant violations. These indicate a bug in the compiler itself, not in your code — consider reporting them to the oxc or React teams.

Powered by the React Compiler, which runs once per file and is shared with the other React Compiler rules. Port of react-hooks/invariant.

Why is this bad?

An invariant violation means the compiler's internal state is inconsistent; the affected function is skipped rather than optimized.

How to use

To enable this rule using the config file or in the CLI, you can use:

Config (.oxlintrc.json)

{
  "plugins": ["react"],
  "rules": {
    "react/invariant": "error"
  }
}

Config (oxlint.config.ts)

import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["react"],
  rules: {
    "react/invariant": "error",
  },
});

CLI

oxlint --deny react/invariant --react-plugin

Version

This rule was added in vnext.

References

• Rule Source
• Upstream rule docs
• Open rule in Oxc Playground