使用新的指令編輯器有效率地建立 Chrome 開發人員工具通訊協定 (CDP) 指令

Hadrien Jaubert
Hadrien Jaubert

Chrome 開發人員工具通訊協定 (CDP) 是一種遠端偵錯通訊協定 (API),可讓開發人員與執行中的 Chrome 瀏覽器進行通訊。Chrome 開發人員工具會使用 CDP,協助你檢查瀏覽器的狀態、控管行為,並收集偵錯資訊。您也可以建立使用 CDP 的 Chrome 擴充功能。

例如,以下 CDP 指令,會在含有 styleSheetId 的樣式表 (位於 location 指定的位置) 中插入含有指定 ruleText 的新規則。

{ 
    command: 'CSS.addRule', 
    parameters: {
        styleSheetId: '2',
        ruleText:'Example', 
        location: {
            startLine: 1,
            startColumn: 1,
            endLine: 1,
            endColumn: 1
        }
    }
}

「通訊協定監控器」導覽匣分頁可讓您傳送 CDP 要求,以及查看開發人員工具傳送及接收的所有 CDP 要求和回應。

通訊協定監測器底部的指令列列。

以往很難手動編寫指令,尤其是包含許多參數的指令。您不僅需要注意左右括號和引號,還必須記住指令的參數,進而查詢 CDP 說明文件

為解決這個問題,開發人員工具導入了新的 CDP 編輯器,主要目標為:

  • 自動完成指令。透過自動完成功能提供可用指令清單,簡化 CDP 指令輸入內容。
  • 自動填入指令參數。減少使用者需要查看 CDP 說明文件中的可用指令參數清單。
  • 簡化參數輸入。您只需填入要傳送的參數值即可。
  • 編輯並重新傳送。加快 CDP 指令的修改速度,加快原型設計速度。

接下來,我們來看看新版編輯器有哪些功能,以及如何運用這項工具!

自動完成功能

自動完成下拉式選單。

自動完成功能現在為指令輸入列提供技術支援。這項工具可協助你編寫有權存取的 CDP 指令名稱。這對不接受參數的指令來說非常實用。

字串和數字參數

使用這個新版編輯器,即可輕鬆編輯原始參數值。如要開啟編輯器,請按一下指令輸入裝置旁邊的 開啟左側面板。 圖示。

在您輸入指令名稱後,編輯器會自動顯示對應的參數。您不必查詢說明文件,就能瞭解哪些參數可搭配哪些指令使用。此外,編輯器會按照指定順序顯示參數:參數優先顯示 (紅色),以及下一個選用的參數 (藍色)。

如要新增選用參數的值,請將滑鼠遊標懸停在參數名稱上,然後按一下 + 按鈕。如要將參數重設為未定義,請按一下「重設為預設值」按鈕。

+ 和「重設為預設值」按鈕。

列舉和布林值參數

編輯列舉或布林參數時,您會看到下拉式選單,讓您選擇可能的值 (適用於列舉),或是直接針對布林值選擇「true」或「false」選項。這項功能可降低列舉參數輸入錯誤值的可能性,同時維持準確度和簡易性。

布林值和列舉下拉式選單。

陣列參數

如為陣列參數,您可以手動將值新增至陣列。將滑鼠遊標懸停在參數的資料列上,然後按一下 + 按鈕。

新增陣列項目的 + 按鈕。

如要逐一刪除陣列項目,請按一下項目旁的「繫結」按鈕。您也可以使用區塊按鈕清除陣列中的所有參數。在這種情況下,陣列參數會重設為 []

「刪除參數」和「重設為預設」按鈕。

物件參數

當您輸入接受物件參數的指令時,編輯器會列出此物件的鍵,您可以直接編輯其值。這項功能適用於所有類型的巢狀參數。

巢狀參數。

探索編輯器中指令和參數的功能

你是否不確定參數或指令的用途?現在,您可以將遊標懸停在指令或參數上,系統隨即會彈出說明性的工具提示,其中含有線上說明文件的連結。

將遊標懸停在指令上時,系統會顯示描述性的工具提示。

傳送不正確參數前發出警告

之前,如果您不知道參數的值類型是否正確無誤,且必須等待系統讀取錯誤回應,可以使用這個新版編輯器。如果參數不接受輸入的值,則會顯示即時錯誤。

參數旁邊出現錯誤圖示。

重新傳送指令

如果您要修改剛剛傳送的指令參數,不必再次輸入。如要編輯並重新傳送指令,請在資料格線中的項目上按一下滑鼠右鍵,然後從下拉式選單中選取「編輯並重新傳送」。系統會自動重新開啟 CDP 編輯器,並使用您選取的指令預先填入。

在資料層中,找到含有「編輯並重新傳送」選項的指令下拉式選單。

將指令複製到 JSON 格式

如要將 JSON 格式的 CDP 指令複製到剪貼簿,請按一下工具列最左側的 。 複製圖示。此外,請注意,如果在輸入列中直接輸入指令,系統會完美填入編輯器,反之亦然。

結論

開發人員工具團隊在設計這個新的 CDP 編輯器背後的目標是簡化 CDP 指令的輸入方式。新版編輯器也可用於查看說明文件中的參數,並讓您更輕鬆地傳送 CDP 指令。

下載預覽管道

考慮使用 Chrome Canary 版開發人員版Beta 版做為預設開發瀏覽器。這些預覽管道可讓您存取開發人員工具的最新功能、測試最先進的網路平台 API,並在使用者使用之前就在網站上發現問題!

與 Chrome 開發人員工具團隊聯絡

使用下列選項,討論文章的新功能和異動,以及其他與開發人員工具相關的事項。

  • 請透過 crbug.com 提交建議或意見回饋。
  • 如要回報開發人員工具的問題,請在開發人員工具中依序點選「更多選項」圖示 更多   >「說明」 >「回報開發人員工具的問題」
  • @ChromeDevTools 張貼推文。
  • 歡迎對開發人員工具的 YouTube 影片或開發人員工具秘訣 (YouTube 影片) 提供意見。