# @forgerock/javascript-sdk 中文文档

规范地址：https://npmcn.com/package/%40forgerock/javascript-sdk/

版本：4\.9\.1
npm 元数据更新时间：2026-07-14T16:40:31.826Z
中文译文更新时间：2026-11-15T07:46:44.427Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40forgerock/javascript-sdk
原文对照：https://npmcn.com/package/%40forgerock/javascript-sdk/?lang=original
项目主页：https://github.com/ForgeRock/forgerock-javascript-sdk#readme
源码仓库：https://github.com/ForgeRock/forgerock-javascript-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：566 kB，535 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2019-07-31T05:41:15.913Z
- 最新版本发布：2026-05-06T14:21:27.343Z
- 近 30 天下载量：146480（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 11 个）

## 中文简介

ForgeRock Java 脚本 SDK

## 安装

```sh
npm install @forgerock/javascript-sdk
```

也可以使用：`pnpm add @forgerock/javascript-sdk`、`yarn add @forgerock/javascript-sdk`、`bun add @forgerock/javascript-sdk`

## README

[![npm (scoped)](https://img.shields.io/npm/v/@forgerock/javascript-sdk?color=%23f46200&label=Version&style=flat-square)](https://npmcn.com/package/%40forgerock/javascript-sdk/CHANGELOG.md) [![ForgeRock CI](https://github.com/ForgeRock/forgerock-javascript-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/ForgeRock/forgerock-javascript-sdk/actions/workflows/ci.yml)

[![Logo](https://cdn-docs.pingidentity.com/navbar/ping-logo-horizontal.svg)](https://github.com/ForgeRock)

## 用于 JavaScript 的平 SDK

[更改日志](https://github.com/ForgeRock/forgerock-javascript-sdk/blob/master/CHANGELOG.md) • 妇女 [支助](https://npmcn.com/package/%40forgerock/javascript-sdk/#readme-support) • 妇女 [文档](https://npmcn.com/package/%40forgerock/javascript-sdk/#readme-documentation)

* * *

JavaScript的Ping SDK使您能够快速地将Ping产品集成到您的JavaScript应用中.

使用 SDK 来杠杆 _[智能访问](https://www.pingidentity.com/en/platform/capabilities/intelligent-access.html)_ 通过使用回调可以轻松地从认证树的每个阶段走入.

## 所需资源

-   ForgeRock 身份识别平台
    
    -   平高级身份云
    -   平安 6.5.2+ (中文(简体) )
-   浏览器 :
    
    -   铬 87
    -   Firefox 84 (英语)
    -   萨法里 14
    -   边87 (铬)
    -   Edge 44 (Legacy): 文本编码器需要一个多填充, [`fast-text-encoding` 建议](https://www.npmjs.com/package/fast-text-encoding)

## 安装

```
npm install @forgerock/javascript-sdk
```

## 开始

为了测试JavaScript的平板SDK,执行这些步骤:

1.  设置你的"平一"高级身份 云租房人或平加姆的例子.
    
    见 [服务器配置](https://docs.pingidentity.com/sdks/latest/sdks/tutorials/javascript/00_before-you-begin.html#server_configuration) 在文档中.
    
2.  克隆这个回波:
    
    ```
    git clone https://github.com/ForgeRock/sdk-sample-apps.git
    ```
    
3.  在repo的根文件夹中,请使用国家防范机制安装依赖性:
    
    ```
    npm install
    ```
    
4.  打开 `javascript/embedded-login/.env.example` 并编辑配置值,以匹配您的服务器.
    
5.  文件另存为 `.env` 在同一文件夹中.
    
6.  通过使用简单的HTTP服务器运行样本应用.
    
    -   运行 `npm run start:embedded-login`
7.  在一个 [支持的网页浏览器](https://npmcn.com/package/%40forgerock/javascript-sdk/#readme-requirements)导航到 `https://localhost:8443`。 。 。 .
    

## 样本

我们提供 [样本还原](https://github.com/ForgeRock/sdk-sample-apps) 帮助演示 SDK 功能.

## 文档

有关SDKs的文件见 **[https://docs.pingidentity.com/sdks (中文(简体) )](https://docs.pingidentity.com/sdks)**,包括下列专题:

-   引入 SDK 特性
-   准备使用 SDKS AM
-   API 参考文件

## 支助

如果你遇到任何问题 请检查一下我们 **[解决问题](https://support.pingidentity.com/s/article/How-do-I-troubleshoot-the-ForgeRock-SDK-for-JavaScript)** 页面.

需要我们协助时,可以提出支持票;这里有一些例子说明何时适合开票(但不限于):

-   ForgeRock软件的疑似错误或问题.
-   援助请求----请看 **[文档](https://docs.pingidentity.com/sdks)** 财务报告和审定财务报表 **[知识库](https://support.pingidentity.com/s/knowledge-base)** 先说.

你可以使用 **[平身份支持门户](https://support.pingidentity.com/s/)** 提供一站式支助服务.

支持门户显示当前所有打开的支持门票,并允许您通过点击提高新的门票 **新建车票**。 。 。 .

## 版本历史

[我们的版本历史可以通过访问我们的 ChangeGELOG.md](https://github.com/ForgeRock/forgerock-javascript-sdk/blob/master/CHANGELOG.md)。 。 。 .

## 捐款

如果您想为这个项目做出贡献,您可以将仓库叉出,复制到您的机器上并启动.

## 免责声明

> **本代码由平身份公司("平")在"如实"的基础上提供,无任何种类的保修,在法律允许的最大限度内提供. 平身份公司不代表、要求或保证使用本代码,也不保证与本代码有关的任何数据或资料的准确性、及时性或完整性,平身份公司特此声明所有担保,不论是明示的、默示的或法定的,包括无限制地表示具有商贸能力、适合某一特定目的的担保,以及任何不违规的担保. 平身份公司不应因本守则的任何使用、实施或配置而产生或产生任何赔偿责任,包括但不限于用于任何商业目的. 与使用该守则有关的任何诉讼或诉讼只能由平身份公司所在地或平身份公司主要经营的法域的法院提起,并且根据该法域的法律排除其法律冲突条款.**

## 许可证

这个项目根据麻省理工学院许可证颁发——见 [自由主义](https://npmcn.com/package/%40forgerock/javascript-sdk/LICENSE) 详细文件

* * *

版权2020-2025平人身份. 所有权利保留d

## 常见问题

### @forgerock/javascript-sdk 是什么？

ForgeRock Java 脚本 SDK

### 如何安装 @forgerock/javascript-sdk？

在项目目录运行 npm install @forgerock/javascript-sdk，或使用 pnpm add / yarn add / bun add。

### @forgerock/javascript-sdk 支持 TypeScript 吗？

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

### @forgerock/javascript-sdk 支持 ESM 还是 CommonJS？

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

### @forgerock/javascript-sdk 可以商用吗？

@forgerock/javascript-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @forgerock/javascript-sdk 的下载量有多少？

根据 npm 官方下载统计，@forgerock/javascript-sdk 在 2026/10/16 – 2026/11/14 这 30 天内被下载 146,480 次，日均约 4,883 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @forgerock/javascript-sdk 还在维护吗？

最新版本 4\.9\.1 发布于 2026/05/06（6 个月前）；至今共发布 102 个版本，其中过去 12 个月发布了 11 个；首次发布于 2019/07/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。