Ngày xuất bản: Ngày 8 tháng 9 năm 2026, Lần cập nhật gần đây nhất: Ngày 4 tháng 11 năm 2026
Kể từ Chrome 155, Chrome sẽ cập nhật cách áp dụng các quy định hạn chế trong chính sách doanh nghiệp cho các tiện ích sử dụng API chrome.debugger.
Thay đổi này chỉ ảnh hưởng đến các tiện ích chạy trên trình duyệt được quản lý, trong đó quản trị viên đã định cấu hình rõ ràng runtime_blocked_hosts, DisableScreenshots hoặc các quy tắc Ngăn chặn mất dữ liệu (DLP).
Nếu một tiện ích chạy trên trình duyệt không được quản lý hoặc trong môi trường doanh nghiệp không có các quy định hạn chế cụ thể này theo chính sách, thì chrome.debugger sẽ tiếp tục hoạt động bình thường mà không có thay đổi nào.
Tiến trình và kế hoạch triển khai
- Chrome 155 Beta: Ngày 16 tháng 9 năm 2026
- Ngày phát hành bản Chrome 155 ổn định: Ngày 6 tháng 10 năm 2026
- Ngày huỷ bỏ: Ngày 3 tháng 11 năm 2026
Những thay đổi quan trọng trong Chrome 155
Những thay đổi sau đây chỉ ảnh hưởng đến các trình duyệt do doanh nghiệp quản lý:
Hạn chế về máy chủ lưu trữ: Nếu một chính sách doanh nghiệp (
ExtensionSettings) định cấu hình danh sách máy chủ lưu trữ bị chặn không trống (runtime_blocked_hosts) cho một tiện ích, thìchrome.debugger.attach()sẽ bị từ chối trên tất cả các mục tiêu có:"Host access is restricted by policy."Điều này xảy ra ngay cả khi các nguồn gốc cụ thể được đưa vào
runtime_allowed_hosts.Các quy định hạn chế về ảnh chụp màn hình và DLP: Nếu tính năng chụp ảnh màn hình bị vô hiệu hoá theo chính sách của doanh nghiệp (
DisableScreenshotshoặc quy tắc Ngăn chặn mất dữ liệu (DLP)), thìchrome.debugger.attach()sẽ không thành công và có thông báo:"Screenshot capture is restricted by policy."
Hồ sơ cá nhân và môi trường không được quản lý vẫn có quyền truy cập không hạn chế vào chrome.debugger như trước đây.
API chrome.debugger cấp quyền truy cập trực tiếp vào Giao thức Chrome DevTools (CDP) để có các chức năng mạnh mẽ, bao gồm cả việc đánh giá tập lệnh tuỳ ý và chặn mạng. Vì CDP hoạt động bên dưới mô hình nguồn gốc của nền tảng web, nên tính năng lọc dựa trên nguồn gốc không thể hạn chế CDP một cách an toàn. Do đó, Chrome 155 giải quyết vấn đề này bằng mô hình tất cả hoặc không có gì, xác thực trước các chính sách doanh nghiệp trên mỗi lệnh gọi chrome.debugger.attach().
Hành động được đề xuất cho nhà phát triển
Xử lý khéo léo khi bị từ chối đính kèm
Luôn xử lý các trường hợp từ chối đính kèm trong mã tiện ích để đưa ra ý kiến phản hồi rõ ràng cho người dùng doanh nghiệp:
// 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);
}
});
Cân nhắc các API cấp cao thay thế
Nếu tiện ích của bạn không nhất thiết phải có quyền truy cập trực tiếp vào CDP, hãy cân nhắc chuyển sang các API tiện ích cấp cao hơn hỗ trợ quyền chi tiết của máy chủ lưu trữ và hoạt động cùng với danh sách cho phép và danh sách chặn của máy chủ lưu trữ doanh nghiệp:
- Sử dụng API
chrome.scriptingđể thực thi tập lệnh và chèn kiểu vào các trang được phép. - Sử dụng API
chrome.declarativeNetRequestđể kiểm tra, sửa đổi hoặc chặn các yêu cầu mạng một cách khai báo. - Sử dụng API
chrome.cookiescó quyền của máy chủ lưu trữ tiêu chuẩn.
Hướng dẫn dành cho quản trị viên doanh nghiệp
Thông tin cập nhật (ngày 4 tháng 11 năm 2026): Việc thực thi chính sách của Chrome 155 đã được khôi phục thông qua một bản cập nhật cấu hình phía máy chủ. Chrome sẽ tự động tải bản cập nhật này xuống và áp dụng sau khi khởi động lại. Để tắt việc thực thi mà không cần chờ bản cập nhật này, hãy chạy Chrome bằng cờ hiệu dòng lệnh --disable-features=ExtensionDebuggerStrictPolicyRestrictions.
Cho đến khi việc huỷ bỏ có hiệu lực, hướng dẫn sau đây vẫn được áp dụng.
Quản trị viên doanh nghiệp quản lý chính sách tiện ích cần lưu ý rằng các tiện ích yêu cầu quyền trình gỡ lỗi không thể hoạt động khi có các quy định hạn chế một phần đối với máy chủ lưu trữ (runtime_blocked_hosts). Nếu cần chrome.debugger, tiện ích không được có máy chủ lưu trữ bị chặn được định cấu hình trong ExtensionSettings.
Nếu tính năng chụp ảnh màn hình bị tắt bằng DisableScreenshots hoặc quy tắc Ngăn chặn mất dữ liệu (DLP), thì chrome.debugger.attach() sẽ không thành công.
Những tổ chức yêu cầu danh sách chặn máy chủ lưu trữ hoặc quy định hạn chế về ảnh chụp màn hình nên xác minh xem các tiện ích nội bộ hoặc tiện ích được phê duyệt của họ có thể di chuyển sang các API cấp cao hơn như chrome.scripting hoặc chrome.declarativeNetRequest hay không.
Chia sẻ ý kiến phản hồi
Để biết thêm thông tin, hãy tham khảo tài liệu về API chrome.debugger. Nếu bạn có câu hỏi hoặc ý kiến phản hồi, hãy liên hệ qua nhóm trên Google Groups về Tiện ích Chromium.