@aws-lambda-powertools/commons

中文文档
2.36.0发布于 2026/10/06MIT-0TypeScriptESM + CJS构建来源已验证近 30 天下载 695.6万

AWS Lambda (TypeScript) 库的 Powertool 共享工具包

中文使用文档
文档目录14 节
  1. 介绍
  2. 使用量
  3. 倾角类型
  4. 基数64
  5. JSON 类型 倾斜
  6. Lambda 接口
  7. 贡献
  8. 路线图
  9. 连接
  10. 如何支持 AWS Lambda (TypeScript) 的 Powertools ?
  11. 成为参考客户
  12. 分享你的工作
  13. 使用 Lambda 层
  14. 许可证

AWS Lambda 的动力工具( TypeScript)

用于 AWS Lambda (TypeScript) 的 Powertools 是用于执行无服务器的开发者工具包 最佳做法和增加开发者的速度。 。 。 .

您可以在 TypeScript 和 JavaScript 代码库中使用库.

介绍

Commons软件包包含一套由一个或多个Powertool共享的用于AWS Lambda(TypeScript)公用事业的公用设施. 其中的一些公用设施也可以独立地用于您的 AWS Lambda 函数中.

使用量

要启动, 请通过运行安装工具 :

npm i @aws-lambda-powertools/commons

倾角类型

在使用不同的对象和值时,您可能想要进行运行时类型检查 。 该工具包含一组类型工具,用于检查对象或值的类型.

import { isRecord } from '@aws-lambda-powertools/commons/typeUtils';
import { isString } from '@aws-lambda-powertools/commons/typeUtils';
import { isTruthy } from '@aws-lambda-powertools/commons/typeUtils';


const value = { key: 'value' };
if (isRecord(value)) {
  // value is a record
}

const stringValue = 'string';
if (isString(stringValue)) {
  // stringValue is a string
}

const truthyValue = 'true';
if (isTruthy(truthyValue)) {
  // truthyValue is truthy
}

您可以找到可用的类型的公用事业的完整列表 aPI 文档中。许多这些公用设施也作为类型守护器翻了一番,可以用来缩小对象或值的类型.

基数64

在使用 Base64 编码数据时,您可以使用 fromBase64 快速解码数据并将其转换为 Uint8Array。 。 。 .


import { fromBase64 } from '@aws-lambda-powertools/commons/utils/base64';

const encodedValue = 'aGVsbG8gd29ybGQ=';

const decoded = fromBase64(encodedValue);
// new Uint8Array([ 97, 71, 86, 115, 98, 71, 56, 103, 100, 50, 57, 121, 98, 71, 81, 61 ]); 

JSON 类型 倾斜

在某些情况下,您可能想要为 JSON 对象或值定义类型 。 该工具带有一组类型,用于定义您的 JSON 对象.

import type { JSONValue, JSONObject, JSONArray } from '@aws-lambda-powertools/commons';

Lambda 接口

当使用面向对象的模式定义您的 Lambda 处理器时, 您可以使用 LambdaHandler 界面来定义您的处理器方法的形状.

import type { Context } from 'aws-lambda';
import type { LambdaInterface } from '@aws-lambda-powertools/commons/types';

class Lambda implements LambdaInterface {
  public handler = async (event: unknown, context: Context) => {
    // Your handler code here
  }
}

const handlerClass = new Lambda();
export const handler = lambda.handler.bind(lambda);

贡献

如果你有兴趣为这个项目捐款,请参见我们 贡献准则。 。 。 .

路线图

AWS Lambda(英语:TypeScript)的"Powertools"行进图受顾客需求所驱动.
帮助我们确定未来功能或公用事业的优先次序 更新现有 RFC 和功能请求,或 创建新的,在此 GitHub 仓库中.

连接

如何支持 AWS Lambda (TypeScript) 的 Powertools ?

成为参考客户

了解哪些公司正在使用这个图书馆对于帮助在内部确定项目的优先次序很重要。 如果您的公司正在使用 Powertools 为 AWS Lambda (TypeScript) , 您可以要求您在 README 文件中添加您的姓名和标志 AWS Lambda( TypeScript) 的辅助电源工具(成为参考) 问题.

除其他外,下列公司使用Powertools:

分享你的工作

分享您为 AWS Lambda (TypeScript) 所做的 Powertools 。 看看社区有什么 已经共享 关于AWS Lambda的Powertools (TypeScript).

使用 Lambda 层

这帮助我们了解谁用Powertools为AWS Lambda(英语:TypeScript (TypeScript))以非侵入性的方式使用Powertools,并帮助我们获得未来对其他AWS Lambda语言的Powertool的投资. 何时 使用图层,您可以添加Powertools作为dev的依赖性,以不影响开发过程.

许可证

这个图书馆根据MIT-0许可证获得许可. 见LICENSE文件.

版本与发布记录

@aws-lambda-powertools/commons 共发布 130 个版本,首次发布于 2021/12/15;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.36.0latest2026/10/061 个月前
2.35.02026/08/182 个月前
2.34.02026/07/103 个月前
2.33.12026/05/255 个月前
2.33.02026/04/146 个月前
2.32.02026/03/197 个月前

其他发布通道:next → 2.0.0-alpha.2。

关于 @aws-lambda-powertools/commons 的常见问题

@aws-lambda-powertools/commons 是什么?

AWS Lambda (TypeScript) 库的 Powertool 共享工具包

如何安装 @aws-lambda-powertools/commons?

在项目目录运行 npm install @aws-lambda-powertools/commons,或使用 pnpm add / yarn add / bun add。

@aws-lambda-powertools/commons 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aws-lambda-powertools/commons 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aws-lambda-powertools/commons 可以商用吗?

@aws-lambda-powertools/commons 使用 MIT-0 许可。声明的许可为 MIT-0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@aws-lambda-powertools/commons 的下载量有多少?

根据 npm 官方下载统计,@aws-lambda-powertools/commons 在 2026/10/08 – 2026/11/06 这 30 天内被下载 6,955,856 次,日均约 231,862 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws-lambda-powertools/commons 还在维护吗?

最新版本 2.36.0 发布于 2026/10/06(1 个月前);至今共发布 130 个版本,其中过去 12 个月发布了 11 个;首次发布于 2021/12/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。