# @ariestools/pixel 中文文档

规范地址：https://npmcn.com/package/%40ariestools/pixel/

版本：9\.0\.3
npm 元数据更新时间：2026-11-05T18:02:53.606Z
中文译文更新时间：2026-11-06T19:07:47.529Z
软件包许可：LGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40ariestools/pixel
原文对照：https://npmcn.com/package/%40ariestools/pixel/?lang=original
项目主页：https://xylabs.com/
源码仓库：https://github.com/xylabs/sdk-pixel-js

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

- 包体积（解压后）：103 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26
- 运行依赖：2 个
- 首次发布：2026-07-06T18:31:45.327Z
- 最新版本发布：2026-11-05T18:02:53.313Z
- 近 30 天下载量：2963（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

Xylabs ESB 事件客户端

## 安装

```sh
npm install @ariestools/pixel
```

也可以使用：`pnpm add @ariestools/pixel`、`yarn add @ariestools/pixel`、`bun add @ariestools/pixel`

## README

[![logo](https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg)](https://xylabs.com/)

# @ riastools/ 像素

[![npm](https://img.shields.io/npm/v/@ariestools/pixel.svg)](https://www.npmjs.com/package/@ariestools/pixel) [![license](https://img.shields.io/npm/l/@ariestools/pixel.svg)](https://github.com/xylabs/sdk-js/blob/main/LICENSE)

> Xylabs ESB 事件客户端

## 安装

使用 npm :

```sh
npm install {{name}}
```

使用线条 :

```sh
yarn add {{name}}
```

使用 pnpm :

```sh
pnpm add {{name}}
```

使用包子 :

```sh
bun add {{name}}
```

## 许可证

见 [自由主义](https://npmcn.com/package/%40ariestools/pixel/LICENSE) 用于许可证权利和限制的文件(LGPL-3.0-只).

## 参考文献

### 软件包

### 像素

```
### .temp-typedoc

  ### classes

    ### <a id="PixelApi"></a>PixelApi
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

HTTP客户端用于向XY Labs像素API发送跟踪事件.

## 构造器

### 构造器

```ts
new PixelApi(baseUri?): PixelApi;
```

### 参数

#### 基地乌里?

`string` =: `'prod'`

### 回返

`PixelApi`

## 方法

### 音轨事件( )

```ts
trackEvents(events): Promise<any>;
```

发送一系列用户事件到跟踪API.

### 参数

#### 事件

\[`UserEvent`\[ . \]#./界面/用户活动

提交的活动

### 回返

`Promise`<`any`\> 翻译:

API的响应数据

```
    ### <a id="Referrer"></a>Referrer
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

在会话和本地存储中跟踪并坚持文件推荐人.

## 构造器

### 构造器

```ts
new Referrer(): Referrer;
```

### 回返

`Referrer`

## 属性

### 当地

```ts
local: string;
```

* * *

### 第二届会议

```ts
session: string;
```

## 方法

### 改为 Json ()

```ts
toJson(): 
  | {
  local: string;
  session: string;
}
  | undefined;
```

返回作为 JSON 对象的参考数据,或者如果两个值均为空则未定义.

### 回返

| { `local`数字 : `string`· ; `session`数字 : `string`· ; {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | `undefined`

带有本地和会话引用字符串或未定义的对象

```
    ### <a id="UniqueUserId"></a>UniqueUserId
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

生成并坚持本地Storage中唯一的用户标识符.

## 构造器

### 构造器

```ts
new UniqueUserId(): UniqueUserId;
```

### 回返

`UniqueUserId`

## 属性

### 编号

```ts
id: string;
```

## 方法

### 转到 String ()

```ts
toString(): string;
```

返回作为字符串的唯一用户ID.

### 回返

`string`

```
    ### <a id="UserEventHandler"></a>UserEventHandler
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

处理用户跟踪事件的抽象基础类.

## 由

-   [`XyUserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-XyUserEventHandler)

## 类型参数

### TData 发件人

`TData` _扩展_ `EmptyObject`

## 构造器

### 构造器

```ts
new UserEventHandler<TData>(): UserEventHandler<TData>;
```

### 回返

`UserEventHandler`<`TData`\> 翻译:

## 方法

### 漏斗启动( S)

```ts
abstract funnelStarted<T>(fields): Promisable<void>;
```

跟踪漏斗启动的事件.

### 类型参数

#### T级

`T` _扩展_ `object`

### 参数

#### 字段

[`FunnelStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/FunnelStartedFields) | `T`

### 回返

`Promisable`<`void`\> 翻译:

* * *

### 测试开始( C)

```ts
abstract testStarted<T>(fields): Promisable<void>;
```

跟踪一个测试启动的事件.

### 类型参数

#### T级

`T` _扩展_ `object`

### 参数

#### 字段

[`TestStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/TestStartedFields) | `T`

### 回返

`Promisable`<`void`\> 翻译:

* * *

### 用户 Click ()

```ts
abstract userClick<T>(fields): Promisable<void>;
```

跟踪用户点击事件.

### 类型参数

#### T级

`T` _扩展_ `object`

### 参数

#### 字段

[`UserClickFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/UserClickFields) | `T`

### 回返

`Promisable`<`void`\> 翻译:

* * *

### 视图

```ts
abstract viewContent<T>(fields): Promisable<void>;
```

跟踪视图内容事件.

### 类型参数

#### T级

`T` _扩展_ `object`

### 参数

#### 字段

`T` | [`ViewContentFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/ViewContentFields)

### 回返

`Promisable`<`void`\> 翻译:

```
    ### <a id="UtmFields"></a>UtmFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

从查询字符串追踪 UTM 活动参数, 本地Storage 中的持续历史 .

## 构造器

### 构造器

```ts
new UtmFields(): UtmFields;
```

### 回返

`UtmFields`

## 属性

### 字段

```ts
fields: Record<string, string>[] = [];
```

## 方法

### 获取Utm记录( )

```ts
getUtmRecord(): Record<string, string> | null;
```

从当前 URL 查询字符串中解析 UTM 参数 .

### 回返

`Record`<`string`, (中文(简体) ), `string`\> `null`

UTM 密钥值对的记录, 如果不存在则无效

* * *

### 转到 String ()

```ts
toString(): string;
```

返回作为 JSON 字符串的 UTM 字段历史 .

### 回返

`string`

* * *

### 更新()

```ts
update(): Record<string, string>[];
```

检查新的 UTM 值的查询字符串,如果更改,将其附加到历史中.

### 回返

`Record`<`string`, (中文(简体) ), `string`\>\[\] 翻译:

当前 UTM 字段数组, 如果为空则未定义

```
    ### <a id="XyPixel"></a>XyPixel
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

Singleton像素跟踪器,用于排队并发送用户事件到XY Labs跟踪API.

## 属性

### api 密码

```ts
static api: PixelApi;
```

* * *

### 数字

```ts
cid: string;
```

* * *

### 电子邮件?

```ts
optional email?: string;
```

* * *

### 电子邮件- hash?

```ts
optional email_hash?: string | null;
```

* * *

### 外科医生?

```ts
optional exids?: ExIds;
```

* * *

### 像素盾 ?

```ts
optional pixelId?: string;
```

* * *

### 队列

```ts
queue: UserEvent[] = [];
```

## 访问者

### 实例

### 获取签名

```ts
get static instance(): XyPixel;
```

返回单通 XyPixel 实例,如果尚未初始化,则投掷.

#### 回返

`XyPixel`

## 方法

### 输入( i)

```ts
static init(pixelId): XyPixel;
```

以给定的像素ID初始化 XyPixel 单通.

### 参数

#### 像素Id

`string`

此跟踪实例的像素标识符

### 回返

`XyPixel`

新建的 XyPixel 实例

* * *

### 选择 Api ()

```ts
static selectApi(api): void;
```

替换用于发送事件的默认像素Api实例.

### 参数

#### api 密码

[`PixelApi`](https://npmcn.com/package/%40ariestools/pixel/#readme-PixelApi)

要使用的像素Api 实例

### 回返

`void`

* * *

### 标识( )

```ts
identify(email?): void;
```

与这个像素实例相关联的电子邮件地址.

### 参数

#### 电子邮件?

`string`

用于识别用户的电子邮件地址

### 回返

`void`

* * *

### 发送( )

```ts
send<T>(
   event, 
   fields?, 
eventId?): Promise<void>;
```

排入一个跟踪事件并试图将队列冲到 API 中 .

### 类型参数

#### T级

`T` _扩展_ `Record`<`string`, (中文(简体) ), `unknown`\> 翻译:

### 参数

#### 事件

`string`

事件名称

#### 字段吗?

`T`

可选事件指定字段

#### 事件吗?

`string`

可选唯一事件标识符

### 回返

`Promise`<`void`\> 翻译:

```
    ### <a id="XyUserEventHandler"></a>XyUserEventHandler
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

通过 XyPixel 单通发送跟踪事件的具体事件处理器 .

## 扩展

-   [`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)<`T`\> 翻译:

## 类型参数

### T级

`T` _扩展_ `EmptyObject` =: `EmptyObject`

## 构造器

### 构造器

```ts
new XyUserEventHandler<T>(): XyUserEventHandler<T>;
```

### 回返

`XyUserEventHandler`<`T`\> 翻译:

### 覆盖

[`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)。 。 。 .[`constructor`](https://npmcn.com/package/%40ariestools/pixel/UserEventHandler.md#constructor)

## 方法

### 漏斗启动( S)

```ts
funnelStarted(fields): Promise<void>;
```

通过像素 API 发送一个漏斗启动事件 .

### 参数

#### 字段

[`FunnelStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/FunnelStartedFields) | `T`

### 回返

`Promise`<`void`\> 翻译:

### 覆盖

[`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)。 。 。 .[`funnelStarted`](https://npmcn.com/package/%40ariestools/pixel/UserEventHandler.md#funnelstarted)

* * *

### 购买()

```ts
purchase(fields): Promise<void>;
```

通过像素 API 发送购买事件 .

### 参数

#### 字段

[`PurchaseFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/PurchaseFields) | `T`

### 回返

`Promise`<`void`\> 翻译:

* * *

### 测试开始( C)

```ts
testStarted(fields): Promise<void>;
```

通过像素 API 发送一个测试启动的事件 .

### 参数

#### 字段

[`TestStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/TestStartedFields) | `T`

### 回返

`Promise`<`void`\> 翻译:

### 覆盖

[`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)。 。 。 .[`testStarted`](https://npmcn.com/package/%40ariestools/pixel/UserEventHandler.md#teststarted)

* * *

### 用户 Click ()

```ts
userClick(fields): Promise<void>;
```

通过像素 API 发送用户点击事件.

### 参数

#### 字段

[`UserClickFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/UserClickFields) | `T`

### 回返

`Promise`<`void`\> 翻译:

### 覆盖

[`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)。 。 。 .[`userClick`](https://npmcn.com/package/%40ariestools/pixel/UserEventHandler.md#userclick)

* * *

### 视图

```ts
viewContent(fields): Promise<void>;
```

通过像素 API 发送一个视图内容事件.

### 参数

#### 字段

[`ViewContentFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-../interfaces/ViewContentFields) | `T`

### 回返

`Promise`<`void`\> 翻译:

### 覆盖

[`UserEventHandler`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserEventHandler)。 。 。 .[`viewContent`](https://npmcn.com/package/%40ariestools/pixel/UserEventHandler.md#viewcontent)

```
  ### interfaces

    ### <a id="CommonFields"></a>CommonFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

在所有跟踪活动类型中共享共同域.

## 由

-   [`FunnelStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-FunnelStartedFields)
-   [`PurchaseFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-PurchaseFields)
-   [`TestStartedFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-TestStartedFields)
-   [`UserClickFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-UserClickFields)
-   [`ViewContentFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-ViewContentFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

* * *

### 测试数据?

```ts
optional testData?: string;
```

```
    ### <a id="FunnelStartedFields"></a>FunnelStartedFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

漏斗启动跟踪事件的字段 .

## 扩展

-   [`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`funnel`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#funnel)

* * *

### 测试数据?

```ts
optional testData?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`testData`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#testdata)

* * *

### 名称

```ts
name: string;
```

```
    ### <a id="PurchaseFields"></a>PurchaseFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

购买跟踪活动的字段.

## 扩展

-   [`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`funnel`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#funnel)

* * *

### 测试数据?

```ts
optional testData?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`testData`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#testdata)

* * *

### 编号

```ts
id: string;
```

* * *

### 名字吗?

```ts
optional name?: string;
```

* * *

### 价钱?

```ts
optional price?: number;
```

* * *

### 价值?

```ts
optional value?: number;
```

```
    ### <a id="TestStartedFields"></a>TestStartedFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

用于测试启动跟踪事件的字段(如A/B测试).

## 扩展

-   [`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`funnel`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#funnel)

* * *

### 测试数据?

```ts
optional testData?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`testData`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#testdata)

* * *

### 名称

```ts
name: string;
```

```
    ### <a id="UserClickFields"></a>UserClickFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

用户点击跟踪事件的字段 .

## 扩展

-   [`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`funnel`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#funnel)

* * *

### 测试数据?

```ts
optional testData?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`testData`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#testdata)

* * *

### 元素Name

```ts
elementName: string;
```

* * *

### 元素类型

```ts
elementType: string;
```

* * *

### 意图?

```ts
optional intent?: string;
```

* * *

### 安置吗?

```ts
optional placement?: string;
```

```
    ### <a id="UserEvent"></a>UserEvent
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

代表一个发送到像素API的单一用户跟踪事件.

## 属性

### 数字

```ts
cid: string;
```

* * *

### 创建时间( t) ?

```ts
optional create_time?: number;
```

* * *

### 电子邮件?

```ts
optional email?: string;
```

* * *

### 电子邮件- hash?

```ts
optional email_hash?: string;
```

* * *

### 活动?

```ts
optional event?: string;
```

* * *

### 事件编号 ?

```ts
optional event_id?: string;
```

* * *

### 外科医生?

```ts
optional exids?: ExIds;
```

* * *

### 字段吗?

```ts
optional fields?: Record<string, unknown>;
```

* * *

### 主持人?

```ts
optional host?: string;
```

* * *

### 路径名 ?

```ts
optional pathname?: string;
```

* * *

### 像素吗?

```ts
optional pixel?: string;
```

* * *

### 接收时间?

```ts
optional receive_time?: number;
```

* * *

### 裁判员?

```ts
optional referrer?: object;
```

### 当地

```ts
local: string;
```

### 第二届会议

```ts
session: string;
```

* * *

### 摆脱?

```ts
optional rid?: string;
```

* * *

### 系统?

```ts
optional system?: ParsedResult;
```

* * *

### 欧德?

```ts
optional uid?: string;
```

* * *

### 是吗?

```ts
optional utm?: Record<string, string>[] | Record<string, string[]>;
```

```
    ### <a id="ViewContentFields"></a>ViewContentFields
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

视图内容跟踪事件的字段 .

## 扩展

-   [`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)

## 属性

### 漏斗吗?

```ts
optional funnel?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`funnel`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#funnel)

* * *

### 测试数据?

```ts
optional testData?: string;
```

### 继承自

[`CommonFields`](https://npmcn.com/package/%40ariestools/pixel/#readme-CommonFields)。 。 。 .[`testData`](https://npmcn.com/package/%40ariestools/pixel/CommonFields.md#testdata)

* * *

### 名称

```ts
name: string;
```

* * *

### 路径

```ts
path: string;
```

```
    ### <a id="XyLabsTrackingEventJson"></a>XyLabsTrackingEventJson
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

JSON结构用于存储或传输的XY实验室跟踪事件.

## 属性

### 数字

```ts
cid: string;
```

* * *

### 创建时间( t) ?

```ts
optional create_time?: number;
```

* * *

### 电子邮件?

```ts
optional email?: string;
```

* * *

### 电子邮件- hash?

```ts
optional email_hash?: string;
```

* * *

### 活动?

```ts
optional event?: string;
```

* * *

### 事件编号 ?

```ts
optional event_id?: string;
```

* * *

### 外科医生?

```ts
optional exids?: Record<string, string>;
```

* * *

### 字段吗?

```ts
optional fields?: Record<string, unknown>;
```

* * *

### 主持人?

```ts
optional host?: string;
```

* * *

### 脚?

```ts
optional ip?: string;
```

* * *

### 路径名 ?

```ts
optional pathname?: string;
```

* * *

### 像素吗?

```ts
optional pixel?: string;
```

* * *

### 接收时间?

```ts
optional receive_time?: number;
```

* * *

### 摆脱?

```ts
optional rid?: string;
```

* * *

### 系统?

```ts
optional system?: unknown;
```

* * *

### 欧?

```ts
optional ua?: string;
```

* * *

### 欧德?

```ts
optional uid?: string;
```

* * *

### 是吗?

```ts
optional utm?: Record<string, string>[] | Record<string, string[]>;
```

```
  ### interfaces

    ### <a id="UserEventSystem"></a>UserEventSystem
```

[**@ riastools/ 像素**](https://npmcn.com/package/%40ariestools/pixel/#readme-../README)

* * *

```ts
interface UserEventSystem
```

从用户代理字符串中解析出浏览器/OS/引擎信息.

#### 属性

### 浏览器?

```ts
optional browser: UserEventSystemBrowser;
```

### 发动机?

```ts
optional engine: UserEventSystemEngine;
```

### 欧斯?

```ts
optional os: UserEventSystemOS;
```

### 平台吗 ?

```ts
optional platform: UserEventSystemPlatform;
```

## 贷项

[由XY实验室制造](https://xylabs.com/)

## 常见问题

### @ariestools/pixel 是什么？

Xylabs ESB 事件客户端

### 如何安装 @ariestools/pixel？

在项目目录运行 npm install @ariestools/pixel，或使用 pnpm add / yarn add / bun add。

### @ariestools/pixel 支持 TypeScript 吗？

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

### @ariestools/pixel 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ariestools/pixel 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=26。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ariestools/pixel 可以商用吗？

@ariestools/pixel 使用 LGPL-3\.0-only 许可。弱 Copyleft：作为库被调用时通常不要求开源你自己的代码，但修改库本身需以 LGPL 开源；前端打包合并后的适用边界存在不同理解。以上为概括，不构成法律意见，请以许可原文为准。

### @ariestools/pixel 的下载量有多少？

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

### @ariestools/pixel 还在维护吗？

最新版本 9\.0\.3 发布于 2026/11/06（2 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/07/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。