interface vs type

Using interface and type declarations are common way to represent given data structure.
// Using interface
interface Point {
    x: number;
    y: number;
}

// Using type alias
type Point = {
    x: number;
    y: number;
}

Difference

It's possible to declare the same interface multiple times. They will be merged together to form a single interface definition.
interface Point {
    x: number;
}

interface Point {
    y: number;
}

const p: Point = {
    x: 1,
    y: 2,
};
Where type alias must be unique and doesn't allow us to merge the declarations.
type Person = {
    firstName: string;
}
// Throw error: Duplicate identifier
type Person = {
    lastName: string;
}
Being able to merge the interface declarations is very useful, for example, when we provide the type definitions for an external library which isn't made with TypeScript completely.
In that case, if there're some missing definitions, we can provide them via declaration merging.

Good practice

If you are author of a library or create type definitions for an external library, use interface for public APIs. So the consumers can extend them.
Hit the Subscribe button for the latest news on my tools. No spam. Ever!
© 2020 Nguyen Huu Phuoc. All rights reserved