Basis-Werkzeuge

Funktionen ohne Bindung an ein Framework: Typ- und Wertprüfung (isX/nonX/requireX), Arbeit mit Zeichenketten, Arrays und Objekten, JSON und HTML. Die Google-Apps-Script-Laufzeit brauchen sie nicht.

Die Markierung New kennzeichnet eine im jüngsten Release hinzugekommene Funktion, Deprecated eine, die in einem künftigen Release entfernt werden soll.

Funktion	Rückgabetyp	Kurzbeschreibung
`chunk`	`Array`	Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente.
`compact` New	`Array`	Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast.
`decodeHtml`	`String`	Verwandelt numerische Zeichenreferenzen zurück in Zeichen.
`diff` New	`Number`	Gibt den Abstand zweier Daten in einer gewählten Einheit zurück.
`encodeHtml`	`String`	Kodiert jedes Zeichen als numerische Zeichenreferenz.
`equals` New	`Boolean`	Vergleicht zwei Werte tief und null-sicher.
`escapeHtml`	`String`	Ersetzt die fünf Zeichen, die sonst als Markup gelesen würden.
`escapeRegExp`	`String`	Maskiert die Zeichen, die in einem regulären Ausdruck eine Bedeutung tragen.
`escapeXml`	`String`	Maskiert die von XML reservierten Zeichen.
`first` New	`Any`	Nimmt das erste Element eines Arrays oder dessen erste n Elemente, ohne eigene Leerprüfung.
`flat` New	`Object`	Flacht ein verschachteltes Objekt auf eine Ebene mit Punktschlüsseln ab.
`getDaysInMonth` New	`Number`	Gibt zurück, wie viele Tage der Monat eines Datums hat.
`getDaysLeftInMonth` New	`Number`	Gibt zurück, wie viele Tage von einem Datum bis zum Monatsende bleiben.
`getPath` New	`Any`	Liest eine verschachtelte Eigenschaft über einen Pfad, mit Rückfallwert.
`hashCode`	`Number`	Erzeugt einen numerischen Hash für einen beliebigen Wert.
`intersect` New	`Array`	Findet die Werte, die in jedem der übergebenen Arrays vorkommen.
`is2DArray`	`Boolean`	Prüft, ob ein Wert ein nicht-leeres Array ist, dessen Elemente alle Arrays sind.
`isArray`	`Boolean`	Prüft, ob ein Wert ein Array ist.
`isBoolean`	`Boolean`	Prüft, ob ein Wert ein boolescher Wert ist.
`isConsistent2DArray`	`Boolean`	Prüft, ob ein Wert eine nicht-leere Matrix ist, deren Zeilen alle gleich lang sind.
`isCountable`	`Boolean`	Prüft, ob ein Wert eine zählbare Zahl ist.
`isDouble` New	`Boolean`	Prüft, ob ein Wert eine Zahl mit Nachkommateil ist.
`isEmail`	`Boolean`	Prüft, ob ein Wert eine E-Mail-Adresse ist.
`isEmpty`	`Boolean`	Prüft, ob ein Wert leer ist.
`isException`	`Boolean`	Prüft, ob ein Wert eine `Exception` ist.
`isFloat` New	`Boolean`	Prüft, ob ein Wert eine Zahl mit Nachkommateil ist.
`isFunction`	`Boolean`	Prüft, ob ein Wert eine Funktion ist.
`isFunctionLike`	`Boolean`	Prüft, ob ein Wert aufrufbar ist.
`isInteger`	`Boolean`	Prüft, ob ein Wert eine ganze Zahl ist.
`isLength`	`Boolean`	Prüft, ob ein Wert eine gültige Array-Länge ist.
`isNaN` New	`Boolean`	Prüft, ob ein Wert die Zahl `NaN` ist.
`isNil`	`Boolean`	Prüft, ob ein Wert `null` oder `undefined` ist.
`isNonNegative` New	`Boolean`	Prüft, ob ein Wert eine nicht negative Zahl ist.
`isNull`	`Boolean`	Prüft, ob ein Wert `null` ist.
`isNumber`	`Boolean`	Prüft, ob ein Wert eine Zahl ist.
`isNumberLike`	`Boolean`	Prüft, ob ein Wert in eine Zahl umwandelbar ist.
`isObject`	`Boolean`	Prüft, ob ein Wert ein Objekt ist.
`isObjectLike`	`Boolean`	Prüft, ob ein Wert objektartig ist.
`isRegExp`	`Boolean`	Prüft, ob ein Wert ein regulärer Ausdruck ist.
`isSafeInteger` New	`Boolean`	Prüft, ob ein Wert eine sichere ganze Zahl ist.
`isScalar`	`Boolean`	Prüft, ob ein Wert ein Skalar ist.
`isString`	`Boolean`	Prüft, ob ein Wert eine Zeichenkette ist.
`isSymbol`	`Boolean`	Prüft, ob ein Wert ein Symbol ist.
`last` New	`Any`	Nimmt das letzte Element eines Arrays oder dessen letzte n Elemente in ursprünglicher Reihenfolge.
`merge` New	`String`	Füllt die `{{ key }}`-Platzhalter einer Vorlage aus einem Objekt.
`nonDouble` New	`Boolean`	Prüft, ob ein Wert nicht eine Zahl mit Nachkommateil ist.
`nonEmptyString` Deprecated	`String`	Gibt den Wert als nicht leere Zeichenkette zurück und nennt im Fehlerfall das Argument.
`isUndefined`	`Boolean`	Prüft, ob ein Wert `undefined` ist.
`isUrl`	`Boolean`	Prüft, ob ein Wert eine URL ist.
`isValidLocale`	`Boolean`	Prüft, ob ein Wert ein Gebietsschema-Code ist.
`isValidSlug`	`Boolean`	Prüft, ob ein Wert ein Slug ist.
`isValidVersion`	`Boolean`	Prüft, ob ein Wert eine Versionsangabe ist.
`isVersionCompatible`	`Boolean`	Prüft, ob eine Version mindestens der geforderten entspricht.
`non2DArray` New	`Boolean`	Prüft, ob ein Wert kein nicht-leeres zweidimensionales Array ist.
`nonArray`	`Boolean`	Prüft, ob ein Wert nicht ein Array ist.
`nonBoolean`	`Boolean`	Prüft, ob ein Wert nicht ein boolescher Wert ist.
`nonConsistent2DArray` New	`Boolean`	Prüft, ob ein Wert keine Matrix mit gleich langen Zeilen ist.
`nonEmpty`	`Boolean`	Prüft, ob ein Wert nicht leer ist.
`nonException` New	`Boolean`	Prüft, ob ein Wert nicht eine `Exception` ist.
`nonFloat` New	`Boolean`	Prüft, ob ein Wert nicht eine Zahl mit Nachkommateil ist.
`nonFunction` New	`Boolean`	Prüft, ob ein Wert nicht eine Funktion ist.
`nonCountable` New	`Boolean`	Prüft, ob ein Wert nicht eine zählbare Zahl ist.
`nonFunctionLike` New	`Boolean`	Prüft, ob ein Wert nicht aufrufbar ist.
`nonInteger` New	`Boolean`	Prüft, ob ein Wert nicht eine ganze Zahl ist.
`nonLength` New	`Boolean`	Prüft, ob ein Wert nicht eine gültige Array-Länge ist.
`nonNaN` New	`Boolean`	Prüft, ob ein Wert nicht die Zahl `NaN` ist.
`nonNil`	`Boolean`	Prüft, ob ein Wert nicht `null` oder `undefined` ist.
`nonNull`	`Boolean`	Prüft, ob ein Wert nicht `null` ist.
`nonNegative` Deprecated	`Boolean`	Prüft, ob ein Wert eine nicht negative Zahl ist.
`nonNumber`	`Boolean`	Prüft, ob ein Wert nicht eine Zahl ist.
`nonNumberLike` New	`Boolean`	Prüft, ob ein Wert nicht in eine Zahl umwandelbar ist.
`nonObject` New	`Boolean`	Prüft, ob ein Wert nicht ein Objekt ist.
`nonObjectLike` New	`Boolean`	Prüft, ob ein Wert nicht objektartig ist.
`nonRegExp` New	`Boolean`	Prüft, ob ein Wert nicht ein regulärer Ausdruck ist.
`nonSafeInteger` New	`Boolean`	Prüft, ob ein Wert nicht eine sichere ganze Zahl ist.
`nonScalar`	`Boolean`	Prüft, ob ein Wert nicht ein Skalar ist.
`nonString`	`Boolean`	Prüft, ob ein Wert nicht eine Zeichenkette ist.
`nonSymbol`	`Boolean`	Prüft, ob ein Wert nicht ein Symbol ist.
`nonUndefined`	`Boolean`	Prüft, ob ein Wert nicht `undefined` ist.
`nonUrl` New	`Boolean`	Prüft, ob ein Wert nicht eine URL ist.
`nonValidEmail` New	`Boolean`	Prüft, ob ein Wert nicht eine E-Mail-Adresse ist.
`nonValidLocale` New	`Boolean`	Prüft, ob ein Wert nicht ein Gebietsschema-Code ist.
`nonValidSlug` New	`Boolean`	Prüft, ob ein Wert nicht ein Slug ist.
`nonValidVersion` New	`Boolean`	Prüft, ob ein Wert nicht eine Versionsangabe ist.
`nonVersionCompatible` New	`Boolean`	Prüft, ob eine Version hinter der geforderten zurückbleibt.
`now`	`Number`	Gibt die aktuelle Zeit in Millisekunden seit der Epoche zurück.
`ObjectTag`	`Enum`	Die internen Tags, die ein Wert melden kann, als benannte Konstanten.
`objectToString`	`String`	Gibt den internen Tag eines Werts zurück.
`offset` New	`Date`	Verschiebt ein Datum um eine Anzahl einer Einheit.
`parseJson` Deprecated	`Object`	Liest JSON und versucht es bei striktem Fehlschlag mit einem toleranten Leser erneut.
`require2DArray` New	`Array`	Gibt den Wert als nicht-leeres zweidimensionales Array zurück oder wirft.
`requireArray` New	`Array`	Gibt den Wert als ein Array zurück oder wirft.
`requireBoolean` New	`Boolean`	Gibt den Wert als einen booleschen Wert zurück oder wirft.
`requireConsistent2DArray` New	`Array`	Gibt den Wert als Matrix mit gleich langen Zeilen zurück oder wirft und benennt die Zeile.
`requireCountable` New	`Number`	Gibt den Wert als eine zählbare Zahl zurück oder wirft.
`requireDouble` New	`Number`	Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft.
`requireEmpty` New	`Any`	Gibt den Wert als einen leeren Wert zurück oder wirft.
`requireException` New	`Exception`	Gibt den Wert als eine `Exception` zurück oder wirft.
`requireFloat` New	`Number`	Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft.
`requireFunction` New	`Function`	Gibt den Wert als eine Funktion zurück oder wirft.
`requireFunctionLike` New	`Function`	Gibt den Wert als einen aufrufbaren Wert zurück oder wirft.
`requireInteger` New	`Number`	Gibt den Wert als eine ganze Zahl zurück oder wirft.
`requireLength` New	`Number`	Gibt den Wert als eine gültige Array-Länge zurück oder wirft.
`requireNaN` New	`Number`	Gibt den Wert als `NaN` zurück oder wirft.
`requireNil` New	`Null \| Undefined`	Gibt den Wert als `null` oder `undefined` zurück oder wirft.
`requireNonArray` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Array ist.
`requireNonBoolean` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein boolescher Wert ist.
`requireNonDouble` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist.
`requireNonEmpty` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht leer ist.
`requireNonFloat` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist.
`requireNonInteger` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine ganze Zahl ist.
`requireNonNaN` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht die Zahl `NaN` ist.
`requireNonSafeInteger` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine sichere ganze Zahl ist.
`requireSafeInteger` New	`Number`	Gibt den Wert als eine sichere ganze Zahl zurück oder wirft.
`requireSymbol` New	`Symbol`	Gibt den Wert als ein Symbol zurück oder wirft.
`requireNonEmptyString`	`String`	Gibt den Wert als Zeichenkette mit Inhalt zurück oder wirft.
`requireNonException` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine `Exception` ist.
`requireNonFunction` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Funktion ist.
`requireNonFunctionLike` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht aufrufbar ist.
`requireNoNilElements` New	`Array`	Gibt die Sammlung unverändert zurück, nachdem geprüft wurde, dass kein Element `null` oder `undefined` ist.
`requireNonLength` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine gültige Array-Länge ist.
`requireNonNil` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist.
`requireNonNull`	`any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist.
`requireNonNumber` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl ist.
`requireNonNumberLike` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht in eine Zahl umwandelbar ist.
`requireNonObject` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Objekt ist.
`requireNonObjectLike` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht objektartig ist.
`requireNonRegExp` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein regulärer Ausdruck ist.
`requireNonScalar` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Skalar ist.
`requireNonString` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zeichenkette ist.
`requireNonSymbol` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Symbol ist.
`requireNonUndefined` New	`Any`	Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `undefined` ist.
`requireNull` New	`Null`	Gibt den Wert als `null` zurück oder wirft.
`requireNumber` New	`Number`	Gibt den Wert als eine Zahl zurück oder wirft.
`requireNumberLike` New	`Number \| String`	Gibt den Wert als einen numerischen Wert zurück oder wirft.
`requireObject` New	`Object`	Gibt den Wert als ein Objekt zurück oder wirft.
`requireObjectLike` New	`Object`	Gibt den Wert als einen objektartigen Wert zurück oder wirft.
`requireRegExp` New	`RegExp`	Gibt den Wert als einen regulären Ausdruck zurück oder wirft.
`requireScalar` New	`Scalar`	Gibt den Wert als einen Skalar zurück oder wirft.
`requireState` New	`void`	Behauptet, dass eine Bedingung gilt, und wirft, wenn nicht.
`requireString`	`String`	Gibt den Wert als eine Zeichenkette zurück oder wirft.
`requireUndefined` New	`Undefined`	Gibt den Wert als `undefined` zurück oder wirft.
`requireUrl` New	`String`	Gibt den Wert als eine URL zurück oder wirft.
`requireValidEmail`	`String`	Gibt den Wert als eine E-Mail-Adresse zurück oder wirft.
`requireValidLocale` New	`String`	Gibt den Wert als einen Gebietsschema-Code zurück oder wirft.
`requireValidSlug` New	`String`	Gibt den Wert als einen Slug zurück oder wirft.
`requireValidVersion` New	`String`	Gibt den Wert als eine Versionsangabe zurück oder wirft.
`requireVersionCompatible` New	`String`	Gibt die Version zurück, sobald sie die Anforderung erfüllt, sonst wirft sie.
`retry` New	`T`	Ruft eine Funktion nach einem Fehler erneut auf, mit wachsender Wartezeit.
`setPath` New	`Object`	Schreibt eine verschachtelte Eigenschaft über einen Pfad und legt Fehlendes an.
`StopWatch` New	`StopWatch`	Misst die Zeit einer Folge benannter Aufgaben.
`stringifyJson`	`String`	Serialisiert einen Wert nach JSON mit fester Schlüsselreihenfolge.
`toCamelCase`	`String`	Fügt die Wörter einer Zeichenkette zu camelCase zusammen.
`toInteger`	`Number \\| null`	Liest eine Zahl aus einem Wert oder meldet, dass keine da ist.
`toKebabCase`	`String`	Schreibt eine Zeichenkette in kebab-case.
`toLowerCase`	`String`	Schreibt eine Zeichenkette klein und räumt auf Wunsch den Leerraum auf.
`toProperCase`	`String`	Schreibt den ersten Buchstaben jedes Wortes groß und den Rest klein.
`toSnakeCase`	`String`	Schreibt eine Zeichenkette in snake_case.
`toUpperCase`	`String`	Schreibt eine Zeichenkette groß und räumt auf Wunsch den Leerraum auf.
`transpose`	`Array`	Vertauscht Zeilen und Spalten einer Matrix.
`unique` New	`Array`	Entfernt Dubletten aus einem Array und behält das erste Vorkommen jedes Werts.
`versionCompare`	`Number`	Vergleicht zwei Versionsangaben numerisch.
`without` New	`Array`	Entfernt jedes Vorkommen der genannten Werte aus einem Array.

23 September 2026

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