Como obter as versões dos pacotes instalados com npm

Neste artigo você vai aprender a como obter as versões dos pacotes instalados com npm no nosso projeto de Node JS

Pra ver a versão de um pacote já instalado, abre o terminal na pasta do projeto e roda npm list <nome do pacote> (list é alias do npm ls)

Sem opção nenhuma, o npm ls mostra apenas as dependências imediatas do projeto raiz: use npm ls –all pra ver a árvore inteira

Se você quer a versão publicada no registry, e não a instalada, o comando é npm view <nome do pacote> version (info, show e v são aliases do mesmo comando)

E pra ler direto uma chave do package.json sem abrir o arquivo, use npm pkg get dependencies

Fala programador(a), beleza? Bora aprender mais sobre npm!

O npm é o gerenciador de pacotes padrão para o Node.js, e é amplamente utilizado para instalar bibliotecas e ferramentas que podem ser usadas em projetos de JavaScript.

Às vezes, é importante saber qual é a versão de um pacote instalado no npm, seja para garantir que está usando a versão mais atual ou para debugar problemas que possam estar ocorrendo.

Existem algumas maneiras de obter a versão de um pacote instalado no npm, e neste artigo, vamos explorar alguns desses métodos com exemplos de código.

Método 1: Usar o comando ‘npm list’

O comando ‘npm list’ exibe uma lista de todos os pacotes instalados em um projeto, incluindo a versão de cada pacote.

Para usar esse comando, basta abrir o terminal e navegar até a pasta raiz do seu projeto e executar o seguinte comando:

npm list

Isso irá exibir uma lista de todos os pacotes instalados no projeto, incluindo a versão de cada pacote. Aqui está um exemplo de saída desse comando:

├── [email protected]
├── [email protected]
├── [email protected]
└── [email protected]

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Para obter apenas a versão de um pacote específico, basta adicionar o nome do pacote como um argumento para o comando ‘npm list’.

Por exemplo, para obter a versão do pacote ‘express’, basta executar o seguinte comando:

npm list express

Isso irá exibir a versão do pacote ‘express’ instalado no projeto, assim como qualquer outro pacote que dependa do ‘express’:

├── [email protected]
├── [email protected]
└── [email protected]

Método 2: Usar o comando ‘npm view’

O comando ‘npm view’ exibe informações sobre um pacote específico, incluindo a versão mais atual disponível no npm registry. Para usar esse comando, basta executar o seguinte comando no terminal:

npm view <nome do pacote> version

Substitua ‘<nome do pacote>’ pelo nome do pacote cuja versão deseja obter. Por exemplo, para obter a versão mais atual do pacote ‘express’, basta executar o seguinte comando:

npm view express version

Método 3: Usando o arquivo package.json

O arquivo package.json é um arquivo importante em qualquer projeto Node.js e é criado automaticamente quando você cria um projeto com o comando npm init. Ele contém informações sobre o projeto, incluindo as dependências instaladas.

Para ver a versão de um pacote específico, basta abrir o arquivo package.json e procurar pelo nome do pacote na seção “dependencies”. Por exemplo:

{
  "name": "my-project",
  "version": "1.0.0",
  "dependencies": {
    "express": "4.17.1"
  }
}

Método 4: Usando o comando npm show

O comando npm show exibe informações detalhadas sobre um pacote, incluindo a versão atualmente instalada. Para ver a versão de um pacote específico, basta adicionar o nome do pacote como argumento. Por exemplo:

npm show express version

Em resumo, existem várias maneiras de verificar qual é a versão de um pacote instalado no npm.

Você pode usar os comandos npm list, npm view, npm ls ou npm show, ou pode consultar o arquivo package.json do projeto.

Qualquer um desses métodos pode ser útil dependendo da sua situação específica.

Deixe um comentário contando o que achou deste artigo 🙂

Quer aprender mais sobre Node.js? Confira o vídeo abaixo:

Conclusão

Neste artigo você viu como obter as versões dos pacotes instalados com npm

Utilizamos várias abordagens, que chegam no mesmo resultado

Agora basta você decidir qual a melhor para a sua situação, e aplicar o código!

Está buscando a sua primeira vaga como Programador? Confira o nosso treinamento completo clicando aqui.

Uma plataforma de cursos com projetos completos, comunidade de alunos e muito mais!

Há também o nosso canal no YouTube, com muito conteúdo gratuito de qualidade!

Resposta rápida:

