내장 플러그인
Oxlint는 많은 인기 있는 ESLint 플러그인 규칙 세트의 내장 구현을 포함하고 있습니다. recommended 구성에서 대부분의 규칙은 이미 구현되어 있으므로, 추가 설정 없이도 유용한 결과를 얻을 수 있습니다.
Oxlint는 ESLint와 호환되는 API를 사용하는 자바스크립트로 작성된 플러그인도 지원합니다. 자바스크립트 플러그인을 참고하세요.
Oxlint에서 플러그인이란?
플러그인은 이름이 지정된 규칙 그룹입니다. 플러그인을 활성화하면 해당 규칙들이 사용 가능해지며, 카테고리 플래그는 어떤 규칙이 활성화되고 어느 심각도로 작동할지를 제어합니다.
ESLint에서 마이그레이션하는 경우, 플러그인은 이미 알고 계신 생태계와 매핑되며, 예를 들어 import, react, jsx-a11y, jest, unicorn 등이 있습니다.
플러그인 활성화
강력히 권장되는 방법은 플러그인을 활성화하기 위해 구성 파일을 사용하는 것입니다. 이 방식은 프로젝트에서 다른 개발자들과 관리 및 공유하기 훨씬 더 쉬워집니다.
구성 파일에서 활성화
.oxlintrc.json 파일에서 plugins 필드를 사용하여 플러그인을 활성화할 수도 있습니다:
{
"plugins": ["import"]
}plugins를 설정하면 기본 플러그인 세트가 오버라이드됩니다. 이 목록에는 활성화하려는 모든 플러그인을 포함해야 합니다.
CLI를 통해 활성화
또한 --<플러그인 이름>-plugin CLI 플래그를 사용하여 플러그인을 활성화할 수 있습니다.
예시: import 플러그인 활성화
oxlint --import-plugin활성화 후, 카테고리 플래그가 어떤 것이 켜질지를 결정합니다.
예시: correctness 카테고리의 import 플러그인 규칙을 오류로, suspicious 카테고리의 규칙을 경고로 설정:
oxlint --import-plugin -D correctness -W suspiciouscorrectness 규칙은 기본적으로 활성화되어 있습니다.
팁: 전체 플러그인 플래그 목록을 보려면 oxlint --help를 실행하세요.
기본 플러그인 비활성화
구성 파일에서 기본 플러그인 비활성화
구성 파일에서 모든 기본 플러그인을 비활성화하려면 plugins를 빈 배열로 설정하세요:
{
"plugins": []
}이 설정은 모든 기본 플러그인을 비활성화하고, 기초 규칙 세트만 사용하게 됩니다.
CLI를 통해 기본 플러그인 비활성화
일부 플러그인은 기본적으로 활성화되어 있습니다. --disable-<플러그인 이름>-plugin을 사용하여 기본 플러그인을 비활성화할 수 있습니다.
예시: unicorn 비활성화
oxlint --disable-unicorn-plugin비활성화 가능한 것은 오직 기본 플러그인뿐입니다. 기본이 아닌 플러그인은 단순히 생략하면 됩니다.
지원되는 플러그인
다음 표는 내장 플러그인과 그 출처를 나열합니다.
| 플러그인 이름 | 기본 제공 여부 | 출처 |
|---|---|---|
eslint | 예 | ESLint 핵심 규칙 |
typescript | 예 | typescript-eslint에서 가져온 타입스크립트 규칙 (즉, @typescript-eslint/plugin). 타입 인식 규칙은 타입 인식 모드를 사용해 알파 버전에서 사용 가능합니다. |
unicorn | 예 | eslint-plugin-unicorn |
react | 아니요 | eslint-plugin-react 및 eslint-plugin-react-hooks |
react-perf | 아니요 | eslint-plugin-react-perf |
nextjs | 아니요 | @next/eslint-plugin-next |
oxc | 예 | Oxc 전용 규칙 및 deepscan에서 포팅된 일부 규칙 |
import | 아니요 | eslint-plugin-import (eslint-plugin-import-x와 동일) |
jsdoc | 아니요 | eslint-plugin-jsdoc |
jsx-a11y | 아니요 | eslint-plugin-jsx-a11y |
node | 아니요 | eslint-plugin-n |
promise | 아니요 | eslint-plugin-promise |
jest | 아니요 | eslint-plugin-jest |
vitest | 아니요 | @vitest/eslint-plugin 또는 eslint-plugin-vitest |
vue | 아니요 | 스크립트 태그와 함께 작동하는 eslint-plugin-vue 규칙 |
현재 규칙 커버리지 상태에 대한 정보는 린터 제품 계획 이슈를 참조하세요.
새 플러그인 추가
Oxlint는 내장 플러그인과 ESLint와 호환되는 자바스크립트 플러그인을 통해 생태계를 지원하는 데 초점을 맞추고 있습니다. 기존 내장 플러그인에 규칙을 추가하는 기여를 장려합니다.
어떤 규칙 세트가 내장 플러그인으로 구현되어야 한다고 생각되면, 먼저 깃허브 디스커션을 열어 주세요.