Excess property checks vs structural compatibility in Typescript - Performance Comparison
We want to understand how TypeScript checks object properties affect performance.
Specifically, how excess property checks and structural compatibility scale with input size.
Analyze the time complexity of this TypeScript code snippet.
interface Person {
name: string;
age: number;
}
const p1: Person = { name: "Alice", age: 30 };
const p2: Person = { name: "Bob", age: 25, city: "NY" };
function greet(person: Person) {
console.log(`Hello, ${person.name}`);
}
greet(p1);
greet(p2); // Error: excess property 'city'
This code shows how TypeScript checks for extra properties when assigning objects to a type.
- Primary operation: Checking each property of the object against the expected type properties.
- How many times: Once per property in the object being assigned.
As the number of properties in the object grows, the number of checks grows too.
| Input Size (number of properties) | Approx. Operations (property checks) |
|---|---|
| 10 | About 10 checks |
| 100 | About 100 checks |
| 1000 | About 1000 checks |
Pattern observation: The number of checks grows directly with the number of properties.
Time Complexity: O(n)
This means the checking time grows linearly with the number of properties in the object.
[X] Wrong: "Excess property checks happen instantly no matter how many properties there are."
[OK] Correct: Each property must be checked, so more properties mean more work for the compiler.
Understanding how TypeScript checks object shapes helps you write better code and reason about performance.
"What if we passed an object with nested objects? How would the time complexity change?"
Practice
excess property checks primarily prevent when assigning an object literal to a variable of a specific type?Solution
Step 1: Understand excess property checks context
Excess property checks happen when assigning an object literal directly to a typed variable.Step 2: Identify what excess property checks prevent
They prevent extra properties not declared in the target type from being assigned, catching typos or mistakes.Final Answer:
Assigning object literals with extra properties not defined in the target type -> Option AQuick Check:
Excess property checks = prevent extra properties [OK]
- Confusing excess property checks with missing property errors
- Thinking property order matters
- Assuming excess checks apply to variables, not literals
Solution
Step 1: Check direct object literal assignments
const obj: {name: string} = {name: 'Alice', age: 30}; assigns a literal with an extra propertyagedirectly to a typed variable, triggering excess property checks.Step 2: Compare with other options
const extra = {name: 'Bob', age: 25}; const obj: {name: string} = extra; assigns from a variable, so excess property checks do not apply. Options C and D have no extra properties.Final Answer:
const obj: {name: string} = {name: 'Alice', age: 30}; -> Option DQuick Check:
Direct literal with extra property = error [OK]
- Thinking variables cause excess property errors
- Ignoring the difference between literals and variables
- Assuming type assertions always cause errors
interface Person { name: string; }
const extra = { name: 'Eve', age: 40 };
const p: Person = extra;
console.log(p.name);Solution
Step 1: Understand assignment from variable
Assigning from variableextrabypasses excess property checks, so assignment is allowed.Step 2: Check console output
Accessingp.nameprints 'Eve' as expected.Final Answer:
Eve -> Option CQuick Check:
Variable assignment allows extra properties, prints name [OK]
- Expecting excess property error on variable assignment
- Confusing compile-time error with runtime output
- Assuming extra properties are removed
interface Car { make: string; }
const car = { make: 'Toyota', year: 2020 };
const myCar: Car = { make: 'Honda', year: 2018 };Solution
Step 1: Identify excess property check error
Direct assignment of object literal with extra propertyyearcauses error.Step 2: Fix by assigning from variable
Assigning from variablecaravoids excess property checks and fixes error.Final Answer:
Error due to extra property 'year' in direct object literal; fix by assigning from variable -> Option AQuick Check:
Direct literal with extra prop = error; use variable [OK]
- Adding extra properties to interface unnecessarily
- Ignoring excess property check rules
- Assuming no error on direct literal with extra props
interface User { username: string; }
// Option 1
const u1: User = { username: 'john', email: 'john@example.com' };
// Option 2
const extraUser = { username: 'jane', email: 'jane@example.com' };
const u2: User = extraUser;
// Option 3
const u3 = { username: 'doe', email: 'doe@example.com' } as User;
// Option 4
const u4: User = { username: 'max' };Solution
Step 1: Analyze Option 1
Direct literal with extra propertyemailcauses excess property check error.Step 2: Analyze Option 2 and 4
Option 2 assigns from variable, so no error. Option 4 matches interface exactly, no error.Step 3: Analyze Option 3
Type assertion on direct object literal with extra propertyemailstill triggers excess property checks, causing an error.Final Answer:
Only Option 2 and Option 4 -> Option BQuick Check:
Direct literal with extras errors; variable assignment and exact match okay [OK]
- Thinking type assertions bypass excess property checks on object literals
- Thinking all direct literals with extras are allowed
- Ignoring structural compatibility rules
Ready to prove it?
Pass the test and this pattern moves unknown
