Sys.Debug の assert メソッド
更新 : 2007 年 11 月
条件をチェックし、その条件が false の場合は、メッセージを表示してデバッガを中断するように求めるプロンプトを表示します。
Sys.Debug.assert(condition, message, displayCaller);
引数
condition
コードの実行を続行する場合は true を指定し、message を表示してデバッガを中断する場合は false を指定します。message
(省略可能) 表示するメッセージです。既定値は、空の文字列 ("") です。displayCaller
(省略可能) assert を呼び出している関数の名前をメッセージ中に出力する場合は、true を指定します。既定値は false です。
解説
assert メソッドをコード中で呼び出す場合は、操作の成否を true または false で表し、その値を condition に使用します。操作が失敗した場合 (condition が false の場合)、アサート ロジックが実行されます。
開発者によるエラーのキャッチには、assert メソッドを使用してください。ネットワーク エラーやアクセス許可エラーなど、ユーザー エラーやランタイム エラー条件に対応するには、例外をスローします。
デバッグ動作、要件、およびトレース メッセージ出力は、ブラウザによって異なります。詳細については、「AJAX アプリケーションのデバッグとトレースの概要」を参照してください。
使用例
ユーザー定義変数 n が正の整数でなかった場合に assert メソッドを呼び出す関数の例を次に示します。これは、Sys.Debug クラスの概要で説明している例の一部です。
function btnAssert_onclick() {
var n;
// Insert code intended to set n to a positive integer.
if (false) n = 3;
// Assert if n is not greater than 0.
Sys.Debug.assert(n > 0, "n must be set to a positive integer.");
}
function btnAssert_onclick() {
var n;
// Insert code intended to set n to a positive integer.
if (false) n = 3;
// Assert if n is not greater than 0.
Sys.Debug.assert(n > 0, "n must be set to a positive integer.");
}