JavaScript Proxy: перехватить доступ к объекту

Категория: JavaScript · Язык: JavaScript · Обновлено:

Proxy оборачивает объект и перехватывает операции: чтение, запись, проверку свойства, вызов функции. Ловушки handler позволяют добавить валидацию, значения по умолчанию, логирование или ленивую загрузку. Для стандартного поведения внутри ловушек используют Reflect, чтобы не потерять семантику объекта.

Проверить запись и изменить чтение

JavaScript
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

JavaScript
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); // true

has влияет на оператор in, deleteProperty — на delete. Proxy соблюдает инварианты JavaScript: например, нельзя скрыть неконфигурируемое свойство target. Нарушение инварианта даёт TypeError.

Proxy не является механизмом безопасности: target доступен напрямую, а код может обойти обёртку. Не используйте его для авторизации или сокрытия секретов. Для валидации схем лучше Pydantic/Zod, для реактивности — фреймворк, для логов — явные функции.

Производительность proxy ниже обычного объекта, особенно в горячих циклах. Применяйте точечно: обёртка API-клиента, dev-инструмент, мок. Proxy.revocable позволяет отозвать доступ, но не защищает target от прямых ссылок.

Документация: Proxy, Reflect.