chrome.extensionTypes

說明

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

類型

CSSOrigin

Chrome 66 以上版本

已插入 CSS 的來源

列舉

"author"

"user"

DeleteInjectionDetails

Chrome 87 以上版本

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

屬性

  • allFrames

    布林值 (選用)

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

  • 代碼

    字串 選用

    要移除的 CSS 程式碼。

  • cssOrigin

    CSSOrigin 選用

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

  • 檔案

    字串 選用

    要移除的 CSS 檔案。

  • frameId

    數字 選填

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

  • matchAboutBlank

    布林值 (選用)

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

DocumentLifecycle

Chrome 106 以上版本

影格的文件生命週期。

列舉

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,只會插入頂層頁框。如果已設定 trueframeId,系統會將程式碼插入所選影格及其所有子頁框。

  • 代碼

    字串 選用

    要插入的 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