當一個非同步任務可能失敗、且失敗後值得再試幾次時,該怎麼組織程式碼?本文以文字轉語音(TTS)的批次合成場景為例,說明如何用 jQuery Deferred 搭配遞迴,做出「失敗自動重試、超過次數則放棄」的流程。
function runAsyncTTS(text, speecher, audiopath) {
var def = jQuery.Deferred();
var args = {
"SynthText": text,
"VoiceSpeecher": speecher,
"WordSpeed": "3",
"UseCSSML": "0",
"AudioPath": audiopath
};
tts.asyncTTS(JSON.stringify(args), function(err, result) {
def.resolve(result);
});
return def.promise();
}這是最基本的 Promise 包裝:建立 Deferred,把 callback 風格的 API 包起來,最後回傳 promise 而非 deferred 本身。只回傳 promise 是刻意的——外部只能掛 done/fail,無法自行呼叫 resolve,狀態的所有權留在函式內部。
function textToSpeechBat(metaJson, speecher, audioPath) {
var def = $.Deferred();
var result = { originalWords: "", resultJsonArr: [] };
var jsons = "";
for(var index = 0; index < metaJson.words.length; index++) {
var audioName = metaJson.words[index]['audio'];
audioName = audioName.replace('.mp3','');
var audioFile = audioPath + "/" + audioName + '.wav';
var args = '{"SynthText": "' + metaJson.words[index]['word'] +
'", "VoiceSpeecher": "' + speecher +
'", "WordSpeed": "3", "UseCSSML": "0", "AudioPath": "' +
audioFile + '"}';
jsons += args + "|";
}
jsons = jsons.substr(0, jsons.length - 1);
tts.asyncTTSBat(jsons, function(err, ret) {
result['resultJsonArr'] = ret.split('|');
def.resolve(result);
});
return def.promise();
}這裡用豎線作為分隔符,把多筆參數串成一串再送出,回傳後也用同一個符號切回陣列。最後那行 substr 是為了去掉尾端多餘的分隔符。
這個做法有明顯的風險:用字串拼接產生 JSON,只要 word 中出現引號或反斜線就會產生無效的 JSON。應改用 JSON.stringify();而自訂分隔符也可能與內容中的豎線衝突。若 API 支援,傳陣列會更穩妥。
function textToSpeechWithTryTimes(metaJson, speecher, audioPath, times) {
var def = $.Deferred();
var ttsRet = null;
var ttsCallBack = function(index) {
if(index < times) {
textToSpeechBat(metaJson, speecher, audioPath).done(function (ret) {
console.log("textToSpeechWithTryTimes: " + JSON.stringify(ret));
ttsRet = ret;
var resultJsonArr = ret.resultJsonArr;
var audioFlag = true;
for(var i = 0; i < resultJsonArr.length; i++) {
if(resultJsonArr[i] == "") {
audioFlag = false;
break;
}
var retObj = JSON.parse(resultJsonArr[i]);
console.log(retObj['audioFlag']);
if(retObj['audioFlag'] == 'false' || retObj['result'] == "") {
audioFlag = false;
break;
}
}
console.log(audioFlag);
if(audioFlag == false) {
console.log("textToSpeechWithTryTimes 失敗,重試");
ttsCallBack(++index);
} else {
console.log("textToSpeechWithTryTimes 成功,回傳");
def.resolve(ret);
}
});
}
if(index == times) {
console.log("textToSpeechWithTryTimes 已達重試上限,回傳");
def.resolve(ttsRet);
}
};
ttsCallBack(0);
return def.promise();
}核心是一個名為 ttsCallBack 的遞迴函式,它帶一個 index 計數器:
這種「用遞迴取代 callback 巢狀」的寫法,在 Promise 出現前是處理序列式非同步的常見手法,可讀性明顯優於多層縮排的 callback hell。
async function withRetry(fn, times) {
for (var i = 0; i < times; i++) {
try { return await fn(); }
catch (e) { if (i === times - 1) throw e; }
}
}迴圈取代遞迴,意圖一目了然。這個實例的價值在於展示了一個完整模式:把非同步 API 包成 promise、用遞迴實作重試、在成功與耗盡兩條路徑上都給出明確的結束點。理解它之後,改用 async/await 重寫會非常直觀。