Type 선언을 위한 방식 (interface VS type)

[choichangyeon]

TypeScript에선 변수에 대한 타입을 설정해서 사용하고, 서버로부터 데이터를 받아오는 것도
미리 해당 데이터에 대한 구조를 선언해야합니다!

이때 2가지 방식으로 타입을 선언할 수 있는데,
interface와 type이 있습니다.

저는 일반적으로 확장시킬 수 있고, 필요에 따라 조작할 수 있는 interface로 타입을 선언하는 것을 추천합니다!
이에 대해서 여러 의견 주시면 감사하겠습니다!

[choichangyeon]

근데 찾아보니 원시 타입 선언과 computed value에서는 type이 강점이 있더라구요!
그래서 팀원 분들의 의견에 따르도록 하겠습니다!

하단은 예시 코드입니다!

// 원시 타입 선언
type Name = string; // primitive
type Age = number;
type Person = [string, number, boolean]; // tuple
type NumberString = string | number; // union

//computed value
type Subjects = 'Math' | 'Science' | 'Sociology';

type Grades = {
  [key in Subjects]: string;
}

[parkminjo]

저는 interface와 type을 둘 다 가져가면 어떨까 생각합니다.

찾아본 결과,
type과 interface의 가장 큰 차이점은 확장 가능성이라고 합니다.
type은 유니온 타입을 이용하여 조합해서 사용할 수 있긴 하지만, 이미 정의된 타입에 대해서 추가적인 확장이 어렵다고 합니다.

interface는 상속을 통해 확장이 가능하기 때문에 유연하게 타입을 구성할 수 있습니다.

// interface 확장 예시
interface Person {
  name: string;
  age: number;
}

interface Employee extends Person {
  position: string;
}

const employee: Employee = {
  name: 'John',
  age: 30,
  position: 'Developer',
};

이런 상황을 고려했을 때 interface를 사용하면 이점을 가져갈 수 있다고 생각합니다.

그런데... 정말 간단한 타입을 지정하는 상황이 발생했을 때를 고려하여, 그럴 경우에만 type을 사용하는 것이 좋지 않을까 생각합니다.
ex) 객체는 interface, 아래 예시 코드와 같은 상황은 type

// interface로 타입을 지정할 수 없는 경우
type Age = number;

// 유니언 타입
type StringOrNumber = string | number;

// 튜플 타입
type Coordinates = [number, number];

[hye410]

저는 팀프로젝트이기 때문에 type 별칭을 사용하는 것이 적합하다고 생각합니다.

왜냐하면 interface는 확장이 가능하기 때문입니다.

• 확장이 가능하기 때문에 편하고 유연하게 타입을 정의할 수 있다는 장점이 있습니다.
• 하지만 이런 점 때문에 팀 프로젝트에서는 맞지 않다고 생각합니다.
• 팀 프로젝트 특성 상 여러 사람이 타입을 정의하게 될 텐데, 이전에 정의된 타입을 모두 읽어보지 않는 한 (설령 읽었다고 하더라도)
• 의도치 않게 같은 이름의 타입을 정의하게 될 수도 있다는 생각이 듭니다.
• 이로 인해 팀원 간 타입 충돌을 초래할 수 있습니다.

[parkminjo]

그냥 여담이지만
잘 모르겠을 때는 interface를 사용하라고 공식 문서에 나와있네요...

For the most part, you can choose based on personal preference,
and TypeScript will tell you if it needs something to be the other kind of declaration.
If you would like a heuristic, use interface until you need to use features from type.

[ImJaeOne]

TypeScript를 사용하는 주요 이유 중 하나는 타입 안전성을 보장하는 것입니다. 그러나 interface를 사용할 경우, 나중에 타입이 확장되거나 덮어씌어지는 문제가 발생할 수 있습니다. 이로 인해 타입 안전성이 훼손될 위험이 존재합니다.

interface는 타입을 확장하거나 다른 타입과 병합할 때 유용한 점이 있지만, 이를 남용할 경우 예상치 못한 타입 덮어쓰기가 일어날 수 있습니다. 예를 들어, 서로 다른 파일이나 모듈에서 같은 이름의 interface를 선언하면 그 타입들이 병합되어 의도치 않은 타입 변경이 일어날 수 있습니다. 이렇게 타입이 덮어씌어지면, 나중에 코드에서 예상과 다른 타입이 들어와 버그가 발생할 수 있습니다.

이러한 문제를 방지하려면, type을 사용하여 고정된 타입을 선언하는 것이 더 안전하다고 생각합니다. type은 재선언할 수 없기 때문에, 한 번 정의한 타입이 변경될 일이 없고, 덮어쓰기도 불가능합니다. 이는 타입 안전성을 최대한 보장할 수 있는 방식으로, 타입 변경을 방지하는 데 유리합니다.

따라서 type을 쓰는 것이 좋을 것 같다고 생각합니다!