What causes Cannot Set Property of Undefined?

A variable is declared but never assigned an object before property assignment. A function returns undefined when it was expected to return an object. An async operation has not completed yet and the result is still undefined. A typo in a variable name references the wrong (undefined) binding.

← Errors

JavaScript

Cannot Set Property of Undefined: What It Means and How to Fix It

Error reference

Cannot Set Property of Undefined

Language

JavaScript

Severity

High

When it happens

This TypeError is thrown when you try to assign a property to a value that is undefined.

Potential fixes

Initialize variables to an empty object ({}) or the appropriate default before assigning properties. Use optional chaining (?.) for reading, but remember it does not help for writing. Add null checks or default values when a function might return undefined.

Deep dive

This TypeError is thrown when you try to assign a property to a value that is undefined. Unlike reading a property from undefined, writing to it is never silently ignored: it always throws immediately.

Why it happens

•A variable is declared but never assigned an object before property assignment.
•A function returns undefined when it was expected to return an object.
•An async operation has not completed yet and the result is still undefined.
•A typo in a variable name references the wrong (undefined) binding.

Potential fixes

Initialize variables to an empty object ({}) or the appropriate default before assigning properties. Use optional chaining (?.) for reading, but remember it does not help for writing. Add null checks or default values when a function might return undefined.

Examples

JavaScript

Code that triggers the error

let user;
user.name = "Alice";

Error output

TypeError: Cannot set properties of undefined (setting 'name')

Fixed code

let user = {};
user.name = "Alice";
console.log(user.name); // "Alice"

Practice in English

How would you explain a Cannot Set Property of Undefined to a fellow dev? Choose the right phrase:

"I hit an error...

Debugging in English?

You just read real developer English to fix this. Lingua-e has free exercises built the same way: standups, code reviews, and real workplace scenarios.

Practice developer English, free