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

unlinkメソッドは、指定されたパスにあるファイルを削除する非同期操作を実行するメソッドです。 このメソッドは、Node.jsの標準モジュールであるfs（ファイルシステム）モジュールに属しており、プログラムからファイルシステムのファイルを削除するために広く利用されます。主に、アプリケーションで生成された一時ファイルをクリーンアップしたり、ユーザーが不要としたデータをファイルシステムから完全に削除したりする場面で不可欠な機能です。

unlinkメソッドを使用する際は、第一引数に削除したいファイルのパスを文字列で指定します。Node.jsの非同期処理の特性上、通常は第二引数に完了時の処理を記述するコールバック関数を渡します。このコールバック関数は、削除が成功した場合はnull、エラーが発生した場合はエラーオブジェクトを受け取ります。また、モダンなJavaScriptの書き方として、fs.promises.unlink()というPromiseベースのAPIも利用可能です。これはasync/await構文と組み合わせることで、より読みやすくエラーハンドリングしやすいコードを実現できます。

注意点として、unlinkはファイルのみを対象とし、ディレクトリの削除には使用できません。存在しないファイルを削除しようとした場合や、ファイルへのアクセス権限がない場合は、エラーが発生します。システムの安定稼働やセキュリティを考慮する上で、ファイルの削除処理における適切なエラーハンドリングは非常に重要です。システムエンジニアを目指す初心者の方にとって、ファイル管理の基本を理解し、安全なファイル操作を実装するために、このunlinkメソッドの役割と使い方を習得することは大変有益です。

Copy
1import { unlink } from 'node:fs/promises';
2
3(async () => {
4  try {
5    await unlink('path/to/delete/file.txt');
6  } catch (error) { }
7})();

path, callback

• path: string: 削除するファイルのパス
• callback: Function: 処理完了後に実行されるコールバック関数

戻り値なし

戻り値はありません