@grafana/levitate

中文文档
0.18.0发布于 2026/09/29Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 8万

帮助了解由国家预防机制包(或任何类型脚本代码)输出和消费的API的工具.

中文使用文档
文档目录3 节
  1. 使用量
  2. 忽略特定导出变化
  3. 捐款

* 抵债

npm version npm downloads CI prettier TypeScript

帮助了解由国家预防机制包(或任何类型脚本代码)输出和消费的API的工具.

使用量

比较不同软件包版本的导出

# Compare exports of different versions of a package
npx @grafana/levitate compare \
    --prev @grafana/[email protected] \
    --current @grafana/ui@canary

清单进口

# List the imports used by a program
npx @grafana/levitate list-imports \
    --path <PATH-TO-A-PACKAGE>/module.ts \
    --filters "@common/pages" "@grafana/data" \
    --verbose

列表导出

# List the exports of a compiled package
npx @grafana/levitate list-exports \
    --path <PATH-TO-A-PACKAGE>/index.d.ts

检查模块和软件包之间的兼容性

使用特定版本的软件包检查代码的相容性( 如 : @ grafana/ data@ 9. 0.0) 对照同一软件包的另一版本(例如:@grafana/data@ 9.0.5).

# Check if the current module.ts usage of @grafana/data is
# compatible with the latest version of it
npx @grafana/levitate is-compatible \
    --path <PATH-TO-A-PACKAGE>/module.ts \
    --target "@grafana/data@latest"

忽略特定导出变化

要忽略特定导出名称中的更改( 添加、 更改、 删除), 您可以创建 .levignore.js 在同一个目录中引用起落架.

该文件的格式如下:

module.exports = {
  removals: [
    // each entry is a regex
    /Sample\.ignoreThisOne/,
    /Sample\.ignoreThisOneToo/,
    /Sample.*\b/,
    'Sample.ignoreThisOneToo', // strings are converted to regex to match exact
  ],
  changes: [
    //...
  ],
  additions: [
    //...
  ],
};

说明:

  • 利维塔特会在它检查的任何包中忽略匹配正则exs的符号. 如果多个软件包导出同名符号,它们都会被忽略.
  • 这只影响 compare 财务报告和审定财务报表 is-compatible 命令。 它不会影响 list-imports 或者说 list-exports 命令.
  • 你应该找到自己的位置 .levignore.js 在同一个目录中引用起落架.

捐款

如果你有兴趣为利维塔特计划捐款,请阅读 贡献指南。 。 。 .

版本与发布记录

@grafana/levitate 共发布 43 个版本,首次发布于 2021/12/14;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.18.0latest2026/09/291 个月前
0.17.32026/05/275 个月前
0.17.22025/11/011 年前
0.17.12025/06/181.4 年前
0.17.02025/06/171.4 年前
0.16.42025/06/121.4 年前

关于 @grafana/levitate 的常见问题

@grafana/levitate 是什么?

帮助了解由国家预防机制包(或任何类型脚本代码)输出和消费的API的工具.

如何安装 @grafana/levitate?

在项目目录运行 npm install @grafana/levitate,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 levitate,可以用 npx levitate 直接运行。

@grafana/levitate 支持 TypeScript 吗?

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

@grafana/levitate 支持 ESM 还是 CommonJS?

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

@grafana/levitate 需要什么版本的 Node.js?

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

@grafana/levitate 可以商用吗?

@grafana/levitate 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@grafana/levitate 的下载量有多少?

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

@grafana/levitate 还在维护吗?

最新版本 0.18.0 发布于 2026/09/29(1 个月前);至今共发布 43 个版本,其中过去 12 个月发布了 2 个;首次发布于 2021/12/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。