摘要：已支持的平臺官方支持的運行時包括瀏覽器微信小程序。瀏覽器端支持全局攔截。支持請求配置頁面內嵌到原生中時，支持將請求轉發到，支持直接請求圖片。

Fly.js 的定位是成為 Javascript http請求的終極解決方案，也就是說，在任何能夠執行 Javascript 的環境，只要具有訪問網絡的能力，Fly都能運行在其上，并提供統一的Promise based API。

Github: https://github.com/wendux/fly

Fly.js 官方支持的Javascript運行時包括：瀏覽器、node、微信小程序。這意味著你可以在這些平臺使用同一份代碼來發起http請求。值得一提是集成到web應用時（瀏覽器環境）， fly.js的大小只有4.7KB， 非常輕量。

Fly.js 支持的JavaScript運行時是不同的，但提供的用戶層API是統一的，API是基于Promise的，風格和 axios 很像（但不完全相同），下面看幾個例子：

var fly=require("flyio")
//通過用戶id獲取信息,參數直接寫在url中
fly.get("/user?id=133")
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

//query參數通過對象傳遞
fly.get("/user", {
      id: 133
  })
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

fly.post("/user", {
    name: "Doris",
    age: 24
    phone:"18513222525"
  })
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

function getUserRecords() {
  return fly.get("/user/133/records");
}

function getUserProjects() {
  return fly.get("/user/133/projects");
}

fly.all([getUserRecords(), getUserProjects()])
  .then(fly.spread(function (records, projects) {
    //兩個請求都完成
  }))
  .catch(function(error){
    console.log(error)
  })

…….

上面只是Fly.js的簡單使用，Fly.js 除了支持Promise風格的API之外，另外還支持：

支持請求／響應攔截器。

自動轉換 JSON 數據。

瀏覽器端支持全局Ajax攔截。

API支持typeScript。

支持請求配置

H5頁面內嵌到原生 APP 中時，支持將 http 請求轉發到 Native，支持直接請求圖片。

詳細的文檔請參考 github fly .

Fly 引入了Http Engine 的概念，所謂 Http Engine，就是真正發起 http 請求的引擎，這在瀏覽器中一般都是XMLHttpRequest，而在其它JavaScript運行時下，需要提供相應平臺的Http Engine，Fly 正是通過切換不同平臺的 Http Engine 而實現同時支持不同JavaScript運行時的 。

Http Engine 是一個標準的接口協議，內部實現了真正的HTTP請求邏輯，不同JavaScript運行時只需要實現Http Engine的接口協議，就可以無縫集成到Fly.js中。

如上所述，要支持新的JavaScript運行時時，我們需要實現該平臺下的Http Engine即可，但是從頭實現一個Http Engine 是非常復雜的，為此，Fly 官方提供了一個 EngineWrapper 幫助工具，它可以通過一個adapter(適配器)生成一個完整的 Http Engine，所以，我們只需要實現一個adapter就行。

var engine= EngineWrapper(function (request,responseCallback) {
            responseCallback({
                statusCode:200,
                responseText:"你變或者不變，我都不變?。",
                extraFeild:"自定義字段"
            })
        })
fly.engine=engine;

fly.get("../package.json").then(d=>{
    log(d.data)
    log(d.extraFeild)
})

控制臺輸出

> 你變或者不變，我都不變?。
> 自定義字段

EngineWrapper的參數就是adapter, 在這個例子中，adapter 并沒有真正發起 http 請求，而是直接返回了固定內容，這樣 fly 上層請求任何接口收到的內容永遠都是相同的。完整的示例請移步：Fly.js-Http Engine .

我們說過，在瀏覽器環境中，fly 使用的默認engine 就是 XMLHttpRequest。現在我們想想混合APP， 如果能在 Native（Android、IOS） 上實現一個engine，然后供瀏覽器中的 fly 使用，那么也就會將原本應該在瀏覽器中發起的請求重定向到了 Native 上。而這個在 Native 上實現的 engine，我們稱其為遠程 Http Engine，這是因為調用者和執行者并不在同一個環境。

通過遠程Http Engine, Fly.js可以實現一個逆天的功能--請求重定向。它可以將本來會在瀏覽器中發起的http請求重定向到Native, 這樣就可以在Native 上進行統一的請求管理、cookie同步、證書檢驗、緩存和訪問控制等，詳細的內容請參考: Fly.js 請求重定向 。

貼出Fly.js的Github源碼地址：https://github.com/wendux/fly , 詳細的文檔請移步github, 如果你喜歡Fly.js，歡迎star.