@captchafox/react

中文文档
1.13.0发布于 2026/06/30MITTypeScriptESM + CJS构建来源已验证近 30 天下载 99.5万

NPM version

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 道具
  4. 使用验证回调
  5. 与实例互动

@ captchafox/ 反应

NPM version

安装

使用您喜欢的软件包管理器安装库

npm install @captchafox/react
yarn add @captchafox/react
pnpm add @captchafox/react
bun add @captchafox/react

使用量

import { CaptchaFox } from '@captchafox/react';

function Example() {
  return <CaptchaFox sitekey="sk_11111111000000001111111100000000" />;
}

道具

Prop类型说明需求
站台密钥string部件的站点密钥✅
朗语string部件应显示的语言 。 默认自动检测它.
模式inline|popup|hidden部件应显示在 .
开始none|auto|focus核查开始时的控制。 默认为 none。 。 。 .
主题light | dark | ThemeDefinition部件的主题 。 默认为光.
无string随机生成的非ce.
i18n (英语)object自定义i18n配置.
隐藏boolean隐藏关闭按钮并阻止用户关闭部件模式.
认证function在成功核实后,以响应符号调用.
失败function在核查失败后打电话.
错误function当错误发生时调用 .
结束function当挑战结束时召唤.
关闭function当挑战结束时打电话来.

使用验证回调

import { CaptchaFox, CAPTCHA_RESPONSE_KEY } from '@captchafox/react';

function Example() {
  const handleVerify = (token: string) => {
    // do something with the token here (e.g. submit the form)
    const formData = {
      // your form data
      [CAPTCHA_RESPONSE_KEY]: token
    };
  };

  return <CaptchaFox sitekey="sk_11111111000000001111111100000000" onVerify={handleVerify} />;
}

与实例互动

import { useRef } from 'react'
import { CaptchaFox, CaptchaFoxInstance } from '@captchafox/react'

function Example() {
    const captchaRef = useRef<CaptchaFoxInstance | null>(null);

    const triggerAction = async () => {
        // execute the captcha
        try {
            const token = await captchaRef.current?.execute()
        } catch {
            // unsuccessful verification
        }
    }

    return (
        <CaptchaFox
            sitekey="sk_11111111000000001111111100000000"
            ref={captchaRef}
        />
        <button onClick={triggerAction}>Action</button>
    )
}

您可以在 GitHub 仓库。 。 。 .

版本与发布记录

@captchafox/react 共发布 21 个版本,首次发布于 2023/03/24;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.13.0latest2026/06/304 个月前
1.12.12026/06/224 个月前
1.12.02026/04/206 个月前
1.11.02026/03/038 个月前
1.10.02025/09/041.2 年前
1.9.02025/03/241.6 年前

关于 @captchafox/react 的常见问题

如何安装 @captchafox/react?

在项目目录运行 npm install @captchafox/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、react-dom(>=16.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@captchafox/react 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@captchafox/react 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@captchafox/react 可以商用吗?

@captchafox/react 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@captchafox/react 的下载量有多少?

根据 npm 官方下载统计,@captchafox/react 在 2026/10/09 – 2026/11/07 这 30 天内被下载 995,039 次,日均约 33,168 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@captchafox/react 还在维护吗?

最新版本 1.13.0 发布于 2026/06/30(4 个月前);至今共发布 21 个版本,其中过去 12 个月发布了 4 个;首次发布于 2023/03/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。