Skip to content

A fully typed library to verify hCaptcha.com tokens submitted by users when solving captcha challenges.

License

Notifications You must be signed in to change notification settings

velut/verify-hcaptcha

Repository files navigation

✅ verify-hcaptcha

Build status Coverage jsDocs.io Language npm License

A fully typed library to verify hCaptcha.com tokens submitted by users when solving captcha challenges.

Warning

This is an unofficial library; we are not affiliated with hCaptcha.com.

Useful resources

Install

Using npm:

npm add verify-hcaptcha

Using yarn:

yarn add verify-hcaptcha

Using pnpm:

pnpm add verify-hcaptcha

Using bun:

bun add verify-hcaptcha

Usage Examples

Verify a token submitted by a user:

import { verifyHcaptchaToken } from "verify-hcaptcha";

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");
}

License

MIT

Copyright (c) 2024 Edoardo Scibona

See LICENSE file.