SuperAPI AI 工具集

n8n-syntax-extension-methods

编程与开发

查看项目

更新于 10-26 08:07

技能介绍

n8n-syntax-extension-methods 是一份面向 n8n v1.x 表达式引擎的扩展方法完整参考,属于 Claude 技能包中的语法参考类内容。其核心主张是:在 n8n 表达式中应始终优先使用扩展方法,而不是原生 JavaScript 的等价写法,因为这些方法对空值安全,并针对 n8n 表达式引擎做了优化。

用途与覆盖范围 按数据类型组织方法:字符串 19 个、数组 21 个、数字 11 个、对象 12 个、布尔 3 个、DateTime 25 个以上(基于 Luxon),以及 BinaryFile 的 7 个只读属性。文档还提供决策树,帮助根据当前数据类型和需求选择合适的方法类别。

主要能力 字符串方法覆盖提取(extractEmail、extractUrl、extractDomain、extractUrlPath)、校验(isEmail、isUrl、isEmpty、isNotEmpty)、编码与哈希(urlEncode、urlDecode、base64Encode、base64Decode、hash)、类型转换(toDateTime、toBoolean)和格式化(toSentenceCase、toSnakeCase、toTitleCase、quote、removeMarkdown、replaceSpecialChars)。数组方法覆盖取元素、pluck 字段、去重、集合运算、聚合与重构。数字方法覆盖取整、本地化格式化、类型判断和转换。对象方法覆盖字段过滤、合并、结构与序列化。DateTime 方法覆盖属性访问、加减、比较、格式化与时区处理。

使用方式 在 n8n 表达式(双花括号)中直接对值调用对应方法,并支持链式调用,例如 $json.items.pluck("price").sum()、$now.minus({days: 7}).startOf("day").toISO()、$json.timestamp.toDateTime().format("yyyy-MM-dd")。文档配套 methods.md(完整签名与返回类型)、examples.md(实用示例)与 anti-patterns.md(常见错误)三个参考文件,并链接 n8n 官方表达式文档和 Luxon DateTime 文档。

重要行为与限制 多个方法有特定行为:extractEmail 未找到时返回 undefined;hash 默认 md5;average、sum 对非数值数组报错;isEven、isOdd 对非整数报错;toDateTime 默认把数字视为 Unix 毫秒;compact 不移除 0 与 false;merge 以基础对象优先;hasField 仅检查顶层键;diffTo 返回 Duration 对象;isBetween 两端为开区间;BinaryFile 的 fileSize 返回字符串;数据库存储的二进制数据不设置 directory。文档强调不应在不了解返回类型的情况下链式调用,日期处理应使用 $now 与 $today 而非 new Date()。

适用场景 适用于在 n8n 工作流表达式中进行数据清洗与转换、日期时间运算与格式化、数组去重与聚合、对象字段筛选与序列化、读取上传文件元数据等任务。

限制 该内容为语法参考文档,本身不提供执行环境或运行时;部分具体用法细节以配套参考文件为准,本页面仅给出概览。官方文本暂未提供。