35.estatisticas_de_arquivos_no_node.md

Estátisticas de arquivos no Node.js

Cada arquivo vem com um conjunto de detalhes que podemos inspecionar usando o Node.js.

Em particular, usando o método stat() fornecido pelo módulo fs.

Você o chama passando um caminho de arquivo e, assim que o Node.js obtiver os detalhes do arquivo, ele chamará a função de callback que você passar, com 2 parâmetros: uma mensagem de erro e as estátisticas do arquivo:

const fs = require('fs');

fs.stat('/Users/joe/test.txt', (err, stats) => {
  if (err) {
    console.error(err);
  }
  // nós teremos acesso ao arquivo stats in `stats`
});

O Node.js também fornece um método de sincronização, que bloqueia o encadeamento até que as estatísticas do arquivo estejam prontas:

const fs = require('fs');

try {
  const stats = fs.statSync('/Users/joe/test.txt');
} catch (err) {
  console.error(err);
}

As informações do arquivo são incluídas na variável stats. Que tipo de informação podemos extrair usando as estatísticas?

Muito, incluindo:

• se o arquivo for um diretório ou um arquivo, usando stats.isFile() e stats.isDirectory().
• se o arquivo for um link simbólico usando stats.isSymbolicLink().
• o tamanho do arquivo em bytes usando stats.size.

Existem outros métodos avançados, mas a maior parte do que você usará em sua programação do dia-a-dia é isso.

const fs = require('fs');

fs.stat('/Users/joe/test.txt', (err, stats) => {
  if (err) {
    console.error(err);
    return;
  }

  stats.isFile(); // true
  stats.isDirectory(); // false
  stats.isSymbolicLink(); // false
  stats.size; // 1024000 //= 1MB
});

Você também pode usar o método fs.Promises.stat() baseado em promise oferecido pelo módulo fs/promises se desejar:

const fs = require('fs/promises');

async function example() {
  try {
    const stats = await fs.stat('/Users/joe/test.txt');
    stats.isFile(); // true
    stats.isDirectory(); // false
    stats.isSymbolicLink(); // false
    stats.size; // 1024000 //= 1MB
  } catch (err) {
    console.log(err);
  }
}
example();