Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Прокси (Proxy) JS: Объектно-ориентированный дизайн

В JavaScript встроен особый объект Proxy, с помощью которого можно управлять доступом к свойствам практически любых объектов. И хотя в прикладном коде такая задача встречается не часто, в библиотеках и фреймворках Proxy используется регулярно. Вот лишь некоторые примеры его использования: перегрузка некоторых операторов, мокинг объектов, передача сообщений, отслеживание изменений (обычно при управлении состоянием приложения), валидация, логгирование, кеширование и многое другое.

Схема использования этого объекта выглядит так: создаётся объект, в конструктор которого передаётся два параметра (о них ниже), и дальше вся работа с исходным объектом идёт через созданный объект прокси.

const proxy = new Proxy(target, handler);

Первый параметр (target) - это объект, для которого нужно сделать прокси. Второй параметр (handler) – объект с обработчиками, которые перехватывают разные операции над исходным объектом (target).

Посмотрим на простой пример, в котором Proxy возвращает значение по умолчанию, если свойства не существует:

// Количество пользователей в разных странах
const usersCountByCountry = {};

const handlers = {
  get: (target, prop) => {
    // in проверяет наличие свойства по всей цепочке прототипов
    // В случае Proxy это правильнее чем _.has
    if (prop in target) {
      return target[prop];
    }

    return 0;
  },
};

// obj – обернул исходный объект
const obj = new Proxy(usersCountByCountry, handlers); 

obj.russia; // 0
obj.russia += 1; // 1
obj.usa; // 0

Proxy оборачивает исходный объект и перехватывает запросы к нему. Делается это с помощью обработчиков, называемых ловушками (trap). Ловушки описываются как методы объекта, который передается вторым параметром в конструктор Proxy.

Всего в Proxy 13 ловушек, среди которых самые часто используемые это "get" и "set". С помощью них перехватываются все операции чтения (get) и записи (set).

Ловушка get вызывается при каждом обращении к любому свойству объекта. На вход ей передается исходный объект и имя свойства, к которому идёт обращение. Внутри же, можно строить любую логику. В нашем примере мы возвращаем значение свойства из target, если оно существует, и 0 в случае его отсутствия.

get: (target, prop) => {
  if (prop in target) {
    return target[prop];
  }

  return 0;
},

Рассмотрим теперь пример с ловушкой set:

const student = {
  name: 'Roman',
  age: 23,
  program: 'js-frontend',
};

const rewrite = new Proxy(student, {
  set(target, prop, value) {
    // если свойство есть в объекте, proxy позволяет нам его переписать
    if (prop in target) {
      target[prop] = value;
      // при успешной записи, метод set() должен вернуть true
      return true;
    } else {
      // если свойства нет в объекте, то выбросится ошибка, либо можем вернуть false
      throw new Error(`Cannot rewrite non-existed property '${prop}'`);
    }
  },
});

Теперь, если присвоить значение несуществующему свойству в объекте, то будет ошибка:

// Если попытаться изменить несуществующее свойство, то выдаст ошибку:
rewrite.country = 'Russia';
// Error: Cannot rewrite non-existed property 'country'

// Если свойство уже есть, то ошибки не будет:
rewrite.name = 'Alexandr';

console.log(student);
// => { name: 'Alexandr', age: 23, program: 'js-frontend' }

Концептуально, Proxy это такая штука, которая "не отсвечивает". Прикладной код не должен знать, что он работает не с исходным объектом, а с Proxy. Только в этом случае будет обеспечиваться прозрачная работа с Proxy, то есть не придется затачивать код под него. Частично ответственность за это лежит на программисте, а частично на Proxy. Поэтому:

  • У Proxy нет своих свойств, он всегда проксирует вызовы
  • Из Proxy невозможно извлечь исходный объект и каким-то образом поменять его в обход ловушек
  • В соответствии со спецификацией, не существует способа определить, что объект это прокси (технически такая возможность есть, но в нормальной ситуации она не должна использоваться)

Дополнительные материалы

  1. Документация Proxy
  2. on-change
  3. Для чего нужен объект Proxy?

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.

Ошибки, сложный материал, вопросы >
Нашли опечатку или неточность?

Выделите текст, нажмите ctrl + enter и отправьте его нам. В течение нескольких дней мы исправим ошибку или улучшим формулировку.

Что-то не получается или материал кажется сложным?

Загляните в раздел «Обсуждение»:

  • задайте вопрос. Вы быстрее справитесь с трудностями и прокачаете навык постановки правильных вопросов, что пригодится и в учёбе, и в работе программистом;
  • расскажите о своих впечатлениях. Если курс слишком сложный, подробный отзыв поможет нам сделать его лучше;
  • изучите вопросы других учеников и ответы на них. Это база знаний, которой можно и нужно пользоваться.

Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
900
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно.

  • 130 курсов, 2000+ часов теории
  • 900 практических заданий в браузере
  • 360 000 студентов
Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы

С нуля до разработчика. Возвращаем деньги, если не удалось найти работу.

Иконка программы Фронтенд-разработчик
Профессия
Разработка фронтенд-компонентов веб-приложений
25 мая 10 месяцев
Иконка программы Node.js-разработчик
Профессия
Разработка бэкенд-компонентов веб-приложений
25 мая 10 месяцев
Иконка программы Fullstack-разработчик
Профессия
Новый
Разработка фронтенд и бэкенд компонентов веб-приложений
25 мая 16 месяцев

Используйте Хекслет по максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»