Select Page

TypeScript, a superset of JavaScript, brings static typing to the game, making it easier to catch errors early in the development process. One of the powerful features TypeScript offers is Type Assertions. In this post, we’ll explore what Type Assertions are, why they are useful, and how to use them effectively in your code.

What are Type Assertions?

Type Assertions are a way to tell the TypeScript compiler to treat a value as a specific type. This is useful when you have more information about the type of a variable than TypeScript can infer. Type Assertions do not change the runtime behavior of the code; they are purely a compile-time construct used to inform the TypeScript compiler of the type you expect.

There are two syntaxes for Type Assertions in TypeScript:

  1. The as syntax.
  2. The angle-bracket (<type>) syntax.

Why Use Type Assertions?

Type Assertions are particularly useful when working with dynamic data, such as data received from an API or when you know more about a variable’s type than TypeScript can infer. They help ensure that your code adheres to the expected types, reducing the likelihood of runtime errors.

Using the as Syntax

The as syntax is the preferred way of asserting types, especially when working with JSX in React, where angle brackets are already used.


let someValue: unknown = “This is a string”;

let strLength: number = (someValue as string).length;

console.log(strLength); // Output: 16

In this example, someValue is of type unknown. By using as string, we assert that someValue is a string, allowing us to safely access the length property.

Using the Angle-Bracket Syntax

The angle-bracket syntax is an alternative way to perform Type Assertions. However, it is not recommended for use in .tsx files (React) to avoid conflicts with JSX syntax.


let someValue: unknown = “This is a string”;

let strLength: number = (<string>someValue).length;

console.log(strLength); // Output: 16

This example achieves the same result as the previous one, but uses angle brackets for the Type Assertion.

Practical Examples

Let’s explore some practical examples to see how Type Assertions can be used in real-world scenarios.

Working with API Data

When working with data from an API, Type Assertions can help ensure that you are working with the expected types.

interface User { id: number; name: string; email: string; }

async function fetchUser(userId: number): Promise<User> { const response =

await fetch(`${userId}`);

const data = await response.json();

// Assert that the returned data is of type User return data as User;


fetchUser(1).then(user => { console.log(;

// Output: the name of the user with id 1


In this example, we fetch user data from an API and assert that the returned data is of type User.

Working with API Data

Type Assertions are useful when working with DOM elements, where TypeScript might not know the exact type of an element.

const inputElement = document.getElementById(“username”) as HTMLInputElement;

inputElement.value = “Alice”;

Here, we assert that the element with ID username is an HTMLInputElement, allowing us to safely access the value property.


Type Assertions in TypeScript are a powerful tool for ensuring your code adheres to expected types. They are particularly useful when dealing with dynamic data or when TypeScript’s type inference is not sufficient. By using the as syntax or the angle-bracket syntax, you can inform the TypeScript compiler of the specific type you expect, leading to safer and more robust code.

Remember to use Type Assertions judiciously, as incorrect assertions can lead to runtime errors. When used correctly, they can greatly enhance the type safety and readability of your TypeScript code.

Start incorporating Type Assertions in your TypeScript projects today and take full advantage of the type system that TypeScript offers!