@datarangers/sdk-javascript

中文文档
0.1.7发布于 2026/10/21SEE LICENSE IN LICENSETypeScriptESM + CJS近 30 天下载 1.5万

简体中文 联合国 {\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} DataRangers SDK - Web端 □ □ □ SDK

中文使用文档
文档目录5 节
  1. 构建SDK
  2. 使用方式
  3. 1. 在你的js文件中初始化SDK
  4. 2. 上报自定义用户事件
  5. 3. 使用当前登录用户的信息做为唯一标识来进行上报

简体中文 | English

DataRangers SDK - Web端

构建SDK

npm install 
npm run build

使用方式

1. 在你的js文件中初始化SDK

const SDK = require('@datarangers/sdk-javascript');

SDK.init({
  app_id: 1234, // 替换成你申请的 "APP_ID"
  channel: 'cn', // 选择你要上报的区域,cn: 国内 sg: 新加坡 va:美东
  log: true, // 是否打印日志
});

SDK.config({
  username: 'xxx', // 你想要上报一个username的公共属性
});

SDK.start(); // 初始化完成,事件开始上报

2. 上报自定义用户事件

// 比如上报一个'play_video'视频播放的事件
SDK.event('play_video', {
  title: 'Here is the video title',
});

3. 使用当前登录用户的信息做为唯一标识来进行上报

// 可以在用户登录后获取带有唯一性的标识来设置给user_unique_id
 SDK.config({
    user_unique_id: 'zhangsan', // 用户唯一标识,可以是你的系统登录用户id
  });

版本与发布记录

@datarangers/sdk-javascript 共发布 17 个版本,首次发布于 2022/12/13;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.1.7latest2026/10/2121 天前
0.1.62026/09/231 个月前
0.1.52026/09/231 个月前
0.1.42025/12/3010 个月前
0.1.32025/09/231.1 年前
0.1.22025/09/091.2 年前

其他发布通道:lite → 0.0.5-lite。

关于 @datarangers/sdk-javascript 的常见问题

@datarangers/sdk-javascript 是什么?

简体中文 联合国 {\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} DataRangers SDK - Web端 □ □ □ SDK

如何安装 @datarangers/sdk-javascript?

在项目目录运行 npm install @datarangers/sdk-javascript,或使用 pnpm add / yarn add / bun add。

@datarangers/sdk-javascript 支持 TypeScript 吗?

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

@datarangers/sdk-javascript 支持 ESM 还是 CommonJS?

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

@datarangers/sdk-javascript 可以商用吗?

@datarangers/sdk-javascript 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@datarangers/sdk-javascript 的下载量有多少?

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

@datarangers/sdk-javascript 还在维护吗?

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