ClickSave:圖片下載擴充功能的開發紀錄
2025-01-17
約 8 分鐘
ClickSave 圖片下載擴充功能的開發紀錄:從滑鼠懸停按鈕、原圖網址辨識,到批次下載與上架後的維護。
我和 Felix 一起開發了 ClickSave,一個用來下載網頁圖片的 Chrome 擴充功能。起初只是想減少整理設計素材時反覆存圖的步驟,後來才發現,下載到正確的圖片、讓按鈕在不同網站穩定運作,都需要額外處理
保存圖片時遇到的問題
當時我需要從 Instagram、Pinterest 和其他網站保存大量設計參考。每張圖片都要右鍵、選擇「另存圖片」並指定位置;有些網站提供的檔案還只是低解析度預覽圖
因此我想做一個擴充功能,讓下載按鈕在滑鼠移到圖片上時出現
第一版擴充功能
第一版的設計很直接:偵測滑鼠停留的圖片,在圖片旁顯示下載按鈕,點擊後保存檔案
我把想法告訴朋友 Felix Falkenberg(@ffalkenberg)。他從事 ML 與 DevOps 工作,也是一位數位遊牧者。我們決定一起做這個擴充功能
我以前寫過幾個 Chrome 擴充功能,但多半只供自己短暫使用,沒有上架。這一次,我們從一開始就以公開使用為目標,必須處理不同網站的圖片結構和各種實際操作情況
滑鼠懸停事件

成品會在滑鼠移到圖片上時顯示下載按鈕。第一版雖然能偵測圖片,按鈕卻常在滑鼠移動時閃爍或消失
1 2 3 4 5 6
| document.addEventListener('mouseover', function(e) { if (e.target.tagName === 'IMG') { showDownloadButton(e.target); } });
|
實際測試時出現了幾種問題:
- 按鈕閃爍不停
- 效能問題導致頁面卡頓
- 有些圖片檢測不到
- 按鈕位置不正確
第一版沒有處理滑鼠從圖片移向按鈕的短暫間隔,因此按鈕容易在點擊前消失。後來加入延遲,才讓這個互動穩定下來
事件處理與延遲
經過幾天的研究和測試,我學到了事件委派和防抖的重要性:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
| let hoverTimeout; let currentImage = null;
document.addEventListener('mouseover', function(e) { if (e.target.tagName === 'IMG' && e.target !== currentImage) { clearTimeout(hoverTimeout); hoverTimeout = setTimeout(() => { showDownloadButton(e.target); currentImage = e.target; }, 200); } });
document.addEventListener('mouseout', function(e) { if (e.target.tagName === 'IMG') { clearTimeout(hoverTimeout); setTimeout(() => { hideDownloadButton(); }, 300); } });
|
尋找原始解析度圖片
按鈕能出現之後,下一個問題是下載哪一張。很多網站頁面上放的是縮圖,按原本的 src 下載,拿到的也只是縮圖
Google Images 的圖片來源

