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

rmdirメソッドは、Node.jsのファイルシステム操作において、指定された空のディレクトリを削除するために使用されるメソッドです。このメソッドは、引数として削除したいディレクトリのパスを受け取ります。指定されたディレクトリが実際に存在し、かつそのディレクトリが空である場合にのみ、削除処理が実行されます。もしディレクトリ内にファイルや別のサブディレクトリが含まれている場合、このメソッドはエラーを発生させてディレクトリを削除できませんのでご注意ください。

rmdirメソッドは非同期で動作します。これは、削除処理がバックグラウンドで行われ、その完了を待たずにプログラムの次の行が実行されるという意味です。処理が成功したか、あるいはエラーが発生したかは、通常、コールバック関数を通じて通知されます。したがって、このメソッドを使用する際には、エラーハンドリングを適切に行うことが非常に重要です。例えば、指定されたパスのディレクトリが存在しない場合や、プログラムにディレクトリを削除する権限がない場合などにはエラーが発生します。

システムエンジニアを目指す方にとって、ファイルシステムの操作は基本的なスキルの一つです。rmdirメソッドは、不要になったディレクトリを安全に削除する際に役立ちますが、誤って重要なディレクトリを削除しないよう、常に指定するパスを慎重に確認し、エラー処理を組み込むことを強く推奨します。Node.jsには、より新しいfs.rm()メソッドも存在し、再帰的なディレクトリ削除などより高度な機能を提供しますが、空のディレクトリを削除する目的であればrmdirメソッドは依然として有効です。

Copy
1import { rmdir } from 'node:fs/promises';
2
3await rmdir('./path/to/empty-directory');

引数なし

引数はありません

戻り値なし

戻り値はありません