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) на основі вихідного коду бібліотеки.