JavaScriptのプロキシを利用してオブジェクトの動作をカスタマイズ
- 作成日 2025.02.06
- javascript
- javascript

JavaScriptのプロキシ(Proxy)は、オブジェクトの動作を動的にカスタマイズするための強力なツールです。プロキシを使用すると、オブジェクトのプロパティへのアクセスやメソッドの呼び出し、さらにはその動作全体を制御できます。本記事では、プロキシを活用してオブジェクトの挙動を変更する方法について詳しく解説します。
プロキシとは?
プロキシは、JavaScriptでオブジェクトの操作をインターセプトし、カスタマイズするためのオブジェクトです。`Proxy`コンストラクタを使ってプロキシを作成し、ターゲットオブジェクトに対する操作をカスタマイズするためのハンドラ関数を指定します。
プロキシの基本構文
プロキシを作成する基本的な構文は以下の通りです。
const target = {};
const handler = {
get: function(target, prop, receiver) {
return prop in target ? target[prop] : 37; // プロパティが存在しない場合は37を返す
}
};
const proxy = new Proxy(target, handler);
console.log(proxy.someProperty); // 37と表示される
プロパティの取得(get)
プロキシを使用すると、オブジェクトのプロパティにアクセスする際の動作をカスタマイズできます。特に、`get`トラップを使用することで、プロパティの取得方法を変更できます。
const person = {
name: 'John',
age: 30
};
const handler = {
get: function(target, prop) {
if (prop === 'name') {
return `Hello, ${target[prop]}!`; // 'name'プロパティのアクセスをカスタマイズ
}
return prop in target ? target[prop] : 'Property not found';
}
};
const proxy = new Proxy(person, handler);
console.log(proxy.name); // Hello, John! と表示される
console.log(proxy.age); // 30 と表示される
console.log(proxy.gender); // Property not found と表示される
プロパティの設定(set)
プロパティの設定時にもプロキシを活用できます。`set`トラップを使用すると、プロパティに値を設定する際の処理を変更できます。
const user = {
name: 'Alice'
};
const handler = {
set: function(target, prop, value) {
if (prop === 'name' && value.length < 3) {
console.log('Name must be at least 3 characters long');
return false;
}
target[prop] = value;
return true;
}
};
const proxy = new Proxy(user, handler);
proxy.name = 'Jo'; // Name must be at least 3 characters long と表示される
proxy.name = 'John'; // 設定は正常に行われる
console.log(proxy.name); // John と表示される
メソッド呼び出しのカスタマイズ(apply)
プロキシでは、関数の呼び出しをカスタマイズすることも可能です。`apply`トラップを使用することで、メソッドの呼び出し時に追加の処理を挟むことができます。
const handler = {
apply: function(target, thisArg, argumentsList) {
console.log('Function called with arguments:', argumentsList);
return target.apply(thisArg, argumentsList);
}
};
const sum = function(a, b) {
return a + b;
};
const proxy = new Proxy(sum, handler);
console.log(proxy(1, 2)); // Function called with arguments: [1, 2] と表示され、3が返される
プロパティの削除(deleteProperty)
プロパティの削除操作をカスタマイズすることもできます。`deleteProperty`トラップを使うと、オブジェクトからプロパティを削除する際に特別な処理を行えます。
const person = {
name: 'Bob',
age: 25
};
const handler = {
deleteProperty: function(target, prop) {
if (prop === 'age') {
console.log('Age cannot be deleted');
return false;
}
delete target[prop];
return true;
}
};
const proxy = new Proxy(person, handler);
delete proxy.age; // Age cannot be deleted と表示される
delete proxy.name; // nameプロパティは正常に削除される
console.log(person); // { age: 25 }
反応的なデータモデルの作成
プロキシは、反応的なデータモデルを作成するためにも活用できます。オブジェクトのプロパティ変更を監視し、変化があった際に処理を行うことができます。
const data = {
message: 'Hello, world!'
};
const handler = {
set: function(target, prop, value) {
console.log(`Property ${prop} is being set to ${value}`);
target[prop] = value;
return true;
}
};
const proxy = new Proxy(data, handler);
proxy.message = 'Hello, Proxy!'; // Property message is being set to Hello, Proxy! と表示される
console.log(proxy.message); // Hello, Proxy! と表示される
プロキシを利用したデータバリデーション
データバリデーションの目的でプロキシを活用することもできます。`set`トラップを使って、設定される値が条件を満たしているかをチェックできます。
const person = {};
const handler = {
set: function(target, prop, value) {
if (prop === 'age' && (value < 0 || value > 120)) {
console.log('Invalid age');
return false;
}
target[prop] = value;
return true;
}
};
const proxy = new Proxy(person, handler);
proxy.age = 130; // Invalid age と表示される
proxy.age = 30; // 正常に設定される
console.log(person.age); // 30 と表示される
ネストされたオブジェクトのプロキシ
プロキシはネストされたオブジェクトにも適用可能です。入れ子になったオブジェクトの各レベルで個別にプロキシを使うことができます。
const nestedObject = {
level1: {
level2: {
message: 'Hello'
}
}
};
const handler = {
get: function(target, prop) {
if (prop === 'message') {
return 'Custom Message';
}
return prop in target ? target[prop] : 'Property not found';
}
};
const proxy = new Proxy(nestedObject, handler);
console.log(proxy.level1.level2.message); // Custom Message と表示される
プロキシの応用例
プロキシは、ログの記録、データのキャッシュ、トラッキング、さらにはデータストアの抽象化など、さまざまな場面で活用できます。例えば、プロパティアクセスを監視して、リアルタイムで変更履歴を取得することも可能です。
まとめ
プロキシを活用することで、JavaScriptのオブジェクトに対する操作を非常に柔軟にカスタマイズできます。`get`、`set`、`deleteProperty`、`apply`などのトラップを使いこなすことで、オブジェクトの振る舞いを制御し、より洗練されたコードを実現することが可能です。
-
前の記事
TypeScriptのReadonly型でデータの不変性を確保しよう 2025.02.06
-
次の記事
i18nextでReactアプリを多言語対応する方法 2025.02.06
コメントを書く