【Node.js24.x】Object::Stats()メソッドの使い方

Statsメソッドは、Node.jsのファイルシステムモジュール（fsモジュール）において、ファイルやディレクトリの様々な詳細情報を取得し、その種類を判別する機能を提供します。

この機能は、主にfs.stat()、fs.fstat()、fs.lstat()などのメソッドによってファイルやディレクトリの状態を読み取った際に、その結果として返されるfs.Statsオブジェクトを介して利用されます。fs.Statsオブジェクトは、取得した情報に基づいて、それが通常のファイルなのか、ディレクトリなのか、あるいはシンボリックリンクなのかといった種類を簡単に判別するための専用のメソッド群（例: isFile(), isDirectory(), isSymbolicLink()など）を備えています。

具体的には、ファイルサイズ、最終アクセス時刻、最終変更時刻、作成時刻、所有者情報、パーミッション設定などのメタデータがこのStatsオブジェクトにカプセル化されています。システムエンジニアがファイルシステムの操作を行う際には、これらの情報が非常に重要となります。例えば、特定のディレクトリ内のファイルのみを処理したり、更新日時が新しいファイルだけをバックアップしたりするなど、様々な条件に基づいて処理を分岐させる場面で不可欠です。

Statsオブジェクトが提供するこれらのメソッドとプロパティを理解することは、Node.jsで堅牢なファイル操作ロジックを構築するための基礎となります。ファイルやディレクトリの情報を正確に把握し、それに応じた適切な処理を実行するために活用される、極めて実用的な機能です。

Copy
1const fs = require('node:fs');
2const stats = fs.statSync('file.txt');
3stats.isFile();

...args

Node.js v24 の Object.Stats メソッドに、...args という名前で引数はありません。

戻り値なし

戻り値はありません