Introducción
En n8n, las expresiones son el puente entre los datos en bruto y la lógica dinámica. En lugar de codificar valores, escribes expresiones que leen datos de nodos anteriores, aplican transformaciones y pasan el resultado al siguiente paso —todo sin escribir un nodo de Código completo.
Cada expresión en n8n está envuelta en llaves dobles y se evalúa en tiempo de ejecución. El motor detrás de ellas es un entorno de JavaScript ligero con un conjunto de variables y métodos auxiliares integrados. Comprender esta capa es lo que separa un flujo de trabajo frágil de uno que realmente maneja datos del mundo real.
Sintaxis de la Expresión y Variables Integradas
Las dos variables integradas más importantes que usarás constantemente son $json y $input. $json se refiere al cuerpo JSON del ítem actual que se está procesando. $input te da acceso al objeto de entrada completo, incluida la capacidad de referenciar otros ítems en la misma ejecución.
Para referenciar un campo del ítem actual:
Para referenciar la salida de un nodo anterior específico por nombre:
Para acceder al índice del ítem actual en un lote:
Para obtener el número total de ítems que llegan al nodo actual:
Estas variables están disponibles en casi todos los campos que muestran el conmutador de expresión — campos de entrada, establecer valores de nodos, condiciones IF, parámetros de solicitud HTTP y más.
![Diagrama de flujo que muestra cómo las variables $json, $input y $node[] corresponden a los datos que fluyen entre tres nodos en secuencia](https://cdn.sanity.io/images/hs5ychob/production/3d36be3889caa66f87dad98289d27e37b5c516fd-1344x768.jpg?w=1200&q=75&auto=format&fit=max)
Transformando datos con expresiones
Más allá del acceso simple a campos, las expresiones admiten la API completa de JavaScript para strings, arrays y objetos. Aquí es donde las transformaciones ocurren en línea sin un nodo Code dedicado.
Convertir una cadena a mayúsculas:
Recortar espacios en blanco y verificar una condición:
Construir una cadena formateada a partir de múltiples campos:
Analizar una fecha y reformatearla usando la integración incorporada de $now y Luxon:
n8n integra Luxon para el manejo de fechas. Puedes hacer referencia a ella directamente como DateTime dentro de cualquier expresión — no se necesita importación.
Aplanar un campo anidado de forma segura utilizando encadenamiento opcional:
Este patrón —encadenamiento opcional más coalescencia nula— es crítico cuando tus datos de origen son inconsistentes. Previene que las expresiones arrojen errores que podrían cancelar toda la ejecución.
Trabajando con arrays en expresiones
Cuando un nodo genera varios elementos, a veces necesitas agregarlos o filtrarlos desde una expresión aguas abajo. $input.all() te da el array completo de elementos como objetos con una propiedad json.
Obtén el correo electrónico de cada elemento en el lote como un array:
Filtra elementos donde un campo cumple una condición y cuéntalos:
Suma un campo numérico a través de todos los elementos:
Estas expresiones funcionan bien dentro de un nodo Set o un nodo Merge donde quieres producir un valor agregado único a partir de un lote antes de pasarlo aguas abajo.
Errores comunes
El problema más frecuente es hacer referencia a un campo que no existe en algunos ítems. La expresión genera un TypeError y la ejecución se detiene. Siempre usa encadenamiento opcional cuando no se garantiza la existencia del campo.
Otro error común es olvidar que $json se refiere al ítem actual, no al resultado completo de un nodo. Si un nodo emite cinco ítems y los procesas con $json.value, cada ítem se procesa de forma independiente; no obtienes un array de cinco valores, obtienes un valor por cada pasada de ejecución.
Confundir $node["NodeName"].json con $json también es una fuente regular de errores. $node[] te restringe al último output de un nodo específico independientemente del camino de ejecución actual, lo que puede devolver datos obsoletos en flujos con bifurcaciones. Úsalo de forma deliberada y con moderación.
Finalmente, evita colocar lógica compleja de varios pasos dentro de una sola expresión. Una vez que necesitas más de dos operaciones encadenadas o un bucle con efectos secundarios, mueve esa lógica a un nodo Code. Las expresiones son para transformaciones, no para control de flujo.
Resumen
Las expresiones en n8n te permiten leer, transformar y combinar datos dinámicamente usando $json, $input y $node[] como tus puntos de acceso principales. Los métodos de cadena, arreglo y fecha de JavaScript funcionan de forma nativa dentro de llaves dobles, y Luxon está disponible para el formateo de fechas. Patrones de acceso seguro como el encadenamiento opcional y la coalescencia nula mantienen tus flujos de trabajo resilientes frente a datos no consistentes de la fuente. Cuando la lógica de transformación crece más allá de unas cuantas operaciones encadenadas, el nodo Code es la herramienta adecuada: las expresiones cubren todo lo demás.
Punto de control de la lección
Repasa lo aprendido y recibe comentarios sobre tu trabajo.