Patrón return items en n8n
Por qué patrones de return incorrectos en nodos Code causan pérdida silenciosa de datos
¿Qué es este problema?
Los nodos Code de n8n esperan que los items se retornen en un formato específico: un array de objetos con propiedades 'json' (y opcionalmente 'binary'). Retornar datos en formato incorrecto causa errores o pérdida silenciosa de datos.
Errores comunes:
•Retornar objetos crudos en lugar de wrappers {json: ...}•Retornar un solo item en lugar de un array•Olvidar retornar algo (undefined implícito)•Mezclar formatos de items inconsistentemente
¿Por qué es un problema?
Pérdida silenciosa de datos
Formatos de return inválidos pueden resultar en output vacío sin error.
Errores de tipo
Nodos downstream fallan cuando reciben items malformados.
Comportamiento inconsistente
A veces funciona, a veces no, dependiendo de los datos.
Dificultad de debugging
El mensaje de error no indica claramente el problema de formato de return.
Cómo solucionarlo
- 1
Usar formato correcto
Siempre retorna: return items.map(item => ({ json: { ...tus datos } }))
- 2
Verificar Run Once Each Item
En modo 'Run Once for Each Item', retorna un solo objeto {json: ...}.
- 3
Usar helpers $input
Usa $input.all() y modifica items en lugar de crear desde cero.
- 4
Validar output
Agrega console.log(items) antes del return para verificar el formato.
Escanea tu workflow ahora
Sube tu archivo JSON de n8n y detecta nodos Code con patrones de return potencialmente incorrectos.