Skip to content

Rules

The standard has 200 rules. Names are ESLint’s names; use them in rules in a policy. Run pawl explain <rule> to see a rule’s level in your repo.

On top of these, pawl turns on Biome’s own recommended rules for each technology a project uses: react, next, react-native, qwik, solid, vue, svelte, astro, tailwind, tanstack-query, drizzle, playwright, turbo.

A guardrail rule guards against a mistake coding agents make often. A rule that is unstable in the engine that enforces it is off unless the policy is strict. A rule with no Biome rule is enforced by Oxlint, or by ESLint with the plugin installed.

Rule What it checks Level Biome rule Notes
no-debugger No debugger statements. error suspicious/noDebugger
no-unused-vars No unused variables. error correctness/noUnusedVariables
no-empty No empty blocks. warn (error when strict) suspicious/noEmptyBlockStatements guardrail
no-eval No eval(). error security/noGlobalEval
no-with No with statements. error suspicious/noWith
use-isnan Use Number.isNaN() to test for NaN. error correctness/useIsNan
valid-typeof Compare typeof against valid strings. warn correctness/useValidTypeof
no-unreachable No unreachable code. error correctness/noUnreachable
no-sparse-arrays No sparse arrays. error suspicious/noSparseArray
no-dupe-keys No duplicate object keys. error suspicious/noDuplicateObjectKeys
no-duplicate-case No duplicate case labels. error suspicious/noDuplicateCase
no-cond-assign No assignment inside expressions. error suspicious/noAssignInExpressions
no-empty-pattern No empty destructuring patterns. error correctness/noEmptyPattern
no-async-promise-executor No async Promise executors. error suspicious/noAsyncPromiseExecutor
no-unused-expressions No unused expressions. error suspicious/noUnusedExpressions
no-unsafe-finally No control flow in finally blocks. error correctness/noUnsafeFinally
no-constant-condition No constant conditions. warn correctness/noConstantCondition
no-redeclare No redeclared variables. error suspicious/noRedeclare
no-prototype-builtins No direct calls to Object.prototype methods. error suspicious/noPrototypeBuiltins
no-fallthrough No fallthrough between switch cases. warn suspicious/noFallthroughSwitchClause
no-self-compare No comparing a value with itself. error suspicious/noSelfCompare
default-case-last Put the default case last. error suspicious/useDefaultSwitchClauseLast
no-useless-catch No catch blocks that only rethrow. error complexity/noUselessCatch guardrail
no-var Use let or const. error suspicious/noVar
prefer-const Use const for values that are never reassigned. error style/useConst
eqeqeq Use === and !==. error suspicious/noDoubleEquals
no-console No console calls in shipped code. warn suspicious/noConsole
no-alert No alert, confirm or prompt. error suspicious/noAlert
no-param-reassign No reassigning function parameters. warn style/noParameterAssign
no-else-return No else after a return. warn style/noUselessElse
no-useless-constructor No empty or pass-through constructors. warn complexity/noUselessConstructor
no-useless-rename No renaming to the same name. error complexity/noUselessRename
no-useless-escape No unnecessary escapes. warn complexity/noUselessEscapeInRegex
no-useless-concat No concatenating two literals. warn complexity/noUselessStringConcat
no-unneeded-ternary No ternary where a simpler form exists. warn complexity/noUselessTernary
no-nested-ternary No nested ternaries. warn style/noNestedTernary
no-undef-init No initializing to undefined. warn complexity/noUselessUndefinedInitialization
prefer-template Use template literals over string concatenation. warn style/useTemplate
prefer-arrow-callback Use arrow functions for callbacks. warn complexity/useArrowFunction
prefer-exponentiation-operator Use ** over Math.pow(). warn style/useExponentiationOperator
operator-assignment Use shorthand assignment operators. warn style/useShorthandAssign
default-param-last Put default parameters last. warn style/useDefaultParameterLast
yoda Put the variable first in comparisons. warn style/noYodaExpression
no-shadow No shadowing a variable from an outer scope. off (warn when strict) suspicious/noShadow
no-await-in-loop No await inside loops. off (warn when strict) performance/noAwaitInLoops
require-await No async functions without await. off (warn when strict) suspicious/useAwait
array-callback-return Enforce consistent return values in iterable callbacks. warn suspicious/useIterableCallbackReturn
arrow-body-style Enforce consistent arrow function bodies. warn style/useConsistentArrowReturn
func-style Enforce consistent use of function declarations or expressions assigned to variables. off (warn when strict) nursery/useConsistentFunctionStyle unstable in Biome
max-depth Enforce a maximum depth that blocks can be nested. off (warn when strict) nursery/noExcessiveNestedBlocks unstable in Biome
no-constant-binary-expression Disallow expressions where the operation doesn’t affect the value. warn suspicious/noConstantBinaryExpressions
no-new Disallow new operators outside of assignments or comparisons. warn correctness/noUnusedInstantiation
no-unassigned-vars Disallow let or var variables that are read but never assigned. error suspicious/noUnassignedVariables
no-undef Prevents the usage of variables that haven’t been declared inside the document. warn correctness/noUndeclaredVariables
no-use-before-define Disallow the use of variables, function parameters, classes, and enums before their declaration. warn correctness/noInvalidUseBeforeDeclaration
no-useless-assignment Disallow assignments whose value is never read. off (error when strict) nursery/noUselessAssignment unstable in Biome
no-useless-return Disallow redundant return statements. warn complexity/noUselessReturn
no-void Disallow the use of void operators, which is not a familiar operator. warn complexity/noVoid
prefer-promise-reject-errors Require Error objects as Promise rejection reasons. off (warn when strict) nursery/usePromiseRejectErrors unstable in Biome
prefer-regex-literals Enforce the use of the regular expression literals instead of the RegExp constructor if possible. warn complexity/useRegexLiterals
preserve-caught-error Enforce that new Error() is thrown with the original error as cause. error style/useErrorCause
unicorn/catch-error-name Require a specific name for caught errors. off (warn when strict) nursery/useCatchErrorName unstable in Biome
unicorn/no-lonely-if Enforce using single if instead of nested if clauses. warn style/useCollapsedIf
unicorn/no-negated-condition Disallow negation in the condition of an if statement if it has an else clause. warn style/noNegationElse
unicorn/no-useless-spread Disallow spread syntax that has no effect. off (warn when strict) nursery/noUselessSpread unstable in Biome
unicorn/no-useless-undefined Disallow the use of useless undefined. warn complexity/noUselessUndefined
unicorn/prefer-array-flat-map Promotes the use of .flatMap() when map().flat() are used together. warn complexity/useFlatMap
unicorn/prefer-array-some Prefer Array.prototype.some() over verbose existence checks. warn complexity/useArraySome
unicorn/prefer-includes Prefer Array#includes() over Array#indexOf(), Array#lastIndexOf(), and Array#some() when checking for existence or non-existence. off (warn when strict) nursery/useIncludes unstable in Biome
unicorn/prefer-number-properties Use the Number properties instead of global ones. warn style/useNumberNamespace
unicorn/prefer-string-slice Enforce the use of String.slice() over String.substr() and String.substring(). warn style/noSubstr
unicorn/prefer-string-trim-start-end Enforce the use of String.trimStart() and String.trimEnd() over String.trimLeft() and String.trimRight(). warn style/useTrimStartEnd
unicorn/throw-new-error Require new when throwing an error. warn style/useThrowNewError
unicorn/prefer-optional-catch-binding Leave out a catch binding that is never used. warn complexity/noUselessCatchBinding
unicorn/prefer-array-find Use .find() over .filter()[0]. warn complexity/useArrayFind
unicorn/prefer-string-starts-ends-with Use startsWith() and endsWith() over a regular expression or a slice comparison. off (warn when strict) nursery/useStringStartsEndsWith unstable in Biome
unicorn/consistent-function-scoping Move a function to the outermost scope it can live in. warn Oxlint or an ESLint plugin
unicorn/no-abusive-eslint-disable No disable comments that name no rule. warn Oxlint or an ESLint plugin
unicorn/no-typeof-undefined Compare with undefined directly, not with typeof x === ‘undefined’. warn Oxlint or an ESLint plugin
unicorn/prefer-array-flat Use .flat() over flattening an array by hand. warn Oxlint or an ESLint plugin
unicorn/prefer-logical-operator-over-ternary Use ?? or || over a ternary that repeats its condition. warn Oxlint or an ESLint plugin
unicorn/prefer-spread Use spread over Array.from(), concat(), slice() and split(“”) for copies. warn Oxlint or an ESLint plugin
unicorn/prefer-string-replace-all Use replaceAll() over replace() with a global regular expression. warn Oxlint or an ESLint plugin
unicorn/prefer-ternary Use a ternary over an if-else that only assigns or returns. warn Oxlint or an ESLint plugin
promise/always-return Return a value or throw in every then() callback. warn Oxlint or an ESLint plugin
promise/catch-or-return Handle the rejection of a promise with catch(), or return the promise. warn Oxlint or an ESLint plugin
Rule What it checks Level Biome rule Notes
@typescript-eslint/no-explicit-any No explicit any. warn (error when strict) suspicious/noExplicitAny guardrail
@typescript-eslint/no-non-null-assertion No non-null assertions. warn (error when strict) style/noNonNullAssertion guardrail
@typescript-eslint/ban-ts-comment No @ts-ignore. warn (error when strict) suspicious/noTsIgnore guardrail
@typescript-eslint/consistent-type-imports Use import type for types. warn (error when strict) style/useImportType
@typescript-eslint/array-type Use one array type syntax. warn style/useConsistentArrayType
@typescript-eslint/no-namespace No TypeScript namespaces. error style/noNamespace
@typescript-eslint/no-inferrable-types No type annotations the compiler infers. warn style/noInferrableTypes
@typescript-eslint/prefer-as-const Use as const over a literal type assertion. error style/useAsConstAssertion
@typescript-eslint/no-unsafe-declaration-merging No merging a class with an interface. error suspicious/noUnsafeDeclarationMerging
@typescript-eslint/no-extra-non-null-assertion No repeated non-null assertions. error suspicious/noExtraNonNullAssertion
@typescript-eslint/no-misused-new No misleading new or constructor signatures. error suspicious/noMisleadingInstantiator
@typescript-eslint/prefer-namespace-keyword Use namespace over module. error suspicious/useNamespaceKeyword
@typescript-eslint/prefer-optional-chain Use optional chaining. warn complexity/useOptionalChain
@typescript-eslint/no-floating-promises No unhandled promises. off (error when strict) nursery/noFloatingPromises guardrail, unstable in Biome
@typescript-eslint/no-misused-promises No promises where a plain value is expected. off (error when strict) nursery/noMisusedPromises unstable in Biome
@typescript-eslint/consistent-type-exports Promotes the use of export type for types. warn style/useExportType
@typescript-eslint/no-deprecated Restrict imports of deprecated exports. warn suspicious/noDeprecatedImports
@typescript-eslint/no-duplicate-enum-values Disallow duplicate enum member values. warn suspicious/noDuplicateEnumValues
@typescript-eslint/no-dynamic-delete Disallow using the delete operator with a property name that is computed at runtime. off (warn when strict) nursery/noDynamicDelete unstable in Biome
@typescript-eslint/no-empty-object-type Disallow primitive type aliases and misleading types. warn complexity/noBannedTypes
@typescript-eslint/no-invalid-void-type Disallow void type outside of generic or return types. warn suspicious/noConfusingVoidType
@typescript-eslint/no-unnecessary-type-assertion Disallow type assertions that don’t change the type of an expression. off (warn when strict) nursery/noUselessTypeAssertion unstable in Biome
@typescript-eslint/no-unsafe-return Disallow returning a value typed as any from a function. off (error when strict) nursery/noUnsafeReturn unstable in Biome
@typescript-eslint/no-var-requires Disallow use of CommonJs module system in favor of ESM style imports. warn style/noCommonJs
@typescript-eslint/prefer-for-of Prefer using for…of loops over standard for loops where possible. warn style/useForOf
@typescript-eslint/prefer-nullish-coalescing Enforce using the nullish coalescing operator (??) instead of logical or (||). off (warn when strict) nursery/useNullishCoalescing unstable in Biome
@typescript-eslint/await-thenable No awaiting a value that is not a promise. off (error when strict) nursery/useAwaitThenable unstable in Biome

