PhpStorm 2025.2 Help

运行/调试配置:Karma

创建: 运行(U)| 编辑配置(E)| 添加新配置| Karma

在此对话框中,创建使用 JavaScript 单元测试 以及 Karma 测试运行器 的运行和调试配置。

开始之前

  1. 下载并安装 Node.js

  2. 按照 Karma 中的描述安装 Karma test runner

  3. 设置 | 插件 页面、 插件市场 选项卡上安装 Karma 插件,如 从 JetBrains Marketplace 安装插件 中所述。

Karma 特定配置设置

项目

描述

配置文件

在此字段中,指定 Karma configuration file 的位置。 通常,文件具有扩展名 .conf.js

Karma 选项

在此字段中,指定要传递给 Karma 的命令行选项,以覆盖 karma.conf.js 配置文件中的默认设置。

例如,要在 Headless Chrome 中运行或调试测试,请在 --browsers ChromeHeadless 字段中输入 Karma 选项。 如需更多信息,请参阅 使用 Headless Chrome 进行自动化测试

要查看所有可用的 CLI 选项,请在 终端 Alt+F12 中输入 karma start --help

Node 解释器

在此字段中,指定要使用的 Node.js 解释器。

如果您选择 Project 别名,PhpStorm 将自动使用 Node 解释器 字段中 Node.js 页面的项目默认解释器。 在大多数情况下,PhpStorm 会检测到项目的默认解释器并自动填写该字段。

您也可以选择另一个已配置的本地或远程解释器,或点击 “浏览”按钮 并配置一个新的。

Node 选项

在此字段中,键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。

  • 使用 --require coffeescript/register ,运行期间可以将 CoffeeScript 文件即时编译为 JavaScript。

    这种模式要求 register.js 文件(属于 coffeescript 包)位于您的项目内。 因此,请确保您已按照 安装 CoffeeScript 编译器中的说明,在本地安装了 coffeescript 包。

  • 使用 --inspect--inspect-brk 参数以支持 Chrome Debugging Protocol

Karma 包

在此字段中,指定以下选项之一:

  • Karma 安装主目录 /npm/node_modules/karma 。 如果您通过 Node Package Manager 正常安装了 Karma ,PhpStorm 将自行检测 Karma 安装位置。

  • node_modules/@angular/cli 的路径。

  • 如果您使用 Nxnode_modules/nx 的路径。

工作目录

在此字段中,指定应用程序的工作目录。 默认情况下, 工作目录 字段显示项目根文件夹。 若要更改此预定义设置,请指定所需文件夹的路径。

环境变量

在此字段中,您可以选择性地指定用于执行命令的环境变量。

测试

在此区域指定要执行的测试。 可用选项包括:

  • 所有测试: 选择此选项以运行所有来自 karma.conf.js 配置文件的测试。

  • 测试文件: 选择此选项以仅运行某个文件中的测试,并在 测试文件 字段中指定该文件的路径。

  • 套件: 选择此选项以运行测试文件中的单个套件,并在 测试文件 字段中指定此文件的路径。 点击 “浏览”按钮 并在 套件名称 字段中使用 Add移除 按钮配置要运行的套件列表。

  • Test: 选择此选项以从测试文件运行单个测试,并在 测试文件 字段中指定此文件的路径。 点击 “浏览”按钮 并在 测试名称 字段中配置要运行的测试列表,使用 Add移除 按钮。

通用设置

当您编辑运行配置(而不是运行配置模板)时,您可以指定以下选项:

项目

描述

名称(N)

为运行配置指定一个名称,以便在编辑或运行时能快速识别。

允许多个实例(U)

允许并行运行多个此运行配置实例。

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,PhpStorm建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。

存储为项目文件(S)

将运行配置设置保存到文件中,以便与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,您可以将配置保存到项目中的任何其他目录。

默认情况下,它是禁用的,并且 PhpStorm 将运行配置设置存储在 .idea/workspace.xml

工具栏

运行/调试配置的树状视图具有一个工具栏,可帮助您管理 project 中可用的配置,并调整默认配置模板。

项目

快捷方式

描述

"添加"按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

删除选定的运行/调试配置。 请注意,您不能删除默认配置。

复制

Ctrl+D

创建选定运行/调试配置的副本。 请注意,您创建的是默认配置的副本。

保存配置

仅当您选择一个 临时配置时才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移入新建文件夹/新建文件夹。 您可以通过 将它们放入文件夹来分组运行/调试配置。

要创建文件夹,请选择某个类别中的配置,点击 文件夹 ,并指定文件夹名称。 如果只有一个类别处于焦点状态,则会创建一个空文件夹。

然后,为了将配置移动到文件夹中、文件夹之间或者文件夹外,请使用拖拽或 上移下移 按钮。

要删除分组,请选择一个文件夹,然后点击 删除配置

排序配置

点击此按钮以按字母顺序排序配置。

启动前

在此区域,您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照它们在列表中出现的顺序执行。

项目

快捷方式

描述

"添加"按钮

Alt+Insert

点击此图标以添加下列可用任务之一:

  • 启动Web 浏览器 :选择此选项即可启动浏览器。 在打开的对话框中,选择浏览器的类型并提供起始 URL。 此外,请指定是否希望浏览器随 JavaScript 调试器一起启动。

  • 运行 External tool :选择运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用程序。 如果在 PhpStorm 中尚未定义,请添加其定义。 如需更多信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择执行另一个运行/调试配置,并等待其完成后再开始当前配置。 如果您想并行运行多个配置,请使用 compound run/debug configuration

  • 运行File Watcher :选择此选项以让 PhpStorm 应用所有当前活动的 文件监视器

  • 运行远程外部工具 :添加一个 远程 SSH 外部工具

  • 运行Grunt 任务 :选择此选项来运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数,以及 grunt-cli 包的路径。

  • 运行 Gulp 任务 :选择此选项以运行 Gulp task。

    在打开的 Gulp 任务 对话框中,指定定义所需任务的 Gulpfile.js ,选择要执行的任务,并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。

  • 运行 npm Script :选择此选项来执行一个 npm 脚本。

    NPM Script 对话框中,指定 npm run/debug configuration settings

  • 编译TypeScript :选择运行内置的 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选择或清除此 检查错误 复选框,以配置编译器在检测到错误时的行为:

    • 如果选中了 检查错误 复选框,编译器会显示所有错误,并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框,编译器将显示所有检测到的错误,但运行配置仍将启动。

  • 生成CoffeeScript 源映射 :选择此选项以生成 CoffeeScript 源代码的源映射。 在打开的对话框中,指定您的 CoffeeScript 源文件所在的位置。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

点击此图标可编辑选定的任务。 请在打开的对话框中进行必要的更改。

方法向上

方法 down

Alt+Up

Alt+Down

点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选择此复选框,以便在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,此复选框处于选中状态,并且在您启动 run/debug 配置时, RunDebug 工具窗口会打开。

否则,如果复选框未选中,工具窗口将被隐藏。 但是,在配置运行时,您可以通过按 Alt+4Alt+5 自行打开相应的工具窗口。

最后修改日期: 2025年 9月 26日