คู่มือความเข้ากันได้
Manifest V2 และ Manifest V3: Chrome แต่ละเวอร์ชันติดตั้งอะไรได้บ้าง
ตั้งแต่ Chrome 87 ถึง 156 ไล่ตามเส้นเวอร์ชันเพื่อดูว่ารูปแบบส่วนขยายแต่ละแบบใช้ได้เมื่อใด ใช้ไม่ได้เมื่อใด และควรตรวจอะไรก่อนดาวน์โหลดเวอร์ชันเก่า
Manifest V2 และ Manifest V3 คืออะไร
- Manifest V2
- รูปแบบส่วนขยาย Chrome แบบเก่า ส่วนขยายทำงานด้วยหน้าเบื้องหลังที่ทำงานตลอดเวลา และดักจับหรือแก้ไขคำขอเครือข่ายได้โดยตรง Chrome กำลังเลิกใช้รูปแบบนี้
- Manifest V3
- รูปแบบปัจจุบัน รองรับตั้งแต่ Chrome 88 เบื้องหลังเปลี่ยนเป็น service worker ที่เริ่มทำงานเมื่อจำเป็น การกรองเครือข่ายใช้กฎแบบประกาศ (declarativeNetRequest) และสิทธิ์เข้มงวดขึ้น
ไฟล์ manifest.json ของส่วนขยายแต่ละตัวระบุว่าใช้รูปแบบใด ด้านล่างจะเรียกย่อว่า MV2 และ MV3
Manifest V2 หายไปแล้ว
เบราว์เซอร์ไม่มีสวิตช์หรือนโยบายของ MV2 เหลืออยู่ ทุกวิธีถูกปฏิเสธ MV3 ไม่มีเพดาน — ทำงานได้ตั้งแต่ 88 จนถึง 156 ซึ่งเป็นเวอร์ชันล่าสุดที่เราทดสอบ ความเสี่ยงเดียวที่เหลือคือเบราว์เซอร์ที่เก่าเกินไป
156เวอร์ชันล่าสุดที่ทดสอบ: MV2 ถูกปฏิเสธทุกกรณี MV3 ทำงานวัดจริง151สวิตช์บรรทัดคำสั่งทั้งหมดถูกนำออกวัดจริง
MV2 ถูกปฏิเสธ
สำหรับผู้ใช้ทั่วไป MV2 จบแล้ว: การติดตั้งถูกปฏิเสธและเปิดใช้ใหม่ไม่ได้ โหมดนักพัฒนาซอฟต์แวร์และ “โหลดส่วนขยายที่คลายการแพคแล้ว” ช่วยไม่ได้ มีเพียงนโยบายองค์กร (ถึง 138) และสวิตช์บรรทัดคำสั่ง (ถึง 150) ที่ยังรักษาไว้ได้
150เวอร์ชันสุดท้ายที่สวิตช์บรรทัดคำสั่งยังใช้ได้ (ต้องเปิดใช้ใหม่เพิ่มอีกครั้ง)วัดจริง139นำนโยบายองค์กร ExtensionManifestV2Availability ออกวัดจริง137MV2 ถูกปฏิเสธโดยค่าเริ่มต้น เปิดใช้ใหม่ไม่ได้วัดจริง
MV2 ถูกปิดโดยค่าเริ่มต้น
ส่วนขยาย MV2 ยังติดตั้งได้ แต่จะอยู่ในสถานะปิดใช้ (unsupportedManifestVersion) ผู้ใช้เปิดใช้อีกครั้งได้ที่ chrome://extensions แล้วจะทำงานตามปกติ Google ทยอยเปิดใช้การเปลี่ยนแปลงนี้ตั้งแต่ตุลาคม 2024 ผู้ใช้บางคนจึงเจอช้ากว่า
ต.ค. 2567Google เริ่มทยอยเปิดใช้กับผู้ใช้เอกสาร Chrome129ค่าเริ่มต้นในโค้ดเริ่มปิดใช้ MV2วัดจริง
สองรูปแบบอยู่คู่กัน MV3 ครบขึ้นเรื่อย ๆ
ทั้ง MV2 และ MV3 ใช้ได้ — เป็นช่วงที่ผ่อนปรนที่สุด API ใหม่ของ MV3 มาทีละตัว ส่วนขยายที่ใช้ API เหล่านี้โดยไม่ระบุเวอร์ชันต่ำสุดจะติดตั้งในเบราว์เซอร์เก่าได้ แต่ฟีเจอร์เหล่านั้นใช้ไม่ได้
127–128MV2 ยังทำงาน Chrome เริ่มเตือนเรื่องการเลิกใช้ MV2 ในหน้าส่วนขยายวัดจริง120ใช้สิทธิ์ userScripts ได้ (ผู้ใช้ต้องเปิดเองด้วย)เอกสาร Chrome114ใช้ sidePanel ได้วัดจริง109ใช้ API offscreen ได้ เวอร์ชันก่อนหน้าติดตั้งและทำงานได้ แต่การเรียกใช้ล้มเหลววัดจริงม.ค. 2565Chrome เว็บสโตร์หยุดรับส่วนขยาย MV2 ใหม่ (นโยบายร้านค้า ไม่ใช่การเปลี่ยนแปลงของเบราว์เซอร์)นโยบายร้านค้า96ใช้สิทธิ์ declarativeNetRequestWithHostAccess ได้เอกสาร Chrome92เบื้องหลังแบบโมดูล ES เริ่มทำงานวัดจริง
MV3 เข้าสู่เวอร์ชันเสถียร
ตั้งแต่ Chrome 88 ส่วนขยาย MV3 ติดตั้งและทำงานได้ แต่เบื้องหลังที่เขียนเป็นโมดูล ES ("type": "module") ยังติดตั้งได้โดยไม่เคยทำงานจนถึงเวอร์ชัน 92
88–91เบื้องหลังแบบโมดูลแสดงพร้อม service worker แต่ไม่เคยเริ่มทำงานวัดจริง88MV3 พื้นฐาน: ติดตั้ง เปิดใช้ และเบื้องหลังทำงานได้ทั้งหมดวัดจริง
ยุคที่มีแค่ MV2
Manifest V2 เป็นรูปแบบเสถียรเพียงแบบเดียว ส่วนขยาย MV3 ติดตั้งได้และดูเหมือนเปิดใช้อยู่ใน Chrome เวอร์ชันเสถียร แต่สคริปต์เบื้องหลังไม่เคยทำงาน — เป็นความผิดปกติที่สังเกตได้ยากที่สุด
87เวอร์ชันเสถียร 87 รับได้สูงสุดแค่ manifest_version 2 ส่วนเบื้องหลังแบบ service_worker มีเฉพาะในช่อง Devซอร์สโค้ด
ตั้งแต่ Chrome 137 MV2 ถูกปฏิเสธ และผู้ใช้ทั่วไปไม่มีทางเลี่ยง
Chrome 129–136 ปิดใช้ส่วนขยาย MV2 อัตโนมัติ แต่ผู้ใช้เปิดใช้อีกครั้งได้
MV3 ต้องใช้ Chrome 88 ขึ้นไป เบราว์เซอร์ที่เก่ากว่าติดตั้งได้แต่ไม่เคยทำงาน
ก่อนดาวน์โหลดเวอร์ชันเก่า
- ตรวจเวอร์ชัน manifest: ใน Chrome 137 ขึ้นไปให้เลือกเฉพาะ MV3
- ตรวจเวอร์ชันต่ำสุด: หากต่ำกว่านั้น การติดตั้งจะถูกปฏิเสธ
- หากเบราว์เซอร์เก่า ให้เลือกเวอร์ชันล่าสุดที่เข้ากันได้ หรืออัปเดตเบราว์เซอร์ก่อน
วิธีการและข้อจำกัด
ทดสอบเมื่อ 18 ต.ค. 2026 บน Linux ด้วย Chrome for Testing 113–156 และสแนปช็อต Chromium 87–112 โดยใช้ส่วนขยายทดสอบ และ Google Translate 2.0.13 / 2.0.18 กับ AdBlock ตัวจริง เพื่อแยก “ติดตั้งแล้ว” “เปิดใช้” และ “เบื้องหลังทำงานจริง” ส่วนเส้นทางการติดตั้ง CRX ตรวจด้วยการบังคับติดตั้งผ่านนโยบายองค์กร Chrome for Testing ไม่มีการทยอยเปิดใช้ เวอร์ชันข้างต้นจึงแสดงเวลาที่โค้ดมีผล — ผู้ใช้จริงอาจเห็นการเปลี่ยนแปลงช้ากว่านั้น ไม่ครอบคลุม Windows, Mac, Edge และเบราว์เซอร์ Chromium อื่น ๆ วันที่หลังเวอร์ชัน 150 ประมาณจากรอบการออกเวอร์ชันทุกสี่สัปดาห์ของ Chrome
Edge และเบราว์เซอร์ Chromium อื่น ๆ มีกำหนดการของตัวเอง ยังไม่ได้ทดสอบในที่นี้