大圖直傳佔用帶寬、增加服務端壓力。前端利用 File API 讀取、Canvas 繪製壓縮、toDataURL 輸出 Base64/Blob,可在上傳前大幅減小體積。本文深度解析核心流程與生產級代碼。
FileReader.readAsDataURL(file) 讀取文件為 Base64drawImage 縮放繪製、toDataURL(type, quality) 壓縮輸出<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>
// 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 });
}
};
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,高質量較慢但銳利 |
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);
});
}
// 需引入 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);
});
大批量/高分辨率壓縮時,將 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)解碼超限 | 預先縮略圖、分塊繪製、服務端處理 |
// 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 離屏處理。