說明
chrome.extensionTypes API 包含 Chrome 擴充功能的類型宣告。
類型
列舉
"author"
"user"
DeleteInjectionDetails
要移除的 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
影格的文件生命週期。
列舉
ExecutionWorld
指令碼在 JavaScript 環境中執行的情況。可以是此擴充功能特有的獨立世界、與網頁的 JavaScript 共用的 DOM 主要世界，或是僅供透過 User Scripts API 註冊的指令碼的使用者指令碼世界。
列舉
FrameType
影格的類型。
列舉
"outermost_frame"
"fenced_frame"
"sub_frame"
ImageDetails
圖片格式和品質的詳細資料。
屬性
-
format
ImageFormat 選用
結果圖片的格式。預設值為
"jpeg"。 -
quality
數字 選填
當格式為
"jpeg"時，控制產生的圖片品質。如果是 PNG 圖片，系統會忽略這個值。隨著品質降低，產生的圖片會產生更多視覺構件，並減少儲存該圖片所需的位元組數。
ImageFormat
圖片的格式。
列舉
"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
它最快會在分頁中插入 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。