✅ verify-hcaptcha

A no dependencies, fully typed library to verify hCaptcha tokens submitted by users when solving CAPTCHA challenges.

⚠️ Note: this is an unofficial library; we are not affiliated with hCaptcha.com

Features

• No dependencies
• Fully typed API and response data
• Well documented and tested

API & Package Info

• Explore the API on jsDocs.io
• View package contents on unpkg
• View repository on GitHub
• Read official documentation on hCaptcha

Install

Using npm:

npm i verify-hcaptcha

Using yarn:

yarn add verify-hcaptcha

Using pnpm:

pnpm i verify-hcaptcha

Usage Examples

Verify a token submitted by a user:

import { verifyHcaptchaToken } from "verify-hcaptcha";

(async () => {
  const result = await verifyHcaptchaToken({
    token: "USER-SUBMITTED-RESPONSE-TOKEN",
    secretKey: "YOUR-SECRET-KEY",
    siteKey: "YOUR-SITE-KEY",
  });

  if (result.success) {
    console.log("User is human");
  } else {
    console.log("User is robot");
  }
})();

Verify a token submitted by a user and get the raw response from hCaptcha:

import { rawVerifyHcaptchaToken } from "verify-hcaptcha";

(async () => {
  const result = await rawVerifyHcaptchaToken({
    token: "USER-SUBMITTED-RESPONSE-TOKEN",
    secretKey: "YOUR-SECRET-KEY",
    siteKey: "YOUR-SITE-KEY",
  });

  if (result.success) {
    console.log("User is human");
  } else {
    console.log("User is robot");
  }
})();

License

MIT

MIT License. See LICENSE file.

Copyright (c) 2023 Edoardo Scibona.