verify-hcaptcha

verify-hcaptcha

A no dependencies, fully typed library to verify hCaptcha tokens submitted by users through 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

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 License

Copyright (c) 2021 Edoardo Scibona

See LICENSE file.