TypeScript Academy · 강의

satisfies와 as 단언 비교

as를 사용한 캐스팅보다 satisfies가 안전한 이유를 알아봅니다.

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

타입 단언 연산자의 기능

as 단언은 타입에 관해 사용자를 신뢰하라고 컴파일러에 알립니다. 값이 실제로 맞는지는 검사하지 않고 추론된 타입만 덮어씁니다.

const value = { color: "red" } as { color: string; size: number };
// No error even though size is missing!
console.log(value.color);

타입 단언은 안전 검사를 우회함

as는 검증을 건너뛰므로 실제 버그를 숨길 수 있습니다. 위 객체에는 size가 빠져 있지만 TypeScript는 아무 말도 하지 않습니다.

type Config = { color: string; size: number };
const broken = { color: "red" } as Config;
// broken.size is typed number but is actually undefined at runtime
console.log(broken.size); // undefined

satisfies는 대신 검증함

as를 satisfies로 바꾸면 조용히 넘어가던 버그가 명확한 컴파일 오류로 바뀝니다. 객체가 실제로 타입과 일치해야 하기 때문입니다.

type Config = { color: string; size: number };
// const c = { color: "red" } satisfies Config; // Error: size missing
const c = { color: "red", size: 10 } satisfies Config;
console.log(c.size);

타입 단언은 잘못된 타입을 강제할 수 있음

이중 단언을 사용하면 서로 완전히 호환되지 않는 타입도 단언할 수 있으며, 이는 위험하므로 드물게 사용해야 합니다.

const n = "hello" as unknown as number;
// n is typed number but is actually a string
console.log(typeof n); // "string"

satisfies는 값에 대해 거짓말하지 않음

as와 달리 satisfies는 호환되지 않는 타입이라고 주장하는 데 사용할 수 없습니다. 값이 이미 타입에 맞는지만 확인합니다.

// const x = "hello" satisfies number; // Error: string not assignable to number
const y = 42 satisfies number;
console.log(y);

타입 단언은 초과 속성 검사를 잃게 함

as를 사용하면 추가되었거나 철자가 틀린 키가 그대로 통과합니다. satisfies는 여전히 이를 표시하여 오타를 잡습니다.

type Config = { mode: string };
const withAs = { mdoe: "dark" } as Config;   // typo passes silently
// const withSat = { mdoe: "dark" } satisfies Config; // Error: mdoe
console.log(JSON.stringify(withAs));

타입 단언이 정당하게 필요한 경우

as는 런타임 검사 후 unknown을 좁히거나 DOM과 함께 작업하는 등 유효하게 사용할 수 있습니다. 하지만 config 객체에는 satisfies를 우선 사용하십시오.

const data: unknown = JSON.parse("{ }");
// After your own runtime validation, as can express the result.
const obj = data as Record<string, unknown>;
console.log(typeof obj);

config에는 satisfies 우선 사용

구성, 경로 맵, 팔레트에서는 satisfies가 검증과 정확한 추론을 모두 제공합니다. as는 검증도 보장도 제공하지 않습니다.

type Palette = Record<string, string>;
const safe = { primary: "blue", accent: "gold" } satisfies Palette;
console.log(safe.primary);

상수 단언은 다름

as const를 타입 단언과 혼동하지 마십시오. as const는 리터럴로 좁히고 대상을 읽기 전용으로 만듭니다. 안전하며 satisfies와 함께 사용하는 경우가 많습니다.

type Nums = readonly number[];
const xs = [1, 2, 3] as const satisfies Nums;
console.log(xs[0]);

위험성 요약

as: 컴파일러를 덮어쓰고 검사하지 않으므로 버그를 숨길 수 있습니다. satisfies: 컴파일러와 협력하고 완전히 검사하며 추론을 보존합니다. 기본적으로 satisfies를 선택하십시오.

type Config = { level: number };
// const risky = {} as Config; // compiles, level is undefined
const safe = { level: 1 } satisfies Config;
console.log(safe.level);

타입 단언을 satisfies로 리팩터링하기

good 습관은 다음과 같습니다. 직접 제어하는 리터럴에 as SomeObjectType이 보이면 satisfies로 바꿔 보고 나타나는 오류를 수정해 보십시오.

type Config = { url: string; retries: number };
// Before: const c = { url: "/api" } as Config;
const c = { url: "/api", retries: 3 } satisfies Config;
console.log(c.url, c.retries);

빠른 확인: satisfies와 타입 단언

satisfies와 타입 단언의 차이를 얼마나 이해했는지 확인해 보십시오.

복습: satisfies와 타입 단언 비교

as는 검사를 우회하여 버그를 숨길 수 있지만, satisfies는 값을 검증하고 정확한 추론을 유지한다는 것을 배웠습니다. 직접 제어하는 config 객체에는 satisfies를 우선 사용하십시오.

type Config = { color: string; size: number };
const c = { color: "red", size: 10 } satisfies Config;
console.log(c.color, c.size);

자주 묻는 질문

“satisfies와 as 단언 비교” 강의는 무료인가요?

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

“satisfies와 as 단언 비교”에서 뭘 배우나요?

as를 사용한 캐스팅보다 satisfies가 안전한 이유를 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“satisfies와 as 단언 비교” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← TypeScript Academy(으)로 돌아가기