chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Mô tả

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

Loại

ColorArray

Chrome 139 trở lên

Loại

[number, number, number, number]

CSSOrigin

Chrome 66 trở lên

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

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 trở lên

Thông tin chi tiết về CSS cần xoá. Bạn phải đặt thuộc tính mã hoặc tệp, nhưng không được đặ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, thì có nghĩa là CSS phải được xoá khỏi tất cả khung của trang hiện tại. Theo mặc định, giá trị này là false và chỉ bị xoá khỏi khung trên cùng. Nếu bạn đặt true và frameId, thì mã sẽ bị xoá khỏi khung đã chọn và tất 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

    Tệp CSS cần xoá.

  • frameId

    number không bắt buộc

    Khung mà CSS sẽ bị 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 các 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. Giá trị mặc định là false.

DocumentLifecycle

Chrome 106 trở lên

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

Enum

"prerender"

"đang hoạt động"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 trở lên

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

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 trở lên

Loại khung.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 trở lên

Dữ liệu pixel cho một hình ảnh. Phải là một đối tượng ImageData; ví dụ: từ phần tử canvas.

Loại

ImageData

ImageDetails

Thông tin chi tiết về định dạng, chất lượng và vùng của 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. Giá trị mặc định là "jpeg".

  • chất lượng

    number không bắt buộc

    Khi định dạng là "jpeg", hãy 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 hình ảnh hơn và số byte cần thiết để lưu trữ hình ảnh sẽ giảm.

ImageFormat

Chrome 44 trở lên

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

Enum

"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 thuộc tính mã hoặc tệp, nhưng không được đặ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, thì 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 đặt true và frameId, thì mã sẽ được chèn vào khung đã chọn và tất 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 không đúng cách có thể khiến tiện ích của bạn bị tấn công 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 cần chèn. Bạn chỉ có thể chỉ định thuộc tính 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

    number không bắt buộc

    Chrome 50 trở lên

    Khung nơi tập lệnh hoặc CSS sẽ được chèn. 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 chèn vào các 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 about:-frame cấp cao nhất. Giá trị mặc định là false.

  • runAt

    RunAt không bắt buộc

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

RunAt

Chrome 44 trở lên

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

Enum

"document_start"
Tập lệnh được chèn sau mọi tệp 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 đượ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 tải xong.

"document_idle"
Trình duyệt chọn thời điểm chèn tập lệnh giữa "document_end" và 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 mức độ phức tạp của tài liệu và thời gian tải, đồng thời được tối ưu hoá cho tốc độ tải trang. 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 sẽ 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 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.