npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-turnstile

v1.1.4

Published

React library for Cloudflare's Turnstile CAPTCHA alternative

Downloads

137,912

Readme

react-turnstile

A very simple React library for Cloudflare Turnstile.

Installation

npm i react-turnstile

Usage

import Turnstile, { useTurnstile } from "react-turnstile";

// ...

function TurnstileWidget() {
  const turnstile = useTurnstile();
  return (
    <Turnstile
      sitekey="1x00000000000000000000AA"
      onVerify={(token) => {
        fetch("/login", {
          method: "POST",
          body: JSON.stringify({ token }),
        }).then((response) => {
          if (!response.ok) turnstile.reset();
        });
      }}
    />
  );
}

Turnstile tokens expire after 5 minutes, to automatically reset the challenge once they expire, set the refreshExpired prop to 'auto' or reset the widget yourself using the onExpire callback.

Reducing Layout Shift

The turnstile iframe initially loads as invisible before becoming visible and expanding to the expected widget size.

This causes Layout Shift and reduces your Cumulative Layout Shift score and UX.

This can be fixed with the fixedSize={true} option, which will force the wrapper div to be the specific size of turnstile.

Bound Turnstile Object

The Bound Turnstile Object is given as argument to all callbacks and allows you to call certain window.turnstile functions without having to store the widgetId yourself.

function Component() {
  return (
    <Turnstile
      execution="execute"
      onLoad={(widgetId, bound) => {
        // before:
        window.turnstile.execute(widgetId);
        // now:
        bound.execute();
      }}
    />
  );
}

Documentation

Turnstile takes the following arguments:

| name | type | description | | ----------------- | ------- | ---------------------------------------------------- | | sitekey | string | sitekey of your website (REQUIRED) | | action | string | - | | cData | string | - | | theme | string | one of "light", "dark", "auto" | | language | string | override the language used by turnstile | | tabIndex | number | - | | responseField | boolean | controls generation of <input /> element | | responseFieldName | string | changes the name of <input /> element | | size | string | one of "normal", "compact" | | fixedSize | boolean | fix the size of the <div /> to reduce layout shift | | retry | string | one of "auto", "never" | | retryInterval | number | interval of retries in ms | | refreshExpired | string | one of "auto", "manual", "never" | | appearance | string | one of "always", "execute", "interaction-only" | | execution | string | one of "render", "execute" | | id | string | id of the div | | userRef | Ref | custom react ref for the div | | className | string | passed to the div | | style | object | passed to the div |

And the following callbacks:

| name | arguments | description | | ------------------- | --------------------------- | --------------------------------------------------- | | onVerify | token | called when challenge is passed | | onSuccess | token, preClearanceObtained | called when challenge is passed | | onLoad | widgetId | called when the widget is loaded | | onError | error | called when an error occurs | | onExpire | - | called when the token expires | | onTimeout | token | called when the challenge expires | | onAfterInteractive | - | called when the challenge becomes interactive | | onBeforeInteractive | - | called when the challenge no longer is interactive | | onUnsupported | - | called when the browser is unsupported by Turnstile |

The callbacks also take an additional BoundTurnstileObject which exposes certain functions of window.turnstile which are already bound to the current widget, so you don't need track the widgetId yourself.

For more details on what each argument does, see the Cloudflare Documentation.