Applied only where React is a dependency.

Rule What it checks Level Biome rule Notes
react-hooks/rules-of-hooks Call hooks at the top level. error correctness/useHookAtTopLevel
react-hooks/exhaustive-deps List every dependency of a hook. warn correctness/useExhaustiveDependencies
react/jsx-key Give list items a key. error correctness/useJsxKeyInIterable
react/no-array-index-key No array index as a key. warn suspicious/noArrayIndexKey
react/no-danger No dangerouslySetInnerHTML. warn security/noDangerouslySetInnerHtml
react/no-children-prop No children passed as a prop. error correctness/noChildrenProp
react/jsx-no-duplicate-props No duplicate JSX props. error suspicious/noDuplicateJsxProps
react/jsx-no-comment-textnodes No comments rendered as text. error suspicious/noCommentText
react/jsx-no-useless-fragment No unnecessary fragments. warn complexity/noUselessFragments
react/self-closing-comp Self-close elements without children. warn style/useSelfClosingElements
@eslint-react/dom-no-missing-button-type Require an explicit, valid type on every &lt;button>. warn a11y/useButtonType
@eslint-react/dom-no-unsafe-target-blank Disallow target=“_blank” attribute without rel=“noopener”. warn security/noBlankTarget
react-refresh/only-export-components Enforce declaring components only within modules that export React Components exclusively. warn style/useComponentExportOnlyModules
@eslint-react/no-unstable-default-props No object or array literals as default props, which make a new value on every render. off (warn when strict) nursery/noReactObjectTypeAsDefaultProp unstable in Biome
jsx-a11y/alt-text Give images and image-like elements alt text. error a11y/useAltText
jsx-a11y/anchor-has-content Give anchors content. error a11y/useAnchorContent
jsx-a11y/anchor-is-valid Require anchors to have a valid href. error Oxlint or an ESLint plugin
jsx-a11y/aria-activedescendant-has-tabindex Make elements with aria-activedescendant tabbable. error a11y/useAriaActivedescendantWithTabindex
jsx-a11y/aria-props Use only valid aria-* attributes. error a11y/useValidAriaProps
jsx-a11y/aria-proptypes Give aria-* attributes valid values. error a11y/useValidAriaValues
jsx-a11y/aria-role Use only valid ARIA roles. error a11y/useValidAriaRole
jsx-a11y/aria-unsupported-elements No ARIA on elements that do not support it. error a11y/noAriaUnsupportedElements
jsx-a11y/autocomplete-valid Use valid autocomplete values. error a11y/useValidAutocomplete
jsx-a11y/click-events-have-key-events Pair click handlers with a keyboard handler. error a11y/useKeyWithClickEvents
jsx-a11y/heading-has-content Give headings content. error a11y/useHeadingContent
jsx-a11y/html-has-lang Give the html element a lang attribute. error a11y/useHtmlLang
jsx-a11y/iframe-has-title Give iframes a title. error a11y/useIframeTitle
jsx-a11y/img-redundant-alt No “image” or “photo” in alt text. error a11y/noRedundantAlt
jsx-a11y/interactive-supports-focus Make elements with interactive handlers focusable. error a11y/useFocusableInteractive
jsx-a11y/label-has-associated-control Tie every label to a control. error a11y/noLabelWithoutControl
jsx-a11y/media-has-caption Give audio and video captions. error a11y/useMediaCaption
jsx-a11y/mouse-events-have-key-events Pair mouse over and out with focus and blur. error a11y/useKeyWithMouseEvents
jsx-a11y/no-access-key No accessKey attributes. error a11y/noAccessKey
jsx-a11y/no-autofocus No autoFocus. error a11y/noAutofocus
jsx-a11y/no-distracting-elements No marquee or blink elements. error a11y/noDistractingElements
jsx-a11y/no-interactive-element-to-noninteractive-role No non-interactive roles on interactive elements. error a11y/noInteractiveElementToNoninteractiveRole
jsx-a11y/no-noninteractive-element-interactions No event handlers on non-interactive elements. error a11y/noNoninteractiveElementInteractions
jsx-a11y/no-noninteractive-element-to-interactive-role No interactive roles on non-interactive elements. error a11y/noNoninteractiveElementToInteractiveRole
jsx-a11y/no-noninteractive-tabindex No tabIndex on non-interactive elements. error a11y/noNoninteractiveTabindex
jsx-a11y/no-redundant-roles No roles an element already has. error a11y/noRedundantRoles
jsx-a11y/no-static-element-interactions No event handlers on static elements such as div. error a11y/noStaticElementInteractions
jsx-a11y/role-has-required-aria-props Give each role the ARIA attributes it requires. error a11y/useAriaPropsForRole
jsx-a11y/role-supports-aria-props Use only ARIA attributes the role supports. error a11y/useAriaPropsSupportedByRole
jsx-a11y/scope Use scope only on th elements. error a11y/noHeaderScope
jsx-a11y/tabindex-no-positive No positive tabIndex values. error a11y/noPositiveTabindex

