TypeScript: error TS2454: Variable 'x' is used before being assigned.
Control flow shows a path where the variable is read before any assignment.
error TS2454: Variable 'x' is used before being assigned.Variable 'x' is used before being assigned. ts(2454)TS2454 Variable is used before being assignederror TS2454 Meaning
Initialise at declaration (let x: number | undefined; or a default), assign in every branch, or restructure with const x = cond ? a : b. A definite assignment assertion (let x!: number) silences it if you guarantee assignment elsewhere (e.g., in callbacks).
Common causes
- Assigned only inside
if/loops/try - Assigned in a callback (TS can't see)
- switch without default
- Early use before assignment
- Class property without initialiser
⚡ Quick fix
const x = cond ? 1 : 2;- Initialise:
let x: T | undefined;then check - Definite assignment
let x!: Tif guaranteed
Detailed fix by platform
TypeScript
let timer: ReturnType<typeof setTimeout> | undefined;
How to diagnose
- Path — Unassigned read?
- Callback — Assigned inside?
- Assertion — Safe?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
- Cannot find module './App.vue' or its corresponding type declarations TypeScript: error TS2307: Cannot find module './App.vue' or its corresponding type declarations.
- NG0955 Angular: NG0955: The provided track expression resulted in duplicated keys for a given collection (@for)
- TS1005: ';' expected / ',' expected (syntax error) TypeScript: error TS1005: ';' expected.
Most viewed in TypeScript
Other ways to find it
Where this error sits
Origin: On your device. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 5 Nov 2026