非標準
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
アサーションが false になる場合に、コンソールへエラーメッセージを出力します。アサーションが true になる場合は、何も行いません。
註: This feature is available in Web Workers.
注記: Node.js では、ブラウザで使用できる console.assert() メソッドとは別の console.assert() メソッドが実装されています。
具体的には、ブラウザでは falsy なアサーションを伴って console.assert() を呼び出すと、後続のコードの実行を妨害せずにコンソールへ message を出力します。一方 Node.js では、falsy なアサーションで AssertionError が発生します。
構文
console.assert(assertion, obj1 [, obj2, ..., objN]); console.assert(assertion, msg [, subst1, ..., substN]); // C ライクなメッセージ形式
引数
assertion- ブール式。アサーションが false になると、コンソールにメッセージを出力します。
obj1...objN- 出力する JavaScript オブジェクトのリスト。各オブジェクトを文字列で表現したものを、リストの並び順に追記して出力します。
msg- 0 個以上の置換文字列を含む JavaScript 文字列。
subst1...substNmsg内の置換文字列を置き換える JavaScript オブジェクト。このパラメータで、出力形式を高度に制御できます。
詳しくは console のドキュメントで、コンソールにテキストを出力する をご覧ください。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| Console API console.assert() の定義 |
勧告改訂案 | 最初期の定義 |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | (有) | 28.0 (28.0) | (有) | (有) | (有) |
| Worker で使用可能 | (有) | 38.0 (38.0) | (有) | (有) | (有) |
| C ライクなメッセージ形式 | 未サポート | 28.0 (28.0) | ? | ? | ? |
| 機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本サポート | ? | 28.0 (28.0) | ? | ? | ? |
| Worker で使用可能 | ? | 38.0 (38.0) | ? | ? | ? |
| C ライクなメッセージ形式 | ? | 28.0 (28.0) | ? | ? | ? |