Estatísticas do ficheiro da Node.js

Como receber os detalhes de um ficheiro usando a Node.js

Autores do Artigo

Cada ficheiro vem com um conjunto de detalhes que podemos inspecionar usando a Node.js. Em especial, usando o método stat() fornecido pelo módulo fs.

Tu o chamas passando um caminho de ficheiro, e uma vez que a Node.js receber os detalhes do ficheiro chamará a função de resposta que passares, com dois parâmetros: uma mensagem de erro, e as estatísticas do ficheiro:

A Node.js também fornece um método síncrono, o qual bloqueia a linha de processamento até as estatísticas do ficheiro estiverem prontas:

A informação do ficheiro é incluída na variável stats. Que tipo de informação podemos extrair usando a stats?

Um monte, incluindo:

  • Se o ficheiro é um diretório ou um ficheiro, usando stats.isFile() e stats.isDirectory().
  • Se o ficheiro é uma ligação simbólica usando stats.isSymbolicLink().
  • O tamanho do ficheiro em bytes usando stats.size.

Existem outros métodos avançados, mas a proporção daquilo que usarás no teu dia-à-dia de programação é esta:

Tu podes também usar o método fsPromises.stat() baseado em promessas oferecido pelo módulo fs/promises se quiseres:

Tu podes ler mais a respeito do módulo fs na documentação oficial.