Aprendemos várias técnicas de manipulação de arquivos durante nossa exploração do módulo FileSystem (fs). No entanto, diretórios são mais do que locais para armazenar arquivos – eles oferecem oportunidades para organização, análise de dados e muito mais.

Neste capítulo, abordaremos a manipulação de diretórios e orientaremos sobre como navegar entre diretórios, coletar estatísticas importantes, processar diretórios e criar um script para analisar e exibir o conteúdo de diretórios.

📂 Navegação em Diretórios com fs.readdir

O método fs.readdir lê de forma assíncrona o conteúdo de um diretório. Ele retorna um array com os nomes dos arquivos. Este método pode ser útil para listar arquivos em uma pasta.

Considere um cenário em que lidamos com contratos jurídicos extensos, petições e outros documentos relacionados a diferentes casos e clientes. Podemos criar um sistema que extraia e liste os nomes dos arquivos dentro da pasta de cada cliente.

Exemplo de Código: Ler os nomes dos arquivos de um diretório

const fs = require("fs").promises;

async function listDirectoryContents(directoryPath) {
  try {
    const files = await fs.readdir(directoryPath);
    console.log("Directory Contents:", files);
  } catch (err) {
    console.error("Error reading directory:", err.message);
  }
}

listDirectoryContents("./docs");

Explicação Passo a Passo

📊 Obtendo Estatísticas de Diretórios com fs.stat

Diretórios armazenam arquivos e contêm informações valiosas sobre os atributos de cada arquivo.

O método fs.stat recupera estatísticas de um arquivo ou diretório de forma assíncrona. Essas estatísticas incluem tamanho do arquivo, permissões, carimbos de data/hora e outros dados.

Veja como obter as estatísticas de cada pasta dentro da pasta docs.

Exemplo de Código: Obter nomes e estatísticas de diretórios

const fs = require("fs").promises;

async function processDirectoryContents(directoryPath) {
  try {
    const files = await fs.readdir(directoryPath);

    const fileStatsPromises = files.map(async (file) => {
      const filePath = `${directoryPath}/${file}`;
      const stats = await fs.stat(filePath);
      return { name: file, stats };
    });

    const fileStats = await Promise.all(fileStatsPromises);
    console.log("Detailed File Information:", fileStats);
  } catch (err) {
    console.error("Error processing directory contents:", err.message);
  }
}

processDirectoryContents("./docs");

Explicação Passo a Passo

🧐 Hora do Quiz

Vamos testar seu conhecimento sobre o módulo FileSystem (fs) com algumas perguntas relacionadas à manipulação de diretórios.