Cloudflare 在 2026 年 11 月 20 日為 Browser Run 發布 /script 與 /script/{sessionId} endpoints。開發者現在可以把 JavaScript function 連同 Playwright、Puppeteer 或原始 Chrome DevTools Protocol(CDP)選項送進單一 API request,由隔離的 Worker 連到瀏覽器 session 執行,不必先部署一個專門驅動瀏覽器的 Worker。Cloudflare 同時在 Browser Run changelog 與 Custom scripts 文件列出完整介面,屬於可直接查證的產品更新。

這對網站驗收、定時擷取、後台重複操作與 agent 工具很有吸引力:團隊可先在 dashboard 的 Script Studio 對 live browser 試腳本,再透過 REST API 或 browser binding 執行。但它不是把既有 Playwright test 原封不動貼上去就完成雲端化。session 關閉、目標網站權限、對外連線、憑證、重試與執行結果保存,仍需要應用層治理。

兩個 endpoint 解決不同工作

POST /script 會取得一個 browser session、執行 function,並在 response headers 回傳 cf-browser-session-id 與 cf-browser-target-id;JSON 可序列化的 return value 會包在成功結果中。適合一次性任務,例如打開狀態頁、取得標題與指定欄位,完成後立即關閉。

POST /script/{sessionId} 則在既有 session 繼續工作,可以指定 targetId 接回同一頁,也能建立多個 pages。它適合需要登入後跑多步驟、先由人工介入再續跑,或不同步驟共用 cookie 的流程。代價是應用程式要保存 session 與 target 的生命週期,還要處理 page 已關閉、session 已過期與部分步驟成功的狀態。

官方明確提醒這兩個 endpoints 不會在 script 結束後自動關閉 session;應呼叫 close API 或 browser.close(),否則要等 idle timeout。實作上應使用 try/finally 關閉一次性 session,長流程則記錄 owner、建立時間與最後活動時間,並設一個清理工作回收孤兒 session。只在 happy path 關閉,遇到 exception 時就可能持續占用資源。

Custom scripts 文件也列出幾個重要邊界:送進 endpoint 的 request body 上限為 10MiB;執行逾時會回 408;編譯錯誤、runtime exception 或永遠等不到的 promise 會回 422。從 Worker 使用 browser binding 時,HTTP error 會以 Response 回來而不是直接 throw,因此程式必須檢查 response.ok,不能只靠 catch 判定失敗。script() 目前也不支援純 local mode,使用 wrangler dev 時需 remote mode。

與自架 Playwright、Quick Actions 怎麼選

既有 CI E2E 若需要固定瀏覽器版本、內網環境、測試 fixture 與逐步 trace,自架 runner 或 CI browser 通常更容易重現。它的維運成本較高,卻能完整控制網路、套件與 artifact。不要因為 /script 少一個部署步驟,就把所有 unit、integration 與 E2E 測試搬進外部服務。

只要截圖、PDF、Markdown、links 或結構化頁面資料時,Browser Run Quick Actions 比自訂 script 更小、更容易限制輸入輸出。遇到登入、互動元件、多頁流程或網站沒有適合的單一 action,才用 Playwright/Puppeteer script。若極度在意 payload 與相依套件,也可用較薄的 CDP runner,但團隊要自己處理較低階的事件與命令。

需要完全掌控資料落地、存取內部主機,或受法遵限制不能把頁面內容送到第三方環境時,仍應自架瀏覽器。若需求是公開網站的彈性自動化、尖峰併發與少量客製動作,託管 Browser Run 能降低 browser fleet 維運。選擇前應用自己的 session 數、執行時間與錄影需求查閱當下方案,不猜固定成本。

把 script 當成高權限程式碼

瀏覽器可讀 cookie、表單、頁面內容,也能向外發 request。若 script 或 URL 來自使用者輸入,必須防範 SSRF、資料外洩與任意操作。不要讓一般使用者直接提交未審核 JavaScript;把可執行流程做成版本化模板,只開放經驗證的參數,並限制可選 action。

Cloudflare Browser Run guardrails 可用 allowedDomains 限制 HTTP/HTTPS host;空陣列甚至能完全禁止外部 request。對帳務後台自動化,allowlist 應只包含目標網域與確實需要的 CDN/API host,而不是開放整個網際網路。官方文件顯示被擋 request 會回 403,並帶 cf-mitigated: guardrails 與原因 header;驗收時應主動請求一個未允許網域,確認政策真的生效。

API token 放在 secret store,不進 script body、log 或錄影。登入憑證優先使用短效 token 或專用低權限帳號;若只能用密碼,禁止把值回傳在 script result。Session Recording 與 Live View 也可能看到敏感資料,啟用前要定義誰能查看、保存多久,以及測試環境是否使用遮罩資料。

建議用一個可回放的小流程試點

先選沒有付款、刪除或對外發布效果的公開頁面流程,例如每天檢查三個關鍵頁面的標題與特定按鈕。用 Script Studio 確認 selector 與回傳 JSON,再把 script 存進版本控制,由 CI 部署呼叫端。每次執行記錄 script version、target URL、session ID、開始/結束時間、結果摘要與 error code,不保存不必要的完整頁面。

接著測試 DNS 失敗、selector 消失、登入過期、403、408、422、session 關閉與重複觸發。對會寫入資料的步驟加 idempotency key 或執行前查詢,避免重試重複送單。Finally cleanup、domain guardrails 與失敗告警都通過後,才擴大到需要登入的內部流程。

/script 的價值是讓客製 browser automation 變成可直接呼叫的託管能力,不是消除瀏覽器自動化的風險。若團隊能把 script 來源、session、網路出口與憑證都收斂成明確邊界,它很適合做少量但難以用單一 Quick Action 表達的工作;若任何使用者都能自由提交程式與網址,便利性反而會迅速變成新的高權限執行面。