Declaration merging for interfaces in Typescript

Introduction

Declaration merging lets you combine multiple interface definitions with the same name into one. This helps organize and extend code easily.

When you want to add new properties to an existing interface without changing the original code.

When different parts of your program define parts of the same interface separately.

When working with third-party libraries and you want to add extra properties to their interfaces.

When splitting interface definitions across multiple files for better code organization.

Syntax

Typescript

interface InterfaceName {
  property1: Type1;
}

interface InterfaceName {
  property2: Type2;
}

All interface declarations with the same name merge into one combined interface.

If properties have the same name, their types must be compatible or an error occurs.

Examples

Both interfaces merge into one with name and age properties.

Typescript

interface User {
  name: string;
}

interface User {
  age: number;
}

This creates a Config interface with debug and version.

Typescript

interface Config {
  debug: boolean;
}

interface Config {
  version: string;
}

Sample Program

This program shows how two interface declarations with the same name merge. The Person interface has both firstName and lastName. The object user uses both properties.

Typescript

interface Person {
  firstName: string;
}

interface Person {
  lastName: string;
}

const user: Person = {
  firstName: "Alice",
  lastName: "Smith"
};

console.log(`Full name: ${user.firstName} ${user.lastName}`);

Important Notes

Declaration merging only works with interfaces, not with types or classes.

Be careful to avoid property name conflicts with incompatible types.

Summary

Interfaces with the same name merge their properties into one.

This helps extend or organize interfaces across code.

Use declaration merging to add properties without changing original interface code.

Practice

1. What happens when two interfaces with the same name are declared in TypeScript?

easy

A. Their properties merge into a single interface.

B. The second interface overwrites the first one.

C. A syntax error occurs due to duplicate names.

D. Only the first interface is used, others ignored.

Solution

1. Step 1: Understand interface declaration merging

   In TypeScript, interfaces with the same name combine their properties into one interface.

2. Step 2: Effect of merging

   This allows extending interfaces without overwriting or errors.

3. Final Answer:

   Their properties merge into a single interface. -> Option A

4. Quick Check:

   Declaration merging = properties combined [OK]

Hint: Same name interfaces combine properties automatically [OK]

Common Mistakes:

• Thinking second interface overwrites the first
• Expecting a syntax error on duplicate names
• Assuming only the first interface is used

2. Which of the following is the correct syntax to merge two interfaces named Person in TypeScript?

easy

A. class Person { name: string } class Person { age: number }

B. interface Person { name: string } interface Person { age: number }

C. type Person = { name: string } type Person = { age: number }

D. interface Person { name: string } type Person = { age: number }

Solution

1. Step 1: Identify valid interface merging syntax

   Only multiple interface declarations with the same name merge properties.

2. Step 2: Check each option

   interface Person { name: string } interface Person { age: number } uses two interface Person declarations, which is correct. Options B and C mix types and interfaces or duplicate types, which do not merge. class Person { name: string } class Person { age: number } uses classes, which do not merge.

3. Final Answer:

   interface Person { name: string } interface Person { age: number } -> Option B

4. Quick Check:

   Multiple interface declarations = merge [OK]

Hint: Only interfaces with same name merge, not types or classes [OK]

Common Mistakes:

• Trying to merge types instead of interfaces
• Using classes instead of interfaces
• Mixing type and interface declarations

3. What will be the output of the following TypeScript code?

interface Car { brand: string; }
interface Car { year: number; }
const myCar: Car = { brand: "Toyota", year: 2020 };
console.log(myCar.year);

medium

A. undefined

B. Runtime error

C. Compilation error

D. 2020

Solution

1. Step 1: Understand interface merging effect

   The two Car interfaces merge their properties, so Car has both brand and year.

2. Step 2: Analyze object and output

   The object myCar correctly has both properties. Logging myCar.year outputs 2020.

3. Final Answer:

   2020 -> Option D

4. Quick Check:

   Interface merge allows all properties [OK]

Hint: Merged interfaces combine properties, so all exist in object [OK]

Common Mistakes:

• Expecting a compilation error due to duplicate interface
• Thinking only first interface properties exist
• Confusing runtime and compile-time errors

4. Identify the error in the following TypeScript code that attempts interface merging:

interface User { id: number; }
interface User { name: string; }
const user: User = { id: 1 };

medium

A. Cannot assign number to 'id' property.

B. Duplicate interface declarations cause syntax error.

C. Missing property 'name' in object 'user'.

D. Interface merging does not work with 'const' declarations.

Solution

1. Step 1: Check interface merging and properties

   The two User interfaces merge, so User requires both id and name.

2. Step 2: Analyze object assignment

   The object user only has id, missing name, causing a type error.

3. Final Answer:

   Missing property 'name' in object 'user'. -> Option C

4. Quick Check:

   All merged properties required in object [OK]

Hint: Merged interfaces require all properties in objects [OK]

Common Mistakes:

• Thinking duplicate interfaces cause syntax errors
• Ignoring missing properties in merged interface
• Assuming 'const' affects interface merging

5. Given two interface declarations:

interface Product { id: number; }
interface Product { description?: string; price: number; }

Which of the following objects correctly implements the merged Product interface?

hard

A. { id: 101, price: 29.99 }

B. { id: 101, description: "Book" }

C. { price: 29.99, description: "Book" }

D. { id: 101 }

Solution

1. Step 1: Combine interface properties

   The merged Product interface requires id (number) and price (number), with optional description.

2. Step 2: Check each object against required properties

   { id: 101, price: 29.99 } has id and price, valid. { id: 101, description: "Book" } misses price. { price: 29.99, description: "Book" } misses id. { id: 101 } misses price.

3. Final Answer:

   { id: 101, price: 29.99 } -> Option A

4. Quick Check:

   Required properties must be present [OK]

Hint: All required merged properties must be in object [OK]

Common Mistakes:

• Ignoring required properties when optional ones exist
• Assuming optional properties are required
• Missing required properties in object