Statistiche dei file in Node.js

Ogni file è dotato di una serie di dettagli che possiamo ispezionare usando Node.js. In particolare, usando il metodo stat() fornito dal modulo fs.

Lo si chiama passando un percorso file, e una volta che Node.js ottiene i dettagli del file, chiamerà la funzione di callback che si passa, con 2 parametri: un messaggio di errore e le statistiche del file:

import fs from 'node:fs'
fs.stat('/Users/joe/test.txt', (err, stats) => {
  if (err) {
    console.error(err)
  }
  // abbiamo accesso alle statistiche del file in `stats`
})

Node.js fornisce anche un metodo sincrono, che blocca il thread fino a quando le statistiche del file non sono pronte:

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

Le informazioni sul file sono incluse nella variabile stats. Che tipo di informazioni possiamo estrarre usando le statistiche?

Molte, tra cui:

• se il file è una directory o un file, usando stats.isFile() e stats.isDirectory()
• se il file è un collegamento simbolico usando stats.isSymbolicLink()
• la dimensione del file in byte usando stats.size.

Ci sono altri metodi avanzati, ma la maggior parte di ciò che userai nella tua programmazione quotidiana è questo.

import fs from 'node: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
})

È anche possibile utilizzare il metodo fsPromises.stat() basato su promise offerto dal modulo fs/promises se lo si desidera:

import fs from 'node:fs/promises'
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)
}

È possibile leggere ulteriori informazioni sul modulo fs nella documentazione del modulo file system.