1. 概述
1.1 版本
| 報表伺服器版本 |
|---|
| 11.0 |
1.2 應用場景
在使用FineReportAPI來實現功能場景時，由於會涉及到多個參數，經常會出現參數使用錯誤導致的JS報錯或效果不符合預期的情況。
使用者可透過合理運用瀏覽器的除錯方案，快速判斷當前API的參數值是否符合預期、是否符合API要求等，進而避免錯誤的使用。
2. 除錯方案
2.1 在自訂JS中加入debugger
以列印匯出API為例，在呼叫API前加入debugger來查看參數內容
| API類型 | 除錯方案 |
|---|---|
| 大數據集匯出 | debugger; _g().directExportToExcel (dsName, fileName, params, colNames，forMat，enCoding) |
| 新引擎匯出 | debugger; $("<form>").attr({"style": "display : none", "target": "", "method": "post", "action": url}); |
| URL匯出 | debugger; window.location = encodeURI(REPORT_URL); |
| 其他形式URL匯出 | debugger; window.open(url) |
| post實現URL匯出 | debugger; doHyperlinkByPost(url,config,target,feature) |
| JS列印 | debugger; FR.doURLPrint(config); |
由於API中的參數經常會使用自己定義的參數，這邊給一個例子來說明前端除錯的效果：
定義一個自訂參數「a」，指派給copy；然後在除錯頁面（2.3 除錯效果）可以很清楚的看到這個參數的具體值，進而避免API使用錯誤的情況
2.2 進入瀏覽器除錯頁面
F12進入開發者工具
文檔可參考：借用瀏覽器功能寫JS語句
課程可參考：JavaScript 基礎入門
不同瀏覽器下的tab名稱略有差別
谷歌：原始碼
火狐：除錯器
2.3 除錯效果
1）谷歌
2）火狐
