O que são scripts npm e lifecycle hooks?

Question

Accepted Answer

**Scripts npm** são comandos definidos no campo `scripts` de `package.json` que você executa com `npm run `. Eles padronizam as tarefas do projeto (start, build, test, lint) para que toda a equipe e CI usem os mesmos comandos. **Lifecycle hooks** são scripts especiais que npm executa automaticamente em certos momentos. ## Definindo e executando scripts ```json { "scripts": { "start": "node server.js", "dev": "nodemon server.js", "build": "tsc && vite build", "test": "vitest", "lint": "eslint src", "format": "prettier --write ." } } ``` ```bash npm run dev # any script npm start # `start` and `test` have shortcuts (no "run" needed) npm test ``` Scripts podem encadear comandos com `&&` (executar sequencialmente, parar em falha) e têm acesso a binários instalados localmente (em `node_modules/.bin`) sem caminho — então `"test": "vitest"` funciona mesmo que vitest não seja global. ## Pre e post hooks (automático) ```json { "scripts": { "prebuild": "rimraf dist", // runs AUTOMATICALLY before "build" "build": "tsc", "postbuild": "echo done" // runs AUTOMATICALLY after "build" } } ``` npm executa automaticamente `pre` antes e `post` depois de qualquer script ``. Então `npm run build` executa `prebuild` → `build` → `postbuild` em ordem — útil para passos de setup/limpeza. ## Built-in lifecycle hooks ```json { "scripts": { "postinstall": "node setup.js", // runs after `npm install` completes "prepare": "husky install" // runs after install (commonly sets up git hooks) } } ``` Hooks como `postinstall` e `prepare` executam em momentos definidos do lifecycle de instalação — frequentemente usados para configurar git hooks (husky) ou compilar dependências nativas. (Cuidado: scripts `postinstall` em dependências também são uma consideração de segurança de supply-chain.) ## Passando argumentos e variáveis de ambiente ```bash npm run test -- --watch # pass args to the script after -- NODE_ENV=production npm start # set an env var for the run ``` ## Por que scripts npm em vez de Makefile/ferramentas globais ```text ✓ Self-documenting — `package.json` shows all available tasks ✓ Cross-platform-ish, no global installs needed (uses local node_modules/.bin) ✓ Standard across the JS ecosystem — every dev knows `npm run` ``` ## Por que isso importa Scripts npm são o task runner padrão para projetos Node/JS — eles centralizam e documentam como iniciar, build, testar e lint a app, garantindo que todos (e CI) executem comandos idênticos. Compreender a composição de scripts, os hooks automáticos `pre`/`post` (para setup/limpeza), e lifecycle hooks como `postinstall`/`prepare` permite automatizar workflows do projeto de forma limpa. Eles são a cola da tooling do projeto e aparecem em essencialmente todo repositório Node.