제네릭(Generic)은 코드 재사용성을 높이고 타입 안정성을 보장하는 기능이다.
제네릭을 사용하면 함수나 클래스를 작성할 때, 사용될 데이터의 타입을 미리 지정하지 않고, 이후에 함수나 클래스를 호출할 때 인자로 전달된 데이터의 타입에 따라 자동으로 타입을 추론하게 된다.
function printLog(text: string): string {
return text;
}
printLog('hello'); // 정상
printLog(123); //에러
printLog
함수에 특정 타입을 주어 작성한 코드로, 타입은 명시되었지만, string
타입 외에 다른 타입이 들어온다면 컴파일 에러가 난다. function printLog(text: string): string {
return text;
}
function printLogNumber(text: number): number {
return text;
}
printLog('hello'); // 정상
printLogNumber(123); //정상
|
연산자를 이용하기function printLog(text: string | number) {
return text;
}
printLog('hello'); // 정상
printLogNumber(123); //정상
string
과 number
가 둘 다 접근할 수 있는 API만 제공한다.any
타입 사용하기function printLog(text: any): any {
return text;
}
따라서 제네릭을 사용하게 될 필요성이 생긴다.
제네릭을 사용해서 작성한 코드 예시를 살펴보자.
function printLog<T>(text: T): T {
return text;
}
printLog
함수에 T
라는 타입 변수를 추가했다.
T
는 유저가 준 파라미터의 타입을 캡처해, 이 정보를 나중에 사용할 수 있게 한다.
printLog
함수는 타입을 불문하고 동작하므로 제네릭이라 할 수 있다.
any
를 쓰는 것과는 다르게 인수와 반환 타입에 string
을 사용한 첫 번째 printLog
함수만큼 정확하다. 즉 타입을 추론할 수 있게 된다.
이렇게 제네릭을 작성하고 나면 아래와 같이 작성할 수 있다.
const str = printLog<string>('hello');
T
를 string
타입으로 명시해 주고 타입 주변을 <>
로 감싸준다. 혹은 아래와 같이 타입 추론 기능을 활용해서 작성할 수 있다.
const str = printLog('hello');
전달하는 인수에 따라 컴파일러가 자동으로 T
의 값을 정하는 방법.
타입이 복잡해져 컴파일러가 타입을 유추할 수 없게 되는 경우엔 사용할 수 없다.
인터페이스에도 제네릭을 사용할 수 있다.
interface Item<T> {
name: T;
stock: number;
selected: boolean;
}
Item
인터페이스를 사용하여 만든 객체는 name
의 값으로 어떤 타입이 들어갈지만 작성을 해주면 아래와 같이 인터페이스를 여러 개 만들지 않고도 재사용을 할 수 있게 된다. const obj: Item<string> = {
name: "T-shirts",
stock: 2,
selected: false
};
const obj: Item<number> = {
name: 2044512,
stock: 2,
selected: false
};
제네릭을 사용하는 TypeScript에서 팩토리를 생성할 때 생성자 함수로 클래스 타입을 참조해야 한다.
class GenericNumber<T> {
zeroValue: T;
add: (x: T, y: T) => T;
}
let myGenericNumber = new GenericNumber<number>();
myGenericNumber.zeroValue = 0;
myGenericNumber.add = function(x, y) { return x + y; };
GenericNumber
클래스의 문자 그대로 사용하지만 number
타입만 쓰도록 제한하는 것은 없다. 대신 string
이나 훨씬 복잡한 객체를 사용할 수 있다.제네릭을 사용하기 시작하면, printLog
와 같은 제네릭 함수를 만들 때, 컴파일러가 함수 본문에 제네릭 타입화된 매개변수를 쓰도록 강요한다.
function printLog<T>(text: T): T {
console.log(text.length);
return text;
}
console.log(text.length);
를 작성하게 되면 컴파일 에러가 난다.string
타입이 아닌 number
타입을 보낼 수도 있기 때문에, T
에는 .length
가 있다는 것을 추론할 수 없기 때문!이때는 아래처럼 제네릭에 타입을 줘서 유연하게 함수의 타입을 정의해 줄 수 있다.
function printLog<T>(text: T[]): T[] {
console.log(text.length);
return text;
}
T
라는 변수 타입을 받고, 인자 값으로는 배열 형태의 T
를 받는다. .length
를 허용하게 된다. 혹은 다음과 같이 조금 더 명시적으로 작성이 가능하다.
function printLog<T>(text: Array<T>): Array<T> {
console.log(text.length);
return text;
}
앞서 제네릭 타입 변수 외에도 제네릭 함수에 어느 정도 어떤 타입이 들어올 것인지 힌트를 줄 수 있다.
function printLog<T>(text: T): T {
console.log(text.length);
return text;
}
앞서도 살펴 봤듯이, 인자의 타입에 선언한 T
는 아직 어떤 타입인지 구체적으로 정의하지 않았기 때문에 length
코드에서 오류가 난다.
이럴 때 만약 해당 타입을 정의하지 않고도 length
속성 정도는 허용하려면 아래와 같이 작성하면 된다.
interface TextLength {
length: number;
}
function printLog<T extends TextLength>(text: T): T {
console.log(text.length);
return text;
}
이와 같이 extends
지시자를 이용해 작성하게 되면 타입에 대한 강제는 아니지만 length
에 대해 동작하는 인자만 넘겨받을 수 있게 된다.
혹은 keyof
를 이용해서 제약을 줄 수도 있다.
interface Item<T> {
name: T;
stock: number;
selected: boolean;
}
function printLog<T extends keyof Item>(text: T): T {
return text;
}
printLog('name'); //정상
pirntLog('key'); //에러
<T extends keyof Item>
부분에서 첫 번째 인자로 받는 객체에 없는 속성들은 접근할 수 없게끔 제한할 수 있다.