Glossário JavaScript

O Que É npm? Introdução Básica para Iniciantes

aprenda o que é npm e como usar no seu linux

O npm é o Gerenciador de Pacotes do Node (Node Package Manager) que vem junto com ele e que é muito útil no desenvolvimento Node. Por anos, o Node tem sido amplamente usado por desenvolvedores JavaScript para compartilhar ferramentas, instalar vários módulos e gerenciar suas dependências. Sabendo disso, é realmente importante para pessoas que trabalham com Node.js entendam o que é npm.

Como O npm Funciona?

O npm funciona baseado nesses dois ofícios:

  • Ele é um repositório amplamente usado para a publicação de projetos Node.js de código aberto (open-source). Isso significa que ele é uma plataforma online onde qualquer pessoa pode publicar e compartilhar ferramentas escritas em JavaScript.
  • O npm é uma ferramenta de linha de comando que ajuda a interagir com plataformas online, como navegadores e servidores. Essa utilidade auxilia na instalação e desinstalação de pacotes, gerenciamento da versões e gerenciamento de dependências necessárias para executar um projeto.

Para usá-lo, você precisa instalar o node.js – visto que, eles são empacotados juntos.

download do gerenciador de pacote node

O utilitário de linha de comando do npm permite que o node.js funcione devidamente.

Para usar os pacotes, seu projeto deve conter um arquivo chamado de package.json. Dentro do pacote, você encontrará metadados específicos para os projetos.

Os metadados mostram alguns aspectos do projeto na seguinte ordem:

  • O nome do projeto;
  • A versão inicial;
  • A descrição;
  • O ponto de entrada;
  • Os comandos de teste;
  • O repositório git;
  • As palavras-chave;
  • A licença;
  • As dependências;
  • As dependências do desenvolvedor (devDependencies).

Os metadados ajudam a identificar o projeto e agem como uma base para que os usuários obtenham as informações sobre ele.

Aqui tem um exemplo de como identificar um projeto por meio desses metadados:

{
  "name": "hostinger-npm",
  "version": "1.0.0",
  "description": "npm guide for beginner",
  "main": "beginner-npm.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "npm",
    "example",
    "basic"
  ],
  "author": "Hostinger International",
  "license": "MIT",
  "dependencies": {
    "express": "^4.16.4"
  }
}
  • O nome é hostinger-npm;
  • A versão é 1.0.0;
  • A descrição informa npm guide for beginner;
  • O ponto de entrada do projeto ou o arquivo principal é beginner-npm.js;
  • As palavras chave ou tags para encontrar o projeto no repositório são npm, example e basic;
  • O autor do projeto é Hostinger International;
  • Este projeto está licenciado sob o MIT;
  • As dependências ou outros módulos que esse módulo usa são express 4.16.4.

Como Instalar Módulos npm e Começar Projetos?

Primeiro você precisa garantir que o node.js e npm estão instalados. Faça isso executando os seguintes comandos.

Para ver se o node.js está instalado, abra o Terminal ou uma ferramenta de linha de comando e digite node -v. Ele mostrará o número da versão caso você já o tenha:

$ node -v

v0.10.9

Para verificar se o npm está instalado, digite npm -v. Ele mostrará o número da versão:

$ npm -v 

1.2.25

Se você ainda não o tem instalado, baixe o Node no site do node.js e siga as instruções no instalador.

O npm é famoso pelo seu instalador de uma linha:

$ curl https://npmjs.org/install.sh | sh

Uma vez instalado, você pode atualizar o npm para novas versões. Para atualizá-lo, apenas baixe o instalador do site do node.js e o execute novamente. A nova versão irá substituir automaticamente a última.

No entanto, você também pode atualizá-lo usando este comando:

$ npm update -g npm

Começar um Projeto Com npm

Se você já tiver o Node e o npm e deseja começar a construir seu projeto, execute o comando npm init. Com isso, você dará procedimento aà inicialização do seu projeto.

Por exemplo, vamos criar um diretório chamado test-npm e iniciar um cd nele. Agora, vamos executar nosso primeiro comando npm:

$ npm init

Esse comando funciona como uma ferramenta para criar o arquivo package.json de um projeto.

Depois de executar as etapas do npm init, um arquivo package.json será gerado e colocado no diretório atual.

O init do gerenciador de pacotes do Node explica (em inglês) o que acontece quando você o executa:

