DOM:window.dump
出典: MDC
目次 |
[編集] 概要
コンソールにメッセージを表示します。
[編集] 構文
dump(message);
-
messageは記録するメッセージの文字列です。
[編集] 注記
dump は一般に JavaScript のデバッグのために使われます。特権コードでは Components.utils.reportError や nsIConsoleService を使ってエラーコンソールにメッセージを記録することもできます。
Gecko では既定の状態で dump は無効になっており、実行しても何も起こりませんがエラーも出しません。dump による出力を見るには、設定で browser.dom.window.dump.enabled を true にして dump を有効にしなければなりません。この設定は about:config か user.js ファイルで行ないます。ただこの設定は既定の状態では about:config に載っていないので、自分で作成する必要があります。(コンテントエリアを右クリック -> 新規作成 -> 真偽値)
Windows では、コンソールを表示させなければ何も見る事は出来ません。もしコンソールが表示されていなければ、一旦アプリケーションを閉じた後、コマンドラインパラメータとして -console を付けて開き直せばコンソールが作成されます。他のオペレーティングシステムでは、ターミナルからアプリケーションを起動すれば表示されます。
コンポーネントにおいては window はグローバルオブジェクトではありませんが、JavaScript で実装された XPCOM コンポーネントでも dump は使用できます。ただし、この場合 dump の使用は前述した設定の影響を受けず、常に表示されます。したがって、この設定を自分自身で確認するか、自分で作成したデバッグ用の設定を使うようにして、ユーザーのコンソールに彼らが望まない多量のデバッグ用メッセージが送られないようにする事をお勧めします。
[編集] 仕様
DOM Level 0。どの標準にも属しません。