Interface declaration syntax in Typescript

Introduction

An interface in TypeScript helps you describe the shape of an object. It tells what properties and methods an object should have, like a blueprint.

When you want to define the structure of an object clearly before using it.

When you want to make sure different parts of your code use objects with the same properties.

When you want to describe the shape of data coming from an API.

When you want to create reusable contracts for classes or objects.

When you want to catch mistakes early by checking object shapes during coding.

Syntax

Typescript

interface InterfaceName {
  propertyName: propertyType;
  methodName(param: paramType): returnType;
}

The interface keyword starts the declaration.

Properties and methods inside the interface do not have implementations, only their types.

Examples

This interface describes a person with a name and age.

Typescript

interface Person {
  name: string;
  age: number;
}

This interface describes a calculator with two methods that take numbers and return a number.

Typescript

interface Calculator {
  add(a: number, b: number): number;
  subtract(a: number, b: number): number;
}

This interface describes a car with a brand property and a start method that returns nothing.

Typescript

interface Car {
  brand: string;
  start(): void;
}

Sample Program

This program defines a User interface with two properties and one method. Then it creates an object user that follows this interface and calls the login method.

Typescript

interface User {
  username: string;
  email: string;
  login(): void;
}

const user: User = {
  username: "alice123",
  email: "[e-mail]",
  login() {
    console.log(`${this.username} logged in`);
  }
};

user.login();

Important Notes

Interfaces only exist during development and are removed when the code runs.

You can extend interfaces to build bigger interfaces from smaller ones.

Interfaces help catch errors early by checking object shapes before running the code.

Summary

Interfaces describe the shape of objects with properties and methods.

They help keep your code organized and error-free by defining clear contracts.

Use interface keyword followed by the name and the list of properties/methods.

Practice

1. What is the purpose of an interface in TypeScript?

easy

A. To import external modules

B. To execute code conditionally

C. To define the shape of an object with properties and methods

D. To create a new variable

Solution

1. Step 1: Understand the role of interfaces

   Interfaces describe how an object should look by specifying its properties and methods.

2. Step 2: Compare with other options

   Options A, B, and C describe unrelated concepts like control flow, variables, and modules.

3. Final Answer:

   To define the shape of an object with properties and methods -> Option C

4. Quick Check:

   Interface = Object shape definition [OK]

Hint: Interfaces define object structure, not code execution [OK]

Common Mistakes:

• Confusing interfaces with classes
• Thinking interfaces run code
• Mixing interfaces with variables

2. Which of the following is the correct syntax to declare an interface named Person with a string property name?

easy

A. interface Person { name = string; }

B. interface Person = { name: string; }

C. interface Person (name: string);

D. interface Person { name: string; }

Solution

1. Step 1: Recall interface declaration syntax

   Interfaces use the keyword interface, followed by the name and curly braces with property declarations using colon syntax.

2. Step 2: Check each option

   interface Person { name: string; } uses correct syntax: interface Person { name: string; }. Options B, C, and D have syntax errors like using equals, parentheses, or assignment instead of colon.

3. Final Answer:

   interface Person { name: string; } -> Option D

4. Quick Check:

   Interface syntax uses colon for properties [OK]

Hint: Use colon, not equals, to declare properties in interfaces [OK]

Common Mistakes:

• Using '=' instead of ':' for properties
• Using parentheses instead of braces
• Assigning values inside interface

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

interface Car {
  brand: string;
  year: number;
}

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

medium

A. Toyota 2020

B. undefined 2020

C. Error: Property 'brand' missing

D. Toyota undefined

Solution

1. Step 1: Understand the interface and object assignment

   The interface Car requires brand (string) and year (number). The object myCar correctly provides both.

2. Step 2: Analyze the console.log output

   Concatenating myCar.brand and myCar.year with a space results in Toyota 2020.

3. Final Answer:

   Toyota 2020 -> Option A

4. Quick Check:

   Correct object matches interface = "Toyota 2020" [OK]

Hint: Check if object matches interface properties exactly [OK]

Common Mistakes:

• Missing required properties in object
• Confusing property names
• Expecting runtime errors for correct code

4. Identify the error in this interface declaration and object assignment:

interface User {
  id: number;
  name: string;
}

const user: User = { id: 1 };

medium

A. Interface name should be lowercase

B. Missing property 'name' in object assigned to User

C. Property 'id' should be a string, not number

D. Object should use parentheses instead of braces

Solution

1. Step 1: Check interface properties

   The interface User requires both id (number) and name (string).

2. Step 2: Check object assignment

   The object assigned to user only has id, missing the required name property, causing a TypeScript error.

3. Final Answer:

   Missing property 'name' in object assigned to User -> Option B

4. Quick Check:

   All interface properties must be present in object [OK]

Hint: All interface properties must appear in assigned objects [OK]

Common Mistakes:

• Ignoring missing required properties
• Thinking interface names must be lowercase
• Confusing property types

5. Given the interface declaration below, which object correctly implements Product with an optional description property?

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

hard

A. { id: 101, name: "Book" }

B. { id: 101, description: "A book" }

C. { name: "Book", description: "A book" }

D. { id: "101", name: "Book" }

Solution

1. Step 1: Understand optional properties in interfaces

   The description property is optional (marked with ?), so it can be omitted.

2. Step 2: Check each object against the interface

   { id: 101, name: "Book" } has required id (number) and name (string), no description, which is valid.
   { id: 101, description: "A book" } misses required name.
   { name: "Book", description: "A book" } misses required id.
   { id: "101", name: "Book" } has id as string instead of number.

3. Final Answer:

   { id: 101, name: "Book" } -> Option A

4. Quick Check:

   Optional properties can be omitted safely [OK]

Hint: Optional properties can be left out without error [OK]

Common Mistakes:

• Omitting required properties
• Using wrong types for properties
• Confusing optional with required