← Back to rules

oxc/no-barrel-file 제한

작동 방식

export * 문이 포함되어 있고, 모듈 총 수가 임계값을 초과하는 경우, 바렐 파일(바렐 파일)의 사용을 금지합니다.

기본 임계값은 100입니다.

왜 나쁜가요?

많은 모듈을 재내보내는 바렐 파일은 애플리케이션과 번들러의 성능을 크게 저하시킬 수 있습니다. 바렐 파일이 많은 모듈을 내보내면, 이를 가져오려는 시도는 실제로 사용되는 일부 모듈만을 대상으로 하더라도 모든 내보내진 모듈을 처리하도록 런타임 또는 번들러를 강제하게 됩니다. 이로 인해 시작 시간이 늦어지고 번들 크기가 커집니다.

참고:

• https://github.com/thepassle/eslint-plugin-barrel-files
• https://marvinh.dev/blog/speeding-up-javascript-ecosystem-part-7

예시

불법:

export * from "foo"; // 여기서 `foo`는 100개의 모듈 트리셋을 로드함
import * as ns from "foo"; // 여기서 `foo`는 100개의 모듈 트리셋을 로드함

법적:

export { foo } from "foo";

구성

이 규칙은 다음 속성을 가진 구성 객체를 허용합니다.

threshold

type: integer

기본값: 100

규칙이 트리거되기 전까지 export *를 통해 재내보낼 수 있는 최대 모듈 수입니다.

사용 방법

이 규칙을 설정 파일 또는 명령줄 인터페이스에서 활성화하려면 다음을 사용할 수 있습니다:

설정 (.oxlintrc.json)

{
  "rules": {
    "oxc/no-barrel-file": "error"
  }
}

CLI

oxlint --deny oxc/no-barrel-file

참고 자료

• 규칙 소스