Introduction
Le nœud Code est l’un des outils les plus puissants d’n8n. Lorsque les nœuds intégrés comme Set, Edit Fields ou Split Out ne suffisent pas, le nœud Code vous permet d’écrire du véritable JavaScript pour transformer les données exactement comme vous le souhaitez. Il s’exécute dans un environnement Node.js sandboxé et a un accès direct à la structure des éléments d’n8n, vous donnant un contrôle total sur les données de votre flux de travail.
Cette leçon se concentre sur trois cas d’utilisation pratiques : manipulation de tableaux, formatage de chaînes et calcul de nouveaux champs à partir de ceux existants.
Comment fonctionne le nœud Code
Le nœud Code opère sur le tableau items qui circule dans votre flux de travail. Chaque élément est un objet nommé json qui contient ses données. Lorsque vous ouvrez le nœud Code, vous écrivez le corps d’une fonction — n8n l’enveloppe automatiquement, vous n’avez donc pas besoin de définir vous-même une fonction.
Il existe deux modes d’exécution. « Run Once for All Items » vous donne accès à tous les éléments en même temps via la variable items. « Run Once for Each Item » donne une variable pour un seul élément. Le mode par défaut et le plus flexible est « Run Once for All Items », sur lequel cette leçon se concentre.
Dans ce mode, votre code doit retourner un tableau d’objets de forme :
Chaque objet du tableau retourné devient un élément de sortie. Si vous retournez un tableau vide, zéro élément est transmis.
Manipulation de tableau
Suppose an upstream node gives you a list of orders, and each item has a products field that is an array of objects. You want to flatten the list so each product becomes its own item.
If you started with 3 order items, each containing 4 products, you end up with 12 output items. This is something Split Out can do for simple cases, but the Code node lets you carry along computed context from the parent item at the same time.
To do the reverse — group multiple items into one — you can use reduce:
Formatage de chaînes
Les transformations de chaînes sont une raison courante d’utiliser le Code node. L’éditeur d’expression gère les cas simples, mais le formatage multi-étapes est plus propre en code.
Voici un exemple qui normalise un champ de nom — supprime les espaces en début et fin, convertit en capitalisation Titre et construit une étiquette d’affichage:
En utilisant l’opérateur spread ...item.json, on conserve tous les champs existants et on ajoute les nouveaux par-dessus, de sorte que les nœuds en aval voient toujours les données d’origine.
Calcul de nouveaux champs
Le Code node est idéal lorsque un nouveau champ dépend d’un calcul sur plusieurs champs existants — des totaux, l’âge à partir d’une date de naissance, ou des indicateurs de statut basés sur des règles métier.
Notez l’utilisation de +value.toFixed(2) — toFixed renvoie une chaîne, donc l’opérateur unaire + la convertit à nouveau en nombre. Cela compte car les nœuds en aval qui font des calculs ou des comparaisons se comporteront différemment avec des chaînes plutôt qu’avec des nombres.
Erreurs courantes
Oublier d’empaqueter la sortie en JSON est l’erreur la plus fréquente. Rendre { name: 'Alice' } au lieu de { json: { name: 'Alice' } } provoquera une erreur n8n ou une suppression silencieuse des données.
Mutation directe de item.json au lieu de l’étendre peut entraîner des effets secondaires inattendus dans certaines versions de n8n — il faut toujours construire un nouvel objet.
Utiliser await sans marquer le nœud Code comme capable d’être asynchrone : si vous devez appeler une aide intégrée comme $node ou effectuer des opérations asynchrones, assurez-vous que votre logique prend en compte le mode d’exécution. Les transformations synchrones standard comme les exemples ci-dessus n’ont pas besoin d’installation spéciale.
Enfin, le nœud Code n’a pas accès par défaut aux paquets npm externes dans n8n Cloud. Sur n8n auto-hébergé, vous pouvez mettre sur liste blanche des paquets, mais écrivez votre code pour qu’il soit portable à moins que vous ne contrôliez le déploiement.
Résumé
Le nœud Code vous donne un environnement JavaScript complet pour gérer des transformations que les nœuds intégrés ne peuvent pas exprimer proprement. L’habitude clé est de toujours retourner un tableau d’objets { json: ... }, d’étendre les champs existants lorsque vous souhaitez simplement ajouter de nouveaux éléments, et de choisir “Run Once for All Items” lorsque la transformation implique de remodeler la collection elle-même.
Point de contrôle de la leçon
Révisez la leçon et recevez des conseils sur votre travail.