Inicio·Comandos de terminal

npm run

Paquetes y entornos

Uso

npm run <script> [-- <args>]

Ejecuta un comando de la sección scripts de package.json; los argumentos para el script requieren un -- delante, y solo start y test pueden llamarse sin run.

Opciones habituales

OpciónSignificado
--everything after it goes to the script, not to npm
--if-presentexit quietly when the script is missing
-w <workspace>run it in one workspace
--workspacesrun it in every workspace
-shide npm own output

Ejemplos

npm run build

runs the build script from package.json

npm run test -- --watch

passes --watch to the test runner, not to npm

npm run

with no name, lists the scripts that exist

La pregunta siempre es qué va dónde: dentro de este proyecto o en todo el sistema.

Cómo leerlo

  • Los corchetes [ ] marcan una parte que puedes omitir.
  • Los puntos suspensivos … indican que puedes poner varios.
  • Las opciones distinguen mayúsculas: en algunos comandos -r y -R no hacen lo mismo.

Preguntas

Q. ¿Qué hace npm run?

Ejecuta un comando de la sección scripts de package.json; los argumentos para el script requieren un -- delante, y solo start y test pueden llamarse sin run.

Q. ¿Cómo se escribe?

npm run <script> [-- <args>] — los corchetes marcan lo que puedes omitir.

Q. ¿Cuántas opciones vale la pena saber?

Aquí van 5; la lista completa está en man npm. Este comando está en Paquetes y entornos.

Comandos relacionados

página man: man npm-run