n8n-expression-testing

n8n-expression-testing 是一項專門的工程代理工具，旨在確保複雜 n8n 工作流程表達式的穩健性與安全性。它為驗證 n8n 節點內基於 JavaScript 的表達式提供了結構化的方法，防止因語法錯誤、空指標引用或不安全編碼慣例而導致的運行時故障。此工具對於管理大型數據管線且需要高度可靠的數據轉換邏輯的工作流程開發人員、自動化工程師和 QA 專家至關重要。通過自動化審核流程，它能大幅減少處理動態 $json、$node 和 $items 引用時通常所需的除錯時間。

• 語法驗證：分析表達式字符串以確認其 JavaScript 結構的正確性，在部署前有效移除模板標記以進行錯誤檢查。

• 上下文變數驗證：確保關鍵的上下文變數（如 $json、$node、$items、$now 和 $workflow）被正確引用與類型定義。

• 安全性分析：檢測 eval() 或 Function() 建構函式等危險函式的使用，以降低潛在的注入風險。

• 自動化測試生成：利用提供的上下文數據模擬執行，以捕捉邊界條件錯誤、類型轉換問題及缺失的備用值。

• 效能優化：識別可能在處理大型數據集的工作流程中導致效能瓶頸的低效陣列操作或遞迴邏輯。

• 輸入/輸出：接收原始表達式字符串與目標上下文數據；輸出結構化的驗證報告、錯誤診斷訊息及修復後的程式碼片段。

• 最佳實踐：實作使用可選串接 (?.) 與合併運算子 (??) 的空安全訪問模式，以防止未定義屬性的訪問錯誤。

• 相容性：支援 n8n 內建方法的完整範疇，包括透過 Luxon 進行的日期處理、字串格式化及複雜物件操作。

• 約束：主要針對標準 n8n 表達式環境設計；假設為 Node.js 相容的 JavaScript 執行上下文。