Interface vs type alias decision in Typescript - When to Use Which

The Big Idea

Ever wondered why TypeScript offers both interfaces and type aliases for defining data shapes?

The Scenario

Imagine you are building a large app and need to describe the shape of data objects. You try writing out every property by hand each time you use them.

The Problem

This manual way is slow and confusing. You might forget a property or write it differently in different places. It's easy to make mistakes and hard to keep things consistent.

The Solution

Using interfaces and type aliases lets you define data shapes once and reuse them everywhere. They help catch errors early and keep your code clean and consistent.

Before vs After

✗ Before

const user = { name: 'Alice', age: 30 };
function greet(user) {
  console.log(user.name);
}

✓ After

interface User { name: string; age: number; }
const user: User = { name: 'Alice', age: 30 };
function greet(user: User) {
  console.log(user.name);
}

What It Enables

You can confidently build complex apps with clear, reusable data definitions that prevent bugs and save time.

Real Life Example

When working on a team, interfaces and type aliases make sure everyone agrees on how data looks, so features fit together smoothly.

Key Takeaways

Manual data shape definitions are error-prone and repetitive.

Interfaces and type aliases provide reusable, clear data contracts.

Choosing between them helps write safer and more maintainable TypeScript code.

Practice

1. Which statement best describes when to use an interface instead of a type alias in TypeScript?

easy

A. Use interface when you want to extend or merge object shapes.

B. Use interface only for primitive types like string or number.

C. Use interface to create union or tuple types.

D. Use interface when you want to name any type, including functions.

Solution

1. Step 1: Understand interface capabilities

   Interfaces are designed to describe object shapes and support extension and merging.

2. Step 2: Compare with type alias features

   Type aliases can name any type but do not support merging and are less suited for extension of object shapes.

3. Final Answer:

   Use interface when you want to extend or merge object shapes. -> Option A

4. Quick Check:

   Interface = extension and merging [OK]

Hint: Interfaces merge and extend; type aliases do not [OK]

Common Mistakes:

• Thinking interfaces can name union types
• Believing type aliases support merging
• Using interface for primitives only

2. Which of the following is the correct syntax to declare a type alias for a union of string literals?

easy

A. interface Status = 'success' | 'error';

B. interface Status: 'success' | 'error';

C. type Status: 'success' | 'error';

D. type Status = 'success' | 'error';

Solution

1. Step 1: Recall type alias syntax

   Type aliases use the keyword type followed by the name, equals sign, and the type expression.

2. Step 2: Identify union type declaration

   The union of string literals is written as 'success' | 'error' after the equals sign.

3. Final Answer:

   type Status = 'success' | 'error'; -> Option D

4. Quick Check:

   Type alias syntax = type Name = TypeExpression [OK]

Hint: Use 'type' keyword with '=' for aliases [OK]

Common Mistakes:

• Using 'interface' for union types
• Using ':' instead of '=' in type alias
• Mixing interface and type alias syntax

3. Given the following code, what will be the output of console.log(user1.age);?

interface User {
  name: string;
}

interface User {
  age: number;
}

const user1: User = { name: 'Alice', age: 30 };

medium

A. 30

B. undefined

C. TypeScript error: Duplicate identifier 'User'

D. Runtime error

Solution

1. Step 1: Understand interface merging

   TypeScript merges multiple interface declarations with the same name into one combined interface.

2. Step 2: Check the combined interface properties

   The merged User interface has both name and age properties, so user1 can have both.

3. Final Answer:

   30 -> Option A

4. Quick Check:

   Interface merging allows combined properties [OK]

Hint: Interfaces with same name merge properties [OK]

Common Mistakes:

• Expecting a duplicate identifier error
• Thinking type aliases merge
• Assuming age is undefined

4. Identify the error in the following code and choose the correct fix:

type Person = {
  name: string;
};

type Person = {
  age: number;
};

medium

A. Use union type instead of redeclaration.

B. Change both to interfaces to allow merging.

C. Type aliases cannot be redeclared; rename one alias.

D. No error; code is valid.

Solution

1. Step 1: Understand redeclaration rules for type aliases

   Type aliases cannot be declared multiple times with the same name; this causes a duplicate identifier error.

2. Step 2: Identify the fix

   Renaming one of the type aliases avoids the conflict; interfaces can merge but type aliases cannot.

3. Final Answer:

   Type aliases cannot be redeclared; rename one alias. -> Option C

4. Quick Check:

   Type aliases = no redeclaration [OK]

Hint: Type aliases cannot be declared twice with same name [OK]

Common Mistakes:

• Assuming type aliases merge like interfaces
• Ignoring duplicate identifier error
• Trying to redeclare type alias without rename

5. You want to create a reusable type that can represent either a user object with name and age or a string ID. Which is the best approach?

hard

A. Use an interface for the user object and a separate type alias for the union with string.

B. Use a type alias with a union of the user object type and string.

C. Use an interface with a union inside it.

D. Use two interfaces and merge them.

Solution

1. Step 1: Identify the need for union types

   You want a type that can be either an object or a string, which requires a union type.

2. Step 2: Choose the best syntax for union types

   Type aliases can represent unions directly, while interfaces cannot represent unions themselves.

3. Final Answer:

   Use a type alias with a union of the user object type and string. -> Option B

4. Quick Check:

   Type aliases = best for unions [OK]

Hint: Use type alias for unions including objects and primitives [OK]

Common Mistakes:

• Trying to use interface for union types
• Merging interfaces to represent unions
• Separating types unnecessarily