Extraits de code (JS)
Les extraits que je réutilise le plus souvent
Le code dans n8n n’est pas un concours d’élégance. C’est un outil pour transformer un item, appeler une API ou contourner une limite. La bonne question n’est pas « puis-je l’écrire en JavaScript ? », mais « est-ce que ce sera plus lisible qu’avec des nœuds ? ».
Ce module rassemble les extraits que je réutilise le plus : tableaux, dates, regex, transformations d’items. Chaque extrait est accompagné de ce qu’il fait et de ce qu’il ne fait pas. Copiez, testez, puis adaptez.
Parfois, un nœud Code de quelques lignes est plus lisible et plus rapide qu’une chaîne de quinze nœuds. Ce n’est pas une règle générale : un nœud natif reste préférable quand il suffit. Le code devient utile quand la transformation est difficile à exprimer visuellement, ou quand il faut traiter un cas limite que les nœuds ne couvrent pas proprement.
Trois règles avant de coller un extrait : comprenez ce qu’il fait, testez-le sur un
seul item avant de le lancer sur mille, et prévoyez ce qui se passe si une valeur est
null ou absente. Un code qui fonctionne sur l’exemple du tutoriel peut échouer sur la
première ligne réelle.
A. Arrays (Listes)
.map()
Transformer une liste. (ex: Garder juste les emails).
.filter()
Garder ce qui matche une condition.
B. Strings (Texte)
.split()
Couper du texte.
Template Literals
Injecter des variables proprement.
C. Dates (L’Enfer)
Utilisez toujours ce format en interne dans n8n.
Dans n8n expressions :
-> 02/02/2025
D. Regex (Expressions Régulières)
Pour extraire des motifs complexes.
// D’abord retirer les espaces, puis chercher 10 chiffres d’affilée
const phone = text.replace(/\s/g, "").match(/\d{10}/);
// Résultat: "0612345678"
$json.email lit un champ de l’item courant et $('NomDuNoeud').first().json lit le premier item d’un nœud précédent : préférez ces expressions à un nœud Code quand c’est possible.
E. n8n en pratique : 3 motifs
Quatre recettes qui reviennent dans presque tous les projets. Nœud Code en mode "Run Once for All Items", sauf mention contraire.
Paginer une API
let page = 1;
let tous = [];
let suite = true;
while (suite) {
const r = await $http.request({
method: 'GET',
url: 'https://api.exemple.fr/items?page=' + page
});
tous = tous.concat(r.data);
suite = r.next_page === true;
page = page + 1;
}
return tous.map(x => ({ json: x }));
Dédupliquer par email
const vus = new Set();
return items.filter(i => {
const mail = (i.json.email || '').toLowerCase();
if (!mail || vus.has(mail)) return false;
vus.add(mail);
return true;
}).map(i => ({ json: i.json }));
Échéance +30 jours, format FR
{{ $now.plus({ days: 30 }).toFormat('dd/MM/yyyy') }}
Variante du motif C : on ajoute 30 jours avant de formater.
Détecter un chevauchement de créneaux
items[0] = créneau demandé, suivants = réservations existantes. Utilisé par le TP salles du module 3.
const demande = items[0].json;
const debut = new Date(demande.debut).getTime();
const fin = new Date(demande.fin).getTime();
const clash = items.slice(1).some(r => {
const d = new Date(r.json.debut).getTime();
const f = new Date(r.json.fin).getTime();
return debut < f && d < fin;
});
return [{ json: { libre: !clash } }];
Lire une erreur JavaScript sans paniquer
Une erreur dit rarement « voici la cause ». Elle donne un type, un message et une ligne. Les plus
fréquentes dans n8n : TypeError: Cannot read properties of undefined (un champ
n’existe pas), SyntaxError: Unexpected token (une parenthèse, une virgule ou une quote
manque), et ReferenceError: x is not defined (une variable mal nommée ou déclarée dans
un autre bloc). Lisez la première ligne de la pile, pas la dernière : c’est souvent là que se trouve
l’appel fautif.
console.log
temporaire ou un nœud Set pour voir la valeur réelle, puis corrigez. Si vous ne comprenez pas
l’erreur, ne la contournez pas avec un try/catch qui avale tout : vous déplacez le
problème plus loin.