merge

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

Leerraum in den Klammern wird ignoriert, {{name}} und {{ name }} sind derselbe Platzhalter. Ein Schlüssel, den das Objekt nicht hat, bleibt stehen — die Lücke ist damit sichtbar statt still leer; onMissing: "empty" entfernt ihn stattdessen.

escape nimmt eine Funktion, die auf jeden eingesetzten Wert angewendet wird — übergeben Sie escapeHtml, wenn das Ergebnis in eine Seite geht.

Parameter

Parameter	Typ	Beschreibung
`template`	`string`	Die Vorlage mit `{{ key }}`-Platzhaltern.
`data`	`object`	Das Objekt, aus dem die Werte stammen.
`options` (optional) `= {}`	`MergeOptions`	`onMissing` ist `"keep"` oder `"empty"`; `escape` ist eine auf jeden Wert angewendete Funktion.

Rückgabewert

string — die Vorlage mit gefüllten Platzhaltern.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	die Vorlage ist keine Zeichenkette oder die Daten sind kein Objekt.

Beispiele

Eine Vorlage füllen

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

Siehe auch

Quellcode

src/lang/string/merge.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.