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

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

В JavaScript встроен особый объект Proxy — это «полномочие действовать от имени другого лица» в переводе с английского языка. С помощью 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?
  4. Геттеры и сеттеры в JS
  5. Что такое приватные поля с префиксом # в классах?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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