# Метод stat

Метод `stat` возвращает статистическую информацию о файле или папки в формате объекта. В первом параметре метода указывается путь к нужному нам файлу или папке, во втором и третьем необязательных параметрах - объект с опциями и коллбэк.

## Синтаксис

`fs.stat(путь к файлу или папке, [опции], [коллбэк]);`

## Объект с опциями

Опция | Описание
--- | ---
`bigint` | Если `true`, задает отображение числовых значений в формате `bigint`. Значение по умолчанию `false`.

## Пример

Пусть у нас есть следующая файловая структура:

<$structure$> /dir/ file1.txt file2.txt <-structure->

Давайте асинхронно прочитаем статистическую информацию о папке `dir` через `await`:

`import fs from 'fs/promises'; try { let data = await fs.stat('./dir/'); console.log(data); } catch (err) { console.log(err); }`

## Пример

Давайте асинхронно узнаем статистическую информацию о файле `file1.txt` через `then`:

`import fs from 'fs/promises'; fs.stat('./dir/file1.txt').then(data => { console.log(data); }).catch(err => { console.log(err); });`

## Пример

Давайте асинхронно узнаем статистическую информацию о файле `file2.txt` через коллбэк:

`import fs from 'fs'; fs.stat('./dir/file2.txt', function(err, data) { if (!err) { console.log(data); } else { console.log(err); } });`

## Пример

Давайте синхронно прочитаем статистическую информацию о папке `dir` через `statSync`:

`import fs from 'fs'; try { let data = fs.statSync('./dir/'); console.log(data); } catch (err) { console.log(err); }`

## Смотрите также

- метод `readdir`,
  который читает папки
- метод `fstat`,
  который возвращает статистику о файловом дескрипторе
- метод `lstat`,
  который возвращает статистическую информацию о файлах, папки, символической ссылке

← →
↑