'use strict'

module.exports = compose

// compose函數(shù)需要傳入一個(gè)數(shù)組隊(duì)列 [fn,fn,fn,fn]

function compose (middleware) {

    // 如果傳入的不是數(shù)組，則拋出錯(cuò)誤
    if (!Array.isArray(middleware)) throw new TypeError('Middleware stack must be an array!')

    // 數(shù)組隊(duì)列中有一項(xiàng)不為函數(shù)，則拋出錯(cuò)誤
    for (const fn of middleware) {
        if (typeof fn !== 'function') throw new TypeError('Middleware must be composed of functions!')
    }

    // compose函數(shù)調(diào)用后，返回的是以下這個(gè)匿名函數(shù)
    // 匿名函數(shù)接收兩個(gè)參數(shù)，第一個(gè)隨便傳入，根據(jù)使用場景決定
    // 第一次調(diào)用時(shí)候第二個(gè)參數(shù)next實(shí)際上是一個(gè)undefined，因?yàn)槌醮握{(diào)用并不需要傳入next參數(shù)
    // 這個(gè)匿名函數(shù)返回一個(gè)promise
    return function (context, next) {
        let index = -1
        return dispatch(0)
        function dispatch (i) {
            // 如果傳入i為負(fù)數(shù)且<=-1 返回一個(gè)Promise.reject攜帶著錯(cuò)誤信息
            // 所以執(zhí)行兩次next會(huì)報(bào)出這個(gè)錯(cuò)誤。將狀態(tài)rejected，就是確保在一個(gè)中間件中next只調(diào)用一次

            if (i <= index) return Promise.reject(new Error('next() called multiple times'))

            // 執(zhí)行一遍next之后,這個(gè)index值將改變
            index = i

            // 根據(jù)下標(biāo)取出一個(gè)中間件函數(shù)
            let fn = middleware[i]

            // next在這個(gè)內(nèi)部中是一個(gè)局部變量，值為undefined，因?yàn)槌跏紱]有傳next的值
            // 當(dāng)i已經(jīng)是數(shù)組的length了，說明中間件函數(shù)都執(zhí)行結(jié)束，執(zhí)行結(jié)束后把fn設(shè)置為undefined
            // 問題：本來middleware[i]如果i為length的話取到的值已經(jīng)是undefined了，為什么要重新給fn設(shè)置為undefined呢？
            if (i === middleware.length) fn = next

            //如果中間件遍歷到最后了。那么。此時(shí)return Promise.resolve()返回一個(gè)成功狀態(tài)的promise
            // 方面之后做調(diào)用then
            if (!fn) return Promise.resolve()

            // try catch保證錯(cuò)誤在Promise的情況下能夠正常被捕獲。
            // 調(diào)用后依然返回一個(gè)成功的狀態(tài)的Promise對象
            // 用Promise包裹中間件，方便await調(diào)用
            // 調(diào)用中間件函數(shù)，傳入context（根據(jù)場景不同可以傳入不同的值，在Koa傳入的是ctx）
            // 第二個(gè)參數(shù)是一個(gè)next函數(shù)，可在中間件函數(shù)中調(diào)用這個(gè)函數(shù)
            // 調(diào)用next函數(shù)后，遞歸調(diào)用dispatch函數(shù)，目的是執(zhí)行下一個(gè)中間件函數(shù)
            // next函數(shù)在中間件函數(shù)調(diào)用后返回的是一個(gè)promise對象
            try {
                return Promise.resolve(fn(context, function next () {
                    return dispatch(i + 1)
                }))
            } catch (err) {
                return Promise.reject(err)
            }
        }
    }
}