Applied only where Qwik is a dependency.

Rule What it checks Level Biome rule Notes
qwik/jsx-a Require anchors to provide a real navigation destination. warn a11y/useValidAnchor
qwik/jsx-img Enforces that &lt;img> elements have both width and height attributes. warn correctness/useImageSize
qwik/jsx-no-script-url Disallow javascript: URLs in HTML. warn security/noScriptUrl
qwik/loader-location Enforce that Qwik loader functions are declared in the correct location. warn correctness/useQwikLoaderLocation
qwik/no-react-props Prevents React-specific JSX properties from being used. error suspicious/noReactSpecificProps
qwik/no-use-visible-task Disallow useVisibleTask$() functions in Qwik components. warn correctness/noQwikUseVisibleTask
qwik/prefer-classlist Prefer using the class prop as a classlist over the classnames helper. warn correctness/useQwikClasslist
qwik/use-method-usage Disallow use* hooks outside of component$ or other use* hooks in Qwik applications. error correctness/useQwikMethodUsage
qwik/valid-lexical-scope Disallow unserializable expressions in Qwik dollar ($) scopes. error correctness/useQwikValidLexicalScope

Applied only where Vue or Nuxt is a dependency.

Rule What it checks Level Biome rule Notes
vue/block-order Enforce the order of the top-level blocks in Vue components. off (warn when strict) nursery/useVueBlockOrder unstable in Biome
vue/multi-word-component-names Enforce multi-word component names in Vue components. warn style/useVueMultiWordComponentNames
vue/no-mutating-props Disallow changing the props of a Vue component. off (warn when strict) nursery/noVueMutatingProps unstable in Biome
vue/require-default-prop Require a default value for optional props in Vue components. off (warn when strict) nursery/useVueDefaultProp unstable in Biome
vue/require-prop-types Require a type for every prop of a Vue component. off (warn when strict) nursery/useVueTypedProps unstable in Biome
vue/component-definition-name-casing Write the name of a component definition in PascalCase. warn Oxlint or an ESLint plugin

