configuração de package.json

Se você estiver desenvolvendo um aplicativo Node.js com muitos pacotes npm, não é incomum encontrar avisos ou erros ao criar seu projeto se um ou mais pacotes tiverem sido atualizados. Às vezes, um conflito de versão resulta ou uma versão do pacote foi preterida. Aqui estão algumas dicas rápidas para ajudá-lo a configurar seu arquivo package.json e entender o que está acontecendo quando você vê avisos ou erros. Este não é um guia completo para package.json e se concentra apenas no controle de versão do pacote npm.

O sistema de controle de versão do pacote npm tem regras rígidas. O formato de versão segue aqui:

[major].[minor].[patch]

Digamos que você tenha um pacote em seu aplicativo com uma versão 5.2.1. A versão principal é 5, a versão secundária é 2 e o patch é 1.

• Em uma atualização de versão principal, o pacote inclui novos recursos que são incompatíveis com versões anteriores, ou seja, alterações significativas.
• Em uma atualização de versão menor, novos recursos foram adicionados ao pacote que são compatíveis com versões anteriores.
• Em uma atualização de patch, uma ou mais correções de bug são incluídas. As correções de bug são sempre compatíveis com versões anteriores.

Vale a pena observar que alguns recursos de pacote npm têm dependências. Por exemplo, para usar um novo recurso do pacote do compilador TypeScript (ts-loader) com webpack, é possível que você também precise atualizar o pacote npm do webpack e o pacote webpack-cli.

Para ajudar a gerenciar o controle de versão do pacote, o npm dá suporte a várias notações que você pode usar no package.json. Você pode usar essas notações para controlar o tipo de atualizações de pacote que deseja aceitar em seu aplicativo.

Digamos que você esteja usando o React e precise incluir o pacote react e react-dom npm. Você pode especificar isso de várias maneiras em seu arquivo depackage.json . Por exemplo, você pode especificar o uso da versão exata de um pacote da seguinte maneira.

"dependencies": {
  "react": "16.4.2",
  "react-dom": "16.4.2",
},

Usando a notação anterior, o npm sempre obterá a versão exata especificada, 16.4.2.

Você pode usar uma notação especial para limitar as atualizações a atualizações de patch (correções de bug). Neste exemplo:

"dependencies": {
  "react": "~16.4.2",
  "react-dom": "~16.4.2",
},

você usa o caractere til (~) para instruir o npm a atualizar um pacote apenas quando este receber um patch. Portanto, o npm pode atualizar o react 16.4.2 para 16.4.3 (ou 16.4.4, etc.), mas não aceitará uma atualização para a versão principal ou secundária. Portanto, a versão 16.4.2 não será atualizada para 16.5.0.

Você também pode usar o símbolo caret (^) para especificar que o npm pode atualizar a versão menor.

"dependencies": {
  "react": "^16.4.2",
  "react-dom": "^16.4.2",
},

Usando essa notação, o npm pode atualizar o react 16.4.2 para 16.5.0 (ou 16.5.1, 16.6.0 etc.), mas não aceitará uma atualização para a versão principal. Portanto, a versão 16.4.2 não será atualizada para 17.0.0.

Quando o npm atualiza pacotes, ele gera um arquivo package-lock.json , que lista as versões reais do pacote npm usadas em seu aplicativo, incluindo todos os pacotes aninhados. Embora package.json controle as dependências diretas do aplicativo, ele não controla dependências aninhadas (outros pacotes npm exigidos por um pacote npm específico). Você pode usar o arquivo package-lock.json em seu ciclo de desenvolvimento se precisar garantir que outros desenvolvedores e testadores estejam usando os pacotes exatos que você está usando, incluindo pacotes aninhados. Para obter mais informações, consulte package-lock.json na documentação do npm.

Para o Visual Studio, o arquivo package-lock.json não é adicionado ao seu projeto, mas você pode encontrá-lo na pasta do projeto.