# @gesslar/toolkit 中文文档

规范地址：https://npmcn.com/package/%40gesslar/toolkit/

版本：6\.0\.3
npm 元数据更新时间：2026-10-25T16:03:12.672Z
中文译文更新时间：2026-11-16T05:35:09.526Z
软件包许可：0BSD

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

原始 npm 页面：https://www.npmjs.com/package/%40gesslar/toolkit
原文对照：https://npmcn.com/package/%40gesslar/toolkit/?lang=original
项目主页：https://github.com/gesslar/toolkit#readme
源码仓库：https://github.com/gesslar/toolkit

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

- 包体积（解压后）：823 kB，94 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：4 个
- 首次发布：2025-09-21T13:06:13.729Z
- 最新版本发布：2026-10-25T16:03:12.500Z
- 近 30 天下载量：2594（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：149（近 12 个月 114 个）

## 中文简介

节点和浏览器环境的公用设施集.

## 安装

```sh
npm install @gesslar/toolkit
```

也可以使用：`pnpm add @gesslar/toolkit`、`yarn add @gesslar/toolkit`、`bun add @gesslar/toolkit`

## README

# @ gesslar/ toolkit (英语)

[![CodeQL, Linting, Testing](https://github.com/gesslar/toolkit/actions/workflows/Quality.yaml/badge.svg)](https://github.com/gesslar/toolkit/actions/workflows/Quality.yaml)

节点/ js 和浏览器环境的公用设备集, 包括文件 和目录抽象、终端工具、验证助手和数据 操作函数.

## 包含类

### 浏览器

这些类存在于浏览器内部并功能,或者类似浏览器 环境,如Tauri app.

| 名称 | 说明 |
| --- | --- |
| 收藏 | 阵列、地图、集和其他收藏操作方法 |
| 数据 | 初步操纵和类型识别 |
| 处置者 | 可支配资源的生命周期管理 |
| HTML 语言 | HTML 装入和消毒工具 |
| 通知 | DOM 事件的事件系统包 |
| 承诺 | 承诺用于安置、过滤和从承诺结果中提取价值的公用事业 |
| 萨斯 | 自定义带有增强特性的错误类 |
| 结巴 | 总体执行情况 |
| 时间 | 取消支助的时间安排和基于承诺的拖延 |
| 类型 | 基于字符串的类型管理( 在浏览器中导出为 TypeSpec) |
| UTI 语录 | 一般公用事业职能 |
| 有效 | 审定和断言方法 |

### 节点.js

包括所有浏览器功能外加用于文件一/O,日志和系统操作的Node.js特有模块.

| 名称 | 说明 |
| --- | --- |
| 缓存 | 文件 I/ O 操作的缓存管理 |
| 目录对象 | 目录元数据和操作,包括路径解析、存在检查和转录 |
| 文件对象 | 文件操作的文件系统包 |
| 文件系统 | 具有静态公用设施的文件系统操作基础类 |
| 胶片 | 记录框架 |
| 通知 | 节点事件的事件系统包 |
| 萨斯 | 自定义带有增强特性的错误类 |
| 结巴 | 总体执行情况 |
| 任期 | 终端格式化和产出公用事业 |
| UTI 语录 | 一般公用功能(节点增强版) |
| 有效 | 审定和断言方法 |
| 监视器 | 带有解弹保护的文件和目录更改监视器 |

## 安装

```shell
npm i @gesslar/toolkit
```

## 使用量

工具包了解环境并自动检测是否正在使用 在网页浏览器中或在Node.js中。 您可以选择指定 `node` 或者说 `browser` 变体明确.

### 类似浏览器

TypeScript编辑器不从jsDelivr中取出类型 。 如果您想要内置类型 不从 npm 安装,请使用 esm.sh `?dts` URL 或安装软件包 本地开发,运行时使用CDN.

#### jsDelivr( 仅运行时间)

```html
https://cdn.jsdelivr.net/npm/@gesslar/toolkit
```

#### esm.sh(运行时间,类型)

```html
https://esm.sh/@gesslar/toolkit
https://esm.sh/@gesslar/toolkit?dts` (serves `.d.ts` for editors)
```

### 节点.js

```javascript
import * as TK from "@gesslar/toolkit"
```

```javascript
import {Data, FileObject, Cache} from "@gesslar/toolkit"
```

```javascript
import {Data, FileObject} from "@gesslar/toolkit/node"
```

```javascript
import { Data, Collection, Util } from '@gesslar/toolkit/browser'
```

浏览器版本包括: Collection, Data, Disposer, HTML, Notify, Sass,, Tantrum),类型(TypeSpec),Util,和有效. 仅节点模块(Cache, 目录对象, 文件对象, 文件系统, Glog, Term) 在浏览器版本中不可用 .

### 供应商包

预建的捆绑包括用于没有建设管道的环境,例如: 作为网页视图(VS代码,Tauri,Electron)或平版HTML页面. 不需要捆绑.

#### ES模块

```html
<script type="module">
  import {Data, Collection} from "./node_modules/@gesslar/toolkit/vendor/toolkit.esm.js"
</script>
```

或通过软件包导出导入 :

```javascript
import {Data, Collection} from "@gesslar/toolkit/vendor"
```

#### UMD (全球脚本)

```html
<script src="./node_modules/@gesslar/toolkit/vendor/toolkit.umd.js"></script>
<script>
  const {Data, Collection} = Toolkit
</script>
```

供应商捆绑包含上述与浏览器相匹配的公用事业, 完全自成一体,外部依赖性为零.

## 邮政

如果你走这么远,请理解 我绝对没有顾虑 当它涉及到打破变化。 图书馆的观众主要是 我个人。 因此,任何依赖图书馆内容的东西 认真的坠毁,然后我不得不重塑那些东西。 这就像玩 九扇门 但与自相为. 还有个懒惰的炸弹等着 и 是我栽赃的 对我来说 炸弹就爆炸了.

当然欢迎你使用我的图书馆! 它很强壮。 呃,但也许 在版本中锁定,直到你看到 东西会拉满你全身。 一、导 言 让机器人做我的公关通知 一般来说,他们很擅长射击 关克兰松 关于我的嗜好 打破变化, 所以你应该没事 如果你注意的话 🤷🏻

达巴州参议员亚巴(杜)诚恳地表示:

## 许可证

`@gesslar/toolkit` 将在 [0BSD 数据](https://npmcn.com/package/%40gesslar/toolkit/LICENSE.txt)。 。 。 .

此软件包包含或依赖第三方组件在其下方 许可证:

| 依赖性 | 许可证 |
| --- | --- |
| [@ gesslar/ 颜色](https://github.com/gesslar/colours) | 0BSD 数据 |
| [页:1](https://github.com/ajv-validator/ajv) | 麻省理工学院 |
| [纪事5](https://github.com/json5/json5) | 麻省理工学院 |
| [支持颜色](https://github.com/chalk/supports-color) | 麻省理工学院 |
| [雅姆尔](https://github.com/eemeli/yaml) | 公务员制度委员会 |

## 常见问题

### @gesslar/toolkit 是什么？

节点和浏览器环境的公用设施集\.

### 如何安装 @gesslar/toolkit？

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

### @gesslar/toolkit 支持 TypeScript 吗？

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

### @gesslar/toolkit 支持 ESM 还是 CommonJS？

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

### @gesslar/toolkit 需要什么版本的 Node\.js？

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

### @gesslar/toolkit 可以商用吗？

@gesslar/toolkit 使用 0BSD 许可。几乎没有限制：可自由使用、修改和分发，连保留版权声明也不要求。以上为概括，不构成法律意见，请以许可原文为准。

### @gesslar/toolkit 的下载量有多少？

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

### @gesslar/toolkit 还在维护吗？

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

