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

fdatasyncSyncメソッドは、Node.jsのファイルシステム（fs）モジュールに属し、指定されたファイルディスクリプタに対応するファイルのデータ変更を、ストレージデバイスに同期的に書き込むことを保証するメソッドです。このメソッドは、プログラムがメモリ上で変更したファイルの内容が、システムクラッシュや電源障害が発生した場合でも失われることなく、永続的に物理ディスクに保存されるようにするために使用されます。

具体的には、オペレーティングシステムのファイルバッファにあるファイルデータが、実際にストレージデバイスへと書き込まれます。fsyncSyncメソッドがファイルの内容とメタデータ（ファイルサイズや更新時刻など）の両方を同期するのに対し、fdatasyncSyncメソッドはファイルデータのみの同期を保証します。このため、メタデータの同期が不要な場合にfsyncSyncよりも処理のオーバーヘッドが少なくなる可能性があります。

本メソッドは同期処理であるため、ファイルデータの書き込みが完了するまでプログラムの実行をブロックします。これにより、データの一貫性は保証されますが、処理に時間がかかる場合はアプリケーション全体の応答性に影響を与える可能性があります。引数には、同期操作を行うファイルのファイルディスクリプタを渡します。同期処理中にエラーが発生した場合は、例外がスローされますので、適切なエラーハンドリングが必要です。データベースやログファイルなど、データの整合性が特に重要となる場面で活用されます。

Copy
1const fs = require('fs');
2const fileDescriptor = fs.openSync('example.txt', 'w');
3fs.fdatasyncSync(fileDescriptor);

fd

• fd: number: 同期処理を実行するファイルディスクリプタ（ファイルへの参照）を指定する数値

戻り値なし

戻り値はありません