---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/event.Mapper.md
  - https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/event.Mapper.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt

# event.Mapper

Расширяет [IEventTrigger](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md).

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

[Конструктор](#constructor-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
event.Mapper(targetEventManager, mappingTable)
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`targetEventManager`](#param-targetEventManager)[*](*star) | — | Тип: [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md)

Менеджер событий, на который маппер распространяет инициируемые на нем события. ||
|| [`mappingTable`](#param-mappingTable)[*](*star) | — | Тип: Object

Таблица правил маппинга. Представляет собой хэш, ключами которого являются типы событий, а значениями - соответствующие функции маппинга, либо Boolean значения. Функция маппинга для конкретного типа событий получает на вход экземпляр события, инициированного на маппере, а возвращать должна экземпляр события для распространения далее по иерархии, либо null, если распространение необходимо запретить. Boolean значения трактуются следующим образом:
- true - события данного типа распространяются по иерархии в неизменном виде;
- false - события данного типа по иерархии не распространяются.
Дополнительно в таблице доступен ключ "*" для правила обработки по умолчанию. ||
|#

\* Обязательный параметр/опция.

**Пример:**

```javascript
// Создаем и устанавливаем маппер событий, который преобразует событие "click" корневой
// коллекции геообъектов в событие "geoobjectclick" самой карты.
var mapper = new ymaps.event.Mapper(myMap.events, {
    "*": false,
    "click": function (event) {
        return new ymaps.Event({
             type: "geoobjectclick",
             target: map,
             originalTarget: event.get("target")
        }, event);
    }
});

myMap.geoObjects.events.setParent(mapper);
```

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [fire](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md#fire)([type](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md#fire-param-type)[, [eventObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md#fire-param-eventObject)]) | [IEventTrigger](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md) | Инициирует событие.

Унаследован от [IEventTrigger](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventTrigger.md#fire). ||
|#

<!-- XLIFF_FARM_YmVkZmIw_CACHING -->

[*star]: Обязательный параметр.