![npm](https://img.shields.io/npm/v/recaptcha-v3.svg) ![npm type definitions](https://img.shields.io/npm/types/recaptcha-v3.svg)

Usage no npm install needed!

<script type="module">
  import sebakRecaptchaV3 from 'https://cdn.skypack.dev/@sebak/recaptcha-v3';



npm npm type definitions

A simple and easy to use reCAPTCHA (v3 only) library for the browser.


With NPM:

$ npm install recaptcha-v3

With Yarn:

$ yarn add recaptcha-v3


To use this package you only need a valid site key for your domain, which you can easily get here.


With promises:

import { load } from 'recaptcha-v3'

load('<site key>').then((recaptcha) => {
  recaptcha.execute('<action>').then((token) => {
      console.log(token) // Will print the token

With async/await:

import { load } from 'recaptcha-v3'

async function asyncFunction() {
  const recaptcha = await load('<site key>')
  const token = await recaptcha.execute('<action>')

  console.log(token) // Will also print the token

Loader options

The loader takes care of loading the reCAPTCHA script from Google. Therefore the loader offers optional options for additional configuration:

Name Description Type Default value
useRecaptchaNet Due to limitations in certain countries it's required to use recaptcha.net instead of google.com. boolean false
autoHideBadge Will automatically hide the reCAPTCHA badge. Warning: The usage is only allowed if you follow the offical guide for hiding the badge from Google (see here) boolean false


To use the options just pass an additional object to the load(...) method. For example:

import { load } from 'recaptcha-v3'

load('<site key>', {
  useRecaptchaNet: true,
  autoHideBadge: true
}).then((recaptcha) => {