@guestyorg/tokenization-js

中文文档
1.2.0发布于 2026/09/02MITTypeScriptESM + CJS零依赖近 30 天下载 3.3万

客串化 SDK 装载工具及类型

中文使用文档
文档目录6 节
  1. 手动包含脚本标签
  2. 用它作为ES模块
  3. 安装
  4. 使用量
  5. 加载脚本( 选项 )
  6. 类型脚本支持

JS SDK 客串化

融合SDK有两种方法:

手动包含脚本标签

在您的应用程序中添加脚本标签 head 或者说 body。 。 。 . 此负载 guestyTokenization 全局对象 window 浏览器范围

<script src="https://pay.guesty.com/tokenization/v3/init.js"></script>

用它作为ES模块

将 SDK 装入模块的好处 :

  • 同步加载脚本以确保页面渲染不被屏蔽
  • 返回一个承诺,以知道脚本装入何时完成
  • 决定: null 如果在服务器环境中调用

注意: 要符合PCI, 您必须直接装入 SDK https://pay.guesty.com (英语) (或者通过添加脚本标记或者使用ES模块). 你不能把它包含在一个捆绑或主机.

安装

使用 npm 安装Guesty Tokenization JS模块:

npm install @guestyorg/tokenization-js

使用量

导入 loadScript 用于同步装入 Guesty Tokenization JS SDK 的功能

加载脚本( 选项 )

  • 接受一个 options 对象以配置脚本 URL 和属性
  • 返回以 window.guestyTokenization sDK 装入完成后

选项

  • sandbox - 把SDK装入沙盒模式
  • version - 要装入的 SDK 版本( 默认 ): v1) (中文(简体) ). 支持的数值 : v1, (中文(简体) ), v2, (中文(简体) ), v3
loadScript({ sandbox: true, version: 'v3' });

这相当于以下剧本:

<script
  src="https://pay.guesty.com/tokenization/v3/init.js"
  data-env="sandbox"
></script>

自动/等待

import { loadScript } from '@guestyorg/tokenization-js';

try {
  const guestyTokenization = await loadScript({ version: 'v3' });
  // Guesty Tokenization JS SDK is loaded and ready to use
} catch (error) {
  console.error('Failed to load the Guesty Tokenization JS SDK script', error);
}

承诺

import { loadScript } from '@guestyorg/tokenization-js';

loadScript({ version: 'v3' })
  .then((guestyTokenization) => {
    // Guesty Tokenization JS SDK is loaded and ready to use
  })
  .catch((error) => {
    console.error(
      'Failed to load the Guesty Tokenization JS SDK script',
      error
    );
  });

类型脚本支持

这个包包括了Guesty Tokenization JS SDK的TypeScript类型定义. 这包括用于 window.guestyTokenization 名称空间。 我们支持使用 TypeScript 版本\\ 3.8 的项目.

版本与发布记录

@guestyorg/tokenization-js 共发布 9 个版本,首次发布于 2023/09/14;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.2.0latest2026/09/022 个月前
1.1.12024/10/102 年前
1.1.02024/10/092 年前
1.0.42024/08/062 年前
1.0.32024/06/032 年前
1.0.22024/03/182 年前

关于 @guestyorg/tokenization-js 的常见问题

@guestyorg/tokenization-js 是什么?

客串化 SDK 装载工具及类型

如何安装 @guestyorg/tokenization-js?

在项目目录运行 npm install @guestyorg/tokenization-js,或使用 pnpm add / yarn add / bun add。

@guestyorg/tokenization-js 支持 TypeScript 吗?

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

@guestyorg/tokenization-js 支持 ESM 还是 CommonJS?

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

@guestyorg/tokenization-js 可以商用吗?

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

@guestyorg/tokenization-js 的下载量有多少?

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

@guestyorg/tokenization-js 还在维护吗?

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