1. 개요
2. 변수 및 매개변수 선언
3. 함수 반환 타입
4. 객체와 인터페이스
5. 참조

1. 개요

TypeScript에서 명시적 타입 어노테이션을 작성할 때 몇 가지 고려해야 할 사항이 있습니다. 이는 코드의 가독성과 유지 보수성을 높이고 잠재적인 버그를 줄일 수 있습니다. 아래에서는 주요 사항을 살펴보겠습니다.

2. 변수 및 매개변수 선언

변수나 매개변수를 명시적으로 타입을 지정할 때, 해당 값에 대한 예상 타입과 일치하는지를 검토해야 합니다. 특히, any 타입의 사용을 최소화하고 실제로 사용되는 타입을 명시하는 것이 중요합니다.

let count: number = 5;
function greet(name: string) {
  return `Hello, ${name}!`;
}

3. 함수 반환 타입

함수의 반환 타입을 명시적으로 지정하는 것이 좋습니다. 이는 함수의 반환 값이 예상한 타입과 일치하는지를 확인할 수 있도록 도와줍니다.

function add(x: number, y: number): number {
  return x + y;
}

4. 객체와 인터페이스

객체나 클래스의 구조를 명시적으로 정의할 때 인터페이스를 활용하는 것이 좋습니다. 이를 통해 코드의 가독성을 높이고 잠재적인 오류를 줄일 수 있습니다.

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

function printPerson(person: Person) {
  console.log(person.name, person.age);
}

5. 참조

TypeScript 공식 문서: TypeScript 공식 문서