O arquivo package.json
:
Todos os projetos Node que utilizam algum gerenciador de pacotes, como o NPM ou o Yarn possuem um arquivo package.json
, que define as métricas, de maneira geral, do projeto, identificando as dependências, nome do pacote, e muitas outras informações.
Para saber mais sobre o arquivo package.json
e todos as suas funcionalidades, queira consultar a documentação do package.json
.
Os npm scripts:
Uma das funcionalidades que gerenciadores de pacotes como NPM ou Yarn fornecem são os scripts, que consistem, basicamente, em "atalhos" para comandos, definidos no arquivo package.json
. Eles também fornecem hooks para o ciclo de vida do pacote.
Um exemplo (arquivo package.json
):
{
"scripts": {
"start": "node app.js"
}
}
Note que acima definimos o script start
, que pode ser invocado pelo seu terminal usando npm run start
, ou, em sua forma reduzida npm start
.
O comando npm build
:
Como demonstrado acima, o autor de um pacote pode definir scripts customizados para o seu pacote. Imagine agora que este pacote precise de uma etapa de build. Essa necessidade é muito comum em projetos que usam recursos como o TypeScript.
Um exemplo:
Tendo em vista que o pacote não pode ser publicado ao registro do NPM com código TypeScript, é muito comum criar um script (geralmente, por convenção, com o nome build
), para fazer o build
do código TypeScript para JavaScript:
{
"scripts": {
"build": "tsc" <-- Comando usado para compilar arquivos TypeScript em JS!
}
}
Este foi só um dos exemplos para o npm build
, já que o seu uso varia de acordo com o projeto.
Leitura extra