clinic.js — TypeScript 应用监控工具

什么是 clinic.js？

Clinic.js 是一套用于监控和分析 Node.js 应用程序（使用 TypeScript 编写）的工具集。它使开发者能够识别性能瓶颈、内存泄漏和 Event Loop 问题。该库以 flamegraph、bubbleprof 和 heapprofiler 的形式提供可视化报告。

为什么需要监控 TypeScript？

TypeScript 编译为 JavaScript，但在执行层面它仍然是 Node.js。没有监控，就无法理解应用程序在负载下为何变慢。Clinic.js 有助于：

• 检测慢速函数和异步操作
• 分析内存使用情况
• 优化 Event Loop（例如，在处理繁重计算时）
• 比较重构前后的性能

安装

通过 npm 全局安装 clinic.js：

npm install -g clinic

为了在 TypeScript 项目中使用，还需安装类型定义：

npm install --save-dev @types/node

主要功能

• clinic doctor — 应用程序健康状态通用诊断（Event Loop、内存、CPU）
• clinic flame — 创建火焰图以分析调用栈
• clinic bubbleprof — 异步操作可视化（Promise、回调）
• clinic heapprofiler — 堆分析，用于查找内存泄漏

与 TypeScript 结合使用的示例

假设您有一个基于 Express 和 TypeScript 的应用程序。使用 clinic doctor 运行它：

clinic doctor -- node dist/index.js

运行结束后（按 Ctrl+C），将打开一个 HTML 报告。用于测试的示例代码：

import express from 'express';const app = express();

app.get('/heavy', (req, res) => {  const arr = [];  for (let i = 0; i < 1e6; i++) {    arr.push(Math.random());  }  res.send('Done');});

app.listen(3000, () => console.log('Server running'));

然后使用 autocannon 对其进行加压：

npx autocannon -c 10 -d 10 http://localhost:3000/heavy

报告将显示该循环阻塞了 Event Loop。

何时使用

• 当生产环境出现性能下降时
• 在扩展应用程序之前
• 重构关键代码段时
• 优化异步流时（例如，使用 RxJS 时）

结论

Clinic.js 是任何使用 Node.js 的 TypeScript 开发者必备的工具。它取代了手动日志记录，并帮助快速找到调试器中无法捕获的问题。