n8n 中文文档

编程式参数

这些是可用于编程式节点的节点基础文件 的参数。

本文档提供了简短的代码片段,以帮助理解代码结构和概念。有关构建节点的完整演练,包括实际代码示例,请参阅构建编程式节点。

编程式节点也使用 execute() 方法。更多信息请参考编程式执行方法。

所有节点可用的参数请参考标准参数。

defaultVersion

数字 | 可选

在使用完整版本控制方法时使用 defaultVersion。

n8n 支持两种节点版本控制方法。有关更多信息,请参阅 Node 版本控制。

methods 和 loadOptions

对象 | 可选

包含编程式节点的 loadOptions 方法。您可以使用此方法查询服务以获取用户特定的设置(例如从 Gmail 获取用户的电子邮件标签),然后返回它们并在 GUI 中渲染,以便用户可以在后续查询中包含它们。

例如,n8n 的 Gmail 节点 使用 loadOptions 获取所有电子邮件标签:

    methods = {
        loadOptions: {
            // 获取所有标签并显示它们
            async getLabels(
                this: ILoadOptionsFunctions,
            ): Promise<INodePropertyOptions[]> {
                const returnData: INodePropertyOptions[] = [];
                const labels = await googleApiRequestAllItems.call(
                    this,
                    'labels',
                    'GET',
                    '/gmail/v1/users/me/labels',
                );
                for (const label of labels) {
                    const labelName = label.name;
                    const labelId = label.id;
                    returnData.push({
                        name: labelName,
                        value: labelId,
                    });
                }
                return returnData;
            },
        },
    };

version

数字 或 数组 | 可选

在使用轻量级版本控制方法时使用 version。

如果您的节点只有一个版本,这可以是一个数字。如果您想支持多个版本,请将其转换为数组,包含每个节点版本的数字。

n8n 支持两种节点版本控制方法。编程式节点可以使用其中任何一个。有关更多信息,请参阅 Node 版本控制。

features

对象 | 可选

定义根据节点版本评估的命名功能标志。使用 displayOptions 中的 @feature 功能来控制参数可见性,或使用 this.isNodeFeatureEnabled() 在代码中检查它们。

有关更多信息,请参阅基于功能的版本控制。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。