偵錯

上次更新: 2023-12-07
  • 主題:
  • Web SDK
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer

啟用偵錯功能後,SDK會將訊息輸出至瀏覽器主控台,有助於對實作進行偵錯,並瞭解SDK的運作方式。

除錯功能預設為停用,但可以透過四種不同方式切換:

  • configure 命令
  • setDebug 命令
  • 查詢字串引數
  • 切換在Adobe Experience Platform Debugger中啟用偵錯。 Adobe Experience Platform是一款功能強大的工具,可檢查您的網頁,並協助您偵錯Experience Cloud產品的實施問題。 Adobe Experience Platform Debugger的可用形式為 鉻黃 副檔名。 您可以從AEP Web SDK區段的設定標籤啟用偵錯。

顯示設定畫面的Experience PlatformDebugger UI影像。

使用Configure命令切換偵錯

使用設定SDK時 configure 命令,透過設定 debugEnabled 選項至 true.

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg",
  "debugEnabled": true
});
秘訣

這可針對網頁的所有使用者進行偵錯,而非僅針對您的個人瀏覽器。

使用Debug命令切換偵錯

切換使用另一個除錯工具 debug 命令如下:

alloy("setDebug", {
  "enabled": true
});

如果您不想變更網頁上的程式碼,或不想為網站的所有使用者產生記錄訊息,這會特別有用,因為您可以執行 debug 命令於瀏覽器的JavaScript主控台中。

使用查詢字串引數切換除錯

透過設定 alloy_debug 查詢字串引數至 truefalse 如下所示:

http://example.com/?alloy_debug=true

類似於 debug 命令,如果您不想變更網頁上的程式碼,或不想為網站的所有使用者產生記錄訊息,這會特別有用,因為您可以在瀏覽器中載入網頁時設定查詢字串引數。

優先順序和期間

當透過設定除錯時 debug 命令或查詢字串引數,會覆寫任何 debug 選項設定於 configure 命令。 在這兩種情況下,在工作階段期間,除錯功能也會維持開啟狀態。 換言之,如果您使用debug命令或查詢字串引數啟用除錯功能,則會保持啟用狀態,直到下列其中一項:

  • 工作階段結束
  • 您執行 debug 命令
  • 您再次設定查詢字串引數

正在擷取程式庫資訊

存取您已載入至網站之程式庫背後的部分詳細資料,通常會有幫助。 若要這麼做,請執行 getLibraryInfo 命令如下:

alloy("getLibraryInfo").then(function(result) {
  console.log(result.libraryInfo.version);
  console.log(result.libraryInfo.commands);
  console.log(result.libraryInfo.configs);
});

目前,提供 libraryInfo 物件包含下列屬性:

  • version:這是載入的程式庫版本。 例如,如果載入的程式庫版本是1.0.0,則值會是 1.0.0. 當程式庫在標籤擴充功能(名為「AEP Web SDK」)中執行時,版本為程式庫版本,而標籤擴充功能版本以「+」符號連結。 例如,如果程式庫的版本是1.0.0,而標籤擴充功能的版本是1.2.0,則值將是 1.0.0+1.2.0.
  • commands:這些是載入的程式庫支援的所有可用命令。
  • configs:這些是載入的程式庫中所有的目前設定。

本頁內容