萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

前端純 JS 實現圖片壓縮上傳:File API + Canvas 核心原理與代碼實戰

大圖直傳佔用帶寬、增加服務端壓力。前端利用 File API 讀取、Canvas 繪製壓縮、toDataURL 輸出 Base64/Blob,可在上傳前大幅減小體積。本文深度解析核心流程與生產級代碼。

核心技術棧

  • File API:FileReader.readAsDataURL(file) 讀取文件為 Base64
  • Canvas:drawImage 縮放繪製、toDataURL(type, quality) 壓縮輸出
  • Blob/FormData:Base64 轉 Blob,構建表單上傳

完整實現代碼(ES6 模塊化)

1. HTML 結構

<input type="file" id="fileImg" accept="image/*" />
<form id="uploadForm">
    <img id="preview" src="" alt="預覽" style="display:none; max-width:300px;" />
    <button type="submit">上傳</button>
</form>

2. 核心壓縮庫 JIC (JavaScript Image Compressor) 精簡版


// jic.js - 核心壓縮邏輯
const jic = {
    /**
     * 壓縮圖片
     * @param {HTMLImageElement} sourceImg - 已加載的 Image 對象
     * @param {Number} quality - 壓縮質量 0-1 (對應 toDataURL 第二參數)
     * @param {Number} maxWidth - 最大寬度限制(可選)
     * @param {Number} maxHeight - 最大高度限制(可選)
     * @returns {Object} { src: DataURL, width, height, size: Byte }
     */
    compress: function(sourceImg, quality, maxWidth, maxHeight) {
        var canvas = document.createElement("canvas");
        var ctx = canvas.getContext("2d");
        
        var width = sourceImg.naturalWidth || sourceImg.width;
        var height = sourceImg.naturalHeight || sourceImg.height;
        
        // 計算縮放比例(保持長寬比)
        if (maxWidth && width > maxWidth) {
            height = height * (maxWidth / width);
            width = maxWidth;
        }
        if (maxHeight && height > maxHeight) {
            width = width * (maxHeight / height);
            height = maxHeight;
        }
        
        canvas.width = width;
        canvas.height = height;
        
        // 高質量縮放(可選)
        ctx.imageSmoothingEnabled = true;
        ctx.imageSmoothingQuality = "high";
        ctx.drawImage(sourceImg, 0, 0, width, height);
        
        // 輸出壓縮後的 DataURL
        var mimeType = "image/jpeg"; // 統一輸出 JPEG,體積最小
        var dataUrl = canvas.toDataURL(mimeType, quality);
        
        // 計算近似體積(Base64 長度 * 3/4)
        var byteString = atob(dataUrl.split(",")[1]);
        var size = byteString.length;
        
        return { src: dataUrl, width, height, size };
    },
    
    /**
     * DataURL 轉 Blob(用於 FormData 上傳)
     */
    dataURLtoBlob: function(dataUrl) {
        var parts = dataUrl.split(",");
        var mime = parts[0].match(/:(.*?);/)[1];
        var bstr = atob(parts[1]);
        var n = bstr.length;
        var u8arr = new Uint8Array(n);
        while (n--) u8arr[n] = bstr.charCodeAt(n);
        return new Blob([u8arr], { type: mime });
    }
};

3. 主邏輯:文件選擇 → 預覽 → 壓縮 → 表單提交


document.getElementById("fileImg").addEventListener("change", function(e) {
    var file = e.target.files[0];
    if (!file || !file.type.match("image.*")) return;
    
    var reader = new FileReader();
    reader.onload = function(event) {
        var img = new Image();
        img.onload = function() {
            // 壓縮:質量 0.6,最大寬高 1920px
            var compressed = jic.compress(img, 0.6, 1920, 1920);
            
            // 預覽
            var $preview = $("#preview");
            $preview.attr("src", compressed.src).show();
            console.log(`原始: ${file.size} bytes → 壓縮: ${compressed.size} bytes (${(compressed.size/file.size*100).toFixed(1)}%)`);
            
            // 存儲壓縮結果供提交使用
            $preview.data("compressed-blob", jic.dataURLtoBlob(compressed.src));
        };
        img.src = event.target.result;
    };
    reader.readAsDataURL(file);
});

