fly.js

Fly.js 是一个轻量级的 JavaScript 库，主要用于进行 HTTP 请求操作。与其他大型库如 Axios 或者 Fetch API 不同，Fly.js 以其小巧和高效的特性吸引了开发者的关注。其主要设计目标是提供一个简单且直接的方式来发送 HTTP 请求，同时也涵盖了一些高级功能，如请求拦截、响应拦截和错误处理。

Fly.js 的基本使用

要使用 Fly.js 进行 HTTP 请求，首先需要在项目中引入 Fly.js。可以通过 npm 的方式进行安装：

npm install flyio

安装完成之后，可以在 JavaScript 文件中进行引用：

const Fly = require("flyio");

// 创建一个 Fly 实例
const fly = new Fly();

发送请求

Fly.js 支持多种 HTTP 请求方法，包括 GET、POST、PUT、DELETE 等。每种方法都有其特定的使用场景，并且 Fly.js 提供了一种流畅的 API 来发送这些请求。

GET 请求

GET请求通常用于从服务端获取数据。在 Fly.js 中发送一个 GET 请求的方法如下：

fly.get("https://jsonplaceholder.typicode.com/posts")
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

在这个例子中，Fly.js 通过调用 fly.get 方法发送一个 GET 请求到指定的 URL，并在请求成功时通过 then 方法处理响应结果。如果请求失败，则会触发 catch 方法以处理错误。

POST 请求

POST请求通常用于向服务端发送数据，例如表单提交。在 Fly.js 中，POST 请求可以这样发送：

fly.post("https://jsonplaceholder.typicode.com/posts", {
        title: 'foo',
        body: 'bar',
        userId: 1
    })
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

这里，fly.post 方法的第二个参数即是要发送的请求体数据。在请求成功后，结果会通过 then 方法返回。

请求拦截器

Fly.js 提供了请求拦截器，可以在请求发送之前对请求进行处理或修改。例如，您可以在请求拦截器中加入认证信息或修改请求头。

fly.interceptors.request.use(request => {
    request.headers["Authorization"] = "Bearer <token>";
    return request;
});

响应拦截器

类似地，Fly.js 也提供了响应拦截器，可以对响应进行处理或检查。通过响应拦截器，您可以在其他代码处理之前统一处理响应数据，检查错误状态等。

fly.interceptors.response.use(
    response => {
        // 对响应数据进行处理
        return response;
    },
    error => {
        // 处理错误
        return Promise.reject(error);
    }
);

错误处理

Fly.js 支持内置的错误处理机制，在请求出错时可以通过 catch 方法处理错误信息。Fly.js 会返回一个包含各种信息的错误对象，例如响应状态码、错误类型等。

fly.get("https://jsonplaceholder.typicode.com/invalid-url")
    .catch(error => {
        console.error("Error status:", error.status);
        console.error("Error message:", error.message);
    });

取消请求

在某些情况下，您可能需要取消正在进行中的 HTTP 请求。Fly.js 提供了取消请求的功能：

const cancelToken = {};
fly.get("https://jsonplaceholder.typicode.com/posts", null, {
    cancelToken
}).catch(error => {
    if (fly.isCancelled(error)) {
        console.log('Request canceled', error.message);
    } else {
        console.error('Request failed', error);
    }
});

// 取消请求
fly.abort(cancelToken);

配置和定制

Fly.js 允许全局配置请求的默认参数，这样您可以在初始化时设置一些通用的配置。例如，您可以设置默认的请求头或者基准URL：

fly.config.headers = {
    "X-Custom-Header": "foobar"
};

fly.config.baseURL = "https://jsonplaceholder.typicode.com";

这使得后续的所有请求都会使用这些默认配置，当然这些配置也可以在单个请求中被覆写。

总结

Fly.js 是一个功能齐全且高效的 HTTP 请求库，特别适合需要轻量级解决方案的项目。它不仅提供了多种常用的HTTP方法，还支持请求拦截、响应拦截、以及简洁的错误处理机制，迎合了现代JavaScript开发者的许多需求。尽管其功能不如更大型的库那么全面，但它以体积小、性能优良而成为一种不错的选择。对于那些希望在不引入复杂性和臃肿库的情况下兼顾功能性的开发者来说，Fly.js 是一个值得一试的工具。