# @clinic/bubbleprof 中文文档

规范地址：https://npmcn.com/package/%40clinic/bubbleprof/

版本：10\.0\.0
npm 元数据更新时间：2023-06-27T21:22:04.084Z
中文译文更新时间：2026-11-10T01:46:04.617Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.4 MB，184 个文件
- TypeScript 类型：未声明
- 运行依赖：24 个
- 首次发布：2021-11-12T14:29:34.686Z
- 最新版本发布：2023-06-27T21:22:03.448Z
- 近 30 天下载量：169420（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

可编程到 Clinic.js 的接口

## 安装

```sh
npm install @clinic/bubbleprof
```

也可以使用：`pnpm add @clinic/bubbleprof`、`yarn add @clinic/bubbleprof`、`bun add @clinic/bubbleprof`

## README

# Bulbleprof诊所

[![Greenkeeper badge](https://badges.greenkeeper.io/clinicjs/node-clinic-bubbleprof.svg)](https://greenkeeper.io/) [![npm version](https://img.shields.io/npm/v/@clinic/bubbleprof.svg?style=flat-square)](https://www.npmjs.org/@clinic/bubbleprof) [![Stability Stable](https://img.shields.io/badge/stability-stable-green.svg?style=flat-square)](https://nodejs.org/api/documentation.html#documentation_stability_index) [![Github Actions build status](https://github.com/clinicjs/node-clinic-bubbleprof/workflows/CI/badge.svg)](https://github.com/clinicjs/node-clinic-bubbleprof/actions) [![Downloads](http://img.shields.io/npm/dm/@clinic/bubbleprof.svg?style=flat-square)](https://www.npmjs.org/@clinic/bubbleprof) [![Code style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/feross/standard)

可编程接口到 [诊所.js](https://github.com/clinicjs/node-clinic) 泡泡鱼. 更多关于诊所的知识 [https://clinicjs.org/ (中文(简体) )](https://clinicjs.org/)

![Screenshot](https://npmcn.com/package/%40clinic/bubbleprof/screenshot.png)

## 问题

打开一个问题,请使用 [主要仓库](https://github.com/clinicjs/node-clinic) 与 `bubbleprof` 标签.

## 安装

```console
npm i -S @clinic/bubbleprof
```

## 支持的节点版本

-   16及以上节点j

## 示例

```js
const ClinicBubbleprof = require('@clinic/bubbleprof')
const bubbleprof = new ClinicBubbleprof()

bubbleprof.collect(['node', './path-to-script.js'], function (err, filepath) {
  if (err) throw err

  bubbleprof.visualize(filepath, filepath + '.html', function (err) {
    if (err) throw err
  })
})
```

要从Clinic.js Bubbleprof开始 你也许想看看 [实例 还原](https://github.com/clinicjs/node-clinic-bubbleprof-examples)。 。 。 .

## 文档

```js
const ClinicBubbleprof = require('@clinic/bubbleprof')
const bubbleprof = new ClinicBubbleprof()
```

### 新的 Bibbleprof( \[设置\])

-   设置 [`<Object>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
    -   检测端口 [`<boolean>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type) **默认**错误
    -   调试 [`<boolean>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type) 如果设置为真, 生成的 html 将不会被修改 . **默认**错误
    -   离线 [`<String>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String) 存储所收集数据的文件夹 . **默认**:"'

#### `bubbleprof.collect(args, callback)`

使用 :

```js
const { spawn } = require('child_process')
spawn(args[0], ['-r', 'sampler.js'].concat(args.slice(1)))
```

注入的采样器将在当前的工作目录中生成一个文件,其中 进程 `PID` 在其文件名中。 相对于当前工作的文件路径 目录将是回调中值.

stdout, stderr,和stdin会被转发到调用过程. 也一样 `SIGINT` 活动.

#### `bubbleprof.visualize(dataFilename, outputFilename, callback)`

将消耗指定的数据文件 `dataFilename`,此数据文件将是 采样者使用 `bubbleprof.collect`。 。 。 .

`bubbleprof.visualize` 然后输出一个独立的 HTML 文件到 `outputFilename`。完成后,调用时不另加 参数,但可能的错误除外.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40clinic/bubbleprof/LICENSE)

## 常见问题

### @clinic/bubbleprof 是什么？

可编程到 Clinic\.js 的接口

### 如何安装 @clinic/bubbleprof？

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

### @clinic/bubbleprof 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/clinic\_\_bubbleprof 是否存在。

### @clinic/bubbleprof 可以商用吗？

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

### @clinic/bubbleprof 的下载量有多少？

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

### @clinic/bubbleprof 还在维护吗？

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