Node.jsで関数の引数を省略可能な任意のオプションにする

2025年2月18日

Node.jsで関数の引数を柔軟に設計したい場合、一部の引数を省略可能にする必要があることがあります。
この記事では、簡潔で実用的な方法を使って、引数をオプションにする仕組みを解説します。

引数をオプションにする方法

JavaScriptでは、関数の引数をオプションにする直接的な記法はありません。
そのため、以下の方法を使用します。

これらを組み合わせることで、柔軟で再利用性の高いコードを実現できます。

以下は、データベース接続オブジェクト（client）、リクエスト（req）、レスポンス（res）の引数を持つ関数で、一部またはすべてを省略可能にする実装例です。

// オプション引数を受け取るアクション関数

const someAction = async ({ client = null, req = null, res = null } = {}) => {

if (client) {

console.log('DB Client is available');

}

if (req) {

console.log('Request data:', req.body);

}

if (res) {

res.status(200).json({ message: 'Success' });

}

};

// ハンドラー関数

const handleRequest = async (req, res, action) => {

let client = null;

try {

// 必要ならクライアントを生成

client = req.database ? await req.database.connect() : null;

// アクション関数を呼び出し

await action({ client, req, res });

} catch (error) {

console.error('Error:', error);

res.status(500).json({ error: 'Internal Server Error' });

} finally {

if (client) client.release();

}

};

// 使用例

handleRequest(req, res, someAction);

オプション引数の処理
- someAction関数では、client, req, resをオプション引数として受け取り、それぞれのデフォルト値をnullに設定しています。
- 呼び出し側で必要な引数だけを渡せるため、柔軟な設計が可能です。
デフォルト値の活用
- 渡されなかった引数に対してデフォルト値を設定することで、エラーを防ぎます。
- 例: client = null は、データベース接続が不要な場合の処理を簡潔に記述できます。
リソース管理
- ハンドラー関数handleRequestでは、データベースクライアントを必要な場合にのみ生成し、最終的に解放しています。
柔軟な引数設計
- action関数に渡す引数をオブジェクトにまとめることで、コードの可読性が向上し、将来的な変更にも対応しやすくなります。