쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

TypeScript를 사용하여 Lambda 함수 빌드

포커스 모드
TypeScript를 사용하여 Lambda 함수 빌드 - AWS Lambda

Node.js 런타임을 사용하여 AWS Lambda에서 TypeScript 코드를 실행할 수 있습니다. Node.js 는 기본적으로 TypeScript 코드를 실행하지 않으므로 먼저 TypeScript 코드를 JavaScript로 트랜스파일해야 합니다. 그런 다음 JavaScript 파일을 사용하여 함수 코드를 Lambda에 배포합니다. 코드는 사용자가 관리하는 AWS Identity and Access Management(IAM) 역할의 자격 증명을 사용하여 JavaScript용 AWS SDK가 포함된 환경에서 실행됩니다. Node.js 런타임에 포함된 SDK 버전에 대해 자세히 알아보려면 런타임에 포함된 SDK 버전 섹션을 참조하세요.

Lambda는 다음과 같은 Node.js 런타임을 지원합니다.

명칭 식별자 운영 체제 사용 중단 날짜 블록 함수 생성 블록 함수 업데이트

Node.js 22

nodejs22.x

Amazon Linux 2023

2027년 4월 30일

2027년 6월 1일

2027년 7월 1일

Node.js 20

nodejs20.x

Amazon Linux 2023

2026년 4월 30일

2026년 6월 1일

2026년 7월 1일

Node.js 18

nodejs18.x

Amazon Linux 2

2025년 9월 1일

2025년 10월 1일

2025년 11월 1일

TypeScript 개발 환경 설정

로컬 통합 개발 환경(IDE) 또는 텍스트 편집기를 사용하여 TypeScript 함수 코드를 작성합니다. Lambda 콘솔에서는 TypeScript 코드를 생성할 수 없습니다.

esbuild 또는 Microsoft의 TypeScript 컴파일러(tsc)를 사용하여 TypeScript 코드를 JavaScript로 트랜스파일할 수 있습니다. AWS Serverless Application Model(AWS SAM)AWS Cloud Development Kit (AWS CDK) 모두 esbuild를 사용합니다.

esbuild를 사용할 경우 다음을 고려하세요.

  • TypeScript 경고에는 여러 종류가 있습니다.

  • 사용하려는 Node.js 런타임과 일치하도록 TypeScript 변환 설정을 구성해야 합니다. 자세한 내용은 esbuild 설명서의 Target(대상)을 참조하세요. Lambda에서 지원하는 특정 Node.js 버전을 타겟팅하는 방법을 보여주는 tsconfig.json 파일의 예는 TypeScript GitHub 저장소를 참조하세요.

  • esbuild는 유형 검사를 수행하지 않습니다. 유형을 확인하려면 tsc 컴파일러를 사용합니다. 다음 예에 표시된 대로 tsc -noEmit을 실행하거나 tsconfig.json 파일에 "noEmit" 파라미터를 추가합니다. 이렇게 하면 tsc를 구성하여 JavaScript 파일을 방출하지 않습니다. 유형을 확인한 후 esbuild를 사용하여 TypeScript 파일을 JavaScript로 변환합니다.

예 tsconfig.json
{ "compilerOptions": { "target": "es2020", "strict": true, "preserveConstEnums": true, "noEmit": true, "sourceMap": false, "module":"commonjs", "moduleResolution":"node", "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "isolatedModules": true, }, "exclude": ["node_modules", "**/*.test.ts"] }

Lambda에 대한 유형 정의

@types/aws-lambda 패키지는 Lambda 함수에 대한 유형 정의를 제공합니다. 함수가 다음 중 하나를 사용하는 경우 이 패키지를 설치합니다.

함수에 Lambda 유형 정의를 추가하려면 @types/aws-lambda를 개발 종속성으로 설치합니다.

npm install -D @types/aws-lambda

그런 다음 aws-lambda에서 유형을 가져옵니다.

import { Context, S3Event, APIGatewayProxyEvent } from 'aws-lambda'; export const handler = async (event: S3Event, context: Context) => { // Function code };

import ... from 'aws-lambda' 문은 유형 정의를 가져옵니다. 관련 없는 타사 도구인 aws-lambda npm 패키지는 가져오지 않습니다. 자세한 내용은 DefinitelyTyped GitHub 리포지토리의 aws-lambda를 참조하세요.

참고

자체 사용자 지정 유형 정의를 사용할 때는 @types/aws-lambda가 필요 없습니다. 이벤트 객체에 대한 자체 유형을 정의하는 함수 예제는 예제 TypeScript Lambda 함수 코드 섹션을 참조하세요.

이 페이지에서

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.