@aws-lite/client

中文文档
0.24.1发布于 2026/10/17Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 849.2万

简单、快、可扩展的 AWS 客户端

中文使用文档
文档目录14 节
  1. 是谁做的?
  2. 那么,这是什么 aws-lite ? 吗?
  3. 为什么不使用 aws-sdk 编号 : @aws-sdk/* ? 吗?
  4. 特征
  5. 安装 aws-lite
  6. 示例
  7. 学多点
  8. 客户端配置
  9. 要求/答复
  10. 使用类型脚本
  11. 插件 API
  12. 业绩
  13. 捐款
  14. 正式名单 @aws-lite/* 插件
aws-lite

aws-lite 简单,极快,可扩展的节点.js客户端与AWS服务交互.

(其误报也好

你可以把它看作是AWS的JavaScript SDK的一种由社区驱动的替代品.

GitHub CI status npm version Apache-2.0 License


是谁做的?

aws-lite 由居民开发和维护 OpenJS基金会建筑师我们小于3 AWS!

那么,这是什么 aws-lite? 吗?

aws-lite 是一个简单,极快,可扩展的节点.js客户端,用于与AWS服务交互.

(其误报也好

你可以把它看作是AWS的JavaScript SDK的一种由社区驱动的替代品.

为什么不使用 aws-sdk 编号 : @aws-sdk/*? 吗?

亚马逊历史上在维持其SDK方面做了出色的工作. 然而,AWS已经将其被广泛采纳的v2 SDK贬值;其v3 SDK依赖于生成的代码,导致大量依赖,性能差,语义尴尬,难以理解文档,以及没有可使用堆栈痕迹的错误.

我们依靠并相信AWS,所以我们建立了 aws-lite 在Node.js中提供更简单、更快、更稳定的位置,以便与AWS服务合作.

特征

  • 2-5x比AWS SDK v3快
  • 简单的语义化和直接的基于承诺的界面
  • 人可读文件
  • 可自定义
  • 堆栈跟踪和行号出错
  • 内建平面
  • 用 AWS 签名 v4 担保
  • 不需要任何插件即可与任何 AWS 服务进行交互
  • 自动解析/序列化 JSON, AWS- flavored JSON, 和 XML 请求/ 响应有效载荷
  • 方便地与本地测试套件和AWS服务模拟
  • 使用现有的服务插件,或 开发自己的
  • 检查原始请求和回复的调试模式
  • 就两个依附关系

安装 aws-lite

安装客户端 :

npm i @aws-lite/client

您可以使用客户端作为-is与 AWS 服务 APIs 快速交互,或者用这样的特定服务插件扩展:

npm i @aws-lite/dynamodb

一般情况下,类型可选 @aws-lite/*-types 软件包,可以这样添加:

npm i -D @aws-lite/dynamodb-types

学习更多关于 aws-lite 类型.

示例

现在开始给AWS打电话:

// Instantiate a client with the DynamoDB plugin
import awsLite from '@aws-lite/client'
const aws = await awsLite({ region: 'us-west-1', plugins: [ import('@aws-lite/dynamodb') ] })

// Easily interact with the AWS services your application relies on
await aws.DynamoDB.PutItem({
  TableName: '$table-name',
  Item: {
    // AWS-lite automatically de/serializes DynamoDB JSON
    pk: '$item-key',
    data: {
      ok: true,
      hi: 'friends'
    }
  }
})

await aws.DynamoDB.GetItem({
  TableName: '$table-name',
  Key: { pk: '$item-key' }
})
// {
//   Item: {
//     pk: '$item-key',
//     data: data: {
//       ok: true,
//       hi: 'friends'
//     }
//   }
// }

// Use the lower-level client to fire a GET request by specifying a `service` and `endpoint`
await aws({
  service: 'lambda',
  endpoint: '/2015-03-31/functions/$function-name/configuration',
})
// {
//   FunctionName: '$function-name',
//   Runtime: 'nodejs20.x',
//   ...
// }

// POST JSON by adding a `payload` property
await aws({
  service: 'lambda',
  endpoint: '/2015-03-31/functions/$function-name/invocations',
  payload: { ok: true },
})

学多点

客户端配置

证书和一般配置选项 aws-lite

要求/答复

使用 aws-lite 提出请求并收到答复

使用类型脚本

使用 TypeScript 的指南和示例 aws-lite

插件 API

文档和实例 aws-lite 插件 API

业绩

公开的、可复制的、现实世界的度量标准,用于 aws-lite 和其他 AWS SDKs 软件

捐款

开源捐助方准则、方法和指示

正式名单 @aws-lite/* 插件

版本与发布记录

@aws-lite/client 共发布 82 个版本,首次发布于 2023/09/08;过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.24.1latest2026/10/1721 天前
0.24.02026/09/261 个月前
0.23.72026/06/104 个月前
0.23.62026/04/116 个月前
0.23.52026/03/078 个月前
0.23.42026/03/078 个月前

其他发布通道:RC → 0.22.0-RC.3。

关于 @aws-lite/client 的常见问题

@aws-lite/client 是什么?

简单、快、可扩展的 AWS 客户端

如何安装 @aws-lite/client?

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

@aws-lite/client 支持 TypeScript 吗?

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

@aws-lite/client 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@aws-lite/client 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aws-lite/client 可以商用吗?

@aws-lite/client 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-lite/client 的下载量有多少?

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

@aws-lite/client 还在维护吗?

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