用過富文本編輯器的人都熟悉這個操作:截個圖,在編輯區按 Ctrl+V,圖片就自動上傳了。這個體驗確實順手,本文拆解它的實現原理,並說明三大瀏覽器的差異與兼容做法。
整個流程是:復制 → 粘貼 → 上傳。對應到代碼上就是三步:
測試代碼:
<textarea></textarea>
<div contenteditable style="width: 100px; height: 100px; border: 1px solid"></div>
<script>
document.addEventListener('paste', function (event) {
console.log(event);
});
</script>
Chrome:






Firefox:


IE11:
Chrome 有現成的 API:通過 clipboardData.items、getAsFile()、FileReader 就能在 paste 回調裡拿到 base64(截圖和網頁圖片都能拿到)。
Firefox 和 IE11 沒有這套 API,但並非無計可施——因為數據已經表現在 img 的 src 上了。截圖粘貼時 src 就是 base64,網頁粘貼時 src 就是對方服務器的地址。做法分兩種:截圖直接取 src;網頁圖片則把地址交給後端,由後端下載到自己服務器,再把新地址返回前端。
為了統一管理,最終把兩種情況下的 img.src 都替換成自己存儲的地址。
<head>
<meta charset="UTF-8">
<title>粘貼上傳</title>
<style>
body {
display: -webkit-flex;
display: flex;
-webkit-justify-content: center;
justify-content: center;
}
#tar_box { width: 500px; height: 500px; border: 1px solid red; }
</style>
document.addEventListener('paste', function (event) {
var isChrome = false;
if (event.clipboardData || event.originalEvent) {
// Chrome 分支(部分版本使用 event.originalEvent)
var clipboardData = event.clipboardData || event.originalEvent.clipboardData;
if (clipboardData.items) {
var items = clipboardData.items,
len = items.length,
blob = null;
isChrome = true;
// items.length 與 mime 類型有關:
// 純文本 -> 1,items[0].type = 'text/plain'
// 網頁圖片 -> 2,items[1].type = 'image/*'
// 截圖工具 -> 1,items[0].type = 'image/png'
event.preventDefault(); // 阻止默認粘貼行為
for (var i = 0; i < len; i++) {
if (items[i].type.indexOf("image") !== -1) {
blob = items[i].getAsFile(); // 此方法在 Firefox/IE11 中不支持
}
}
if (blob !== null) {
var reader = new FileReader();
reader.onload = function (e) {
// e.target.result 即圖片的 base64 字符串
uploadImgFromPaste(e.target.result, 'paste', isChrome);
};
reader.readAsDataURL(blob);
}
} else {
// Firefox 分支:延遲取值,確保圖片已插入 div
setTimeout(function () {
var imgList = document.querySelectorAll('#tar_box img'),
len = imgList.length, src_str = '', i;
for (i = 0; i < len; i++) {
if (imgList[i].className !== 'my_img') {
src_str = imgList[i].src; // base64 或外站地址
}
}
uploadImgFromPaste(src_str, 'paste', isChrome);
}, 1);
}
} else {
// IE11 分支
setTimeout(function () {
var imgList = document.querySelectorAll('#tar_box img'),
len = imgList.length, src_str = '', i;
for (i = 0; i < len; i++) {
if (imgList[i].className !== 'my_img') {
src_str = imgList[i].src;
}
}
uploadImgFromPaste(src_str, 'paste', isChrome);
}, 1);
}
});
function uploadImgFromPaste(file, type, isChrome) {
var formData = new FormData();
formData.append('image', file);
formData.append('submission-type', type);
var xhr = new XMLHttpRequest();
xhr.open('POST', '/upload_image_by_paste');
xhr.onload = function () {
if (xhr.readyState === 4) {
if (xhr.status === 200) {
var data = JSON.parse(xhr.responseText);
var tarBox = document.getElementById('tar_box');
if (isChrome) {
// Chrome 需要自己創建 img 節點
var img = document.createElement('img');
img.className = 'my_img';
img.src = data.store_path;
tarBox.appendChild(img);
} else {
// 其它瀏覽器只需替換已插入的 img
var imgList = document.querySelectorAll('#tar_box img'),
len = imgList.length, i;
for (i = 0; i < len; i++) {
if (imgList[i].className !== 'my_img') {
imgList[i].className = 'my_img';
imgList[i].src = data.store_path;
}
}
}
} else {
console.log(xhr.statusText);
}
}
};
xhr.onerror = function () { console.log(xhr.statusText); };
xhr.send(formData);
}
setTimeout 的延時是為了保證瀏覽器先把圖片插入到 div,再從 DOM 中取值——順序反了就拿不到 src。用 className 標記 'my_img' 則是為了區分「本頁已上傳的圖」和「剛粘貼進來的新圖」。
router.post('/', upload.array(), function (req, res, next) {
// 1. 拿到 src 字符串,判斷是 base64 還是普通地址,解析後綴
// 2. base64 去掉前綴後轉 buffer;普通地址則先下載
// 3. 寫入硬盤(後續可把地址存庫)
// 4. 返回存儲路徑
var src_str = req.body.image;
var timestamp = new Date().getTime();
if (src_str.match(/^data:image\/png;base64,|^data:image\/jpg;base64,|^data:image\/bmp;base64,/)) {
// 處理截圖:base64 字符串
var pic_suffix = src_str.split(';', 1)[0].split('/', 2)[1];
var base64 = src_str.replace(/^data:image\/png;base64,|^data:image\/jpg;base64,|^data:image\/bmp;base64,/, '');
var buf = Buffer.from(base64, 'base64');
var store_path = 'public/images/test_' + timestamp + '.' + pic_suffix;
fs.writeFile(store_path, buf, function (err) {
if (err) { throw err; }
res.json({ 'store_path': store_path });
});
} else {
// 處理非 Chrome 的網頁圖片:src 是圖片地址,先下載
var temp_array = src_str.split('.');
var pic_suffix = temp_array[temp_array.length - 1];
var store_path = 'public/images/test_' + timestamp + '.' + pic_suffix;
var wstream = fs.createWriteStream(store_path);
request(src_str).pipe(wstream);
wstream.on('finish', function (err) {
if (err) { throw err; }
res.json({ "store_path": store_path });
});
}
});
運行需要 Node 環境:安裝 node、執行 npm install、然後 node app.js。
文件名要唯一。用時間戳在毫秒級仍可能碰撞,建議配合 UUID 或哈希。
下載外站圖片要設超時與大小限制。request(...).pipe() 若對方響應不結束會一直佔着連接, also 存在被構造惡意 URL 打進內網的風險(SSRF),應校驗協議與域名白名單。
base64 上傳體積膨脹約 33%。更優的做法是在 Chrome 分支直接把 Blob 對象 append 進 FormData,讓後端按二進制流接收,省流量也省解析。
Buffer.from 取代 new Buffer。後者在現代 Node 中已廢棄。
以上就是粘貼上傳的完整實現與跨瀏覽器差異分析,核心思路始終沒變:想辦法拿到圖片數據,上傳,再把地址寫回頁面。