使用 TypeScript 建置 Lambda 函數

您可以使用 Node.js 執行期在 AWS Lambda中執行 TypeScript。由於 Node.js 不會在本機執行 TypeScript 程式碼，因此必須先將 TypeScript 程式碼轉換為 JavaScript。然後，使用 JavaScript 檔案，將函數程式碼部署至 Lambda。您的程式碼會在包含適用於 JavaScript 的 AWS SDK 的環境中執行，其中包含您管理之 AWS Identity and Access Management (IAM) 角色的登入資料。若要進一步了解 Node.js 執行時期隨附的 SDK 版本，請參閱 包含執行時期的 SDK 版本。

Lambda 支援以下 Node.js 執行期。

設定 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 時，請考慮下列事項︰

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