@captchahub/turnstile

中文文档
1.0.11发布于 2026/08/29TypeScriptES Module近 30 天下载 6472

CaptchaHub Turnstile是一个TypeScript库,提供与Turnstile Captcha服务的集成,允许在您的应用程序中实现无缝Captcha执行. 此软件包将 CaptchaHub 的核心功能扩展至支持 Turn

中文使用文档
文档目录10 节
  1. 安装
  2. 特征
  3. 使用量
  4. 获取 Captcha 脚本
  5. 获取 Captcha 窗体元素
  6. 正在验证 Captcha
  7. 配置
  8. 扩展性
  9. 理由
  10. 捐款

CaptchaHub 转弯

CaptchaHub Turnstile是一个TypeScript库,提供与Turnstile Captcha服务的集成,允许在您的应用程序中实现无缝Captcha执行. 这个软件包扩展了CaptchaHub的核心功能,支持Turnstile作为Captcha提供者.

安装

使用 pnpm 安装软件包 :

pnpm add @captchahub/core
pnpm add @captchahub/turnstile

特征

  • 用户体验: Turnstile旨在增强用户体验,同时确保安全.
  • 可自定义:轻松地自定义出卡布特克的外观和行为.
  • 需要核心软件包: 此软件包需要 @captchahub/core 用于功能的软件包.

使用量

获取 Captcha 脚本

这个 getCaptchaScript 函数可用如下:

import { getCaptchaScript } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/turnstile';

const config = {
    CAPTCHA_PROVIDER: 'turnstile',
    TURNSTILE_SITE_KEY: process.env.TURNSTILE_SITE_KEY, // Your Turnstile site key
};

const CaptchaComponent = async () => {
    const CaptchaScript = getCaptchaScript(config);

    return (
        <div>
            <CaptchaScript />
            {/* Additional form elements */}
        </div>
    );
};

获取 Captcha 窗体元素

这个 getCaptchaFormElement 函数可用如下:

import { getCaptchaFormElement } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/turnstile';

const config = {
    CAPTCHA_PROVIDER: 'turnstile',
    TURNSTILE_SITE_KEY: process.env.TURNSTILE_SITE_KEY, // Your Turnstile site key
};

const CaptchaFormComponent = async () => {
    const CaptchaFormElement = getCaptchaFormElement(config);

    return (
        <div>
            <CaptchaFormElement />
            {/* Additional form elements */}
        </div>
    );
};

正在验证 Captcha

这个 verifyCaptcha 函数可用如下:

import { verifyCaptcha } from '@captchahub/core';
// Import the provider package to trigger self-registration
import '@captchahub/turnstile';

const config = {
    CAPTCHA_PROVIDER: 'turnstile',
    TURNSTILE_SECRET_KEY: process.env.TURNSTILE_SECRET_KEY, // Your Turnstile secret key
};

const formFieldValues = {
    // Your form field values that need to be verified
};

const isValid = await verifyCaptcha(formFieldValues, config);
if (isValid) {
    console.log('Captcha verified successfully!');
} else {
    console.error('Captcha verification failed.');
}

配置

Turnstile 提供者的配置可以在创建 Captcha 实例时传递到工厂的配置对象中定义. 配置对象必须包含 CAPTCHA_PROVIDER 属性以指定要使用的 Captcha 提供者。 此外,您还需要提供 TURNSTILE_SITE_KEY 财务报告和审定财务报表 TURNSTILE_SECRET_KEY 用于适当的功能.

扩展性

这个 @captchahub/turnstile 软件包的设计可扩展。 您可以通过执行 CaptchaInterface。这使得您可以在未来为额外的cabtcha服务添加支持.

理由

这个 @captchahub/turnstile 软件包旨在为TypeScript应用程序中的captcha工作流程管理提供与Turnstile服务的集成。 通过使用核心软件包,开发者可以轻松地将Turnstile能力整合到他们的网络应用中.

捐款

欢迎捐款! 请随意将这个项目叉出并提交拉动请求. 在提交之前,请确保您的代码通过所有起伏和单元测试.

您可以使用 :

pnpm format

您可以使用 :

pnpm test

版本与发布记录

@captchahub/turnstile 共发布 11 个版本,首次发布于 2024/11/24;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.11latest2026/08/292 个月前
1.0.102026/08/063 个月前
1.0.92026/03/297 个月前
1.0.82026/03/277 个月前
1.0.62025/08/021.3 年前
1.0.52025/03/031.7 年前

关于 @captchahub/turnstile 的常见问题

@captchahub/turnstile 是什么?

CaptchaHub Turnstile是一个TypeScript库,提供与Turnstile Captcha服务的集成,允许在您的应用程序中实现无缝Captcha执行. 此软件包将 CaptchaHub 的核心功能扩展至支持 Turn

如何安装 @captchahub/turnstile?

在项目目录运行 npm install @captchahub/turnstile,或使用 pnpm add / yarn add / bun add。

@captchahub/turnstile 支持 TypeScript 吗?

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

@captchahub/turnstile 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@captchahub/turnstile 可以商用吗?

@captchahub/turnstile 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@captchahub/turnstile 的下载量有多少?

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

@captchahub/turnstile 还在维护吗?

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