06 고급 타입

6.8 프로토타입 안전하게 확장하기

Array 프로토타입에 zip 메서드를 추가해보자.

  • 먼저 .ts 파일(예: zip.ts)에서 Array의 프로토타입을 확장한 다음 새로운 zip 메서드를 프로토타입에 추가한다.
// 타입스크립트에 zip이 무엇인지 설명
interface Array<T> {
  zip<U>(list: U[]): [T, U][]
}

// .zip 구현
Array.prototype.zip = function <T, U>(
  this: T[],
  list: U[]
): [T, U][] {
  return this.map((v, k) =>
    tuple(v, list[k])
  )
}
  • 인터페이스 합치기(선언 합침) 기능을 이용해 전역 범위로 정의된 Array 인터페이스에 zip 메서드를 추가했다.

파일이 모듈 모드라면 전역 확장을 declare global이라는 타입 선언으로 감싸야 한다.

  • 모듈 모드란 예를 들어 zip을 구현하는데 뭔가를 import해야 하는 상황을 말한다.
declare global {
  interface Array<T> {
    zip<U>(list: U[]): [T, U][]
  }
}
  • global은 전역으로 정의된 모든 값(import를 사용하지 않고도 모듈 모드의 파일에서 사용할 수 있는 모든 것)을 포함하는 특별한 네임스페이스로, 이를 이용하면 모듈 모드의 파일에서 전역 범위에 존재하는 이름들도 확장할 수 있게 된다.
  • interface Array를 선언할 때 전역 Array 네임스페이스에 추가했다. 즉, 다른 파일에서 zip.ts를 임포트하지 않아도 [].zip을 이용할 수 있으리라 짐작된다.

하지만 Array.prototype에 기능을 추가하려면 zip을 사용하는 모든 파일이 zip.ts를 먼저 로드해야 한다.

  • 어떻게 zip을 사용하는 모든 파일이 zip.ts를 먼저 로드하도록 할 수 있을까?

프로젝트에서 zip.ts를 명시적으로 제외하도록 tsconfig.json을 수정하자.

  • 그러면 이 기능을 사용하는 쪽에서 명시적으로 임포트해야 한다.
{
  * exclude *: [
    "./zip.ts"
  ]
}

이제 다음처럼 안전하게 zip을 사용할 수 있다.

import './zip'
[1, 2, 3]
  .map(n => n * 2) // number[]
  .zip(['a', 'b', 'c']) // [number, string][]