Node.js, npm e package.json

O que é o Node.js?

O Node.js é um ambiente que permite executar JavaScript fora do navegador, por exemplo no seu computador ou em um servidor. Ele usa o mesmo motor que o Chrome (V8) e abre a porta para criar servidores web, ferramentas de linha de comando e muito mais.

# Executar um arquivo com o Node
node app.js

npm e package.json

O npm (Node Package Manager) é o gerenciador de pacotes do Node. Com ele você instala bibliotecas que outras pessoas publicaram.

npm init -y          # cria um package.json
npm install lodash   # instala uma dependência
npm install --save-dev jest  # dependência de desenvolvimento

O arquivo package.json descreve seu projeto: seu nome, versão, dependências e scripts.

{
  "name": "meu-projeto",
  "version": "1.0.0",
  "scripts": {
    "test": "jest",
    "start": "node app.js"
  },
  "dependencies": {
    "lodash": "^4.17.21"
  }
}

Os scripts são executados com npm run <nome> (ou npm test, npm start para os especiais).

A pasta node_modules (onde as dependências são instaladas) não é enviada para o repositório: ela é regenerada com npm install a partir do package.json.

Exemplos

Ler dados do package.json (simulado)

const pacote = {
  name: "meu-projeto",
  version: "1.0.0",
  scripts: { test: "jest", start: "node app.js" },
};
console.log("Projeto:", pacote.name, "v" + pacote.version);
console.log("Scripts disponíveis:", Object.keys(pacote.scripts));