Template:TryError
 | 此Template被引用於約24,000個頁面。 為了避免造成大規模的影響，所有對此Template的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此Template中，但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
概要
[编辑]本模板實現了try...catch...finally的結構
而若用{{#iferror:}}無法根據錯誤種類來做處不同處理，而若用嵌套解析器，對於部分高開銷操做是不利的，因此提供一個類似程式碼的方式來實現。而考量到en:Template:Try模板存在，因此仔不影響使用的情況以TryError命名。
參數及使用方法
[编辑]{{TryError
|<可能有錯誤的維基代碼>
|catch(<錯誤的class>)=<發生對應錯誤的處置>
|catch=<發生通用錯誤的處置>
|finally=<無論是否錯誤都會顯示的維基代碼>
}}
模板參數
[编辑]本模板用來輸出錯誤訊息到標準輸出，實現了try...catch...finally的結構
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| 可能有腳本錯誤的維基代碼 | 1 | 用來處理腳本錯誤的維基代碼
| 字符串 | 可选 |
| 代碼出現其他錯誤的錯誤訊息 | catch | 若該代碼出現其他錯誤時才會輸出該錯誤訊息
| 字符串 | 可选 |
| 代碼出現特定類型錯誤的錯誤訊息 | catch(類型) | 若該代碼出現某個指定類型的錯誤時才會輸出該錯誤訊息，而類型應該在括號裡指定
| 字符串 | 可选 |
| 不論代碼是否有錯都一定會出現的訊息 | finally | 若該代碼不論是否有錯都一定會出現的內容
| 字符串 | 可选 |
範例
[编辑]- 無錯誤的維基代碼搭配try...catch：
{{TryError
|無錯誤的維基代碼
|catch=
}}
無錯誤的維基代碼
- 移除有錯誤的維基代碼：
{{TryError
|這些{{#expr:0/0}}有錯誤
|catch={{{no error}}}
}}
- 輸出：
- 這些有錯誤
- 輸出：
- 有錯誤的維基代碼：
{{#expr:0/0}}{{link-wd|Q0/0}}
- 輸出：
- 除以零。ID“Q0/0”在系统中是未知的。请使用一个有效的实体ID。
- 輸出：
- 有錯誤的維基代碼搭配try...catch：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch=
}}
- 輸出：
- 輸出：
- try...catch...finally
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}{{User 超電磁炮|level=1/0|name=零除錯誤|call=除錯}}{{Topic:Xo1mzbojtxmiusgl}}{{模板1}}
|catch=發生{{{message}}}錯誤！
|finally=結束
}}
- 輸出：
- 發生除以零。ID“Q0/0”在系统中是未知的。请使用一个有效的实体ID。除以零。无法嵌入结构式讨论版块。检测到模板循环：Template:模板1錯誤！結束
- 輸出：
- try並catch 「scribunto-error」錯誤和一般catch：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch(scribunto-error)=發生{{{message}}}錯誤！
|catch=發生{{{message}}}錯誤！
|finally=結束
}}
- 輸出：
- 發生ID“Q0/0”在系统中是未知的。请使用一个有效的实体ID。錯誤！結束
- 輸出：
- try並提供空的一般catch：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch=
|finally=結束
}}
- 輸出：
- 結束
- 輸出：
- try並throw：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch(scribunto-error)={{{throw}}}
|finally=結束
}}
- 輸出：
- ID“Q0/0”在系统中是未知的。请使用一个有效的实体ID。結束
- 輸出：
- try並throw其他錯誤：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch(scribunto-error)={{參數|throw|foo(throw其他錯誤)}}
|finally=結束
}}
- 輸出：
- throw其他錯誤結束
- 輸出：
- 巢狀try...catch：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}{{TryError|{{#expr:0/0}}|catch={{參數|throw|foo(throw其他錯誤)}} }}
|catch(foo)=接到foo錯誤
|finally=結束
}}
- 輸出：
- 接到foo錯誤結束
- 輸出：
- 未能提供匹配的錯誤catch：
{{TryError
|{{#expr:0/0}}{{link-wd|Q0/0}}
|catch(foo)=接到foo錯誤
|finally=結束
}}
- 輸出：
- 未處理的例外狀況:除以零。ID“Q0/0”在系统中是未知的。请使用一个有效的实体ID。結束
- 輸出：
技術限制
[编辑]與#iferror一樣，本模板無法處理來自擴展標籤（如<math>...</math>）的錯誤
{{#iferror:<math>\你好</math>}}
- 輸出
- 解析失败 (语法错误): {\displaystyle \你好}
- 輸出
{{TryError
|<math>\你好</math>
|catch={{{no error}}}
}}
- 輸出
- 解析失败 (语法错误): {\displaystyle \你好}
- 輸出