如何在JavaScript中使用Zabbix的CurlHttpRequest()？解决本地运行报错问题

CurlHttpRequest 不是ECMAScript标准内置对象，是Zabbix在自身JS执行沙箱中注入的专属全局对象，仅能在Zabbix服务端/代理端的脚本运行上下文（Webhook脚本、自定义HTTP监控项、全局执行脚本等场景）中直接调用。本地的Node.js、浏览器JS引擎都没有内置这个对象，直接运行自然会报「CurlHttpRequest未定义」的错误。

Zabbix的JS沙箱基于Duktape引擎实现，CurlHttpRequest是对底层libcurl能力的封装，用来在Zabbix脚本中发起HTTP请求，它的公开方法列表如下：

• addHeader(name, value)：为请求添加自定义请求头，可多次调用添加多个头
• setProxy(proxy_url)：配置请求使用的HTTP代理地址
• setTimeout(ms)：设置请求超时时间，单位为毫秒
• getHeaders()：获取响应返回的全部响应头，返回格式为JSON字符串
• status()：获取响应的HTTP状态码
• get(url, data)：发起GET请求，第二个参数为可选的请求体内容
• post(url, data)：发起POST请求，第二个参数为请求体内容
• put(url, data)：发起PUT请求
• patch(url, data)：发起PATCH请求
• delete(url, data)：发起DELETE请求

注意：Zabbix原生环境中所有请求方法都是同步阻塞执行的，调用后直接返回响应体字符串，不需要写异步回调、async/await语法。

方案1：直接使用Zabbix原生环境调试（推荐，无兼容问题） #

这是最准确的调试方式，不会出现本地和线上行为不一致的问题：

1. 登录Zabbix管理后台，进入「管理」-「脚本」页面新建脚本
2. 脚本类型选择「Webhook」，粘贴编写的JS代码
3. 点击页面上的测试按钮即可直接运行脚本，查看执行结果、返回值和报错信息，该环境原生支持CurlHttpRequest，不会出现未定义错误。

写代码时注意尽量使用ES5标准语法，Zabbix的Duktape引擎对ES6+语法支持有限，避免出现语法解析错误。

方案2：本地模拟CurlHttpRequest对象（适合离线开发） #

如果需要在本地离线写代码，可以自行实现一个同名模拟类，对齐原生方法的行为，再基于这个类开发调试。Node.js环境下的基础实现示例如下：

const https = require('https');
const http = require('http');

class CurlHttpRequest {
  constructor() {
    this._headers = {};
    this._timeout = 5000;
    this._proxy = null;
    this._resStatus = 0;
    this._resHeaders = {};
  }

  addHeader(name, value) {
    this._headers[name] = value;
  }

  setProxy(proxyUrl) {
    this._proxy = proxyUrl;
  }

  setTimeout(ms) {
    this._timeout = ms;
  }

  getHeaders() {
    return JSON.stringify(this._resHeaders);
  }

  status() {
    return this._resStatus;
  }

  _request(method, reqUrl, data = '') {
    const parsedUrl = new URL(reqUrl);
    const lib = parsedUrl.protocol === 'https:' ? https : http;
    let result = '';
    let error = null;

    const req = lib.request({
      hostname: parsedUrl.hostname,
      port: parsedUrl.port,
      path: parsedUrl.pathname + parsedUrl.search,
      method: method,
      headers: this._headers,
      timeout: this._timeout
    }, (res) => {
      this._resStatus = res.statusCode;
      this._resHeaders = res.headers;
      res.on('data', chunk => result += chunk);
    });

    req.on('error', err => error = err);
    req.on('timeout', () => {
      req.destroy();
      error = new Error('Request timeout');
    });

    if (data && ['POST', 'PUT', 'PATCH', 'DELETE'].includes(method)) {
      req.write(data);
    }
    req.end();

    // 同步等待请求完成，对齐Zabbix同步调用逻辑
    while(!result && !error) {
      require('deasync').runLoopOnce();
    }
    if (error) throw error;
    return result;
  }

  get(url, data) {
    return this._request('GET', url, data);
  }

  post(url, data) {
    return this._request('POST', url, data);
  }

  put(url, data) {
    return this._request('PUT', url, data);
  }

  patch(url, data) {
    return this._request('PATCH', url, data);
  }

  delete(url, data) {
    return this._request('DELETE', url, data);
  }
}

// 测试代码
const req = new CurlHttpRequest();
req.addHeader('Content-Type', 'application/json');
const res = req.post('https://example.com/api', JSON.stringify({key: 'value'}));
console.log('状态码：', req.status());
console.log('响应内容：', res);

本地使用需要先安装deasync依赖实现同步请求：执行npm i deasync即可。注意本地模拟实现仅覆盖核心逻辑，和Zabbix原生实现可能存在细节差异，代码写完后一定要放到Zabbix环境中做最终验证。

• Zabbix沙箱环境不支持require/import语法，无法引入第三方JS库，所有逻辑需要用原生JS实现
• 请求返回的响应体是字符串格式，如果接口返回JSON，需要手动调用JSON.parse()解析
• 不要在脚本中写死敏感信息，尽量使用Zabbix的用户宏存储密钥、地址等配置

内容的提问来源于stack exchange，提问作者adler