@esri/telemetry-siteimprove

中文文档
5.1.2发布于 2026/10/23Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 6438

Siteimprove 的 Esri 遥测包

中文使用文档
文档目录8 节
  1. 目录
  2. 安装
  3. 如何运作
  4. 浏览器
  5. 服务器
  6. 问题
  7. 捐款
  8. 许可证

@esri/telemetry-siteimprove

站点改进 用于 @esri/telemetry。此软件包创建了具有适当属性的 Siteimprove 脚本,并注入到 DOM 中.

目录

安装

npm install @esri/telemetry @esri/telemetry-siteimprove

如何运作

@esri/telemetry-siteimprove 软件包在客户端浏览器和服务器端节点.js中工作. 要使用,安装软件包,将软件包纳入您的工程,创建插件实例,并添加到 plugins 以 @esri/遥测

以下为如何使用浏览器插件的例子.

浏览器

import { Telemetry } from '@esri/telemetry'
import { Siteimprove } from '@esri/telemetry-siteimprove'

const siteimproveTracker = new Siteimprove({
  code: 'XXXXXX' // required, replace with code
})

const telemetryOptions = {
  plugins: [siteimproveTracker],
  portal: {
    subscriptionInfo: {},
    user: {},
  },
}

const telemetry = new Telemetry(telemetryOptions)
await telemetry.init();

telemetry.logPageView({page: 'home'}) // Required
telemetry.logEvent({
  action: 'Download', // Required
  category: 'Dataset', // Required
  label: 'New' // Optional

})

服务器

import { Telemetry } from '@esri/telemetry';
import { Siteimprove } from '@esri/telemetry-siteimprove';

const siteimproveTracker = new Siteimprove({
  code: 'XXXXXX' // required, replace with code
});

const telemetryOptions = {
  plugins: [siteimproveTracker],
  portal: {
    subscriptionInfo: {},
    user: {},
  },
};

const telemetry = new Telemetry(telemetryOptions);

const scriptTags = telemetry.getScriptTags();

初始化后 Telemetry.js 与 telemetry-siteimprove 插件, 遥测数据将发送到与所提供的 Siteimprove ID 相关的 Siteimprove 分析实例 .

问题

如果有什么不起作用,请看一看 以往问题 先说 你找到新窃听器了吗? 创建问题 这里。 。 。 .

捐款

Esri欢迎所有人的贡献。 请看我们的 提交文件的准则。 。 。 .

许可证

版权: 2022 Esri

根据Apache许可证第2.0版("License"); 您不得使用此文件,除非符合许可证. 您可在下列地点获得许可证副本:

http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )

除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

许可证副本可到存放处索取 自由主义 文档.

版本与发布记录

@esri/telemetry-siteimprove 共发布 33 个版本,首次发布于 2022/05/03;过去 12 个月发布了 1 个版本。

版本发布日期距今
5.1.2latest2026/10/2322 天前
5.1.12025/07/121.3 年前
5.1.02025/07/111.3 年前
5.0.02025/07/101.3 年前
4.0.22025/04/161.6 年前
4.0.12024/03/212 年前

其他发布通道:next → 3.1.4。

关于 @esri/telemetry-siteimprove 的常见问题

@esri/telemetry-siteimprove 是什么?

Siteimprove 的 Esri 遥测包

如何安装 @esri/telemetry-siteimprove?

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

@esri/telemetry-siteimprove 支持 TypeScript 吗?

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

@esri/telemetry-siteimprove 支持 ESM 还是 CommonJS?

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

@esri/telemetry-siteimprove 可以商用吗?

@esri/telemetry-siteimprove 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@esri/telemetry-siteimprove 的下载量有多少?

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

@esri/telemetry-siteimprove 还在维护吗?

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