Skip to content

legado.http.get

同步 HTTP GET 请求,直接返回响应体字符串。

签名

js
legado.http.get(url, headers?) → string
参数类型必填说明
urlstring请求 URL
headersobject自定义请求头 { key: value }

返回值:响应体字符串。网络异常时抛出 JS 异常。

示例

基本用法

js
var html = legado.http.get('https://www.example.com/page');

解析 JSON 响应

js
var resp = legado.http.get('https://api.example.com/books');
var data = JSON.parse(resp);
legado.log('共 ' + data.total + ' 本书');

带查询参数

js
var url = BASE + '/search?q=' + encodeURIComponent(keyword) + '&page=' + page;
var result = legado.http.get(url);

自定义请求头

js
var html = legado.http.get(url, {
  'Referer': 'https://example.com',
  'User-Agent': 'Custom/1.0',
  'X-Token': 'my-secret-token'
});

错误处理

js
function safeGet(url) {
  try {
    return legado.http.get(url);
  } catch (e) {
    legado.log('请求失败: ' + e.message);
    return null;
  }
}

默认行为

  • 所有请求默认携带 Chrome UA(Mozilla/5.0 ... Chrome/120.0.0.0
  • 可通过 headers 参数覆盖 User-Agent
  • 请求是同步阻塞的,无需 await

基于 MIT 许可发布