Code:
/**
* 'asyncLoadScript'方法的配置項'options'的類型定義
* @typedef {Object} IOptions
* @prop {string} id - script標籤的ID
* @prop {Function} onSucceed - 加載成功後的回調
* @prop {(Function|undefined)} onFailed - 加載失敗後的回調
* @prop {boolean} strict - True: 'all'; False: 'allSettled';
*/
/**
* 異步加載JS腳本文件
* @param {string[]} scripts - JS文件路徑列表
* @param {IOptions} options - 額外配置項
* @return {Promise}
*/
function asyncLoadScript(scripts, options) {
// 'scripts'參數不合法
if (!Array.isArray(scripts)) {
return Promise.reject(new Error('參數不合法'));
}
// 如果'scripts'參數長度爲空,則直接結束
if (scripts.length === 0) {
console.warn('scripts 數組爲空');
return Promise.resolve();
}
const docHead = document.querySelector('head');
// 處理<head>元素未找到的情況
if (docHead === null) {
return Promise.reject(new Error('未找到head標籤'));
}
// 用於生產並加載script標籤的promise數組
const scriptLoaderPromises = scripts.map(scriptPathname => {
return new Promise((resolve, reject) => {
const tag = document.createElement('script');
tag.setAttribute('src', scriptPathname);
typeof options?.id === 'string' && tag.setAttribute('id', options.id);
tag.setAttribute('async', true);
tag.addEventListener('load', () => resolve(tag));
tag.addEventListener('error', reject);
docHead.appendChild(tag);
});
});
// 選用的'Promise'靜態方法名稱('all', 'allSettled')
const staticMethodPropName = options?.strict === false ? 'allSettled' : 'all';
// *如果'options.onSucceed'方法未定義或不合法,則直接返回當前的promise,交由外部處理
if (typeof options?.onSucceed !== 'function') {
return Promise[staticMethodPropName](scriptLoaderPromises);
}
let failedHandler = options?.onFailed;
// 如果'options.onFailed'未定義,則會使用本地默認方法去處理錯誤情況
if (typeof failedHandler !== 'function') {
failedHandler = err => {
console.warn('asyncLoadScript 執行時出錯:', err);
};
}
return Promise[staticMethodPropName](scriptLoaderPromises)
.then(options.onSucceed)
.catch(failedHandler);
}