開發自己的 Firefox add-on 附加元件(九) 主控台( Console )

在這一系列的 add-on 開發教學文章中，有一個很實用的錯誤主控台( error console )，其可用來輸出錯誤、警告、和我們指定的資訊，對 debugging 有很大的幫助。


若使用 add-on builer，我們可以從以下圖片中的位置開啟：



Console 物件讓我們可以記錄 add-on 的日誌( log )。如果是使用 command line 環境來開發add-on(for example, by executing cfx run or cfx test)，則這些 log 訊息會顯示在所使用的 command shell 中。如果已經將 add-on 安裝進 host application，則日誌訊息會顯示在 host application 的錯誤主控台( Error Console )中。

Console 物件有以下方法( methods )：

console.log(object[, object, ...])

將訊息類的信息記錄到 shell 中。根據主控台底層的系統和介面的不同，可能可以檢視記錄下來的衍伸物件( non-primitive object )的屬性。

console.info(object[, object, ...])
和 console.log() 相同。

console.warn(object[, object, ...])

記錄警告類的信息。

console.error(object[, object, ...])

記錄錯誤類的信息。

console.debug(object[, object, ...])

記錄 debug 信息。

console.exception(exception)

將指定的例外實體( exception instance )以錯誤類信息記錄，並輸出例外的堆疊追蹤( stack trace )。

console.trace()

記錄在此函數被呼叫時的堆疊追蹤( stack trace )。