chrome.extensionTypes

Nội dung mô tả

API chrome.extensionTypes chứa các phần khai báo loại cho các tiện ích của Chrome.

Loại

CSSOrigin

Chrome 66 trở lên

Nguồn gốc của CSS được chèn.

Liệt kê

"author"

DeleteInjectionDetails

Chrome 87 trở lên

Thông tin chi tiết về CSS cần xoá. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không thể đặt cả hai cùng một lúc.

Thuộc tính

  • allFrames

    boolean không bắt buộc

    Nếu allFrames là true, ngụ ý rằng CSS cần được xoá khỏi tất cả các khung của trang hiện tại. Theo mặc định, đó là false và chỉ bị xoá khỏi khung trên cùng. Nếu bạn thiết lập true và frameId, thì mã sẽ bị xoá khỏi khung đã chọn và tất cả các khung con của khung đó.

  • mã

    chuỗi không bắt buộc

    Mã CSS cần xoá.

  • cssOrigin

    CSSOrigin không bắt buộc

    Nguồn gốc của CSS cần xoá. Giá trị mặc định là "author".

  • tệp

    chuỗi không bắt buộc

    CSS cần xoá.

  • frameId

    số không bắt buộc

    Khung mà tại đó CSS cần được xoá. Giá trị mặc định là 0 (khung cấp cao nhất).

  • matchAboutBlank

    boolean không bắt buộc

    Nếu matchAboutBlank là true thì mã cũng sẽ bị xoá khỏi khung khoảng:blank và about:srcdoc nếu tiện ích của bạn có quyền truy cập vào tài liệu gốc. Theo mặc định, giá trị này là false.

DocumentLifecycle

Chrome 106 trở lên

Vòng đời của tài liệu của khung.

Liệt kê

ExecutionWorld

Chrome 111 trở lên

Thế giới JavaScript để thực thi một tập lệnh. Có thể là thế giới riêng biệt đối với tiện ích này, thế giới chính của DOM được chia sẻ với JavaScript của trang hoặc thế giới tập lệnh người dùng chỉ có sẵn cho các tập lệnh được đăng ký bằng API Tập lệnh người dùng.

Liệt kê

"USER_SCRIPT"

FrameType

Chrome 106 trở lên

Loại khung.

Liệt kê

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

Thông tin chi tiết về định dạng và chất lượng của một hình ảnh.

Thuộc tính

  • định dạng

    ImageFormat không bắt buộc

    Định dạng của hình ảnh thu được. Mặc định là "jpeg".

  • chất lượng

    số không bắt buộc

    Khi định dạng là "jpeg", bạn sẽ kiểm soát chất lượng của hình ảnh thu được. Giá trị này bị bỏ qua đối với hình ảnh PNG. Khi chất lượng giảm, hình ảnh thu được sẽ có nhiều cấu phần phần mềm trực quan hơn và số byte cần lưu trữ sẽ giảm.

ImageFormat

Chrome 44 trở lên

Định dạng của hình ảnh.

Liệt kê

"jpeg"

"png"

InjectDetails

Thông tin chi tiết về tập lệnh hoặc CSS cần chèn. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không thể đặt cả hai cùng một lúc.

Thuộc tính

  • allFrames

    boolean không bắt buộc

    Nếu allFrames là true, ngụ ý rằng JavaScript hoặc CSS phải được chèn vào tất cả các khung của trang hiện tại. Theo mặc định, giá trị này là false và chỉ được chèn vào khung trên cùng. Nếu bạn thiết lập true và frameId, thì mã sẽ được chèn vào khung đã chọn và tất cả các khung con của khung đó.

  • mã

    chuỗi không bắt buộc

    Mã JavaScript hoặc CSS cần chèn.

    Cảnh báo: Hãy cẩn thận khi sử dụng tham số code. Việc sử dụng sai cách có thể khiến tiện ích của bạn gặp phải các cuộc tấn công viết tập lệnh trên nhiều trang web

  • cssOrigin

    CSSOrigin không bắt buộc

    Chrome 66 trở lên

    Nguồn gốc của CSS sẽ chèn. Chỉ có thể chỉ định URL này cho CSS, chứ không thể chỉ định cho JavaScript. Giá trị mặc định là "author".

  • tệp

    chuỗi không bắt buộc

    Tệp JavaScript hoặc CSS cần chèn.

  • frameId

    số không bắt buộc

    Chrome 50 trở lên

    Khung mà tập lệnh hoặc CSS sẽ được chèn vào. Giá trị mặc định là 0 (khung cấp cao nhất).

  • matchAboutBlank

    boolean không bắt buộc

    Nếu matchAboutBlank là true thì mã cũng được đưa vào khung about:blank và about:srcdoc nếu tiện ích của bạn có quyền truy cập vào tài liệu gốc. Không thể chèn mã vào cấp cao nhất khoảng:-frames. Theo mặc định, giá trị này là false.

  • runAt

    RunAt không bắt buộc

    Thời gian sớm nhất để JavaScript hoặc CSS được đưa vào thẻ. Giá trị mặc định là "document_idle".

RunAt

Chrome 44 trở lên

Thời gian sớm nhất để JavaScript hoặc CSS được đưa vào thẻ.

Liệt kê

"document_start"
Tập lệnh được chèn vào sau bất kỳ tệp nào từ css, nhưng trước khi bất kỳ DOM nào khác được tạo hoặc bất kỳ tập lệnh nào khác chạy.

"document_end"
Tập lệnh được chèn ngay sau khi DOM hoàn tất, nhưng trước khi các tài nguyên phụ như hình ảnh và khung được tải.

"document_idle"
Trình duyệt chọn thời điểm để chèn tập lệnh trong khoảng thời gian từ "document_end" đến ngay sau khi sự kiện window.onload kích hoạt. Thời điểm chèn chính xác phụ thuộc vào độ phức tạp của tài liệu cũng như thời gian tải và thời điểm tải, đồng thời được tối ưu hoá cho tốc độ tải trang. Các tập lệnh nội dung chạy tại "document_idle" không cần theo dõi sự kiện window.onload; các tập lệnh này được đảm bảo chạy sau khi DOM hoàn tất. Nếu một tập lệnh chắc chắn cần chạy sau window.onload, thì tiện ích này có thể kiểm tra xem onload đã kích hoạt hay chưa bằng cách sử dụng thuộc tính document.readyState.