0Pricing
TypeScript Academy · 강의

사용자 정의 형식 가드 함수

is 조건식을 작성해 사용자 정의 형식 가드를 만듭니다.

사용자 정의 형식 가드 함수은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

시작하기

사용자 정의 타입 가드를 사용하면 `is` 술어 반환 타입을 이용하여 좁히기 검사를 재사용 가능한 함수로 캡슐화할 수 있습니다.

is 술어 반환 타입

타입 가드 함수는 `paramName is Type`을 반환합니다. 함수가 true를 반환하면 TypeScript는 매개변수를 해당 타입으로 좁힙니다.
function isString(val: unknown): val is string {
  return typeof val === 'string';
}

타입 가드 사용하기

if 조건에서 타입 가드를 호출하십시오. TypeScript는 블록 내부에서 타입을 좁힙니다.
function process(val: unknown) {
  if (isString(val)) {
    console.log(val.toUpperCase()); // val: string
  }
}

인터페이스를 위한 타입 가드

인터페이스에는 instanceof를 사용할 수 없으므로 타입 가드가 인터페이스 유니언을 좁히는 기본 방법입니다.
interface Cat { meow(): void }
interface Dog { bark(): void }
function isCat(pet: Cat | Dog): pet is Cat {
  return 'meow' in pet;
}

복잡한 객체를 위한 타입 가드

특정 타입으로 사용하기 전에 실행 시점에 객체의 형태를 검증하는 타입 가드를 작성하십시오.
interface User { name: string; age: number; }
function isUser(val: unknown): val is User {
  return (
    typeof val === 'object' &&
    val !== null &&
    typeof (val as any).name === 'string' &&
    typeof (val as any).age === 'number'
  );
}

타입 가드와 타입 단언

타입 가드는 실행 시점에 검사합니다. 타입 단언(`as Type`)은 컴파일 시점에만 적용되며 잘못된 내용을 가리킬 수 있습니다. 외부 데이터에는 가드를 우선 사용하십시오.

타입 가드로서의 Array.isArray

Array.isArray는 내장 타입 가드입니다. TypeScript는 이를 이해하고 그에 맞게 타입을 좁힙니다.
function flatten(val: string | string[]): string[] {
  return Array.isArray(val) ? val : [val];
}

제네릭 타입 가드

재사용 가능한 실행 시점 검사기를 만들기 위해 타입 가드를 제네릭으로 작성할 수 있습니다.
function isNonNull<T>(val: T | null | undefined): val is T {
  return val !== null && val !== undefined;
}
const values = [1, null, 2, undefined].filter(isNonNull);
// values: number[]

단언 함수

단언 함수는 `asserts`를 사용합니다. 조건이 거짓이면 예외를 발생시키고 호출 이후에 타입을 좁힙니다.
function assertIsString(val: unknown): asserts val is string {
  if (typeof val !== 'string') throw new TypeError('Not a string');
}
assertIsString(input);
console.log(input.toUpperCase()); // narrowed to string

타입 가드의 책임

TypeScript는 타입 가드의 반환 값을 완전히 신뢰합니다. 가드가 잘못되면 TypeScript는 컴파일 시점에 불일치를 감지하지 못합니다.

filter와 find에서의 타입 가드

타입 가드를 array.filter에 직접 전달하여 결과 타입을 좁히십시오.
const mixed: (string | null)[] = ['a', null, 'b'];
const strings = mixed.filter((x): x is string => x !== null);
// strings: string[]

빠른 확인

함수를 TypeScript 타입 가드로 표시하는 반환 타입 주석은 무엇입니까?

복습

사용자 정의 타입 가드는 `param is Type` 반환 타입을 사용하여 좁히기 로직을 캡슐화합니다. filter/find와 함께 사용할 수 있고, 인터페이스를 좁힐 수 있으며, 제네릭으로 만들 수도 있습니다. 단언 함수는 불리언을 반환하지 않고 타입을 좁힙니다.

자주 묻는 질문

“사용자 정의 형식 가드 함수” 강의는 무료인가요?

네 — “사용자 정의 형식 가드 함수” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“사용자 정의 형식 가드 함수”에서 뭘 배우나요?

is 조건식을 작성해 사용자 정의 형식 가드를 만듭니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“사용자 정의 형식 가드 함수” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. typeof 및 참 같은 값에 따른 형식 좁히기
  2. instanceof 및 in을 사용한 형식 좁히기
  3. 사용자 정의 형식 가드 함수
  4. never를 사용한 모든 경우 처리 검사
← TypeScript Academy(으)로 돌아가기