chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ chrome.mimeHandler API เพื่อจัดการสตรีมประเภท MIME ในส่วนขยายของบุคคลที่สาม

ความพร้อมใช้งาน

Chrome 151 ขึ้นไป

ประเภท

MimeHandlerOptions

พร็อพเพอร์ตี้

  • canEmbed

    บูลีน ไม่บังคับ

    Chrome 157 ขึ้นไป

    ใช้เครื่องจัดการนี้สำหรับการโหลดแบบฝัง (iframe, embed, object) ได้หรือไม่ ค่าเริ่มต้นจะเป็นค่า can_embed ของรายการไฟล์ Manifest ไม่มีผลขณะที่ enabled เป็นเท็จ

  • เปิดอยู่

    บูลีน ไม่บังคับ

    ตัวแฮนเดิลนี้เปิดใช้อยู่หรือไม่ ค่าเริ่มต้นจะเป็นค่า enabled ของรายการไฟล์ Manifest

StreamInfo

พร็อพเพอร์ตี้

  • แบบฝัง

    บูลีน

    เป็นจริงหากโหลดในบริบทที่ฝัง (iframe/embed/object)

  • mimeType

    สตริง

    ประเภท MIME ของเนื้อหาที่ถูกสกัดกั้น

  • originalUrl

    สตริง

    URL ต้นทางที่ผู้ใช้ไป

  • responseHeaders

    ออบเจ็กต์

    ส่วนหัวการตอบกลับ HTTP เป็นคู่คีย์-ค่า

  • streamUrl

    สตริง

    URL สำหรับดึงข้อมูลสตรีม

  • tabId

    ตัวเลข

    รหัสแท็บที่มีเอกสาร

เมธอด

abortAndFallbackToNativeHandler()

Promise 
chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

ยกเลิกการจัดการสตรีมปัจจุบันและส่งต่อเนื้อหาไปยังเครื่องมือจัดการแบบเนทีฟของ User Agent หลังจากเรียกใช้แล้ว เฟรมส่วนขยายจะถูกทำลาย ผู้เรียกไม่ควรคาดหวังให้มีการดำเนินการเพิ่มเติม

พารามิเตอร์

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getMimeHandlerOptions()

Promise 
chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

อ่านตัวเลือกสำหรับประเภท MIME สมาชิกแต่ละคนคือค่าที่ส่วนขยายตั้งค่าไว้ หรือค่าของรายการไฟล์ Manifest หากส่วนขยายไม่ได้ตั้งค่าไว้

พารามิเตอร์

  • mimeType

    สตริง

    ประเภท MIME ที่จะอ่านตัวเลือก โดยต้องเป็นประเภท MIME ที่ส่วนขยายจัดการผ่าน mime_types_handler

  • callback

    function ไม่บังคับ

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

    (options: MimeHandlerOptions) => void

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

  • Promise ได้รับการแก้ไขด้วยตัวเลือกสำหรับประเภท MIME

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getStreamInfo()

Promise 
chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

เรียกดูข้อมูลสตรีมสำหรับบริบทของเครื่องจัดการ MIME ปัจจุบัน ต้องเรียกจากภายในหน้าส่วนขยายเครื่องจัดการ MIME

พารามิเตอร์

  • callback

    function ไม่บังคับ

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

    (info: StreamInfo) => void

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

  • Promise<StreamInfo>

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

setMimeHandlerOptions()

Promise 
chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

ตั้งค่าตัวเลือกการกำหนดค่าสำหรับประเภท MIME ที่ระบุ หากส่วนขยายทำงานในโหมดไม่ระบุตัวตนแบบแยก ตัวเลือกที่ตั้งค่าจากโหมดไม่ระบุตัวตนจะมีผลกับโหมดไม่ระบุตัวตนเท่านั้น และจะคงอยู่จนกว่าเซสชันไม่ระบุตัวตนจะสิ้นสุดลง ตัวเลือกที่ไม่ได้ตั้งค่าจากโหมดไม่ระบุตัวตนจะเป็นไปตามค่าที่ตั้งไว้นอกโหมดไม่ระบุตัวตน

พารามิเตอร์

  • mimeType

    สตริง

    ประเภท MIME ที่จะกำหนดค่า โดยต้องเป็นประเภท MIME ที่ส่วนขยายจัดการผ่าน mime_types_handler

  • ตัวเลือก

    MimeHandlerOptions

    ตัวเลือกที่จะเปลี่ยนแปลง

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    ระบบจะดำเนินการตามสัญญาเมื่อตั้งค่าการกำหนดค่าแล้ว

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback