Cookie 工作階段

SameSession 如何解密本機 Chrome 設定檔的 Cookie 並注入一次性瀏覽器，以讀取需登入的頁面。

用法

result, err := browser.Fetch(ctx, "https://example.com/profile", 60*time.Second, &browser.Option{
    SameSession: true,
    Profile:     "Default",
})

原本的 Chrome 完全不受影響：Cookie 資料庫先複製到暫存目錄，載入頁面的瀏覽器跑在這份副本上。Profile 是 Chrome 設定檔根目錄下的子目錄名（Default、Profile 1……）。

流程

graph TB
    A[launchWithSnapshot] --> B[複製 Cookies / -wal / -shm 至暫存目錄]
    B --> C[取 Chrome Safe Storage 密碼]
    C --> D[PBKDF2-SHA1 推導 16 bytes 金鑰]
    D --> E[sqlite3 讀出 cookies]
    E --> F[AES-128-CBC 解密 v10 前綴值]
    F --> G[啟動暫存 profile 的 Chrome]
    G --> H[SetCookies 注入]

解密與注入

cookies 資料表每一列轉成一筆 CDP cookie，含 domain、path、到期時間（由 WebKit epoch 換算）、Secure、HTTPOnly、SameSite。解碼失敗的列直接略過。

注入

缺 domain 或 name 的 Cookie 會被丟棄，空 path 補成 /。批次注入失敗時改逐筆注入，只要有一筆成功就繼續；全部失敗回傳 inject cookies (0/N)。

失敗行為

路由仍然適用：SameSession 呼叫被擋時可以有頭重試，每次嘗試各自建立暫存設定檔。見 Fetch 路由。