在 Google Images,圖片元素的 src 常指向低解析度預覽圖。要找原圖 URL,還得檢查頁面的其他屬性和資料結構
我花了一週測它的頁面結構,最後把幾種可能放原圖 URL 的位置依序檢查:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
| function getGoogleImagesHighRes(img) { const dataUrl = img.getAttribute('data-src') || img.getAttribute('data-original-src') || img.getAttribute('data-iurl'); const parent = img.closest('[data-ri]'); if (parent) { try { const metadata = JSON.parse(parent.getAttribute('data-ri')); if (metadata.ou) return metadata.ou; } catch (e) { } } if (img.srcset) { const srcsetUrls = parseSrcset(img.srcset); return srcsetUrls[srcsetUrls.length - 1].url; } if (img.src.includes('googleusercontent.com')) { return img.src.replace(/=s\d+/, ''); } return img.src; }
|
不同網站的圖片結構
接下來我們發現,每個主流網站都有自己的圖片存儲邏輯:
- Instagram:高解析度圖片藏在
data-* 屬性中,但屬性名會變化
- Twitter:需要修改 URL 參數來獲取大圖版本(
:large vs :small)
- Pinterest:原始圖片 URL 隱藏在複雜的 JSON 結構中
- Facebook:多層嵌套的圖片版本,需要遞歸查找
我們需要為每個網站開發專門的解析邏輯:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
| class ImageResolver { constructor() { this.siteHandlers = { 'instagram.com': this.handleInstagram, 'twitter.com': this.handleTwitter, 'x.com': this.handleTwitter, 'images.google.com': this.handleGoogleImages, 'pinterest.com': this.handlePinterest, 'facebook.com': this.handleFacebook }; } async resolveHighResUrl(img) { const hostname = window.location.hostname; const handler = this.siteHandlers[hostname]; if (handler) { try { const result = await handler(img); if (result && result !== img.src) return result; } catch (error) { console.warn(`Handler failed for ${hostname}:`, error); } } return this.genericResolve(img); } handleTwitter(img) { if (img.src.includes('pbs.twimg.com')) { return img.src.replace(/:(small|medium|thumb)/, ':large'); } return img.src; } }
|
下載按鈕的互動設計
技術問題解決後,我們開始面對各種意想不到的用戶體驗問題
可拖曳按鈕的位置
最初我們把下載按鈕固定在圖片的右上角,但很快發現問題:
- 在小圖片上按鈕過於突兀
- 有時會遮擋重要內容(如水印、文字)
- 不同網站的 CSS 會影響按鈕顯示
我們決定讓按鈕可拖曳,但這帶來了新的技術挑戰:如何確保按鈕始終保持在圖片邊界內?
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| function constrainButtonPosition(button, image, newX, newY) { const imgRect = image.getBoundingClientRect(); const btnRect = button.getBoundingClientRect(); const minX = 0; const minY = 0; const maxX = imgRect.width - btnRect.width; const maxY = imgRect.height - btnRect.height; const constrainedX = Math.max(minX, Math.min(maxX, newX)); const constrainedY = Math.max(minY, Math.min(maxY, newY)); return { x: constrainedX, y: constrainedY }; }
|
排除裝飾性圖片
測試過程中我們發現了一個意想不到的問題:很多網站都有用來裝飾的小圖片,比如:
- 1x1 像素的追蹤圖片
- 用於背景裝飾的重複圖案
- 載入中的佔位符圖片
- CSS 背景圖片
這些圖片上出現下載按鈕既沒用又影響體驗
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
| function shouldShowDownloadButton(img) { if (img.width < 50 || img.height < 50) return false; if (img.width === 1 && img.height === 1) return false; const src = img.src.toLowerCase(); const suspiciousPatterns = [ 'placeholder', 'loading', 'spinner', 'icon-', 'logo-small', 'avatar-default', '1x1', 'pixel' ]; if (suspiciousPatterns.some(pattern => src.includes(pattern))) { return false; } const computedStyle = window.getComputedStyle(img); if (computedStyle.display === 'none' || computedStyle.visibility === 'hidden') { return false; } const aspectRatio = img.width / img.height; if (aspectRatio > 20 || aspectRatio < 0.05) return false; return true; }
|
按鈕狀態與視覺回饋
我添加了細緻的動畫和狀態指示:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
| .download-button { opacity: 0; transform: scale(0.8); transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1); }
.download-button.show { opacity: 1; transform: scale(1); }
.download-button:hover { transform: scale(1.1); box-shadow: 0 4px 12px rgba(0,0,0,0.3); }
|
我希望按鈕出現時看得見,滑鼠移走後又不會擋住原本的頁面
從單張下載到批次下載
第一版給朋友試用後,有人問能不能一次下載整頁的圖片
我和 Felix 開始做批次下載。單張下載的流程不能直接重複幾十次;要限制同時進行的請求,也要處理其中幾張失敗的情況
批次下載的並行與錯誤處理

實現批次下載看起來簡單,但實際上涉及複雜的非同步處理和錯誤處理。我們需要考慮:
- 避免同時發起太多下載請求(會被瀏覽器限制)
- 處理部分下載失敗的情況
- 給用戶提供進度反饋
- 避免下載重複圖片
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
| class BatchDownloader { async downloadAll(images) { const results = []; const concurrency = 3; for (let i = 0; i < images.length; i += concurrency) { const batch = images.slice(i, i + concurrency); const promises = batch.map(img => this.downloadSingle(img)); try { const batchResults = await Promise.allSettled(promises); results.push(...batchResults); this.updateProgress(i + batch.length, images.length); await this.delay(500); } catch (error) { console.error('Batch download error:', error); } } return results; } }
|
程式碼結構與重構
隨著功能增加,程式碼開始變得複雜和難以維護,我們決定重構:
1 2 3 4 5 6 7 8 9
|
const ClickSave = { core: new CoreModule(), ui: new UIModule(), downloader: new DownloadModule(), settings: new SettingsModule(), analytics: new AnalyticsModule() };
|
每支援一個新網站,就可能需要增加一個 handler。若所有邏輯都放在同一個檔案裡,每次修改都得重新梳理既有程式碼。拆成模組後,新增網站主要是實作對應介面,維護範圍也比較清楚
網站結構變動帶來的維護
維護上的難處來自網站結構持續變動。Google Images 的原圖網址可能藏在資料屬性裡,Twitter 透過網址參數區分尺寸,Pinterest 則會把資料放在 JSON 中。擴充功能必須分別辨認這些來源;網站一改版,原本可用的下載方式就可能失效
和 Felix 合作時,我們會從不同角度檢查設計。批次下載就是一例:如果同時發出太多請求,瀏覽器可能限制下載,因此我們在實作前先決定了並行數量與失敗時的處理方式
後續方向
ClickSave 已通過審核,現在可以從 Chrome Web Store 安裝。後續可能加入圖片放大與去背、Firefox 和 Safari 支援,以及跨裝置設定同步。這些方向仍要根據實際使用情況決定優先順序
從練習專案到上架
我以前做的擴充功能,大多完成了預期的操作就停下來。ClickSave 要公開給別人使用,還得處理那些測試時容易略過的情況:追蹤像素、特殊長寬比的裝飾圖片、不斷變動的資料屬性,以及使用者拖曳按鈕的方式。這些細節決定了功能能否在日常使用中維持穩定
專案相關連結: