h Captcha 装入器
这是 JavaScript 库, 便于配置装入 h 卡普察语Name JS客户SDK有内置错误处理. 它还包括一个重试机制,在hCaptcha脚本由于网络或出乎意料的问题而未能加载时会尝试多次加载.
h 卡普察语Name 是一个用于 reCAPTCHA 的保护用户隐私的倒置.
报名到 h 卡普察语Name 去拿你的地钥匙. 要使用此库需要一个站点键 .
安装
npm install @hcaptcha/loader
或者使用UNPKG通过CDN加载, 说明如下:。 。 。 .
执行情况
import { hCaptchaLoader } from '@hcaptcha/loader';
await hCaptchaLoader();
hcaptcha.render({
sitekey: '<your_sitekey>'
});
const { response } = await hcaptcha.execute({ async: true });
道具
| 名称 | 数值/类型 | 需求 | 默认 | 说明 |
|---|---|---|---|---|
loadAsync | 布尔 | 没有 | true | 设定是否同步装入脚本 . |
cleanup | 布尔 | 没有 | false | 设置后删除脚本标记 . |
crossOrigin | 字符串 | 没有 | anonymous | 设定"匿名"等脚本交叉出自属性. |
scriptSource | 字符串 | 没有 | https://js.hcaptcha.com/1/api.js | 设置脚本源 URI. 胜过 secureApi。 。 。 . |
scriptLocation | HTML 元素 | 没有 | document.head | 附加脚本标签的位置 。 确保将其添加到一个将持续防止在同一文档视图中多次加载的区域. |
secureApi | 布尔 | 没有 | false | 见企业文件. |
apihost | 字符串 | 没有 | - | 见企业文件. |
assethost | 字符串 | 没有 | - | 见企业文件. |
endpoint | 字符串 | 没有 | - | 见企业文件. |
hl | 字符串 | 没有 | - | 见企业文件. |
host | 字符串 | 没有 | - | 见企业文件. |
imghost | 字符串 | 没有 | - | 见企业文件. |
recaptchacompat | 字符串 | 没有 | - | 见企业文件. |
reportapi | 字符串 | 没有 | - | 见企业文件. |
sentry | 布尔 | 没有 | - | 见企业文件. |
uj | 布尔 | 没有 | - | 见企业文件. |
custom | 布尔 | 没有 | - | 见企业文件. |
遗产支助
为了支持更古老的浏览器,会生成一个单独的捆绑,其中将所有ES6代码编译为ES5并附带一个可选的多填装捆绑.
polyfills.js: 为旧浏览器中不支持的特性提供多填充.index.es5.js数字 : @hcaptcha/ loader (英语) 为ES5环境编译了软件包.
导入套装
生成的两个捆绑都使用IIFE格式而不是更现代的导入语法,例如 require 或者说 esm。 。 。 .
// Optional polyfill import
import '@hCaptcha/loader/dist/polyfills.js';
// ES5 version of hCaptcha Loader
import '@hCaptcha/loader/dist/index.es5.js';
hCaptchaLoader().then(function(hcaptcha) {
var element = document.createElement('div');
// hCaptcha API is ready
hcaptcha.render(element, {
sitekey: 'YOUR_SITE_KEY',
// Additional options here
});
});
类型脚本
要用ES5版本处理打字符,请使用以下语句.
declare global {
interface Window {
hCaptchaLoader: any;
}
}
光盘N
针对更老浏览器的 hCaptcha 装入器也可以通过 CDN 导入 联科办,见下文实例.
<!DOCTYPE html>
<head>
<script type="text/javascript" src="https://unpkg.com/@hcaptcha/loader@latest/dist/polyfills.js"></script>
<script type="text/javascript" src="https://unpkg.com/@hcaptcha/loader@latest/dist/index.es5.js"></script>
</head>
<body>
<div id="container"></div>
<script type="text/javascript">
hCaptchaLoader().then(function(hcaptcha) {
// hCaptcha API is ready
hcaptcha.render('container', {
sitekey: 'YOUR_SITE_KEY',
// Additional options here
});
});
</script>
</body>
</html>
社区支助方案
请注意,你应该使用 strict-dynamic 该加载器的策略,因为它需要装入 SDK 通过 appendChild()。 。 。 .
哨兵
通过设置 sentry 标记为假,这样可以防止客户端错误报告发送到我们.
hCaptchaLoader({ sentry: false });