Aprendemos diversas técnicas de manipulação de arquivos durante nossa exploração do módulo FileSystem (fs). Mas 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, vamos aprofundar na manipulação de diretórios e orientar 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. Esse 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 extrai e lista 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 de forma assíncrona as estatísticas de um arquivo ou diretório. Essas estatísticas incluem tamanho do arquivo, permissões, carimbos de data/hora e outros dados.

Vamos 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