chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.mimeHandler để xử lý các luồng loại MIME trong tiện ích của bên thứ ba.

Phạm vi cung cấp

Chrome 151 trở lên

Loại

MimeHandlerOptions

Thuộc tính

  • canEmbed

    boolean không bắt buộc

    Chrome 157 trở lên

    Liệu trình xử lý này có thể được dùng cho các lượt tải được nhúng (iframe, nhúng, đối tượng) hay không. Giá trị mặc định là giá trị can_embed của mục nhập tệp kê khai. Không có hiệu lực khi enabled là false.

  • đang bật

    boolean không bắt buộc

    Liệu trình xử lý này có được bật hay không. Giá trị mặc định là giá trị enabled của mục nhập tệp kê khai.

StreamInfo

Thuộc tính

  • được nhúng

    boolean

    Đúng nếu được tải trong bối cảnh được nhúng (iframe/embed/object).

  • mimeType

    chuỗi

    Loại MIME của nội dung bị chặn.

  • originalUrl

    chuỗi

    URL gốc mà người dùng đã chuyển đến.

  • responseHeaders

    đối tượng

    Tiêu đề phản hồi HTTP dưới dạng cặp khoá-giá trị.

  • streamUrl

    chuỗi

    URL để tìm nạp dữ liệu luồng.

  • tabId

    số

    Mã thẻ chứa tài liệu.

Phương thức

abortAndFallbackToNativeHandler()

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

Huỷ bỏ quá trình xử lý luồng hiện tại và chuyển nội dung cho trình xử lý gốc của tác nhân người dùng. Sau lệnh gọi này, khung tiện ích sẽ bị huỷ; phương thức gọi không nên thực thi thêm.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getMimeHandlerOptions()

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

Đọc các lựa chọn cho một loại MIME. Mỗi thành viên là giá trị mà tiện ích đặt hoặc giá trị của mục nhập tệp kê khai nếu tiện ích chưa đặt giá trị đó.

Thông số

  • mimeType

    chuỗi

    Loại MIME có các tuỳ chọn để đọc. Đây phải là loại MIME mà tiện ích xử lý thông qua mime_types_handler.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (options: MimeHandlerOptions) => void

Giá trị trả về

  • Lời hứa được giải quyết bằng các lựa chọn cho loại MIME.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getStreamInfo()

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

Truy xuất thông tin luồng cho bối cảnh trình xử lý MIME hiện tại. Phải được gọi từ trong trang tiện ích trình xử lý MIME.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (info: StreamInfo) => void

Giá trị trả về

  • <StreamInfo> hứa hẹn

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setMimeHandlerOptions()

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

Đặt các tuỳ chọn cấu hình cho một loại MIME được chỉ định. Nếu tiện ích chạy ở chế độ ẩn danh phân tách, thì các tuỳ chọn được đặt từ chế độ ẩn danh chỉ áp dụng cho chế độ ẩn danh và kéo dài cho đến khi phiên truy cập ẩn danh kết thúc. Các lựa chọn không được đặt ở chế độ ẩn danh sẽ tuân theo các giá trị được đặt bên ngoài chế độ ẩn danh.

Thông số

  • mimeType

    chuỗi

    Loại MIME cần định cấu hình. Đây phải là loại MIME mà tiện ích xử lý thông qua mime_types_handler.

  • tùy chọn

    MimeHandlerOptions

    Các lựa chọn để thay đổi.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Lời hứa được thực hiện khi cấu hình đã được thiết lập.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.