← Back to rules

nextjs/no-assign-module-variable 정확성

작동 방식

Next.js 애플리케이션 내에서 module이라는 이름의 변수에 할당하거나 선언하는 것을 방지합니다.

왜 문제가 될까요?

변수 이름 module은 Next.js 내부 사용 및 모듈 시스템 기능을 위해 예약되어 있습니다. 자신만의 module 변수를 선언하면, Next.js의 내부 모듈 시스템과 충돌할 수 있으며, 애플리케이션에서 예기치 않은 동작을 유발하고 코드 분할 및 핫 모듈 교체 문제를 초래할 수 있습니다.

예시

이 규칙에 위반되는 코드 예시:

// module 변수 선언
let module = {};

// 변수 선언에서 module 사용
const module = {
  exports: {},
};

// module에 값 할당
module = { id: "my-module" };

이 규칙에 맞는 코드 예시:

// 다른 변수 이름 사용
let myModule = {};

// 더 명확한 이름 사용
const customModule = {
  exports: {},
};

// 실제 모듈 객체 접근 (사용 가능한 경우)
console.log(module.exports);

사용 방법

설정 파일 또는 CLI를 통해 이 규칙을 활성화하려면 다음을 사용할 수 있습니다:

구성 파일 (.oxlintrc.json)

{
  "plugins": ["nextjs"],
  "rules": {
    "nextjs/no-assign-module-variable": "error"
  }
}

CLI

oxlint --deny nextjs/no-assign-module-variable --nextjs-plugin

참고 자료

• 규칙 소스