Pra saber a versão de um pacote que já está instalado, abre o terminal na pasta do projeto e roda:

npm list <nome do pacote>

O list é alias do npm ls, então os dois fazem a mesma coisa

Sem passar opção nenhuma, ele mostra só as dependências imediatas do projeto raiz: se você quer a árvore inteira, use npm ls –all

Se o que você quer é a versão publicada lá no registry, e não a que está na sua máquina, aí o comando é outro:

npm view <nome do pacote> version

E pra ler o que está escrito no seu package.json sem abrir o arquivo, existe o npm pkg get

O npm list mostra só as dependências diretas:

Detalhe que pega muita gente: sem nenhuma opção, o npm ls lista apenas as dependências imediatas do projeto raiz

Quer ver a árvore inteira, com as dependências das suas dependências? Então é assim:

npm ls –all

E tem dois aliases que economizam digitação: la e ll, que já vêm com informação estendida por padrão

Ah, e os números da saída de exemplo aqui de cima são ilustrativos, beleza? Hoje, agosto de 2026, a versão do express publicada como latest é a 5.2.1, então a sua saída vai ser bem diferente dessa 🙂

npm view olha o registry, não a sua pasta node_modules:

Vale a pausa aqui pra não misturar duas perguntas diferentes

O npm ls responde "o que está instalado neste projeto"

O npm view responde "o que está publicado lá no npm", e por padrão ele traz os dados da versão marcada como latest no registry

Perguntas diferentes, e é super comum a resposta ser diferente também

Outra coisa que confunde: info, show e v são aliases do npm view

Ou seja, npm show express version e npm view express version são exatamente o mesmo comando, só que com nomes diferentes

npm pkg get: lendo o package.json sem abrir o arquivo:

Abrir o arquivo e procurar com o olho funciona, mas o npm tem comando nativo pra isso

npm pkg get dependencies

Ele retorna o valor da chave que você pedir do package.json

E dá pra descer em campo filho e até em índice de array:

npm pkg get scripts.test

Massa pra quando você quer conferir uma coisa só e não quer sair do terminal

E se eu quiser saber se a versão instalada está atrasada?

Aí entra o npm outdated

Ele monta uma tabela comparando as versões, e entender as colunas é o pulo do gato:

Current: a versão que está instalada agora

Wanted: a maior versão que ainda satisfaz o range declarado no seu package.json

Latest: a versão marcada como latest no registry

Location: onde aquele pacote está na árvore de dependências

Quando Current está atrás do Wanted, você está atrasado dentro do próprio range que você mesmo declarou

Quando o Wanted está atrás do Latest, tem versão nova te esperando fora do range, e provavelmente breaking change no caminho. Tome cuidado!

O que muda no npm 12 (e por que isso te afeta aqui):

A versão publicada como latest do npm hoje, agosto de 2026, é a 12.0.2, e a linha 12 começou em 08/07/2026 com a v12.0.0

Tem uma mudança que bate direto no assunto deste artigo: o npm view –json passa a retornar sempre um array

Se você tem script lendo aquela saída como objeto, ele vai quebrar. Se liga nisso!

E tem mais duas mudanças que valem o aviso, mesmo não sendo sobre versão de pacote:

Os scripts das dependências não rodam mais automaticamente no install: eles precisam ser aprovados com o comando npm approve-scripts

Dependência vinda de git exige a flag –allow-git, e dependência por URL remota (tarball HTTPS) exige –allow-remote

A parte boa: essas três mudanças já aparecem como aviso a partir do npm 11.16.0, então dá pra ver o que vai te morder antes de atualizar 😀

Inserir a seção "Perguntas frequentes" com os pares pergunta/resposta do campo geo.faq, cada pergunta como H3

Um caso real de onde essa dúvida aparece: quando eu gravei o tutorial de instalar o n8n localmente, o n8n entrou na máquina como pacote global via npm, e não como dependência de um projeto

Aí a pergunta "qual versão eu tenho aqui?" muda de lugar, porque não existe package.json de projeto pra consultar: o que sobra é perguntar pro próprio npm

E uma coisa que eu peguei ali na prática e sempre vale o aviso: depois de instalar pacote global, às vezes o comando não pega de primeira no terminal que já estava aberto. Fecha e abre um terminal novo, que resolve

O que eu ainda NÃO testei, e não vou fingir que testei: como o npm 12 se comporta na listagem dos pacotes globais e se as novas travas de script mudam alguma coisa nessa saída. Quando eu rodar isso com calma, eu conto por aqui…