Computador arquivos editor e primeira execução

O que você construirá

Este percurso começa com um arquivo de texto que o computador executa. Você aprenderá a localizar esse arquivo, modificá-lo e verificar o efeito da mudança. Essa competência será usada durante todo o livro: antes de declarar que uma tarefa terminou, será necessário identificar o que mudou e observar o resultado.

Um programa contém instruções escritas segundo uma linguagem. O código-fonte é o texto dessas instruções. Um ambiente de execução lê esse texto e realiza as operações permitidas. Neste livro, JavaScript é a linguagem, Node.js executa os exemplos no terminal e o navegador executa a interface. JavaScript e Java são linguagens distintas; os nomes parecidos não tornam seus programas intercambiáveis.

Ampliar diagrama

Onde o trabalho fica guardado

Uma pasta reúne arquivos e outras pastas. Um caminho indica a localização de um item: pratica/src/catalogo.mjs significa o arquivo catalogo.mjs dentro de src, dentro de pratica. O ponto em .mjs separa o nome de uma extensão. Essa extensão ajuda o Node a interpretar o arquivo como módulo JavaScript. Ela não transforma o conteúdo em código correto.

O pacote desta edição contém laboratorios_iniciais e pratica. Extraia o ZIP pelo gerenciador de arquivos e conserve uma cópia sem alterações. Não é necessário criar uma conta ou contratar um serviço para esses exercícios locais. Abra a pasta extraída em um editor que salve texto simples. Um processador de textos que insere formatação de parágrafos não é adequado para salvar código-fonte.

Preparar e localizar o ambiente

Instale o Node.js a partir das instruções oficiais em nodejs.org, escolhendo seu sistema operacional. Os testes desta edição usam a linha 24; o registro técnico informa a versão exata executada. O instalador e a forma de abrir um terminal variam entre sistemas. Após instalar, abra um terminal novo e execute os comandos a seguir. Não copie símbolos de convite como $ ou > que apareçam em outros materiais.

node --version
npm --version

Cada comando deve mostrar um número de versão. Se o sistema disser que node não foi localizado, resolva a instalação antes de tentar executar os exemplos. Reabrir um terminal pode ser necessário para que o caminho do programa seja atualizado. Anote a mensagem recebida; executar o mesmo comando repetidamente não corrige uma instalação ausente.

No gerenciador de arquivos, abra um terminal dentro de laboratorios_iniciais. Outra opção é usar cd seguido do caminho da pasta. Caminhos com espaços precisam de aspas. O diretório de trabalho é a pasta em que o terminal procura os caminhos relativos. O mesmo nome de arquivo pode existir em duas pastas; executar a cópia errada é uma causa comum de confusão.

Primeiro arquivo explicado

Abra 01_primeiro.mjs. Seu conteúdo completo é o seguinte.

const projeto = 'Oficina Caracol';
console.log('Primeiro programa de ' + projeto);

Na primeira linha, const cria um nome para o valor de texto Oficina Caracol. O sinal = atribui esse valor; aqui não faz uma comparação. Na segunda, console.log mostra uma informação no terminal. O sinal + reúne os dois textos. As aspas delimitam texto e os parênteses contêm o valor entregue a console.log. Salve o arquivo antes de executar.

node 01_primeiro.mjs

A saída esperada é Primeiro programa de Oficina Caracol. Ela comprova que esse arquivo foi executado nesse ambiente. Não comprova que o catálogo, o servidor ou a interface estejam corretos. A extensão da prova começa a ser praticada no primeiro exercício.

Prática guiada e resolução

Troque apenas o texto Oficina Caracol por Oficina de Estudos. Salve e execute novamente. Depois volte ao texto original. Se o resultado não mudar, confira o caminho do arquivo aberto, o diretório do terminal e se a alteração foi salva.

Agora retire temporariamente a aspa que fecha o nome do projeto. Execute, observe o erro de sintaxe e restaure a aspa. Um erro de sintaxe impede que o ambiente compreenda o programa; a mensagem costuma indicar uma localização, mas o engano pode ter começado antes dela. Compare a linha com a cópia preservada em vez de alterar várias partes sem hipótese.

Exercício: registre o nome do arquivo, o comando, a versão do Node e as duas saídas após a troca do nome. Solução de referência: as saídas devem diferir somente no nome do projeto. A atividade está concluída quando você consegue repetir a alteração e explicar qual arquivo foi executado. Um print sem caminho e sem comando não permite distinguir cópias diferentes.