Applied only where Svelte is a dependency.

Rule What it checks Level Biome rule Notes
svelte/no-at-html-tags Disallow the use of Svelte’s {@html} tag. off (warn when strict) nursery/noSvelteAtHtmlTags unstable in Biome
svelte/require-each-key Require keyed {#each} blocks in Svelte templates. off (warn when strict) nursery/useSvelteRequireEachKey unstable in Biome
Rule What it checks Level Biome rule Notes
unused-imports/no-unused-imports No unused imports. warn (error when strict) correctness/noUnusedImports
import/no-extraneous-dependencies No importing a package that package.json does not declare. error correctness/noUndeclaredDependencies guardrail
import/no-unresolved No imports that do not resolve. off (error when strict) correctness/noUnresolvedImports guardrail
import/no-cycle No import cycles. off (error when strict) suspicious/noImportCycles
import/first Enforce that all imports appear at the top of the module. error style/useImportsFirst
import/no-self-import Forbid a module from importing itself. off (error when strict) nursery/noSelfImport unstable in Biome
import/no-duplicates Import from a module in one statement, not several. warn Oxlint or an ESLint plugin
import/export No exporting the same name twice. off (warn when strict) unstable in Oxlint, Oxlint or an ESLint plugin
Rule What it checks Level Biome rule Notes
no-only-tests/no-only-tests No focused tests (.only). error suspicious/noFocusedTests guardrail
vitest/no-disabled-tests No skipped tests. warn (error when strict) suspicious/noSkippedTests guardrail
vitest/no-duplicate-hooks No duplicate test hooks. error suspicious/noDuplicateTestHooks
vitest/consistent-test-it Enforce consistent use of it or test for test functions. warn style/useConsistentTestIt
vitest/expect-expect Ensure that test functions contain at least one expect() or similar assertion. error suspicious/useExpect
vitest/max-nested-describe This rule enforces a maximum depth to nested describe() in test files. error complexity/noExcessiveNestedTestSuites
vitest/no-identical-title Disallow identical titles in test suites and test cases. error suspicious/noIdenticalTestTitle
vitest/prefer-to-be Use toBe() to compare primitive values. warn Oxlint or an ESLint plugin
vitest/prefer-to-have-length Use toHaveLength() to check a length. warn Oxlint or an ESLint plugin
vitest/valid-expect Call expect() with one value and a matcher. error Oxlint or an ESLint plugin
Rule What it checks Level Biome rule Notes
markdown/fenced-code-language Name the language of every fenced code block. off (error when strict) nursery/useFencedCodeLanguage unstable in Biome
markdown/heading-increment Raise heading levels one at a time. off (error when strict) nursery/useConsistentHeadingLevel unstable in Biome
yml/no-empty-sequence-entry No empty entries in a YAML list. off (error when strict) nursery/noYamlEmptySequenceEntries unstable in Biome

Applied only in a Turborepo.

Rule What it checks Level Biome rule Notes
turbo/no-undeclared-env-vars Disallow the use of undeclared environment variables. error suspicious/noUndeclaredEnvVars

Checked by pawl itself, on top of the engines.

Rule What it checks Level Biome rule Notes
pawl/format The file is not formatted to the standard. error
pawl/organize-imports Imports are not sorted. error
pawl/no-new-disable No new comments that switch a check off. error guardrail

MIT licensed. Made by santi020k.