# @forgerock/javascript-sdk

> ForgeRock JavaScript SDK

Latest version **4.9.1** (published 2026-05-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install @forgerock/javascript-sdk
pnpm add @forgerock/javascript-sdk
yarn add @forgerock/javascript-sdk
bun add @forgerock/javascript-sdk
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.9.1 |
| Published | 2026-05-06 |
| First published | 2019-07-31 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 553.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 46 |
| Author | ForgeRock |
| Maintainers | daveernstingfr, froliver, chuckmasucci, jaredjensen, deansteen, mrpotes, andrew.hertel, adamheath-fr, lsanches, cerebrl, ryanbas21, pingnpm, ancheetah |

## Links

- npm: https://www.npmjs.com/package/@forgerock/javascript-sdk
- Repository: https://github.com/ForgeRock/forgerock-javascript-sdk
- Homepage: https://github.com/ForgeRock/forgerock-javascript-sdk#readme
- Issues: https://github.com/ForgeRock/forgerock-javascript-sdk/issues
- npm.io page: https://npm.io/package/@forgerock/javascript-sdk

## Dependencies (2)

- [immer](https://npm.io/package/immer.md) ^10.1.1
- [@reduxjs/toolkit](https://npm.io/package/@reduxjs/toolkit.md) ^2.2.5

## Recent versions

- 4.9.1 (latest) — 2026-05-06
- 0.0.0-beta-20260505164724 (beta) — 2026-05-05
- 4.4.1-alpha.2 (alpha) — 2024-04-23
- 4.0.0-beta.4 (develop) — 2023-04-19
- 2.1.0-rc1 (rc) — 2020-08-24
- 4.9.0 — 2026-03-11
- 0.0.0-beta-20260310201812 — 2026-03-10
- 0.0.0-beta-20260305161615 — 2026-03-05
- 0.0.0-beta-20260226211107 — 2026-02-26
- 0.0.0-beta-20260226205941 — 2026-02-26
- 0.0.0-beta-20260223161130 — 2026-02-23
- 0.0.0-beta-20260128183151 — 2026-01-28
- 4.8.3 — 2025-12-02
- 0.0.0-beta-20251202211115 — 2025-12-02
- 0.0.0-beta-20251113233640 — 2025-11-13
- … 87 more at https://npm.io/package/@forgerock/javascript-sdk/versions

## README

[![npm (scoped)](https://img.shields.io/npm/v/@forgerock/javascript-sdk?color=%23f46200&label=Version&style=flat-square)](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)

<p align="center">
  <a href="https://github.com/ForgeRock">
    <img src="https://cdn-docs.pingidentity.com/navbar/ping-logo-horizontal.svg" alt="Logo">
  </a>
  <h2 align="center">Ping SDK for JavaScript</h2>
  <p align="center">
    <a href="https://github.com/ForgeRock/forgerock-javascript-sdk/blob/master/CHANGELOG.md">Change Log</a>
    ·
    <a href="#support">Support</a>
    ·
    <a href="#documentation" target="_blank">Docs</a>
  </p>
<hr/></p>

The Ping SDK for JavaScript enables you to quickly integrate Ping products into your JavaScript apps.

Use the SDKs to leverage _[Intelligent Access](https://www.pingidentity.com/en/platform/capabilities/intelligent-access.html)_ to easily step through each stage of an authentication tree by using callbacks.

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- REQUIREMENTS - Supported AM versions, API versions, any other requirements. -->

## Requirements

- ForgeRock Identity Platform

  - Ping Advanced Identity Cloud
  - PingAM 6.5.2+

- Browsers:
  - Chrome 87
  - Firefox 84
  - Safari 14
  - Edge 87 (Chromium)
  - Edge 44 (Legacy): requires one polyfill for TextEncoder, [`fast-text-encoding` is recommended](https://www.npmjs.com/package/fast-text-encoding)

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- INSTALLATION -->

## Installation

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

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- QUICK START - Get one of the included samples up and running in as few steps as possible. -->

## Getting Started

To try out the Ping SDK for JavaScript, perform these steps:

1. Setup your PingOne Advanced Identity Cloud tenant or PingAM instance.

   See [Server configuration](https://docs.pingidentity.com/sdks/latest/sdks/tutorials/javascript/00_before-you-begin.html#server_configuration) in the Documentation.

2. Clone this repo:

   ```
   git clone https://github.com/ForgeRock/sdk-sample-apps.git
   ```

3. In the root folder of the repo, use NPM to install dependencies:

   ```
   npm install
   ```

4. Open `javascript/embedded-login/.env.example` and edit the configuration values to match your server.

5. Save the file as `.env` in the same folder.

6. Run the sample app by using a simple HTTP server.

   - Run `npm run start:embedded-login`

7. In a [supported web browser](#requirements), navigate to `https://localhost:8443`.

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- SAMPLES - List the samples we include with the SDKs, where they are, briefly what they show. -->

## Samples

We provide a [sample repo](https://github.com/ForgeRock/sdk-sample-apps) to help demonstrate SDK functionality.

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- DOCS - Link off to the AM-centric documentation at sdks.forgerock.com. -->

## Documentation

Documentation for the SDKs is provided at **<https://docs.pingidentity.com/sdks>**, and includes topics such as:

- Introducing the SDK Features
- Preparing AM for use with the SDKS
- API Reference documentation

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- SUPPORT -->

## Support

If you encounter any issues, be sure to check our **[Troubleshooting](https://support.pingidentity.com/s/article/How-do-I-troubleshoot-the-ForgeRock-SDK-for-JavaScript)** pages.

Support tickets can be raised whenever you need our assistance; here are some examples of when it is appropriate to open a ticket (but not limited to):

- Suspected bugs or problems with ForgeRock software.
- Requests for assistance - please look at the **[Documentation](https://docs.pingidentity.com/sdks)** and **[Knowledge Base](https://support.pingidentity.com/s/knowledge-base)** first.

You can raise a ticket using the **[Ping Identity Support Portal](https://support.pingidentity.com/s/)** that provides one stop access to support services.

The support portal shows all currently open support tickets and allows you to raise a new one by clicking **New Ticket**.

## Version History

[Our version history can be viewed by visiting our CHANGELOG.md](https://github.com/ForgeRock/forgerock-javascript-sdk/blob/master/CHANGELOG.md).

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- COLLABORATION -->

## Contributing

If you would like to contribute to this project you can fork the repository, clone it to your machine and get started.

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- LEGAL -->

## Disclaimer

> **This code is provided by Ping Identity Corporation ("Ping") on an "as is" basis, without warranty of any kind, to the fullest extent permitted by law.
> Ping Identity Corporation does not represent or warrant or make any guarantee regarding the use of this code or the accuracy, timeliness or completeness of any data or information relating to this code, and Ping Identity Corporation hereby disclaims all warranties whether express, or implied or statutory, including without limitation the implied warranties of merchantability, fitness for a particular purpose, and any warranty of non-infringement.
> Ping Identity Corporation shall not have any liability arising out of or related to any use, implementation or configuration of this code, including but not limited to use for any commercial purpose.
> Any action or suit relating to the use of the code may be brought only in the courts of a jurisdiction wherein Ping Identity Corporation resides or in which Ping Identity Corporation conducts its primary business, and under the laws of that jurisdiction excluding its conflict-of-law provisions.**

<!------------------------------------------------------------------------------------------------------------------------------------>
<!-- LICENSE - Links to the MIT LICENSE file in each repo. -->

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

---

&copy; Copyright 2020-2025 Ping Identity. All Rights Reserved

---
_Source: https://npm.io/package/@forgerock/javascript-sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._