【JavaScript ECMAScript】Proxy::handler.constructインスタンスメソッドの使い方

handler.construct()メソッドは、JavaScriptのProxyオブジェクトにおいて、new演算子を使用してオブジェクトが生成されるプロセスをインターセプトし、カスタムの振る舞いを実行するメソッドです。これは、特定のコンストラクタ関数に対してnew演算子が適用される際に呼び出される「トラップ」の一種であり、新しいインスタンスが作成される際の動作を詳細に制御することを可能にします。

このメソッドが実行されると、開発者はオブジェクトの生成過程に独自のロジックを組み込むことができます。例えば、インスタンスが作成されるたびにログを記録したり、コンストラクタに渡された引数を検証したり、あるいは元のコンストラクタが通常生成するオブジェクトとは異なる特別なオブジェクトを返したりすることが可能です。

handler.construct()メソッドは、3つの引数を受け取ります。1つ目はtargetで、これはnew演算子が適用された実際のコンストラクタ関数です。2つ目はargumentsListで、コンストラクタに渡される引数群が配列として提供されます。3つ目はnewTargetで、これはnew演算子が最初に呼び出されたオリジナルのコンストラクタ関数を示します。このメソッドは、新しいオブジェクトを戻り値として返す必要があります。オブジェクト以外の値を返すと、TypeErrorが発生しますので注意が必要です。

このトラップは、オブジェクトの生成に関するデザインパターン（例えば、常に単一のインスタンスを保証するシングルトンパターンや、オブジェクトの生成を抽象化するファクトリーパターンなど）を実装する際に非常に有用です。また、既存のクラスや関数のコンストラクタ動作に影響を与えずに、機能を追加したり、監視したりしたい場合にも活用できます。標準のReflect.construct()と組み合わせることで、デフォルトのインスタンス生成動作を維持しつつ、追加の処理を容易に挟み込むことも可能です。

Copy
1class TargetClass {
2  constructor(param1, param2) {
3    this.param1 = param1;
4    this.param2 = param2;
5  }
6}
7
8const handler = {
9  construct(target, argumentsList, newTarget) {
10    // target: プロキシのターゲットオブジェクト (例: TargetClass)
11    // argumentsList: new演算子に渡された引数の配列 (例: [10, 20])
12    // newTarget: 元々new演算子で呼ばれたコンストラクタ (例: ProxyClass)
13
14    // ここでインスタンス生成をインターセプトし、カスタマイズできる
15    // 通常はReflect.constructを使用して元のコンストラクタを呼び出す
16    const instance = Reflect.construct(target, argumentsList, newTarget);
17    
18    // 生成されたインスタンスにプロキシによる変更を加えることも可能
19    instance.addedByProxy = true;
20    
21    return instance;
22  }
23};
24
25const ProxyClass = new Proxy(TargetClass, handler);
26
27// new演算子でProxyClassを呼び出すと、handler.constructが実行される
28const myInstance = new ProxyClass(10, 20);

target, argumentsList, newTarget

• target: ターゲットとなるコンストラクタ関数（クラス）。new 演算子によって呼び出される対象です。
• argumentsList: コンストラクタ関数に渡される引数のリスト。配列形式で渡されます。
• newTarget: new 演算子によって呼び出されたコンストラクタ。new.target に相当します。

Object

Proxyオブジェクトのconstruct()メソッドは、new演算子によるオブジェクトの生成を捕捉した際に呼び出され、生成される新しいオブジェクトを返します。