TS2454

Variable 'X' is used before being assigned

TypeScript TS2454 fires when you read a variable that might not have been assigned a value yet. TypeScript's control flow analysis detects that there's a code path where the variable is read before it's written.

Why This Happens

You declared a variable without an initializer (let x: number) and TypeScript's control flow analysis finds a path where the variable is used before any assignment. Common in conditional assignments inside if blocks.

Code That Triggers TS2454

// TS2454 examples

let result: number;
console.log(result); // Error: Variable 'result' is used before being assigned

// Conditional assignment — TypeScript sees the unassigned path
let message: string;
if (condition) {
  message = "Hello";
}
// If condition is false, message was never assigned
console.log(message); // Error: Variable 'message' is used before being assigned

How to Fix TS2454

Option 1: Initialize the variable with a default value

let result: number = 0;
let message: string = "";

Option 2: Assign in all branches

let message: string;
if (condition) {
  message = "Hello";
} else {
  message = "Goodbye"; // now all paths assign it
}
console.log(message); // OK

Option 3: Use definite assignment assertion when you know it's safe

let message!: string; // ! tells TypeScript: guaranteed to be assigned before use
// Use only when you're certain — TypeScript won't check for you

Frequently Asked Questions — TS2454

What does TS2454 mean?

TS2454 means TypeScript found a code path where you read a variable before it's been assigned. This would be undefined at runtime. TypeScript catches it at compile time to prevent bugs.

How is TS2454 different from 'possibly undefined'?

TS2454 is about control flow — TypeScript proves you read the variable before any assignment. 'Possibly undefined' (TS2532) is about types — the variable's type includes undefined.

When should I use the definite assignment assertion (!)?

Use variable!: Type when you initialize the variable indirectly — for example, in a setup function called from a constructor, or via dependency injection. Only use it when you're genuinely certain it's assigned before use.

TS2454 in class constructors — how to fix?

Either initialize in the declaration (prop: string = ''), initialize in the constructor before use, or use the definite assignment assertion: prop!: string.

TypeScript says TS2454 but I have an else branch — why?

TypeScript's control flow analysis may not recognize complex patterns. Make the assignment explicit in both branches, or initialize with a default value at declaration.

Convert JavaScript to TypeScript automatically

Paste your JS code and get type-annotated TypeScript — including fixes for common type errors — in seconds.

Try the converter →

Other TypeScript Errors

TS2345 TS2339 TS2304 TS2322 TS2531 TS2532 TS2307 TS7006 TS2741 TS2554 TS2366 TS2349 View all →

From the blog

View all →