chrome.mimeHandler

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

  • đang bật

    boolean

    Trình xử lý này có hoạt động cho loại MIME đã cho hay không.

StreamInfo

Thuộc tính

  • được nhúng

    boolean

    True nếu được tải trong một 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 ban đầu mà người dùng đã truy cập.

  • 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ỷ; người gọi không nên mong đợi quá trình thực thi tiếp theo.

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>

    Các promise 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 được duy trì cho một loại MIME. Trả về giá trị mặc định (enabled=true) nếu chưa có giá trị nào được lưu trữ.

Thông số

  • mimeType

    chuỗi

    Loại MIME có các lựa chọn để đọc.

  • 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 được duy trì cho loại MIME.

    Các promise 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ề

  • Promise<StreamInfo>

    Các promise 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 lựa chọn cấu hình cho một loại MIME cụ thể.

Thông số

  • mimeType

    chuỗi

    Loại MIME cần định cấu hình.

  • tùy chọn

    MimeHandlerOptions

    Các lựa chọn mới để sử dụng.

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Promise được giải quyết khi cấu hình đã được thiết lập.

    Các promise 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.