merge

function merge(template: string, data: object, options: MergeOptions = {}): string;

Пробелы внутри скобок игнорируются, поэтому {{name}} и {{ name }} — один и тот же плейсхолдер. Ключ, которого нет в объекте, остаётся как есть: пропуск виден, а не превращается в молчаливую пустоту; onMissing: "empty" убирает его.

escape принимает функцию, применяемую к каждому подставляемому значению, — передайте escapeHtml, если результат попадёт на страницу.

Параметры

Параметр	Тип	Описание
`template`	`string`	Строка шаблона с плейсхолдерами `{{ key }}`.
`data`	`object`	Объект, из которого берутся значения.
`options` (необязательный) `= {}`	`MergeOptions`	`onMissing` — `"keep"` или `"empty"`; `escape` — функция, применяемая к каждому значению.

Возвращает

string — шаблон с заполненными плейсхолдерами.

Исключения

Исключение	Условие
`IllegalArgumentException`	шаблон не строка или данные не объект.

Примеры

Заполнение шаблона

merge("Hi {{ name }}!", { name: "Ada" }); // => "Hi Ada!"
merge("Hi {{ name }}!", {}); // => "Hi {{ name }}!"
merge("Hi {{ name }}!", {}, { onMissing: "empty" }); // => "Hi !"

Смотрите также

Исходный код

src/lang/string/merge.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.