React-google-recaptcha-hook NPM

React Hook for Google reCAPTCHA V3

https://www.google.com/recaptcha/intro/v3.html

Features

⚛ React 18 support
✨ Simple and Easy
🦋 Lightweight
🟢 Zero dependencies
⬇️ Asynchronous APIs

Install

npm install react-google-recaptcha-hook

Simplest Example

import { useGoogleReCaptcha } from "react-google-recaptcha-hook";

const FormComponent = () => {
  const { executeGoogleReCaptcha } = useGoogleReCaptcha(SITE_KEY);

  const submit = async () => {
    const token = await executeGoogleReCaptcha(ACTION_NAME);

    // Do whatever you want with the token
  };

  return <button onClick={submit}>SUBMIT</button>;
};

Usage

const {
  // execute reCAPTCHA with action, return token
  // async (action: string) => Promise<string>
  executeGoogleReCaptcha,
  // hide / show recaptcha-badge
  // async () => Promise<void>
  hideGoogleReCaptcha,
  showGoogleReCaptcha,
} = useGoogleReCaptcha(
  `${YOUR_SITE_KEY}`, // your site key
  {
    hide: `${BOOLEAN}`, // optional, true if you want to hide recaptcha-badge beforehand
    language: `${LANGUAGE_CODE}`, // optional, https://developers.google.com/recaptcha/docs/language
    enterprise: `${BOOLEAN}`, // optional, true if you want to use enterprise edition
    recaptchaNet: `${BOOLEAN}`, // optional, true if you want to use recaptcha.net instead of google.com
  },
);