簡介
無論您使用的是 2D 還是 WebGL 情境,只要使用過 <canvas> 元素,就知道偵錯可能非常困難。使用畫布時,通常會涉及一長串難以追蹤的呼叫:
function draw() {
context.clearRect(0, 0, 258, 258);
context.fillStyle = "#EEEEEE";
context.beginPath();
context.arc(129, 129, 127, 0, 6.28, true);
context.closePath();
context.fill();
// … and on and on
}
有時您可能想擷取傳送至畫布內容的操作說明,並逐一執行。幸好,Chrome 開發人員工具推出全新的 Canvas 檢查功能,可以滿足這項需求!
本文將說明如何使用這項功能,開始對畫布作品進行偵錯。檢查器支援 2D 和 WebGL 情境,因此無論使用哪一種,都能立即取得實用的偵錯資訊。
開始使用
如要開始使用,請在 Chrome 中前往 about:flags,然後開啟「啟用開發人員工具實驗功能」
接著,前往開發人員工具,然後點選右下角的齒輪圖示
。接著,前往「實驗」,啟用「Canvas 檢查」:
如要套用變更,請關閉並重新開啟開發人員工具 (也可以使用 Alt+R 或 Option+R,這兩種方式都很方便)。
DevTools 重新開啟後,前往「Profiles」部分,就會看到新的「Canvas Profiler」選項。
首先,您會發現 Canvas Profiler 已停用。如果頁面包含要偵錯的畫布,只要按下「Enable」,頁面就會重新載入,準備擷取 <canvas> 呼叫:
您必須決定要擷取單一影格或連續影格,影格與您在開發人員工具時間軸中看到的完全相同。
「Single frame」會擷取呼叫,直到目前影格結束為止,然後停止。連續影格則會擷取所有 <canvas> 元素的所有影格,直到您指示停止為止。選擇哪種模式取決於您使用 <canvas> 元素的方式。如果動畫正在播放,您可能想擷取單一影格。如要擷取因使用者事件而產生的簡短動畫,可能需要擷取連續影格。
這樣就設定完成,可以開始擷取了!
擷取影格
如要擷取,只要按下「Start」(開始),然後照常與應用程式互動即可。過一段時間後,返回開發人員工具。如果是連續擷取,請按下「Stop」。
現在,左側清單中會顯示全新的設定檔,其中包含所有 <canvas> 元素中擷取的內容呼叫次數。點選設定檔後,畫面應如下所示:
在下方窗格中,您會看到所有擷取影格的清單,您可以逐步瀏覽這些影格,當您點選每個影格時,頂端的螢幕截圖會顯示該影格結尾的 <canvas> 元素狀態。如果您有多個 <canvas> 元素,可以使用螢幕截圖下方的選單選擇要顯示的元素。
影格內會顯示繪製呼叫群組。每個繪製呼叫群組都包含一個繪製呼叫,也就是群組中的最後一個呼叫。什麼是繪製呼叫?如果是 2D 情境,則會是 clearRect()、drawImage()、fill()、stroke()、putImageData() 或任何文字算繪函式,如果是 WebGL,則會是 clear()、drawArrays() 或 drawElements()。基本上,任何會變更目前繪圖緩衝區內容的操作都算。(如果您不熟悉圖形,可以將緩衝區視為我們正在操作的像素點陣圖)。
現在,您只要逐步瀏覽清單即可。您可以在影格、繪製呼叫群組或呼叫層級執行這項操作。無論您選擇以何種方式逐步瀏覽清單 (螢幕截圖下方有可協助您快速瀏覽的按鈕),您都會看到該點的背景資訊,這表示您可以快速找到並修正出現的錯誤。
大家來找碴
另一項實用功能是查看兩次呼叫之間有哪些屬性和變數發生變化。
只要點選側欄按鈕 (
),就會彈出新檢視畫面。逐步執行繪製呼叫時,您會看到已更新的屬性。將滑鼠游標懸停在任何緩衝區或陣列上,即可顯示其內容。
讓大家聽見你的聲音!
現在您已瞭解如何在 Chrome 開發人員工具中,對畫布作品進行偵錯。如果您對 Canvas Profiler 工具有任何意見,請提交錯誤或在 Chrome 開發人員工具群組中發文。如果發現任何錯誤,或是在檢查 <canvas> 時有任何其他想看到的內容,請告訴我們,因為只有透過開發人員的使用和意見回饋,Chrome 的工具才能變得更好。