On this page:
Accessing the Gulp Tool Window
Gulp.js run configuration.
- the tool window can be accessed this way only after you have opened it using the command or after you have run tasks through theThe tool window is available only when:
-
The Node.js
framework is installed on your computer.
-
The NodeJS repository plugin is installed and enabled.
The plugin is not bundled with PyCharm, but it is available from the PyCharm plugin repository.
Once enabled, the plugin is available at the IDE level, that is, you can use it in all your PyCharm projects. See Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins for details.
-
The
gulp
package is installed in the current project, see Installing Gulp for details. -
At least one
Gulpfile.js
file is available in the current project.
The tool window opens when you
invoke Gulp.js by choosing Show Gulp Tasks
on the context menu of a Gulpfile.js
in the Project tool window
or of a Gulpfile.js
opened in the editor.
The tree is built according to the Gulpfile.js
file on which Gulp.js was invoked.
If you have several Gulpfile.js
files in your project, you can build a separate tasks tree for each of them and run tasks without abandoning the previously built tasks trees.
Each tree is shown in a separate tab.
Use the tool window to run Gulp.js tasks.
Gulp.js Tasks Tree
The tool window shows a tree of Gulp.js tasks. The tree is built according to the Gulpfile.js
on which Gulp.js was invoked.
If you have several Gulpfile.js
files in your project, you can build a separate tasks tree for each of them and run tasks without abandoning the previously built tasks trees.
Each tree is shown under a separate node.
Running Gulp Tasks
To run a task, do one of the following:
- Double click the required task in the tree.
- Select the required task and choose Run <task name> on the context menu of the selection.
- Select the required task and press Enter.
-
To run the
default
task, select the root node in the tree and choose Run default on the context menu of the selection. - To navigate to the definition of a task, select the required task in the tree and choose Jump to source on the context menu of the selection.
The task execution output will be displayed in the Gulp Console pane of the Run tool window.
To run several tasks, use the multiselect mode: hold Shift (for adjacent items) or Ctrl (for non-adjacent items) keys and select the required tasks, then choose Run on the context menu of the selection.
Toolbar
Item | Tooltip | Description |
---|---|---|
![]() | Add Gulpfile |
Click this button to have a tasks tree for another Gulpfile.js file built.
Choose the required Gulpfile.js file from the pop-up list. PyCharm builds a tasks tree and shows it under a separate node.
|
![]() | Remove Gulpfile | Click this button to remove the tasks tree under the selected node. |
![]() | Reload tasks |
Click this button to have the tasks tree under the selected node re-built. You may need a tree re-built after updating the corresponding Gulpfile.js file
because Gulp.js does not apply changes to trees on the fly.
|