發布日期:2026 年 9 月 8 日,上次更新日期:2026 年 11 月 4 日
自 Chrome 155 起,Chrome 會更新企業政策限制對使用 chrome.debugger API 的擴充功能套用的方式。
這項異動只會影響在受管理瀏覽器上執行的擴充功能,且管理員必須明確設定 runtime_blocked_hosts、DisableScreenshots 或資料遺失防護 (DLP) 規則。
如果擴充功能在非受管瀏覽器上執行,或在沒有這些特定政策限制的企業環境中執行,chrome.debugger 會繼續正常運作,不會有任何異動。
時間表和推出
- Chrome 155 Beta:2026 年 9 月 16 日
- Chrome 155 穩定版推出日期:2026 年 10 月 6 日
- 復原:2026 年 11 月 3 日
Chrome 155 的主要異動
下列異動只會影響企業管理的瀏覽器:
主機限制:如果企業政策 (
ExtensionSettings) 為擴充功能設定了非空白的封鎖主機清單 (runtime_blocked_hosts),則chrome.debugger.attach()會在所有目標上遭到拒絕,並顯示以下訊息:"Host access is restricted by policy."即使
runtime_allowed_hosts包含特定來源,也是如此。螢幕截圖和資料遺失防護 (DLP) 限制:如果企業政策 (
DisableScreenshots或資料遺失防護 (DLP) 規則) 停用螢幕截圖功能,chrome.debugger.attach()會失敗並顯示以下訊息:"Screenshot capture is restricted by policy."
個人資料夾和非受管環境則與以往一樣,可不受限制地存取 chrome.debugger。
chrome.debugger API 可直接存取 Chrome 開發人員工具通訊協定 (CDP),提供強大功能,包括任意指令碼評估和網路攔截。CDP 的運作層級低於網路平台的來源模型,因此無法透過來源篩選機制安全地限制 CDP。Chrome 155 採用全有或全無模型解決這個問題,在每次 chrome.debugger.attach() 呼叫時預先驗證企業政策。
建議開發人員採取的行動
妥善處理附加拒絕
請務必在擴充功能程式碼中處理附加拒絕,向企業版使用者提供明確的回饋:
// Promise-based (Manifest V3)
try {
await chrome.debugger.attach({ tabId }, "1.3");
} catch (error) {
if (error.message.includes("Host access is restricted by policy")) {
console.warn("Debugger attach blocked: Extension has host restrictions configured by enterprise policy.");
} else if (error.message.includes("Screenshot capture is restricted by policy")) {
console.warn("Debugger attach blocked: Screenshots or DLP restrictions are enforced by enterprise policy.");
} else {
console.warn("Debugger attach failed:", error.message);
}
}
// Callback-based
chrome.debugger.attach({ tabId }, "1.3", () => {
if (chrome.runtime.lastError) {
console.warn("Debugger attach failed:", chrome.runtime.lastError.message);
}
});
考慮替代的高階 API
如果擴充功能不一定需要直接存取 CDP,請考慮改用支援精細主機權限,且可與企業主機許可清單和封鎖清單搭配運作的高階擴充功能 API:
- 使用
chrome.scriptingAPI 執行指令碼,並在允許的網頁中插入樣式。 - 使用
chrome.declarativeNetRequestAPI,以宣告方式檢查、修改或封鎖網路要求。 - 使用
chrome.cookiesAPI 搭配標準主機權限。
企業管理員指南
更新 (2026 年 11 月 4 日):Chrome 155 政策強制執行措施已透過伺服器端設定更新復原,Chrome 會自動下載並在重新啟動後套用。如要停用強制執行,不必等待這項更新,請使用 --disable-features=ExtensionDebuggerStrictPolicyRestrictions 指令列旗標啟動 Chrome。
在復原生效前,下列指南仍適用。
企業管理員管理擴充功能政策時,請注意需要偵錯工具權限的擴充功能無法在部分主機限制 (runtime_blocked_hosts) 下運作。如果擴充功能需要 chrome.debugger,則不得在 ExtensionSettings 中設定封鎖的主機。
如果使用 DisableScreenshots 或資料遺失防護 (DLP) 規則停用螢幕截圖擷取功能,chrome.debugger.attach() 將會失敗。
如果貴機構需要主機封鎖清單或螢幕截圖限制,請確認內部或核准的擴充功能是否能遷移至較高層級的 API,例如 chrome.scripting 或 chrome.declarativeNetRequest。
提供意見
詳情請參閱 chrome.debugger API 說明文件。如有問題或意見回饋,請前往 Chromium 擴充功能 Google 群組。