WebStorm 2026.2 Help

JSEval​

借助 JSEval 插件,可以直接在 JavaScript 或 TypeScript 文件中其出现的位置查看代码的求值结果。 该工具允许查看 console.log 表达式的值,以及带有 //= 注释的表达式的值。

此外,还可以通过选择运行时、指定 环境变量和应用程序参数 、配置 TypeScript 处理方式等来进一步更改执行上下文。

开始之前

确保您使用的是 WebStorm 2026.1.1 或更高版本。

安装 JSEval 插件

安装 JsEval 插件
  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 市场 选项卡,找到列表中的 JSEval 插件,然后点击 安装

实时求值与代码覆盖率

使用 JSEval 可以即时检查代码,并在程序执行时接收实时的求值与代码覆盖率更新。 表达式的值在可用或被执行时会直接显示在编辑器中。

标记要计算的表达式

  • 在需要求值的表达式末尾添加 //= 注释。

  • 或者,可以通过使用以下错误方法之一将值记录到控制台:

    • console.log()

    • console.error()

    • console.trace()

    • console.info()

    • console.debug()

    • console.warn()

开始求值

  1. 在编辑器中打开要求值的文件。

  2. 从主菜单中选择 视图 | 工具窗口 | JSEval 打开 JSEval​ 工具窗口。

  3. JSEval​ 工具窗口中,执行以下任一操作:

    • 点击工具栏上的 跟踪已打开文件图标 ,并从列表中选择要求值的文件。

    • 要在当前活动编辑器选项卡中对文件求值,请点击 跟踪当前文件图标

    带有被检查文件名称的新选项卡将被添加到 JSEval​ 工具窗口,显示被标记求值的表达式值。 这些值也会直接显示在编辑器中,对应表达式旁边。

错误跟踪

当文件执行失败时, JSEval 会显示错误跟踪,让错误来源一目了然。

JSEval 工具窗口

所有已求值并显示的表达式都可以在专用的 JSEval​ 工具窗口中进一步检查。 还可以在此检查对象和数组的深层嵌套元素,并从树形结构中复制值。 双击某一项可跳转到其被求值的位置。

跟踪已用时间

使用 //' 注释可以跟踪从执行开始到达某表达式所用的时间。

支持导入

还可以通过 imports 跟踪软件包或其他项目文件中的文件。 在被导入文件有变更时,值会同步更新。

配置执行上下文

选择执行的运行时

执行代码时,可以在不同的 Node.js 运行时版本间切换,以比较其差异。

配置 TypeScript 处理方式

对于 TypeScript 文件,还可以配置 Node.js 的 TypeScript 转译处理方式。

JSEval​ 工具窗口的工具栏下拉菜单中,选择以下选项之一:

配置 TypeScript 处理方式
  • 默认 TS 处理方式​​​ — 选择此选项时,不会添加 TypeScript 处理。 仍可通过高级文件设置 如上所述配置自定义处理方式。

  • 转换类型 — 选择此选项可将 --experimental-transform -types 附加到 Node.js 参数中。 转换会应用于仅 TypeScript 特有的类型,例如 enumnamespace

配置其他执行属性

还可额外指定传递给运行时或应用程序的参数、应用程序运行目录以及环境变量。

指定高级求值控制设置

  1. JSEval​ 工具窗口中,点击 高级配置图标

    高级配置图标
  2. 在打开的 高级文件评估控制 对话框中,指定其他配置设置

    高级文件求值控制对话框

配置求值报告的外观

如需更改求值报告及时间求值报告的默认样式,按 Ctrl+Alt+S 打开设置,进入 编辑器 | 配色方案 | JSEval ,并根据您的偏好设置样式和颜色。 在 预览 区域中检查新外观。

2026年 7月 14日