모듈 보강 소개

모듈 보강을 사용하면 기존 모듈을 확장하거나 수정할 수 있으므로 TypeScript의 라이브러리나 모듈에 사용자 지정 속성 또는 메서드를 추가할 수 있습니다.

추가 기능이나 사용자 지정 타입이 필요한 타사 라이브러리를 사용할 때 특히 유용합니다.

모듈 보강이란?

모듈 보강은 declare module 구문을 사용하여 기존 모듈을 다시 열고 해당 모듈의 타입이나 기능을 추가하거나 수정하는 과정입니다.

모듈 보강 기본 예시

다음은 Request 객체에 사용자 지정 속성을 추가하기 위해 express 모듈을 보강하는 예시입니다:

import 'express';

declare module 'express' {
  interface Request {
    user?: { id: string; role: string };
  }
}

보강된 모듈 사용

모듈을 보강한 후에는 애플리케이션에서 확장된 기능을 사용할 수 있습니다:

import express from 'express';

const app = express();

app.use((req, res, next) => {
  req.user = { id: '123', role: 'admin' };
  next();
});

app.get('/', (req, res) => {
  res.send(`User ID: ${req.user?.id}`);
});

타사 모듈에 사용자 지정 타입 추가

모듈 보강은 타사 라이브러리가 사용 사례를 완전히 지원하지 않을 때 사용자 지정 타입을 추가하는 데 자주 사용됩니다.

모듈 보강 시 주의 사항

모듈을 보강할 때는 다음 사항에 유의하십시오:

• 기존 타입을 의도치 않게 덮어쓰지 않도록 하십시오.
• 코드를 더욱 쉽게 유지 관리할 수 있도록 변경 사항을 문서화하십시오.
• 전역 타입이 불필요하게 복잡해지는 것을 방지하기 위해 필요한 경우에만 모듈 보강을 사용하십시오.

실제 사용 사례

모듈 보강은 일반적으로 다음과 같은 경우에 사용됩니다:

• 타사 라이브러리를 확장하여 애플리케이션에 특정한 속성을 포함합니다.
• Express.js와 같은 프레임워크에 사용자 지정 미들웨어 속성을 추가합니다.
• 특정 프로젝트 요구 사항에 맞게 모듈을 조정합니다.

연습 과제

express 모듈의 Request 객체를 확장하여 사용자 지정 isAuthenticated 메서드를 포함하십시오. 샘플 미들웨어 함수에서 이 메서드를 사용하십시오.

축하합니다!

TypeScript에서 모듈 보강을 사용하여 기존 모듈을 확장하거나 수정하는 방법을 배웠습니다. 이 기술을 연습하여 타사 라이브러리를 사용자 지정하고 애플리케이션을 향상해 보십시오!