Exercício – Configurar o package.json

Concluído

Você é um desenvolvedor de Node.js na Tailwind Traders. Saber configurar um novo projeto do Node.js é uma habilidade importante. A inclusão da instalação inclui a geração de um arquivo package.json e a criação de alguns scripts comuns a serem usados em todo o ciclo de vida do projeto.

Abrir projeto no contêiner de desenvolvimento

Um ambiente de desenvolvimento simples foi fornecido para você. Se você já tiver o Node.js LTS instalado no seu computador, poderá ignorar esta seção e clonar o repositório exemplo e usar seu ambiente local.

Desenvolvimento remoto (navegador)

1. Inicie o processo para criar um GitHub Codespace no branch main do repositório GitHub MicrosoftDocs/node-essentials.

   Abra este projeto no Codespaces do GitHub

2. Na página Criar codespace , analise as definições de configuração do codespace e selecione Criar novo codespace

   

3. Aguarde até que o codespace seja iniciado. Esse processo de inicialização pode levar alguns minutos.

4. Abra um novo terminal no codespace.

   Dica

   Você pode usar o menu principal para navegar até a opção de menu Terminal e, em seguida, selecionar a opção Novo Terminal.

   

5. Valide se o .NET 7 está instalado em seu ambiente:

   node --version
   

   O contêiner de desenvolvimento usa uma versão Node.js LTS, como v20.5.1. A versão exata pode ser diferente.

6. Os exercícios restantes neste projeto ocorrem no contexto desse contêiner de desenvolvimento.

Desenvolvimento local(Docker)

1. Abra o Visual Studio Code no contexto de um diretório vazio.

2. Verifique se a extensão Dev Containers está instalada no Visual Studio Code.

3. Abrir um novo terminal no editor.

   Dica

   Você pode usar o menu principal para navegar até a opção de menu Terminal e, em seguida, selecionar a opção Novo Terminal.

   

4. Clonar o repositório MicrosoftDocs/node-essentials do GitHub no diretório atual.

   git clone https://github.com/MicrosoftDocs/node-essentials.git
   

5. Abra o repositório no código com os comandos a seguir no terminal.

   cd node-essentials
   code .
   

6. Abra a Paleta de comandos, procure os comandos Dev Containers e selecione Dev Containers: reabrir no contêiner.

   Dica

   O Visual Studio Code pode solicitar automaticamente que você reabra a pasta existente em um contêiner de desenvolvimento. Isso é funcionalmente equivalente a usar a paleta de comandos para reabrir o workspace atual em um contêiner.

   

7. Valide se o .NET 7 está instalado em seu ambiente:

   node --version
   

   O contêiner de desenvolvimento usa uma versão Node.js LTS, como v20.5.1. A versão exata pode ser diferente.

8. Os exercícios restantes neste projeto ocorrem no contexto desse contêiner de desenvolvimento.

Configurar um novo projeto do Node.js

Para essa unidade, o código-fonte do JavaScript foi fornecido para você. Sua tarefa é criar o arquivo package.json.

1. No terminal, alterne para a pasta desse exercício:

   cd node-dependencies/3-exercise-package-json
   

2. Exiba o conteúdo da pasta:

   ls -R
   

   Nesta pasta, você deverá ver uma subpasta src com um arquivo index.js :

    ./src:
        index.js
   

3. Execute o seguinte comando para criar o arquivo package.json com valores padrão:

   npm init -y
   

   O arquivo package.json que é de modo semelhante a este exemplo:

   {
     "name": "3-exercise-package-json",
     "version": "1.0.0",
     "description": "",
     "main": "index.js",
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [],
     "author": "",
     "license": "ISC"
   }
   

4. Modifique o package.json com esses valores de propriedade:

   • name: "tailwind-trader-api"
   • description: "API HTTP para gerenciar itens do banco de dados Tailwind Traders"
   • main: "index.js"
   • keywords: ["API", "database"]
   • author: "Sam"

   Agora, o arquivo package.json deverá estar semelhante a este código:

   {
     "name": "tailwind-trader-api",
     "version": "1.0.0",
     "description": "HTTP API to manage items from the Tailwind Traders database",
     "main": "index.js",
     "dependencies": {},
     "devDependencies": {},
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": ["api", "database"],
     "author": "Sam",
     "license": "ISC"
   }
   

5. Na seção scripts, adicione um novo script chamado start acima do script test:

   "start": "node ./src/index.js",
   

6. Salve suas alterações e feche o arquivo package.json.

7. Inicie seu projeto com a ação start inserindo este comando:

   npm start
   

   Você deverá ver este resultado:

   Welcome to this application
   

Agora você tem um bom arquivo package.json que pode ser usado como base para o crescimento do seu projeto.