mymacs-MacBook-Pro: test-npm mymac$ npm init
This utility will walk you through creating a package.json file. 
It only covers the most common items, and tries to guess sane defaults. 
See `npm help json` for definitive documentation on these fields and exactly what they do. 
Use `npm install --save` afterwards to install a package and save it as a dependency in the package.json file. 
Press ^C at any time to quit. 
name: (test-npm)

Resposta à solicitação init do npm.

name: (test-npm)hostinger-npm
version: (1.0.0)1.0.0
description: npm guide for beginner
entry point: (index.js) beginner-npm.js
test command:
git repository:
keywords: npm, example, beginner
author: Hostinger Internationallicense: (ISC) MIT

Pressione Enter para aceitar. Então, o npm init fornece uma prévia do package.json que está prestes a ser criado.

Se parece com isso:

{
  "name": "hostinger-npm",
  "version": "1.0.0",
  "description": "npm guide for beginner",
  "main": "beginner-npm.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "npm",
    "example",
    "basic"
  ],
  "author": "Hostinger International",
  "license": "MIT",
  "dependencies": {
    "express": "^4.16.4"
  }
}
Is this OK? (yes) yes
mymac-MacBook-Pro: test-npm mymac$

Digite yes e pressione Enter para confirmar, salvando, assim, o package.json. Você sempre pode modificá-lo depois, editar o arquivo diretamente ou executar npm init novamente.

Instalar Módulos npm

Um pacote em node.js contém todos os arquivos que você precisa para um módulo. Os módulos são bibliotecas JavaScript que você pode incluir no seu projeto.

Instalar módulos é uma das coisas mais básicas que você deve aprender a fazer quando começar a usar o gerenciador de pacote Node. Segue um comando para instalar um módulo no diretório atual:

$ npm install <module> 
$ npm i <module>

No comando acima, substitua o <module> pelo nome do módulo que você quer instalar.

Por exemplo, se você quer instalar o módulo Express – o mais usado e mais bem conhecido framework web node.js – você pode executar o seguinte comando:

$ npm install express
[mymac-MacBook-Pro:test-npm mymac$ npm install express]
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN hostinger-npm@1.0.0 No repository field.
+ express@4.16.4
added 48 packages from 36 contributors and audited 121 packages in 2.798s
found 0 vulnerabilities
mymac-MacBook-Pro: test npm mymac$

O comando acima irá instalar o módulo express em /node_modules no diretório atual.

Sempre que você instalar um módulo do npm, ele será instalado na pasta node_modules.

Abaixo é como ele se aparenta depois de você instalar um modulo no seu projeto:

[mymac-MacBok-Pro: test-npm mymac$ cat package.json]
{
  "name": "hostinger-npm",
  "version": "1.0.0",
  "description": "npm guide for beginner",
  "main": "beginner-npm.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "npm",
    "example",
    "basic"
  ],
  "author": "Hostinger International",
  "license": "MIT",
  "dependencies": {
    "express": "^4.16.4"
  }
}
mymac-MacBok-Pro: test-npm mymac$ []

Conclusão

Como você pode ver, além da função primária como um banco de dados online para vários pacotes node.js, o objetivo principal do gerenciador de pacote Node é uma dependência automatizada e gerenciamento para os arquivos package.json com sua interface da linha de comando.

Esses são os comandos básicos que você deve saber para:

  • Instalar o npm:
$ curl https://npmjs.org/install.sh | sh
  • Checar a versão:
$ npm -v
  • Inicializar o projeto:
$ npm init
  • Instalar módulos:
$ npm install <module>

$ npm i <module>

Se você está planejando trabalhar com JavaScript, o npm é uma ferramenta indispensável para seu fluxo de trabalho.

Andrei L.

Andrei é jornalista e conteudista SEO na Hostinger Brasil. Tem experiência em WordPress e na produção de conteúdos de tecnologia otimizados para conquistar as melhores posições no Google. É fã de games, adora vôlei, ama o inverno e está sempre buscando se aperfeiçoar no Inglês.

Deixe um Comentário

Deixe seu comentário!

Esse site utiliza o Akismet para reduzir spam. Aprenda como seus dados de comentários são processados.

Comece a Economizar Agora!

Hospedagem com tudo incluso e nome de domínio
R$2
29
/mês*