Comentários inline de ignore

Para exceções bem delimitadas onde a regra é certa no geral mas não naquele trecho. Comentários sobrepõem arquivo de config.

Comentários // e /* */, começando com uma das palavras-chave abaixo.

oxlint-disable

Desliga uma ou mais regras até o fim do arquivo ou até reabilitar.

// Desliga todas as regras até o fim do arquivo
/* oxlint-disable */

// Desliga uma regra neste arquivo
/* oxlint-disable no-console */

// Várias regras
/* oxlint-disable no-console, typescript/no-floating-promises */

oxlint-enable

Religa regras até o fim ou até desligar de novo.

/* oxlint-enable no-console */

/* oxlint-enable no-console, no-alert */

oxlint-disable-line

Desliga na linha atual.

console.log("Hello, world!"); // oxlint-disable-line no-console

console.log(x++); // oxlint-disable-line no-console, no-plusplus

oxlint-disable-next-line

Desliga na próxima linha apenas.

// oxlint-disable-next-line no-console
console.log("Hello, world!"); // ok por causa do comentário acima
console.log(x++); // não coberto — o comentário valia só para a linha seguinte

// oxlint-disable-next-line no-console, no-plusplus
console.log("Hello, world!"); // ok

Compatibilidade ESLint

Também funciona com eslint em vez de oxlint: /* eslint-disable */, // eslint-disable-next-line etc.

Preferível usar oxlint-*. Formato eslint-* ajuda na migração quando a regra ainda não existe no Oxlint.

Opções de regra pelo comentário

Comentários só ligam/desligam regra — não mudam opções; opções ficam na config.

Reportar comentários de ignore não usados

Por padrão está desligado. Ligado, o Oxlint avisa quando um oxlint-disable-line não era necessário.

oxlint --report-unused-disable-directives

Severidade:

oxlint --report-unused-disable-directives-severity error

Use apenas uma dessas por vez.

Também na config:

.oxlintrc.json

{
  "$schema": "./node_modules/oxlint/configuration_schema.json",
  "options": {
    "reportUnusedDisableDirectives": "error", // ou "off" ou "warn"
  },
}

oxlint.config.ts

import { defineConfig } from "oxlint";

export default defineConfig({
  options: {
    reportUnusedDisableDirectives: "error", // ou "off" ou "warn"
  },
});