Course contentsShow
← TypeScript
Lesson 1021 of 1,79624. Classes in TypeScriptFree lesson

Definite Assignment Assertion (!)

Use the definite assignment assertion operator when you know a property will be initialized elsewhere.

Definite Assignment Assertion (!) in TypeScript

What you'll learn: How to tell TypeScript that a class property will definitely be initialized, even when the compiler can't verify it.

The Initialization Problem

TypeScript's strict mode requires all class properties to be initialized either at declaration or in the constructor. But sometimes you know a property will be set before it's used—perhaps by a setup method, lifecycle hook, or dependency injection framework—even though TypeScript can't trace that logic.

This is where the definite assignment assertion operator (!) comes in.

The Basic Syntax

Add an exclamation mark after the property name to tell TypeScript: "Trust me, this will be initialized":

class UserProfile {
  username!: string;  // No initialization, but no error
  
  initialize(name: string) {
    this.username = name;
  }
}

const profile = new UserProfile();
profile.initialize("alice");
console.log(profile.username);  // Works fine

Without the !, TypeScript would complain: Property 'username' has no initializer and is not definitely assigned in the constructor.

When to Use It

Common scenarios include:

  • Framework lifecycle methods (like React's componentDidMount)
  • Dependency injection where properties are set by a container
  • Test setup methods that run before each test
  • Initialization patterns where a separate init() method must be called
class Component {
  element!: HTMLElement;
  
  mount(container: HTMLElement) {
    this.element = container;
  }
}

The Risk

The ! operator is a promise to the compiler—not a runtime guarantee. If you forget to actually initialize the property, you'll have undefined at runtime despite TypeScript thinking it's safe.

Key Takeaway: Use definite assignment assertions (!) when you know initialization happens elsewhere in your code, but only when you're certain that pattern is enforced—it's your responsibility to keep that promise.