// 表單提交:使用壓縮後的 Blob
$("#uploadForm").submit(function(e) {
    e.preventDefault();
    var blob = $("#preview").data("compressed-blob");
    if (!blob) return alert("請先選擇圖片");
    
    var formData = new FormData();
    formData.append("image", blob, "compressed_" + Date.now() + ".jpg");
    // 可追加其他字段
    // formData.append("userId", "123");
    
    $.ajax({
        url: "/api/upload",
        type: "POST",
        data: formData,
        processData: false,
        contentType: false,
        success: function(res) { alert("上傳成功"); },
        error: function() { alert("上傳失敗"); }
    });
});

關鍵參數調優指南

參數 推薦值 影響
quality (0-1) 0.6-0.8 越小體積越小、失真越大;0.7 通常肉眼難辨
maxWidth/maxHeight 1920 / 1080 超過螢幕分辨率無意義,強制縮放大幅減小體積
output format image/jpeg 照片類 JPEG 最優;截圖/圖標用 image/png(無損)或 image/webp(現代瀏覽器)
imageSmoothingQuality "high" 縮放質量:low/medium/high,高質量較慢但銳利

進階功能擴展

1. 多圖片批量壓縮併發控制


async function compressFiles(files, options = {}) {
    const { quality = 0.7, maxWidth = 1920, maxHeight = 1920, concurrency = 3 } = options;
    const results = [];
    
    for (let i = 0; i < files.length; i += concurrency) {
        const chunk = Array.from(files).slice(i, i + concurrency);
        const promises = chunk.map(file => compressSingle(file, quality, maxWidth, maxHeight));
        const chunkResults = await Promise.all(promises);
        results.push(...chunkResults);
    }
    return results;
}

function compressSingle(file, quality, maxWidth, maxHeight) {
    return new Promise((resolve, reject) => {
        const reader = new FileReader();
        reader.onload = e => {
            const img = new Image();
            img.onload = () => resolve(jic.compress(img, quality, maxWidth, maxHeight));
            img.onerror = reject;
            img.src = e.target.result;
        };
        reader.onerror = reject;
        reader.readAsDataURL(file);
    });
}

2. EXIF 方向修正(手機拍照常見旋轉問題)


// 需引入 exif-js 或手動解析
EXIF.getData(img, function() {
    var orientation = EXIF.getTag(this, "Orientation");
    if ([3, 6, 8].includes(orientation)) {
        // 在 canvas 繪製前應用旋轉變換
        ctx.save();
        // ... 根據 orientation 旋轉/翻轉 canvas
        ctx.restore();
    }
    ctx.drawImage(img, 0, 0, width, height);
});

3. Web Worker 離屏壓縮(不阻塞主線程)

大批量/高分辨率壓縮時,將 jic.compress 邏輯移入 Worker,主線程通過 postMessage 傳遞 ImageBitmap(OffscreenCanvas)或 Base64 字符串。

常見坑點與解決

問題 原因 解決
壓縮後圖片旋轉 90°/180° 手機照片含 EXIF Orientation,Canvas 不自動應用 解析 EXIF,繪製前應用對應變換
透明背景變黑 JPEG 不支持透明,Canvas 默認黑色背景 輸出 PNG/WebP,或繪製前填充白色背景
toDataURL 拋 SecurityError 跨域圖片污染 Canvas(CORS 缺失) 圖片服務端配置 Access-Control-Allow-Origin,img.crossOrigin="anonymous"
大圖壓縮頁面卡頓 主線程同步繪製阻塞 Web Worker / OffscreenCanvas / 分片處理
iOS Safari 內存崩潰 單張超大圖(>30MP)解碼超限 預先縮略圖、分塊繪製、服務端處理

現代替代:Browser Image Compression 庫


// npm i browser-image-compression
import imageCompression from 'browser-image-compression';

const options = {
    maxSizeMB: 1,
    maxWidthOrHeight: 1920,
    useWebWorker: true,
    onProgress: (p) => console.log(`進度: ${p}%`)
};

const compressedFile = await imageCompression(file, options);
// 直接上傳 compressedFile (File 對象)

結語

前端圖片壓縮 = FileReader 讀取 → Image 解碼 → Canvas 縮放繪製 → toDataURL/Blob 輸出。核心難點在於「縮放算法質量、EXIF 方向修正、跨域污染、大圖內存管理」。掌握原生實現原理,既能輕量級接入無依賴項目,也能深度定制或排查第三方庫疑難雜癥。生產環境強烈建議接入成熟庫(browser-image-compression、compressorjs)並配合 Web Worker 離屏處理。

copyright © 萬盛學電腦網 all rights reserved