seon99il

TypeScript

TypeScript에서 함수의 타입 지정하기

3분 소요

시작하기 전에

공군에서 소프트웨어 개발 특기병으로 복무하던 중, 수요가 늘어 새 프로젝트에 풀스택 개발자로 배정되었습니다. 이 일을 계기로 TypeScript(react)를 많이 다루게 되었습니다.

사실 저는 느슨한 타입 언어와 애증의 관계입니다. 프런트엔드 개발을 그다지 즐기지 않는 이유 중 하나이기도 합니다.

함수를 선언하는 방법

JavaScript에는 함수를 선언하는 방법이 여러 가지 있습니다.

함수 선언문 (Named Function Declaration)

function hello {
// ...
}

익명 함수 표현식

이름이 없는 함수로, JavaScript 엔진이 변수의 이름을 함수의 이름으로 지정합니다.

const hello = function () {
// ...
}

화살표 함수

const hello = () => {
// ...
}

이 글에서는 요즘 널리 쓰이는 화살표 함수 (제가 가장 많이 사용하는 방식) 를 중심으로 설명하겠습니다.

Call Signature

이제 함수에 타입을 지정하는 방법을 살펴보겠습니다.

기본 함수 인자의 타입을 지정하는 방법

const sum = (a: number, b: number): number => {
  return a + b;
};
// a: number
// b: number
// return: number

인터페이스로 타입을 지정하는 방법

interface sumInterface {
 (a: number, b: number): number
}

const sum: sumInterface = (a, b) => {
return a + b
}

선택적 매개변수의 타입을 선언하는 방법

모든 매개변수를 반드시 전달하지 않고 선택 사항으로 만들려면 ?를 붙이면 됩니다.

const sum = (a: number, b?: number) => {
 return a + b
}
sum(10, 10)
sum(10)

? 키워드를 사용하는 것은 | undefined를 추가하는 것과 같습니다: const sum = (a: number, b: number | undefined) => (a + b)

또한 b가 undefined 값을 받는 경우에는 || 또는 ??를 사용해 undefined를 처리할 수 있습니다.

const sum = (a: number, b: number) => {
return a + (b || 0)
}

또는 값이 제공되지 않을 때를 대비해 매개변수를 기본값으로 초기화할 수도 있습니다. 이 경우 TypeScript의 타입 추론이 인자의 타입을 추론하므로 타입을 명시적으로 선언할 필요가 없습니다.

const sum = (a: number, b = 0) => {
return a + b
}
sum(10) // 10
sum(10, 20) // 30
sum (10, undefined) // 10

명명된 매개변수 (Named Parameters)

명명된 매개변수를 사용할 때는 {} 안에 매개변수를 선언한 뒤 그 뒤에 타입을 지정할 수 있습니다. 다음과 같이 동작합니다.

const greet = ({ name, age }: { name: string, age: number })=> {
  console.log(`Hello, my name is ${name} and I am ${age} years old.`);
}

greet({ name: 'Alice', age: 30 });

매개변수가 적은 일반적인 함수에서는 명명된 매개변수를 자주 쓰지 않을 수 있습니다. 하지만 API를 호출할 때 body에 명명된 매개변수를 쓰면 매우 편리하며, 저도 이 방식을 주로 그런 곳에서 사용합니다.

const greet = async ({ name, age }: { name: string, age: number }) => {
  const response = await fetch("/api/greet", {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ name, age })
  });

  const responseData = await response.json();
  console.log(responseData);
}

greet({ name: 'Alice', age: 30 });

인터페이스 사용하기

명명된 매개변수에 인터페이스를 사용하면 코드를 더 깔끔하게 유지하는 데 도움이 됩니다.

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

const greet = async (requst: GreetParams) => {
  const response = await fetch("/api/greet", {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(requst)
  });

  const responseData = await response.json();
  console.log(responseData);
}

greet({ name: 'Alice', age: 30 });

콜백 함수

콜백 함수의 경우 다음과 같이 타입을 지정할 수 있습니다. name: (param: paramType) => returnType

const processData = (data: number[], callback: (item: number) => number):
number[] => {
  return data.map(callback);
};

const double = (num: number): number => {
  return num * 2;
};

const numbers = [1, 2, 3, 4];
const doubledNumbers = processData(numbers, double);

console.log(doubledNumbers);  // [2, 4, 6, 8]

이전 글

전체 글 보기 →

댓글