domConvertToPicDyn.mjs

import isearr from './isearr.mjs'
import importResources from './importResources.mjs'
import domConvertToPic from './domConvertToPic.mjs'


/**
 * 前端DOM元素轉圖片，採用動態加載技術
 *
 * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/domConvertToPicDyn.test.mjs Github}
 * @memberOf wsemi
 * @param {HTMLElement} ele 輸入元素
 * @param {Object} [opt={}] 輸入設定物件，預設{}
 * @param {Number} [opt.scale=1] 輸入縮放比例數字，需大於等於1，預設1
 * @param {Boolean} [opt.toBase64=true] 輸入是否輸出為base64圖片，預設true
 * @param {String} [opt.picType='image/png'] 輸入輸出為base64圖片時的圖片格式，可選'image/jpeg'與'image/png'，使用'image/jpeg'時若無背景預設為黑色，預設'image/png'
 * @param {String|Object|Array} pathItems 輸入資源字串、字串陣列、物件、物件陣列
 * @returns {Promise} 回傳Promise，resolve回傳產出圖片，reject回傳錯誤訊息
 * @example
 * need test in browser
 *
 * domConvertToPicDyn(ele, { scale: 3 })
 *     .then((b64)=>{
 *         // => iVBORw0KGgoAAAANSU...
 *     })
 *
 */
async function domConvertToPicDyn(ele, opt = {}, pathItems) {

    //pathItems
    //若更新, 記得example與readme也要更新
    if (!isearr(pathItems)) {
        pathItems = [
            'https://cdn.jsdelivr.net/npm/html-to-image@1.11.11/dist/html-to-image.js',
        ]
    }

    //importResources
    await importResources(pathItems)

    //domConvertToPic
    let r = domConvertToPic(ele, opt)

    return r
}


export default domConvertToPicDyn