# @bufferapp/buffer-tracking-browser-ts 中文文档

规范地址：https://npmcn.com/package/%40bufferapp/buffer-tracking-browser-ts/

版本：1\.0\.248
npm 元数据更新时间：2026-06-02T05:48:51.450Z
中文译文更新时间：2026-11-08T18:30:55.918Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bufferapp/buffer-tracking-browser-ts
原文对照：https://npmcn.com/package/%40bufferapp/buffer-tracking-browser-ts/?lang=original
项目主页：https://github.com/bufferapp/buffer-tracking-app-browser-ts#readme
源码仓库：https://github.com/bufferapp/buffer-tracking-app-browser-ts

弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.3 MB，23 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2021-01-14T09:19:56.846Z
- 最新版本发布：2024-09-25T12:47:17.601Z
- 近 30 天下载量：5803（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：371（近 12 个月 0 个）

## 中文简介

用于基于浏览器的缓冲键标项目的部分跟踪库

## 安装

```sh
npm install @bufferapp/buffer-tracking-browser-ts
```

也可以使用：`pnpm add @bufferapp/buffer-tracking-browser-ts`、`yarn add @bufferapp/buffer-tracking-browser-ts`、`bun add @bufferapp/buffer-tracking-browser-ts`

## README

[![npm version](https://badge.fury.io/js/@bufferapp%2Fbuffer-tracking-browser-ts.svg)](https://badge.fury.io/js/@bufferapp%2Fbuffer-tracking-browser-ts)

# 缓冲跟踪器 - 浏览器( Typescript)

用于浏览器 Typescript项目的强类型段跟踪伴奏 。 盖子下方使用缓冲部分跟踪计划,作为客户的型号安全包装. 有了这个,就没有必要调用或参考追踪计划了!

您需要配置段 [根据这些指示](https://segment.com/docs/protocols/apis-and-extensions/typewriter/#browser-quickstart) 在使用此软件包之前.

您可以通过运行来安装 :

```
npm install @bufferapp/buffer-tracking-browser-ts
```

在使用前,您需要确保您的项目配置为访问分区. [你可以跟着这个向导走](https://segment.com/docs/connections/sources/catalog/libraries/website/javascript/quickstart/)。 。 。 .

您接下来需要将打字机导入到想要的文件 :

```
import {BufferTracker} from '@bufferapp/buffer-tracking-browser-ts'
```

在添加了依赖性后,您可以使用打字机引用来调用想要的跟踪功能:

```
typewriter.draftSubmitted({
  product: 'publish',
  channel: 'instagram',
  channelType: 'business',
  postId: '58edaj782102dff',
  channelId: '12345679',
  channelServiceId: '987654567898'
})
```

当调用这些功能时, 任何违反或错误都会被记录为对您的控制台的警告 。 如果您希望这些投出出出错( 可能在开发过程中) , 您可以在打字机引用上配置选项, 以启用此功能 :

```
typewriter.setTypewriterOptions({
  onViolation: (msg, violations) => {
    const issues = violations.map(v => v.keyword === 'type' ? `${v.message}: '${v.dataPath}'` : `${v.message}`)
    throw new Error(
      `"${msg.event}" Fired with Tracking Plan Violation\n    ${issues.join('\n    ')}`
    )
  }
})
```

* * *

## 产品/客户打字

如果您需要访问产品或客户端的打字,您可以这样导入:

从“ @bufferapp/buffer- tracking-node-ts” 导入{Production, 客户端} 如果有一个产品或客户端没有包含,请在#data-government slow 通道中告诉我们,并且可以添加:)

* * *

## 抓到他们了

目前没有类型支持在触发跟踪事件时对用户ID或匿名ID的要求. 我们正在努力在最近的将来增加对此的支持,但现在必须指出,在追踪时必须增加其中任一支持!

## 图书馆未反映的最新计划变动

如果库没有反映最新的跟踪变化,那么您可以手动触发重建 。 头去 [这个 URL](https://github.com/bufferapp/tracking-plan/actions/workflows/create_client_tracking_plan.yml) 并选择运行工作流程选项。 几分钟后,应把最新的释放通知国家预防机制.

![Screenshot 2021-06-01 at 14 25 51](https://user-images.githubusercontent.com/3879281/120331073-4ff9c380-c2e5-11eb-879a-38fceb71139c.png)

## 常见问题

### @bufferapp/buffer-tracking-browser-ts 是什么？

用于基于浏览器的缓冲键标项目的部分跟踪库注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

### 如何安装 @bufferapp/buffer-tracking-browser-ts？

在项目目录运行 npm install @bufferapp/buffer-tracking-browser-ts，或使用 pnpm add / yarn add / bun add。

### @bufferapp/buffer-tracking-browser-ts 支持 TypeScript 吗？

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

### @bufferapp/buffer-tracking-browser-ts 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @bufferapp/buffer-tracking-browser-ts 可以商用吗？

@bufferapp/buffer-tracking-browser-ts 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bufferapp/buffer-tracking-browser-ts 的下载量有多少？

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

### @bufferapp/buffer-tracking-browser-ts 还在维护吗？

最新版本 1\.0\.248 发布于 2024/09/25（2 年前）；至今共发布 371 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/01/14。作者已将其标记为弃用，新项目建议寻找替代方案。