Hướng dẫn tương thích
Manifest V2 và Manifest V3: mỗi phiên bản Chrome cài được gì
Từ Chrome 87 đến 156, theo dòng phiên bản để thấy khi nào mỗi định dạng tiện ích hoạt động, khi nào ngừng hoạt động và cần kiểm tra gì trước khi tải phiên bản cũ.
Manifest V2 và Manifest V3 là gì
- Manifest V2
- Định dạng tiện ích Chrome cũ. Tiện ích chạy bằng trang nền luôn hoạt động và có thể chặn, sửa đổi trực tiếp các yêu cầu mạng. Chrome đang loại bỏ dần định dạng này.
- Manifest V3
- Định dạng hiện tại, được hỗ trợ từ Chrome 88. Nền chuyển thành service worker chỉ khởi động khi cần, việc lọc mạng dùng quy tắc khai báo (declarativeNetRequest) và quyền hạn chặt chẽ hơn.
Tệp manifest.json của mỗi tiện ích ghi rõ định dạng nó dùng; bên dưới viết tắt là MV2 và MV3.
Manifest V2 biến mất
Trình duyệt không còn bất kỳ công tắc hay chính sách MV2 nào; mọi cách đều bị từ chối. MV3 không có giới hạn trên — chạy từ 88 đến 156, phiên bản mới nhất chúng tôi thử. Rủi ro duy nhất còn lại là trình duyệt quá cũ.
156Phiên bản mới nhất đã thử: MV2 bị từ chối hoàn toàn, MV3 chạy.Đo thực tế151Tất cả tùy chọn dòng lệnh đã bị gỡ.Đo thực tế
MV2 bị từ chối
Với người dùng thông thường, MV2 đã chấm dứt: việc cài đặt bị từ chối và không thể bật lại; chế độ nhà phát triển và “Tải tiện ích đã giải nén” đều không giúp được. Chỉ chính sách doanh nghiệp (đến 138) và tùy chọn dòng lệnh (đến 150) còn giữ được nó.
150Phiên bản cuối cùng tùy chọn dòng lệnh còn hoạt động (cần bật lại thêm một lần).Đo thực tế139Chính sách doanh nghiệp ExtensionManifestV2Availability bị gỡ bỏ.Đo thực tế137MV2 bị từ chối theo mặc định; không thể bật lại.Đo thực tế
MV2 bị tắt theo mặc định
Tiện ích MV2 vẫn cài được nhưng ở trạng thái tắt (unsupportedManifestVersion). Người dùng có thể bật lại tại chrome://extensions và tiện ích chạy bình thường. Google triển khai dần từ tháng 10/2024, nên một số người dùng gặp muộn hơn.
thg 10 2024Google bắt đầu triển khai dần cho người dùng.Tài liệu Chrome129Giá trị mặc định trong mã bắt đầu tắt MV2.Đo thực tế
Hai định dạng song hành, MV3 dần hoàn thiện
Cả MV2 và MV3 đều chạy — giai đoạn dễ dãi nhất. Các API MV3 mới lần lượt xuất hiện; tiện ích dùng chúng mà không khai báo phiên bản tối thiểu vẫn cài được trên trình duyệt cũ, nhưng các tính năng đó không hoạt động.
127–128MV2 vẫn chạy; Chrome bắt đầu cảnh báo về việc dừng MV2 trên trang tiện ích.Đo thực tế120Có quyền userScripts (người dùng cũng phải bật).Tài liệu Chrome114Có sidePanel.Đo thực tế109Có API offscreen; các bản trước cài và chạy được, nhưng lệnh gọi thất bại.Đo thực tếthg 1 2022Cửa hàng Chrome trực tuyến ngừng nhận tiện ích MV2 mới (chính sách cửa hàng, không phải thay đổi của trình duyệt).Chính sách cửa hàng96Có quyền declarativeNetRequestWithHostAccess.Tài liệu Chrome92Nền mô-đun ES bắt đầu chạy.Đo thực tế
MV3 lên bản ổn định
Từ Chrome 88, tiện ích MV3 cài và chạy được. Nhưng nền viết dưới dạng mô-đun ES ("type": "module") vẫn cài được mà không bao giờ chạy cho đến bản 92.
88–91Nền mô-đun hiện kèm service worker nhưng không bao giờ khởi động.Đo thực tế88MV3 cơ bản: cài đặt, bật và chạy nền đều được.Đo thực tế
Thời chỉ có MV2
Manifest V2 là định dạng ổn định duy nhất. Tiện ích MV3 cài được và trông như đã bật trên Chrome ổn định, nhưng tập lệnh nền không bao giờ chạy — lỗi khó nhận ra nhất.
87Bản ổn định 87 chỉ chấp nhận tối đa manifest_version 2; nền service_worker chỉ có trên kênh Dev.Mã nguồn
Từ Chrome 137, MV2 bị từ chối và người dùng thông thường không có cách nào vượt qua.
Chrome 129–136 tự động tắt tiện ích MV2, nhưng người dùng vẫn có thể bật lại.
MV3 cần Chrome 88 trở lên; trình duyệt cũ hơn cài được nhưng không bao giờ chạy.
Nếu trình duyệt cũ hơn minimum_chrome_version trong tệp kê khai, việc kéo vào trang tiện ích, tải tiện ích đã giải nén và cài qua chính sách đều bị từ chối.
Trước khi tải phiên bản cũ
- Kiểm tra phiên bản manifest: trên Chrome 137 trở lên, chỉ chọn MV3.
- Kiểm tra phiên bản tối thiểu: thấp hơn mức đó, việc cài đặt bị từ chối.
- Với trình duyệt cũ, chọn phiên bản tương thích mới nhất hoặc cập nhật trước.
Phương pháp và giới hạn
Thử nghiệm ngày 18 thg 10, 2026 trên Linux với Chrome for Testing 113–156 và bản chụp Chromium 87–112, dùng tiện ích thử nghiệm cùng Google Translate 2.0.13 / 2.0.18 và AdBlock thật để phân biệt “đã cài”, “đã bật” và “nền thực sự chạy”; đường cài CRX được kiểm tra bằng cài đặt bắt buộc qua chính sách doanh nghiệp. Chrome for Testing không triển khai dần, nên các phiên bản trên cho biết khi nào mã có hiệu lực — người dùng thật có thể thấy thay đổi muộn hơn. Không bao gồm Windows, Mac, Edge và các trình duyệt Chromium khác. Ngày sau bản 150 được ước tính theo chu kỳ phát hành bốn tuần của Chrome.
Edge và các trình duyệt Chromium khác có lịch riêng; chưa được thử ở đây.