【Node.js24.x】Object::cp()メソッドの使い方
cpメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
cpメソッドは、特定のオブジェクトのコンテキストにおいて、外部プロセスを生成し実行するメソッドです。このメソッドは、Node.jsアプリケーションからオペレーティングシステム上のシェルコマンドや他の実行ファイルを起動する際に利用されます。例えば、ファイルのコピーや移動といったシステム操作、データ処理のための外部ツール呼び出し、あるいは他の言語で書かれたスクリプトの実行などが可能です。cpメソッドを使用することで、Node.jsプログラムはシステムのより深い部分と連携し、幅広いタスクを自動化できるようになります。
実行された外部プロセスの標準出力やエラー出力を取得したり、プロセスの終了コードを確認したりすることも可能です。これにより、外部プロセスの結果に基づいてNode.jsアプリケーションのロジックを分岐させたり、エラーハンドリングを行ったりすることができます。ただし、外部プロセスの実行はシステムのセキュリティリスクにつながる可能性があるため、信頼できないソースからの入力を直接コマンドとして使用することは避け、厳格な検証とサニタイズを行うことが極めて重要です。また、長時間実行されるプロセスや多くのリソースを消費するプロセスを扱う際には、非同期処理を適切に管理し、Node.jsアプリケーションの応答性を維持する設計が求められます。
構文(syntax)
1import { cp } from 'node:fs/promises'; 2 3await cp('source.txt', 'destination.txt');
引数(parameters)
src, dest, options, callback
- src: string: コピー元のファイルまたはディレクトリのパス
- dest: string: コピー先のファイルまたはディレクトリのパス
- options: object: コピー処理を制御するためのオプションオブジェクト (省略可能)
- callback: function: コピー処理完了後に実行されるコールバック関数 (省略可能)
戻り値(return)
戻り値なし
戻り値はありません