@yuliqi/node-red-contrib-qurl 0.0.6

An advanced HTTP request node for Node-RED.

npm install @yuliqi/node-red-contrib-qurl

node-red-contrib-qurl

qurl 节点 是一个基于 Axios 的 HTTP/HTTPS 请求节点，支持 Node-RED 流程中灵活的网络请求。
可通过节点配置或消息动态控制请求，还支持将请求函数注入消息 (msg.qurl) 以异步调用。

🌟 特性

• 支持 HTTP 方法：GET / POST / PUT / DELETE / PATCH / HEAD
• 支持自定义请求头和 URL 参数
• 支持 keep-alive 复用 TCP 连接
• 支持 JSON、文本、ArrayBuffer 响应
• 可选择直接请求或注入异步函数 msg.qurl()
• 兼容 Axios 配置语法，支持 async/await 调用

⚡ 安装

cd ~/.node-red
npm install node-red-contrib-qurl

安装完成后重启 Node-RED。

🧩 节点属性

💬 消息属性

🏃 使用示例

1️⃣ 普通请求模式（默认）

msg.method = "get";
msg.url = "/users/1";
return msg;

节点会直接发起请求，返回 msg.payload 或详细响应（视 verboseOut 设置）。

2️⃣ 通过 msg.qurl 执行模式

勾选 通过 msg.qurl 执行 后，节点不会直接请求，而是注入异步函数。

const { qurl } = msg;

try {
    const res = await qurl({
        method: "post",
        url: "/users",
        data: { name: "Alice" },
        params: { debug: true },
        headers: { "X-Auth": "token" }
    });

    msg.payload = res.data;
    return [msg, null];
} catch (err) {
    msg.error = err;
    return [null, msg];
}

💡 支持 async/await，参数与 Axios 配置完全兼容。

🔧 节点状态

⚠️ 注意事项

• 若启用 useQurl，节点只注入函数，不执行请求。
• 建议为每个请求设置合理超时，避免流程阻塞。
• 响应类型为 stream 时返回 Readable 对象，可用于文件写入或转发。
• msg.qurl 支持多次调用，互不干扰，可灵活用于事务或异步控制。
• 配合 Function、Switch、Catch、Status 节点可实现复杂流程控制。

📦 依赖

• axios
• Node.js ≥ 14
• Node-RED ≥ 3.0

🔗 参考

• Axios 官方文档
• Node-RED 官方节点开发文档

📝 许可证

MIT License