Skip to content

Статистика файлов в Node.js

Каждый файл содержит набор сведений, которые мы можем проверить с помощью Node.js. В частности, используя метод stat(), предоставляемый модулем fs.

Вы вызываете его, передавая путь к файлу, и как только Node.js получит сведения о файле, он вызовет переданную вами функцию обратного вызова с двумя параметрами: сообщение об ошибке и статистика файла:

js
import fs from 'node:fs'
fs.stat('/Users/joe/test.txt', (err, stats) => {
  if (err) {
    console.error(err)
  }
  // у нас есть доступ к статистике файла в `stats`
})

Node.js также предоставляет синхронный метод, который блокирует поток до тех пор, пока статистика файла не будет готова:

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

Информация о файле содержится в переменной stats. Какую информацию мы можем извлечь с помощью stats?

Много чего, включая:

  • является ли файл директорией или файлом, используя stats.isFile() и stats.isDirectory()
  • является ли файл символической ссылкой, используя stats.isSymbolicLink()
  • размер файла в байтах, используя stats.size.

Существуют и другие расширенные методы, но основная часть того, что вы будете использовать в повседневном программировании, именно это.

js
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
})

Вы также можете использовать метод fsPromises.stat(), основанный на промисах, предлагаемый модулем fs/promises, если хотите:

js
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)
}

Вы можете узнать больше о модуле fs в документации по модулю файловой системы.