chrome.extensionTypes

說明

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

類型

CSSOrigin

Chrome 66 以上版本

已插入 CSS 的來源。

列舉

"author"

"user"

DeleteInjectionDetails

Chrome 87 以上版本

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

屬性

  • allFrames

    布林值 (選用)

    如果 allFrame 為 true，表示應該從目前網頁的所有頁框中移除 CSS。根據預設，這個項目為 false，只會從頂端頁框中移除。如果設定了 true 和 frameId，則會從所選影格及其所有子項頁框中移除程式碼。

  • 代碼

    字串 選用

    要移除的 CSS 程式碼。

  • cssOrigin

    CSSOrigin 選用

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

  • 檔案

    字串 選用

    要移除的 CSS 檔案。

  • frameId

    數字 選填

    您應移除 CSS 的 Frame。預設值為 0 (頂層頁框)。

  • matchAboutBlank

    布林值 (選用)

    如果 matchAboutBlank 為 true，則只要擴充功能可存取其父項文件，程式碼也會從 about:blank 和 about:srcdoc frame 中移除。預設為 false。

DocumentLifecycle

Chrome 106 以上版本

影格的文件生命週期。

列舉

ExecutionWorld

Chrome 111 以上版本

指令碼在 JavaScript 環境中執行的情況。可以是此擴充功能特有的獨立世界、與網頁的 JavaScript 共用的 DOM 主要世界，或是僅供透過 User Scripts API 註冊的指令碼的使用者指令碼世界。

列舉

FrameType

Chrome 106 以上版本

影格的類型。

列舉

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

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

屬性

  • format

    ImageFormat 選用

    結果圖片的格式。預設值為 "jpeg"。

  • quality

    數字 選填

    當格式為 "jpeg" 時，控制產生的圖片品質。如果是 PNG 圖片，系統會忽略這個值。隨著品質降低，產生的圖片會產生更多視覺構件，並減少儲存該圖片所需的位元組數。

ImageFormat

Chrome 44 以上版本

圖片的格式。

列舉

"jpeg"

"png"

InjectDetails

要插入的指令碼或 CSS 詳細資料。程式碼或檔案屬性必須設定，但兩者不能同時設定。

屬性

  • allFrames

    布林值 (選用)

    如果 allFrame 為 true，表示應將 JavaScript 或 CSS 插入目前網頁的所有頁框。根據預設，這個變數為 false，只會插入頂層頁框。如果已設定 true 和 frameId，系統會將程式碼插入所選影格及其所有子頁框。

  • 代碼

    字串 選用

    要插入的 JavaScript 或 CSS 程式碼。

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

  • cssOrigin

    CSSOrigin 選用

    Chrome 66 以上版本

    要插入的 CSS 來源。只有 CSS 可以指定這個值，不能指定 JavaScript。預設為 "author"。

  • 檔案

    字串 選用

    要插入的 JavaScript 或 CSS 檔案。

  • frameId

    數字 選填

    Chrome 50 以上版本

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

  • matchAboutBlank

    布林值 (選用)

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

  • runAt

    RunAt 選用

    它最快會在分頁中插入 JavaScript 或 CSS。預設為「document_idle」。

RunAt

Chrome 44 以上版本

它最快會在分頁中插入 JavaScript 或 CSS。

列舉

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

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

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