← Back to rules

typescript/triple-slash-reference 정확성

✅ This rule is turned on by default.

작동 방식

특정 삼중 슬래시 지시문을 사용하는 것을 금지하고, 대신 ECMAScript 모듈 가져오기 선언을 사용하도록 권장합니다.

왜 좋지 않은가?

삼중 슬래시 참조 형식 지시문의 사용은 일반적으로 ECMAScript 모듈 가져오기 선언보다 권장되지 않습니다.

예시

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

/// <reference lib="code" />
globalThis.value;

구성

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

lib

type: "always" | "never"

기본값: "always"

/// <reference lib="..." /> 참조에 대해 강제할 내용입니다.

"always"

삼중 슬래시 lib 참조를 허용합니다.

"never"

삼중 슬래시 lib 참조를 금지합니다.

path

type: "always" | "never"

기본값: "never"

/// <reference path="..." /> 참조에 대해 강제할 내용입니다.

"always"

삼중 슬래시 path 참조를 허용합니다.

"never"

삼중 슬래시 path 참조를 금지합니다.

types

type: "always" | "never" | "prefer-import"

기본값: "prefer-import"

/// <reference types="..." /> 참조에 대해 강제할 내용입니다.

"always"

삼중 슬래시 types 참조를 허용합니다.

"never"

삼중 슬래시 types 참조를 금지합니다.

"prefer-import"

ES 모듈 가져오기 선언을 삼중 슬래시 types 참조보다 우선시합니다. 이 옵션은 동일한 모듈에 이미 존재하는 import 선언이 있는 경우에만 경고를 보고합니다.

예를 들어, prefer-import 설정에서 다음과 같은 경우는 린트 위반이로 보고됩니다:

/// <reference types="foo" />
import { bar } from "foo";

사용 방법

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

구성 파일 (.oxlintrc.json)

{
  "rules": {
    "typescript/triple-slash-reference": "error"
  }
}

CLI

oxlint --deny typescript/triple-slash-reference

참고자료

• 규칙 소스