Giới thiệu
Trong n8n, expression chính là cầu nối giữa dữ liệu thô và logic động. Thay vì hardcode giá trị, bạn viết expression để đọc dữ liệu từ các node trước, áp dụng các phép chuyển đổi và truyền kết quả cho bước tiếp theo — tất cả mà không cần viết một Code node hoàn chỉnh.
Mọi expression trong n8n đều được bao bọc trong cặp dấu ngoặc nhọn kép và được đánh giá tại thời điểm chạy (runtime). Engine đằng sau chúng là một môi trường JavaScript gọn nhẹ với một tập các biến built-in và phương thức hỗ trợ. Hiểu được tầng này chính là điều phân biệt một workflow dễ vỡ với một workflow thực sự xử lý được dữ liệu thực tế.
Cú pháp Expression và các Biến Built-in
Hai biến built-in quan trọng nhất mà bạn sẽ sử dụng liên tục là $json và $input. $json tham chiếu đến JSON body của item hiện đang được xử lý. $input cho phép bạn truy cập vào toàn bộ input object, bao gồm khả năng tham chiếu đến các item khác trong cùng một lần chạy.
Để tham chiếu một field từ item hiện tại:
Để tham chiếu output từ một node trước đó cụ thể theo tên:
Để truy cập index của item hiện tại trong một batch:
Để lấy tổng số item đang đi vào node hiện tại:
Các biến này khả dụng trong hầu hết mọi trường có hiển thị nút bật/tắt expression — input field, giá trị Set node, điều kiện IF, tham số HTTP Request và nhiều trường khác.
![flowchart showing how $json, $input, and $node[] variables map to data flowing between three nodes in sequence](https://cdn.sanity.io/images/hs5ychob/production/84cf7b7dcafeaf8632129b911a040676e153e342-1376x768.jpg?w=1200&q=75&auto=format&fit=max)
Chuyển đổi Dữ liệu bằng Expression
Ngoài việc truy cập field đơn giản, expression còn hỗ trợ đầy đủ JavaScript string, array và object API. Đây chính là nơi các phép chuyển đổi diễn ra inline mà không cần một Code node riêng.
Chuyển một chuỗi sang chữ hoa:
Cắt khoảng trắng và kiểm tra một điều kiện:
Tạo một chuỗi đã định dạng từ nhiều field:
Phân tích một ngày và định dạng lại nó bằng tích hợp $now và Luxon có sẵn:
n8n tích hợp sẵn Luxon để xử lý ngày tháng. Bạn tham chiếu trực tiếp nó dưới tên DateTime trong bất kỳ expression nào — không cần import.
Làm phẳng một field lồng nhau một cách an toàn bằng optional chaining:
Pattern này — optional chaining kết hợp nullish coalescing — rất quan trọng khi dữ liệu upstream của bạn không nhất quán. Nó ngăn các expression ném ra lỗi có thể làm chết toàn bộ execution.
Làm việc với Array trong Expression
Khi một node xuất ra nhiều item, đôi khi bạn cần tổng hợp hoặc lọc chúng từ bên trong một expression ở node phía sau. $input.all() cung cấp cho bạn toàn bộ mảng các item dưới dạng object có thuộc tính json.
Lấy email từ mọi item trong batch dưới dạng một mảng:
Lọc các item có field thỏa mãn điều kiện và đếm chúng:
Tính tổng một field số trên toàn bộ item:
Các expression này hoạt động tốt bên trong một Set node hoặc Merge node, nơi bạn muốn tạo ra một giá trị tổng hợp duy nhất từ một batch trước khi truyền nó xuống phía sau.
Những Lỗi Thường Gặp
Vấn đề thường xuyên nhất là tham chiếu đến một field không tồn tại trên một số item. Expression sẽ ném ra TypeError và execution bị dừng. Luôn sử dụng optional chaining khi field không được đảm bảo tồn tại.
Một lỗi thường gặp khác là quên rằng $json tham chiếu đến item hiện tại, không phải toàn bộ output của một node. Nếu một node phát ra năm item và bạn xử lý chúng bằng $json.value, mỗi item được xử lý độc lập — bạn không nhận được một mảng gồm năm giá trị, mà bạn nhận được một giá trị cho mỗi lượt execution.
Nhầm lẫn giữa $node["NodeName"].json với $json cũng là một nguồn bug thường xuyên. $node[] ghim bạn vào output cuối cùng của một node cụ thể bất kể execution path hiện tại, điều này có thể trả về dữ liệu cũ (stale) trong các workflow có phân nhánh. Hãy sử dụng nó một cách có chủ đích và hạn chế.
Cuối cùng, tránh đặt logic nhiều bước phức tạp bên trong một expression duy nhất. Khi bạn cần nhiều hơn hai thao tác chuỗi hoặc một vòng lặp có side effect, hãy chuyển logic đó sang một Code node. Expression dùng để chuyển đổi, không dùng để điều khiển luồng (control flow).
Tóm tắt
Expression trong n8n cho phép bạn đọc, chuyển đổi và kết hợp dữ liệu một cách linh hoạt bằng $json, $input và $node[] làm các điểm truy cập chính. Các phương thức chuỗi, mảng và ngày tháng của JavaScript hoạt động native bên trong cặp dấu ngoặc nhọn kép, và Luxon khả dụng để định dạng ngày tháng. Các pattern truy cập an toàn như optional chaining và nullish coalescing giữ cho workflow của bạn có khả năng chống chịu trước dữ liệu upstream không nhất quán. Khi logic chuyển đổi phát triển vượt quá vài thao tác chuỗi, Code node mới là công cụ phù hợp — expression bao phủ tất cả phần còn lại.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.