使用 TypeScript 构建 Lambda 函数

你可以使用 Node.js 运行时在 Amazon Lambda 中运行 TypeScript 代码。由于 Node.js 不会在本机运行 TypeScript 代码，因此必须首先将 TypeScript 代码转换为 JavaScript。然后，可以使用 JavaScript 文件将您的函数代码部署到 Lambda。您的代码将在包含适用于 JavaScript 的 Amazon SDK 的环境中运行，其中包含来自您管理的 Amazon Identity and Access Management (IAM) 角色的凭证。要了解有关 Node.js 运行时随附的 SDK 版本的更多信息，请参阅 包含运行时的 SDK 版本。

Lambda 支持以下 Node.js 运行时。

设置 TypeScript 开发环境

使用本地集成式开发环境（IDE）或文本编辑器来编写 TypeScript 函数代码。您无法在 Lambda 控制台上创建 TypeScript 代码。

您可以使用 esbuild 或 Microsoft 的 TypeScript 编译器（tsc）将您的 TypeScript 代码转换为 JavaScript。Amazon Serverless Application Model（Amazon SAM） 和 Amazon Cloud Development Kit (Amazon CDK) 都使用 esbuild。

在使用 esbuild 时，请注意以下事项：

 {
  "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。