CKTIS / JavaScript
Proxy – Eigenschaftszugriffe abfangen
Proxy erstellt ein Objekt, das Operationen an einem Zielobjekt vermittelt. Mit den Methoden handler.get und handler.set lassen sich Werte beim Lesen berechnen und Schreibvorgänge kontrollieren, wobei die Invarianten der Sprache eingehalten werden.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) erstellt ein separates vermittelndes Objekt; target wird nicht kopiert. Direkte Operationen auf target umgehen die Traps. Fehlt eine Trap, wird die entsprechende Operation an das Zielobjekt weitergeleitet.
Proxy handler.get, geschrieben als get(target, property, receiver), fängt Eigenschaftslesevorgänge ab und gibt den Wert zurück. property ist eine Zeichenkette oder ein Symbol. receiver ist der Empfänger der Operation, normalerweise der Proxy; wird er an Reflect.get(target, property, receiver) übergeben, bleibt das passende this in Gettern erhalten.
Proxy handler.set, geschrieben als set(target, property, value, receiver), fängt Schreibvorgänge ab. Das Ergebnis wird in einen booleschen Wert umgewandelt: true bedeutet Erfolg, false Ablehnung. Eine abgelehnte Zuweisung löst im Strict Mode einen TypeError aus. Die Rückgabe von true allein speichert den Wert nicht; Reflect.set(target, property, value, receiver) führt die Operation aus und gibt ihr Ergebnis zurück.
Traps müssen Invarianten einhalten: Bei einer eigenen, nicht konfigurierbaren und nicht beschreibbaren Dateneigenschaft darf get keinen anderen Wert zurückgeben, und set darf das Schreiben eines anderen Werts nicht als erfolgreich melden. Verstöße lösen einen TypeError aus. Im Beispiel wird double berechnet und die ungültige Zuweisung an score abgelehnt.
Beispiele
"use strict";
const target = { score: 0 };
const proxy = new Proxy(target, {
get(target, property, receiver) {
if (property === "double") return target.score * 2;
return Reflect.get(target, property, receiver);
},
set(target, property, value, receiver) {
if (property === "score" && !Number.isInteger(value)) return false;
return Reflect.set(target, property, value, receiver);
}
});
proxy.score = 7;
console.log(proxy.score);
console.log(proxy.double);
try {
proxy.score = 1.5;
} catch (error) {
console.log(error.name);
}
console.log(target.score);Ergebnis
7 14 TypeError 7
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.