chrome.extensionTypes

說明

chrome.extensionTypes API 包含 Chrome 擴充功能的型別宣告。

類型

ColorArray

待處理

類型

[數字, 數字, 數字, 數字]

CSSOrigin

Chrome 66 以上版本

插入 CSS 的來源。

列舉

「author」

"user"

DeleteInjectionDetails

Chrome 87 以上版本

要移除的 CSS 詳細資料。必須設定程式碼或檔案資源，但兩者不得同時設定。

屬性

  • allFrames

    boolean 選填

    如果 allFrames 為 true，表示應從目前網頁的所有框架中移除 CSS。根據預設，這會是 false，且只會從頂端影格移除。如果已設定 true 和 frameId，系統會從所選影格和所有子項影格中移除程式碼。

  • 程式碼

    string 選填

    要移除的 CSS 程式碼。

  • cssOrigin

    CSSOrigin 選填

    要移除的 CSS 來源。預設為 "author"。

  • 檔案

    string 選填

    要移除的 CSS 檔案。

  • frameId

    號碼 選填

    應移除 CSS 的 frame。預設值為 0 (頂層影格)。

  • matchAboutBlank

    boolean 選填

    如果 matchAboutBlank 為 true，且擴充功能有權存取其父項文件，則系統也會從 about:blank 和 about:srcdoc 影格中移除該程式碼。預設為 false。

DocumentLifecycle

Chrome 106 以上版本

影格文件生命週期。

列舉

「prerender」

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 以上版本

執行指令碼的 JavaScript 環境。可以是這個擴充功能專屬的隔離世界、與網頁 JavaScript 共用的 DOM 主世界，或是使用者指令碼世界，僅供透過 User Scripts API 註冊的指令碼使用。

列舉

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 以上版本

影格類型。

列舉

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

待處理

圖片的像素資料。必須是 ImageData 物件，例如來自 canvas 元素。

類型

ImageData

ImageDetails

圖片格式和品質的詳細資料。

屬性

  • format

    ImageFormat 選填

    產生的圖片格式。預設值為 "jpeg"。

  • quality

    號碼 選填

    如果格式為 "jpeg"，則可控制產生的圖片品質。系統會忽略 PNG 圖片的這個值。隨著品質降低，產生的圖片會出現更多視覺瑕疵，且所需的儲存位元組數量也會減少。

ImageFormat

Chrome 44 以上版本

圖片格式。

列舉

"jpeg"

"png"

InjectDetails

要插入的程式碼或 CSS 的詳細資料。必須設定程式碼或檔案資源，但兩者不得同時設定。

屬性

  • allFrames

    boolean 選填

    如果 allFrames 為 true，表示 JavaScript 或 CSS 應插入目前網頁的所有框架。根據預設，這會是 false，且只會插入至頂層影格。如果已設定 true 和 frameId，系統就會在所選影格和所有子影格中插入程式碼。

  • 程式碼

    string 選填

    要插入的 JavaScript 或 CSS 程式碼。

    警告：請謹慎使用 code 參數。使用不當可能會讓擴充功能遭到跨網站指令碼攻擊

  • cssOrigin

    CSSOrigin 選填

    Chrome 66 以上版本

    要插入的 CSS 來源。這項屬性只能指定 CSS，不能指定 JavaScript。預設為 "author"。

  • 檔案

    string 選填

    要插入的 JavaScript 或 CSS 檔案。

  • frameId

    號碼 選填

    Chrome 50 以上版本

    應插入指令碼或 CSS 的框架。預設值為 0 (頂層影格)。

  • matchAboutBlank

    boolean 選填

    如果 matchAboutBlank 為 true，且擴充功能可存取其父項文件，則程式碼也會插入 about:blank 和 about:srcdoc 框架。無法在頂層 about: 框架中插入程式碼。預設為 false。

  • runAt

    RunAt 選填

    JavaScript 或 CSS 最快會在何時注入分頁。預設值為「document_idle」。

RunAt

Chrome 44 以上版本

JavaScript 或 CSS 最快何時會插入分頁。

列舉

"document_start"
Script 會在 css 的任何檔案之後，但在任何其他 DOM 建構或任何其他指令碼執行之前插入。

"document_end"
在 DOM 完成後立即插入指令碼，但在圖片和框架等子資源載入前。

"document_idle"
瀏覽器會在「document_end」與 window.onload 事件觸發後立即執行時機，插入指令碼。插入時間點取決於文件的複雜度和載入時間長短，並針對網頁載入速度進行最佳化。在「document_idle」執行的內容指令碼不需要監聽 window.onload 事件，因為系統保證會在 DOM 完成後執行這些指令碼。如果指令碼確實需要在 window.onload 之後執行，擴充功能可以使用 document.readyState 屬性，檢查 onload 是否已觸發。