mirror of
https://github.com/microsoft/vscode.git
synced 2026-02-24 19:56:38 +00:00
e20adc378e
* refactor: Separate `createScriptRunnerTask` and `createInstallationTask` from `createTask` * feat: Add `npm.scriptRunner` * feat: Add Node.js as script runner * refactor: Refactor `isPrePostScript` * refactor: Extract `get*Command` * fix: Typo * style: Remove no-op `catch`es * fix: `node --run` doesn't support `--silent` * refactor: Use `.map` in `escapeCommandLine` * chore: Remove TODO Upstream reviewer is ok with current state * fix: Fix error the resolved task definition differs from the original
44 lines
2.8 KiB
Markdown
44 lines
2.8 KiB
Markdown
# Node npm
|
|
|
|
**Notice:** This extension is bundled with Visual Studio Code. It can be disabled but not uninstalled.
|
|
|
|
## Features
|
|
|
|
### Task Running
|
|
|
|
This extension supports running npm scripts defined in the `package.json` as [tasks](https://code.visualstudio.com/docs/editor/tasks). Scripts with the name 'build', 'compile', or 'watch'
|
|
are treated as build tasks.
|
|
|
|
To run scripts as tasks, use the **Tasks** menu.
|
|
|
|
For more information about auto detection of Tasks, see the [documentation](https://code.visualstudio.com/Docs/editor/tasks#_task-autodetection).
|
|
|
|
### Script Explorer
|
|
|
|
The Npm Script Explorer shows the npm scripts found in your workspace. The explorer view is enabled by the setting `npm.enableScriptExplorer`. A script can be opened, run, or debug from the explorer.
|
|
|
|
### Run Scripts from the Editor
|
|
|
|
The extension supports to run the selected script as a task when editing the `package.json`file. You can either run a script from
|
|
the hover shown on a script or using the command `Run Selected Npm Script`.
|
|
|
|
### Run Scripts from a Folder in the Explorer
|
|
|
|
The extension supports running a script as a task from a folder in the Explorer. The command `Run NPM Script in Folder...` shown in the Explorer context menu finds all scripts in `package.json` files that are contained in this folder. You can then select the script to be executed as a task from the resulting list. You enable this support with the `npm.runScriptFromFolder` which is `false` by default.
|
|
|
|
### Others
|
|
|
|
The extension fetches data from <https://registry.npmjs.org> and <https://registry.bower.io> to provide auto-completion and information on hover features on npm dependencies.
|
|
|
|
## Settings
|
|
|
|
- `npm.autoDetect` - Enable detecting scripts as tasks, the default is `on`.
|
|
- `npm.runSilent` - Run npm script with the `--silent` option, the default is `false`.
|
|
- `npm.packageManager` - The package manager used to install dependencies: `auto`, `npm`, `yarn`, `pnpm` or `bun`. The default is `auto`, which detects your package manager based on files in your workspace.
|
|
- `npm.scriptRunner` - The script runner used to run the scripts: `auto`, `npm`, `yarn`, `pnpm`, `bun` or `node`. The default is `auto`, which detects your script runner based on files in your workspace.
|
|
- `npm.exclude` - Glob patterns for folders that should be excluded from automatic script detection. The pattern is matched against the **absolute path** of the package.json. For example, to exclude all test folders use '**/test/**'.
|
|
- `npm.enableScriptExplorer` - Enable an explorer view for npm scripts.
|
|
- `npm.scriptExplorerAction` - The default click action: `open` or `run`, the default is `open`.
|
|
- `npm.enableRunFromFolder` - Enable running npm scripts from the context menu of folders in Explorer, the default is `false`.
|
|
- `npm.scriptCodeLens.enable` - Enable/disable the code lenses to run a script, the default is `false`.
|