Utilitaires de base

Des fonctions qui ne dépendent d'aucun framework : vérification des types et des valeurs (isX/nonX/requireX), manipulation de chaînes, de tableaux et d'objets, JSON et HTML. L'environnement Google Apps Script ne leur est pas nécessaire.

La mention New signale une fonction ajoutée dans la dernière version ; Deprecated une fonction dont le retrait est prévu dans une version future.

Fonction	Type de retour	Description brève
`chunk`	`Array`	Découpe un tableau en groupes consécutifs de taille fixe, en validant les deux arguments.
`compact` New	`Array`	Retire toutes les valeurs falsy d'un tableau et affine le type des éléments sans cast.
`decodeHtml`	`String`	Retransforme les références numériques en caractères.
`diff` New	`Number`	Renvoie l'intervalle entre deux dates dans l'unité choisie.
`encodeHtml`	`String`	Encode chaque caractère en référence numérique.
`equals` New	`Boolean`	Compare deux valeurs en profondeur et sans risque avec null.
`escapeHtml`	`String`	Remplace les cinq caractères qui seraient autrement lus comme du balisage.
`escapeRegExp`	`String`	Échappe les caractères qui ont un sens dans une expression régulière.
`escapeXml`	`String`	Échappe les caractères réservés par XML.
`first` New	`Any`	Prend le premier élément d'un tableau, ou ses n premiers éléments, sans test de vacuité.
`flat` New	`Object`	Aplatit un objet imbriqué en un seul niveau de clés pointées.
`getDaysInMonth` New	`Number`	Renvoie le nombre de jours du mois d'une date.
`getDaysLeftInMonth` New	`Number`	Renvoie combien de jours séparent une date de la fin de son mois.
`getPath` New	`Any`	Lit une propriété imbriquée par chemin, avec valeur de repli.
`hashCode`	`Number`	Produit un condensé numérique pour n'importe quelle valeur.
`intersect` New	`Array`	Trouve les valeurs présentes dans chacun des tableaux fournis.
`is2DArray`	`Boolean`	Vérifie qu'une valeur est un tableau non vide dont chaque élément est lui-même un tableau.
`isArray`	`Boolean`	Vérifie si une valeur est un tableau.
`isBoolean`	`Boolean`	Vérifie si une valeur est un booléen.
`isConsistent2DArray`	`Boolean`	Vérifie qu'une valeur est une matrice non vide dont toutes les lignes ont la même longueur.
`isCountable`	`Boolean`	Vérifie si une valeur est un nombre dénombrable.
`isDouble` New	`Boolean`	Vérifie si une valeur est un nombre avec une partie fractionnaire.
`isEmail`	`Boolean`	Vérifie si une valeur est une adresse e-mail.
`isEmpty`	`Boolean`	Vérifie si une valeur est vide.
`isException`	`Boolean`	Vérifie si une valeur est une `Exception`.
`isFloat` New	`Boolean`	Vérifie si une valeur est un nombre avec une partie fractionnaire.
`isFunction`	`Boolean`	Vérifie si une valeur est une fonction.
`isFunctionLike`	`Boolean`	Vérifie si une valeur est appelable.
`isInteger`	`Boolean`	Vérifie si une valeur est un entier.
`isLength`	`Boolean`	Vérifie si une valeur est une longueur de tableau valide.
`isNaN` New	`Boolean`	Vérifie si une valeur est le nombre `NaN`.
`isNil`	`Boolean`	Vérifie si une valeur est `null` ou `undefined`.
`isNonNegative` New	`Boolean`	Vérifie si une valeur est un nombre non négatif.
`isNull`	`Boolean`	Vérifie si une valeur est `null`.
`isNumber`	`Boolean`	Vérifie si une valeur est un nombre.
`isNumberLike`	`Boolean`	Vérifie si une valeur est convertible en nombre.
`isObject`	`Boolean`	Vérifie si une valeur est un objet.
`isObjectLike`	`Boolean`	Vérifie si une valeur est de type objet.
`isRegExp`	`Boolean`	Vérifie si une valeur est une expression régulière.
`isSafeInteger` New	`Boolean`	Vérifie si une valeur est un entier sûr.
`isScalar`	`Boolean`	Vérifie si une valeur est un scalaire.
`isString`	`Boolean`	Vérifie si une valeur est une chaîne de caractères.
`isSymbol`	`Boolean`	Vérifie si une valeur est un symbole.
`last` New	`Any`	Prend le dernier élément d'un tableau, ou ses n derniers éléments dans leur ordre d'origine.
`merge` New	`String`	Remplit les emplacements `{{ key }}` d'un gabarit depuis un objet.
`nonDouble` New	`Boolean`	Vérifie qu'une valeur n'est pas un nombre avec une partie fractionnaire.
`nonEmptyString` Deprecated	`String`	Renvoie la valeur comme chaîne non vide, en nommant l'argument en cas d'échec.
`isUndefined`	`Boolean`	Vérifie si une valeur est `undefined`.
`isUrl`	`Boolean`	Vérifie si une valeur est une URL.
`isValidLocale`	`Boolean`	Vérifie si une valeur est un code de locale.
`isValidSlug`	`Boolean`	Vérifie si une valeur est un slug.
`isValidVersion`	`Boolean`	Vérifie si une valeur est une chaîne de version.
`isVersionCompatible`	`Boolean`	Vérifie qu'une version atteint au moins celle requise.
`non2DArray` New	`Boolean`	Vérifie qu'une valeur n'est pas un tableau bidimensionnel non vide.
`nonArray`	`Boolean`	Vérifie qu'une valeur n'est pas un tableau.
`nonBoolean`	`Boolean`	Vérifie qu'une valeur n'est pas un booléen.
`nonConsistent2DArray` New	`Boolean`	Vérifie qu'une valeur n'est pas une matrice dont les lignes ont toutes la même longueur.
`nonEmpty`	`Boolean`	Vérifie qu'une valeur n'est pas vide.
`nonException` New	`Boolean`	Vérifie qu'une valeur n'est pas une `Exception`.
`nonFloat` New	`Boolean`	Vérifie qu'une valeur n'est pas un nombre avec une partie fractionnaire.
`nonFunction` New	`Boolean`	Vérifie qu'une valeur n'est pas une fonction.
`nonCountable` New	`Boolean`	Vérifie qu'une valeur n'est pas un nombre dénombrable.
`nonFunctionLike` New	`Boolean`	Vérifie qu'une valeur n'est pas appelable.
`nonInteger` New	`Boolean`	Vérifie qu'une valeur n'est pas un entier.
`nonLength` New	`Boolean`	Vérifie qu'une valeur n'est pas une longueur de tableau valide.
`nonNaN` New	`Boolean`	Vérifie qu'une valeur n'est pas le nombre `NaN`.
`nonNil`	`Boolean`	Vérifie qu'une valeur n'est pas `null` ou `undefined`.
`nonNull`	`Boolean`	Vérifie qu'une valeur n'est pas `null`.
`nonNegative` Deprecated	`Boolean`	Vérifie qu'une valeur est un nombre non négatif.
`nonNumber`	`Boolean`	Vérifie qu'une valeur n'est pas un nombre.
`nonNumberLike` New	`Boolean`	Vérifie qu'une valeur n'est pas convertible en nombre.
`nonObject` New	`Boolean`	Vérifie qu'une valeur n'est pas un objet.
`nonObjectLike` New	`Boolean`	Vérifie qu'une valeur n'est pas de type objet.
`nonRegExp` New	`Boolean`	Vérifie qu'une valeur n'est pas une expression régulière.
`nonSafeInteger` New	`Boolean`	Vérifie qu'une valeur n'est pas un entier sûr.
`nonScalar`	`Boolean`	Vérifie qu'une valeur n'est pas un scalaire.
`nonString`	`Boolean`	Vérifie qu'une valeur n'est pas une chaîne de caractères.
`nonSymbol`	`Boolean`	Vérifie qu'une valeur n'est pas un symbole.
`nonUndefined`	`Boolean`	Vérifie qu'une valeur n'est pas `undefined`.
`nonUrl` New	`Boolean`	Vérifie qu'une valeur n'est pas une URL.
`nonValidEmail` New	`Boolean`	Vérifie qu'une valeur n'est pas une adresse e-mail.
`nonValidLocale` New	`Boolean`	Vérifie qu'une valeur n'est pas un code de locale.
`nonValidSlug` New	`Boolean`	Vérifie qu'une valeur n'est pas un slug.
`nonValidVersion` New	`Boolean`	Vérifie qu'une valeur n'est pas une chaîne de version.
`nonVersionCompatible` New	`Boolean`	Vérifie qu'une version reste en deçà de celle requise.
`now`	`Number`	Renvoie l'heure courante en millisecondes depuis l'époque.
`ObjectTag`	`Enum`	Les tags internes qu'une valeur peut déclarer, sous forme de constantes nommées.
`objectToString`	`String`	Renvoie le tag interne d'une valeur.
`offset` New	`Date`	Décale une date d'un certain nombre d'unités.
`parseJson` Deprecated	`Object`	Analyse du JSON, puis réessaie avec un lecteur permissif si l'analyse stricte échoue.
`require2DArray` New	`Array`	Renvoie la valeur en tant que tableau bidimensionnel non vide, ou lève une exception.
`requireArray` New	`Array`	Renvoie la valeur en tant que un tableau, ou lève une exception.
`requireBoolean` New	`Boolean`	Renvoie la valeur en tant que un booléen, ou lève une exception.
`requireConsistent2DArray` New	`Array`	Renvoie la valeur en tant que matrice à lignes de même longueur, ou lève en nommant la ligne fautive.
`requireCountable` New	`Number`	Renvoie la valeur en tant que un nombre dénombrable, ou lève une exception.
`requireDouble` New	`Number`	Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception.
`requireEmpty` New	`Any`	Renvoie la valeur en tant que une valeur vide, ou lève une exception.
`requireException` New	`Exception`	Renvoie la valeur en tant que une `Exception`, ou lève une exception.
`requireFloat` New	`Number`	Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception.
`requireFunction` New	`Function`	Renvoie la valeur en tant que une fonction, ou lève une exception.
`requireFunctionLike` New	`Function`	Renvoie la valeur en tant que une valeur appelable, ou lève une exception.
`requireInteger` New	`Number`	Renvoie la valeur en tant que un entier, ou lève une exception.
`requireLength` New	`Number`	Renvoie la valeur en tant que une longueur de tableau valide, ou lève une exception.
`requireNaN` New	`Number`	Renvoie la valeur en tant que `NaN`, ou lève une exception.
`requireNil` New	`Null \| Undefined`	Renvoie la valeur en tant que `null` ou `undefined`, ou lève une exception.
`requireNonArray` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un tableau.
`requireNonBoolean` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un booléen.
`requireNonDouble` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire.
`requireNonEmpty` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas vide.
`requireNonFloat` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire.
`requireNonInteger` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier.
`requireNonNaN` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas le nombre `NaN`.
`requireNonSafeInteger` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier sûr.
`requireSafeInteger` New	`Number`	Renvoie la valeur en tant que un entier sûr, ou lève une exception.
`requireSymbol` New	`Symbol`	Renvoie la valeur en tant que un symbole, ou lève une exception.
`requireNonEmptyString`	`String`	Renvoie la valeur comme une chaîne non vide, ou lève.
`requireNonException` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas une `Exception`.
`requireNonFunction` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas une fonction.
`requireNonFunctionLike` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas appelable.
`requireNoNilElements` New	`Array`	Renvoie la collection inchangée après avoir vérifié qu'aucun élément n'est `null` ni `undefined`.
`requireNonLength` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas une longueur de tableau valide.
`requireNonNil` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`.
`requireNonNull`	`any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`.
`requireNonNumber` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre.
`requireNonNumberLike` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas convertible en nombre.
`requireNonObject` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un objet.
`requireNonObjectLike` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas de type objet.
`requireNonRegExp` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas une expression régulière.
`requireNonScalar` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un scalaire.
`requireNonString` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas une chaîne de caractères.
`requireNonSymbol` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas un symbole.
`requireNonUndefined` New	`Any`	Renvoie la valeur après avoir vérifié qu'elle n'est pas `undefined`.
`requireNull` New	`Null`	Renvoie la valeur en tant que `null`, ou lève une exception.
`requireNumber` New	`Number`	Renvoie la valeur en tant que un nombre, ou lève une exception.
`requireNumberLike` New	`Number \| String`	Renvoie la valeur en tant que une valeur numérique, ou lève une exception.
`requireObject` New	`Object`	Renvoie la valeur en tant que un objet, ou lève une exception.
`requireObjectLike` New	`Object`	Renvoie la valeur en tant que une valeur de type objet, ou lève une exception.
`requireRegExp` New	`RegExp`	Renvoie la valeur en tant que une expression régulière, ou lève une exception.
`requireScalar` New	`Scalar`	Renvoie la valeur en tant que un scalaire, ou lève une exception.
`requireState` New	`void`	Affirme qu'une condition tient, et lève dans le cas contraire.
`requireString`	`String`	Renvoie la valeur en tant que une chaîne de caractères, ou lève une exception.
`requireUndefined` New	`Undefined`	Renvoie la valeur en tant que `undefined`, ou lève une exception.
`requireUrl` New	`String`	Renvoie la valeur en tant que une URL, ou lève une exception.
`requireValidEmail`	`String`	Renvoie la valeur en tant que une adresse e-mail, ou lève une exception.
`requireValidLocale` New	`String`	Renvoie la valeur en tant que un code de locale, ou lève une exception.
`requireValidSlug` New	`String`	Renvoie la valeur en tant que un slug, ou lève une exception.
`requireValidVersion` New	`String`	Renvoie la valeur en tant que une chaîne de version, ou lève une exception.
`requireVersionCompatible` New	`String`	Renvoie la version une fois l'exigence satisfaite, ou lève.
`retry` New	`T`	Rappelle une fonction quand elle lève, avec une attente croissante entre les tentatives.
`setPath` New	`Object`	Écrit une propriété imbriquée par chemin, en créant ce qui manque.
`StopWatch` New	`StopWatch`	Chronomètre une suite de tâches nommées.
`stringifyJson`	`String`	Sérialise une valeur en JSON avec un ordre de clés fixe.
`toCamelCase`	`String`	Assemble les mots d'une chaîne en camelCase.
`toInteger`	`Number \\| null`	Extrait un nombre d'une valeur, ou signale qu'il n'y en a pas.
`toKebabCase`	`String`	Réécrit une chaîne en kebab-case.
`toLowerCase`	`String`	Met une chaîne en minuscules, en nettoyant au besoin ses espaces.
`toProperCase`	`String`	Met la première lettre de chaque mot en majuscule et le reste en minuscules.
`toSnakeCase`	`String`	Réécrit une chaîne en snake_case.
`toUpperCase`	`String`	Met une chaîne en majuscules, en nettoyant au besoin ses espaces.
`transpose`	`Array`	Échange les lignes et les colonnes d'une matrice.
`unique` New	`Array`	Retire les doublons d'un tableau en gardant la première occurrence de chaque valeur.
`versionCompare`	`Number`	Compare deux chaînes de version numériquement.
`without` New	`Array`	Retire d'un tableau toutes les occurrences des valeurs indiquées.

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.