【Node.js24.x】Object::lchmodSyncプロパティの使い方

lchmodSyncプロパティは、Node.jsのfsモジュールの一部として、指定されたファイルまたはシンボリックリンクのパーミッション（アクセス権限）を同期的に変更するための関数を保持するプロパティです。このプロパティにアクセスすることで、ファイルシステムのアクセス制御を変更する機能を利用できます。

この機能は、変更対象のファイルパスと新しいパーミッションモードを引数として受け取ります。パーミッションモードは、ファイルへの読み取り、書き込み、実行の各権限を数値（通常は八進数、例: 0o755）で指定するものです。lchmodSyncの大きな特徴は、もし指定されたパスがシンボリックリンクである場合、そのリンクが指し示す先のファイルではなく、シンボリックリンク自体のパーミッションを変更する点にあります。これは通常のfs.chmodSyncとは異なる挙動で、シンボリックリンクのメタデータ自体を操作したい場合に特に有用です。

処理は同期的に行われるため、パーミッション変更の操作が完了するまで、Node.jsアプリケーションの実行は一時的にブロックされます。これにより、処理の完了を待ってから次のコードを実行できるため、単純なスクリプトや起動時の設定などには便利です。しかし、多くのI/O処理を同時に行うサーバーアプリケーションなど、パフォーマンスが重視される場面では、非同期版のfs.lchmod関数を使用することが一般的に推奨されます。これにより、I/O待ち中に他の処理を進めることができ、アプリケーション全体の応答性を保つことができます。

Copy
1const fs = require('node:fs');
2fs.lchmodSync('path/to/symlink', 0o755);

引数なし

引数はありません

undefined

lchmodSyncは、指定されたパスのファイルまたはシンボリックリンクのパーミッションを変更する同期関数です。この関数は、操作が成功しても失敗しても、明示的な戻り値は提供しません。