ClickSave:圖片下載擴充功能的開發紀錄

目錄
  1. 保存圖片時遇到的問題
  2. 第一版擴充功能
  3. 尋找原始解析度圖片
  4. 下載按鈕的互動設計
  5. 從單張下載到批次下載
  6. 程式碼結構與重構
  7. 網站結構變動帶來的維護
  8. 後續方向
  9. 從練習專案到上架

我和 Felix 一起開發了 ClickSave,一個用來下載網頁圖片的 Chrome 擴充功能。起初只是想減少整理設計素材時反覆存圖的步驟,後來才發現,下載到正確的圖片、讓按鈕在不同網站穩定運作,都需要額外處理

保存圖片時遇到的問題

當時我需要從 Instagram、Pinterest 和其他網站保存大量設計參考。每張圖片都要右鍵、選擇「另存圖片」並指定位置;有些網站提供的檔案還只是低解析度預覽圖

因此我想做一個擴充功能,讓下載按鈕在滑鼠移到圖片上時出現

第一版擴充功能

第一版的設計很直接:偵測滑鼠停留的圖片,在圖片旁顯示下載按鈕,點擊後保存檔案

我把想法告訴朋友 Felix Falkenberg(@ffalkenberg)。他從事 ML 與 DevOps 工作,也是一位數位遊牧者。我們決定一起做這個擴充功能

我以前寫過幾個 Chrome 擴充功能,但多半只供自己短暫使用,沒有上架。這一次,我們從一開始就以公開使用為目標,必須處理不同網站的圖片結構和各種實際操作情況

滑鼠懸停事件

滑鼠移到 Instagram 圖片上,右下角浮現一鍵下載按鈕

成品會在滑鼠移到圖片上時顯示下載按鈕。第一版雖然能偵測圖片,按鈕卻常在滑鼠移動時閃爍或消失

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); // 200ms 延遲避免閃爍
}
});

document.addEventListener('mouseout', function(e) {
if (e.target.tagName === 'IMG') {
clearTimeout(hoverTimeout);
setTimeout(() => {
hideDownloadButton();
}, 300); // 給用戶時間移動到按鈕上
}
});

尋找原始解析度圖片

按鈕能出現之後,下一個問題是下載哪一張。很多網站頁面上放的是縮圖,按原本的 src 下載,拿到的也只是縮圖

Google Images 的圖片來源

在 Google 圖片搜尋結果上懸停,同樣浮現 ClickSave 的下載按鈕

在 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
// Google Images 高解析度檢測:經過無數次試錯後的最終方案
function getGoogleImagesHighRes(img) {
// 方法 1: 檢查各種可能的 data 屬性
const dataUrl = img.getAttribute('data-src') ||
img.getAttribute('data-original-src') ||
img.getAttribute('data-iurl');

// 方法 2: 爬取父元素的 data-ri 屬性(Google的中繼資料)
const parent = img.closest('[data-ri]');
if (parent) {
try {
const metadata = JSON.parse(parent.getAttribute('data-ri'));
// 'ou' 是 original URL 的縮寫
if (metadata.ou) return metadata.ou;
} catch (e) {
// JSON 解析失敗,繼續嘗試其他方法
}
}

// 方法 3: 分析 srcset 找最高解析度
if (img.srcset) {
const srcsetUrls = parseSrcset(img.srcset);
return srcsetUrls[srcsetUrls.length - 1].url;
}

// 方法 4: 嘗試從 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, // Twitter 改名後的域名
'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')) {
// 將 :small 或其他尺寸替換為 :large
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;
}

// 檢查是否為 CSS 背景圖片
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 開始做批次下載。單張下載的流程不能直接重複幾十次;要限制同時進行的請求,也要處理其中幾張失敗的情況

批次下載的並行與錯誤處理

ClickSave 的側邊面板:把整頁圖片列成網格,勾選要的再一次下載

實現批次下載看起來簡單,但實際上涉及複雜的非同步處理和錯誤處理。我們需要考慮:

  • 避免同時發起太多下載請求(會被瀏覽器限制)
  • 處理部分下載失敗的情況
  • 給用戶提供進度反饋
  • 避免下載重複圖片
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
// 重構前:一個巨大的文件,500+ 行
// 重構後:模塊化架構
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 要公開給別人使用,還得處理那些測試時容易略過的情況:追蹤像素、特殊長寬比的裝飾圖片、不斷變動的資料屬性,以及使用者拖曳按鈕的方式。這些細節決定了功能能否在日常使用中維持穩定


專案相關連結: