Course contentsShow
← TypeScript
Lesson 980 of 1,79623. Type AssertionsFree lesson

What Type Assertions Are

Type assertions tell the compiler to treat a value as a specific type, overriding its inferred type.

What Type Assertions Are

You'll learn: How to tell TypeScript to treat a value as a specific type when you know more than the compiler does.

The Core Idea

Type assertions are TypeScript's way of letting you override the compiler's inferred type. You're essentially saying, "Trust me, I know what type this value is better than you do." The compiler will believe you and treat the value as the type you specify.

Think of it like this: TypeScript is a cautious friend who assumes the mystery box you received contains "something unknown." You've peeked inside and know it's a book. A type assertion is you telling your friend, "I've verified it — treat this as a book from now on."

Critically, type assertions don't change the runtime value or perform any conversion. They're purely a compile-time instruction. If you assert incorrectly, TypeScript won't stop you, and you may get runtime errors.

Why You Need Them

Sometimes TypeScript's inference is too conservative. For example:

  • You fetch data from an API and TypeScript sees it as unknown
  • You're working with the DOM and document.getElementById returns HTMLElement | null
  • You've narrowed a type through logic the compiler can't follow

Type assertions let you provide the missing information.

The Syntax Forms

TypeScript offers two syntaxes (you'll see the details in upcoming lessons):

  • The as keyword: value as TargetType
  • Angle-bracket syntax: <TargetType>value

The as syntax is preferred in most codebases, especially when working with JSX.

Key Takeaway: Type assertions tell TypeScript to override its inferred type with your specified type — they're a compile-time instruction that doesn't change runtime behavior, so use them carefully when you genuinely know more than the compiler.