Skip to content

인라인 무시 주석

무시 주석은 일반적으로 올바른 규칙이지만 코드의 작은, 명확한 범위 내에서는 무시해야 할 특수한 경우에 대한 예외 경로를 제공합니다. 인라인 주석은 구성 파일보다 우선됩니다.

Oxlint은 줄 주석(//)과 블록 주석(/* */)을 지원합니다. 주석은 아래의 키워드 중 하나로 시작해야 합니다.

oxlint-disable

파일의 끝까지 또는 다시 활성화될 때까지 하나 이상의 규칙을 비활성화합니다.

js
// 파일 나머지 부분에서 모든 Oxlint 규칙을 비활성화
/* oxlint-disable */

// 이 파일 내에서 단일 규칙을 비활성화
/* oxlint-disable no-console */

// 이 파일 내에서 여러 규칙을 비활성화
/* oxlint-disable no-console, typescript/no-floating-promises */

oxlint-enable

파일의 끝까지 또는 다시 비활성화될 때까지 하나 이상의 규칙을 활성화합니다.

js
/* oxlint-enable no-console */

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

oxlint-disable-line

현재 줄에서 하나 이상의 규칙을 비활성화합니다.

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

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

oxlint-disable-next-line

다음 줄에서 하나 이상의 규칙을 비활성화하고, 이후 줄에 대해 다시 활성화합니다.

js
// oxlint-disable-next-line no-console
console.log("Hello, world!"); // 이전 주석 덕분에 허용됨
console.log(x++); // 이전 주석은 이전 줄에만 적용되었기 때문에 허용되지 않음

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

ESLint 호환성

기존 ESLint 코드베이스와의 호환성을 위해 oxlint 대신 eslint로 바꾼 동일한 키워드도 지원됩니다. 예를 들어 /* eslint-disable */// eslint-disable-next-line입니다.

oxlint-* 형식을 권장합니다. eslint-* 형식은 아직 Oxlint가 지원하지 않는 규칙에 대한 마이그레이션 중에 유용합니다.

규칙 옵션은 인라인에서 변경할 수 없습니다

무시 주석은 규칙을 활성화하거나 비활성화할 수 있지만, 규칙 옵션을 변경할 수는 없습니다. 규칙 옵션은 구성 파일에 포함되어야 합니다.

무사용 무시 주석 보고

무사용 무시 주석 보고는 기본적으로 비활성화되어 있습니다. 활성화되면, 해당 줄에 진단 정보가 보고되지 않을 경우 // oxlint-disable-line 같은 주석을 보고합니다.

보고 활성화:

bash
oxlint --report-unused-disable-directives

중요도 지정:

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

이 옵션은 동시에 하나만 사용할 수 있습니다.