O módulo FileSystem (fs) é um módulo central do Node.js, fornecendo capacidades poderosas para interagir com arquivos de forma programática. Esse módulo é útil em várias tarefas, incluindo o gerenciamento de configurações, o manejo da organização de dados e a leitura e escrita de conteúdo de arquivos.

📖 Leitura de Arquivos com fs.readFile

O método fs.readFile retorna uma promessa que é resolvida com o conteúdo do arquivo. Ele permite a leitura de arquivos de forma assíncrona, sendo adequado para ler arquivos de texto e binários.

• caminho - o caminho do arquivo a ser lido.
• opções - um objeto opcional especificando opções como a codificação.

Imagine a construção de uma plataforma de blogs dinâmica. Aqui, o método fs.readFile entra em cena, recuperando rapidamente o conteúdo de postagens de um arquivo.

Exemplo de Código: Lendo Conteúdo

Explicação Passo a Passo

🖋️ Escrita de Arquivos com fs.writeFile

O método fs.writeFile retorna uma promessa que resolve quando o arquivo foi escrito. Ele é utilizado para escrever dados de maneira assíncrona em um arquivo, que pode ser novo ou existente. Oferece opções para especificar dados, codificação e permissões de arquivo.

• file - o caminho do arquivo para escrita.
• data - os dados a serem escritos, que podem ser uma string ou um buffer.
• options - um objeto opcional especificando opções como a codificação e o modo do arquivo.

Imagine que precisamos salvar um novo usuário no arquivo user-db.json. Aqui o método fs.writeFile garante que nossas palavras encontrem seu lugar.

Exemplo de Código: Escrevendo Dados de Usuário

Explicação Passo a Passo

📄 Extendendo com fs.appendFile

O método fs.appendFile retorna uma promessa que é resolvida quando os dados são anexados ao arquivo. É utilizado para anexar dados de modo assíncrono a um arquivo existente, preservando seu conteúdo anterior.

• arquivo - o caminho do arquivo ao qual os dados serão anexados.
• dados - os dados a serem anexados, que podem ser uma string ou um buffer.
• opcoes - um objeto opcional especificando opções como codificação e modo de arquivo.

Imagine uma aplicação de chat movimentada registrando conversas. À medida que novas mensagens chegam, o método fs.appendFile adiciona novas mensagens ao registro do chat, preservando as interações anteriores.

Exemplo de Código: Anexando Mensagens de Chat

Explicação Passo a Passo

Nota

• fs.writeFile é utilizado para substituir completamente o conteúdo de um arquivo ou criar um novo arquivo.
• fs.appendFile é utilizado para adicionar novos dados ao final de um arquivo existente sem sobrescrever o que já está lá.

🧐 Hora do Quiz

Vamos avaliar seu entendimento dos conceitos do módulo FileSystem (fs):