网络请求

提示

网络 (Network) 模块是 Omni 小组件与互联网通信的桥梁，是动态数据显示的核心。无论是获取天气信息、新闻头条，还是与您自己的服务器 API 交互，都依赖于此模块。它提供了简单而强大的 API 来发起网络请求并处理响应。

新版 API 提供了更灵活的链式调用和配置方式。

发起请求

1. 初始化请求: 使用 new Request(url) 创建一个请求实例。
2. 配置请求 (可选):
   • method: 设置请求方法，如 GET (默认), POST, PUT 等。
   • headers: 设置请求头，格式为 JSON 对象。
   • body: 设置请求体，通常用于 POST 或 PUT 请求。
3. 发送请求并获取数据:
   • fetch(): 发送请求并返回原始响应。
   • fetchJSON(): 发送请求并将响应解析为 JSON 对象。
   • fetchString(): 发送请求并将响应解析为字符串。

示例

GET 请求

const req = new Request("https://2f0.cn/api/omni");
req.headers = { "Content-Type": "application/json" };

// 获取 JSON 数据
const jsonData = await req.fetchJSON();
console.log(jsonData.omni);

// 获取字符串数据
const stringData = await req.fetchString();
console.log(stringData);

POST 请求

const req = new Request("https://2f0.cn/api/omni");
req.method = "POST";
req.headers = { "Content-Type": "application/json" };
req.body = { "omni": "hello OmniWidgets"};

const response = await req.fetchJSON();
console.log(response);