JavaScript Proxy: перехватить доступ к объекту
Proxy оборачивает объект и перехватывает операции: чтение, запись, проверку свойства, вызов функции. Ловушки handler позволяют добавить валидацию, значения по умолчанию, логирование или ленивую загрузку. Для стандартного поведения внутри ловушек используют Reflect, чтобы не потерять семантику объекта.
Проверить запись и изменить чтение
const user = {name: "Анна", age: 30};
const proxy = new Proxy(user, {
get(target, prop, receiver) {
if (prop === "age") {
return `${target[prop]} лет`;
}
return Reflect.get(target, prop, receiver);
},
set(target, prop, value) {
if (prop === "age" && (typeof value !== "number" || value < 0)) {
throw new TypeError("age должен быть неотрицательным числом");
}
return Reflect.set(target, prop, value);
},
});
console.log(proxy.name); // Анна
console.log(proxy.age); // 30 лет
proxy.age = 31;
console.log(user.age); // 31Ловушка get возвращает преобразованное значение только при чтении через proxy; исходный объект не меняется. set проверяет тип и возвращает результат Reflect.set, иначе в strict mode присваивание может завершиться ошибкой. Proxy и target — разные объекты, но изменения target видны через оба.
Перехватить in и delete
const hidden = new Proxy({secret: 1, visible: 2}, {
has(target, prop) {
return prop !== "secret" && Reflect.has(target, prop);
},
deleteProperty(target, prop) {
if (prop === "secret") {
throw new Error("secret удалять нельзя");
}
return Reflect.deleteProperty(target, prop);
},
});
console.log("secret" in hidden); // false
console.log("visible" in hidden); // truehas влияет на оператор in, deleteProperty — на delete. Proxy соблюдает инварианты JavaScript: например, нельзя скрыть неконфигурируемое свойство target. Нарушение инварианта даёт TypeError.
Proxy не является механизмом безопасности: target доступен напрямую, а код может обойти обёртку. Не используйте его для авторизации или сокрытия секретов. Для валидации схем лучше Pydantic/Zod, для реактивности — фреймворк, для логов — явные функции.
Производительность proxy ниже обычного объекта, особенно в горячих циклах. Применяйте точечно: обёртка API-клиента, dev-инструмент, мок. Proxy.revocable позволяет отозвать доступ, но не защищает target от прямых ссылок.
Документация: Proxy, Reflect.