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

The as Syntax

Use `value as Type` to assert that value should be treated as Type, even if TypeScript infers differently.

The as Syntax

What you'll learn: How to explicitly tell TypeScript to treat a value as a specific type using the as keyword, even when the compiler would infer something different.

What Is the as Syntax?

Type assertions let you override TypeScript's automatic type inference when you know more about a value's type than the compiler does. The as syntax is the modern way to write type assertions in TypeScript.

The basic pattern is simple:

value as Type

This tells TypeScript: "Trust me, I know this value should be treated as Type."

How It Works

Think of as like saying "please view this through a different lens." You're not changing the value at runtime—you're just telling TypeScript's type checker to see it differently at compile time.

let someValue: unknown = "hello world";

// TypeScript won't let you call .length on unknown
// let len = someValue.length; // Error!

// Use 'as' to assert it's a string
let len = (someValue as string).length; // Works!

Here, someValue is typed as unknown, so TypeScript blocks property access. But you know it's actually a string, so you assert it with as string.

When You Need It

Type assertions are useful when:

  • You're working with unknown values and need to narrow them
  • TypeScript's inference is too conservative for your use case
  • You're migrating from JavaScript and know the types better than the compiler
  • You're dealing with complex type transformations where inference fails
function parseData(json: unknown) {
    // You validated this is a string elsewhere
    const str = json as string;
    return str.toUpperCase();
}

Key Takeaway: Use value as Type to assert that a value should be treated as Type, overriding TypeScript's automatic inference—but only when you're certain the assertion is safe, because TypeScript won't verify it at runtime.