14

Extraits de code (JS)

Les extraits que je réutilise le plus souvent

Module 145 min de lectureMis à jour le 20 novembre 2026

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.

Pourquoi coder ?
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).

const users = [ {name: "A", email: "a@test.com"}, {name: "B", email: "b@test.com"} ]; // Résultat: ["a@test.com", "b@test.com"] const emails = users.map(u => u.email);

.filter()

Garder ce qui matche une condition.

const nums = [1, 5, 10, 2]; // Résultat: [5, 10] const big = nums.filter(n => n > 4);

B. Strings (Texte)

.split()

Couper du texte.

const name = "Jean Dupont"; // Résultat: "Jean" const firstname = name.split(" ")[0];

Template Literals

Injecter des variables proprement.

const item = "Pomme"; const price = 10; // "Le prix de Pomme est 10€" const msg = `Le prix de ${item} est ${price}€`;

C. Dates (L’Enfer)

ISO 8601 (Le standard)
2025-02-02T14:00:00.000Z

Utilisez toujours ce format en interne dans n8n.

Format (Luxon)

Dans n8n expressions :

{{ $now.toFormat('dd/MM/yyyy') }}

-> 02/02/2025

D. Regex (Expressions Régulières)

Pour extraire des motifs complexes.

const text = "Contactez-moi au 06 12 34 56 78 merci.";
// D’abord retirer les espaces, puis chercher 10 chiffres d’affilée
const phone = text.replace(/\s/g, "").match(/\d{10}/);
// Résultat: "0612345678"
Outil indispensable : Utilisez Regex101.com pour tester vos regex avant de les mettre en prod. L’IA (ChatGPT) est aussi excellente pour générer des Regex. Dans n8n, $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

pagination.js
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

dedupe.js
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

expression Luxon
{{ $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.

overlap.js
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.

Réflexe : reproduisez l’erreur sur un seul item, ajoutez un 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.