chrome.extensionTypes

Mô tả

API chrome.extensionTypes chứa các khai báo kiểu cho tiện ích của 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 mã hoặc thuộc tính 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, điều này có nghĩa là CSS sẽ bị 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 trueframeId, thì mã sẽ bị xoá khỏi khung đã chọn và tất cả các khung con của khung đó.

  • 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à bạn cần xoá CSS. 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ã này 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 mẹ. 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 trong khung.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 trở lên

Môi trường JavaScript để một tập lệnh thực thi trong đó. Có thể là một thế giới biệt lập dành riêng cho 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ỉ dành cho các tập lệnh đã đăng ký bằng User Scripts API.

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 của một hình ảnh. Phải là một đối tượng ImageData; ví dụ: từ mộ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 kết quả. Giá trị mặc định là "jpeg".

  • chất lượng

    number không bắt buộc

    Khi định dạng là "jpeg", tham số này sẽ kiểm soát chất lượng của hình ảnh kết quả. Giá trị này sẽ bị bỏ qua đối với hình ảnh PNG. Khi chất lượng giảm, hình ảnh kết quả sẽ có nhiều hiện tượng giả tạo về hình ảnh hơn và số lượng 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 mã hoặc thuộc tính 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, tức là JavaScript hoặc CSS sẽ đượ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 trueframeId, thì mã sẽ được chèn vào khung đã chọn và tất cả các khung con của khung đó.

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

    Mã JavaScript hoặc CSS để 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 dễ bị tấn công bằng tập lệnh chéo trang

  • 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 để 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 sẽ đượ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 mẹ. Không thể chèn mã vào các khung about:- ở cấp cao nhất. Theo mặc định, giá trị này 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 hình được tải.

"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ính xác để chèn phụ thuộc vào độ 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. Các tập lệnh nội dung chạy ở "document_idle" không cần phải nghe sự kiện window.onload; chúng chắc chắn 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.