chrome.pageCapture

คำอธิบาย

ใช้ chrome.pageCapture API เพื่อบันทึกแท็บเป็น MHTML

MHTML คือรูปแบบมาตรฐานที่เบราว์เซอร์ส่วนใหญ่รองรับ โดยรวมหน้าและทรัพยากรทั้งหมดของหน้า (ไฟล์ CSS, รูปภาพ..) ไว้ในไฟล์เดียว

โปรดทราบว่าไฟล์ MHTML จะโหลดได้จากระบบไฟล์เท่านั้นเพื่อความปลอดภัย และจะโหลดได้ในเฟรมหลักเท่านั้น

สิทธิ์

pageCapture

คุณต้องประกาศสิทธิ์ "pageRecording" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ pageCapture API เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "pageCapture"
  ],
  ...
}

วิธีการ

saveAsMHTML()

สัญญา 
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

บันทึกเนื้อหาของแท็บที่มีรหัสที่ระบุเป็น MHTML

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • tabId

      ตัวเลข

      รหัสของแท็บที่จะบันทึกเป็น MHTML

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (mhtmlData?: ArrayBuffer)=>void

    • mhtmlData

      ArrayBuffer ไม่บังคับ

      ข้อมูล MHTML ในรูปแบบ Blob

การคืนสินค้า

  • คำสัญญา<ArrayBuffer|undefined>

    Chrome 116 ขึ้นไป

    Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