window.dump()

概要

(システムの) コンソールにメッセージを表示します。

構文

window.dump(message);

dump(message);

• message はログ出力するメッセージの文字列です。

注記

dump() の一般的な使い方は、JavaScript のデバッグです。Firefox のプロセスが -console オプション付きで開始された場合、dump() に渡されたメッセージは、システムコンソール (ネイティブのコンソール) に送信されます。-console オプションが指定されていない場合、stderr に出力されます。dump() からの出力は ブラウザコンソール に送信されません。ブラウザコンソール への出力は、console.log() を使用してください。特権コードは、Components.utils.reportError と nsIConsoleService を使用してメッセージを エラーコンソール / ブラウザコンソール にログ出力することもできます。

dump() は、JavaScript で実装された XPCOM コンポーネントでも使用できます。これは、window がコンポーネント内のグローバルオブジェクトでなくても使えます。また、sandboxes 内で明示的に使用可能にすることもできます。しかし、この dump の使用は、後述の設定に影響せず、常に表示されます。この設定を自分で確認するか、独自のデバッグ設定で、多くのデバッグコンテンツを、これらに興味のないユーザのコンソールに送信されないようにすることをおすすめします。ただし、XPCOM コンポーネントからの dump 出力は stderr へ送られますが、別の場所から呼び出された dump は stdout へ出力されるので注意してください。

Gecko の dump() は 既定で無効 です。実行しても何も起こらず、エラーも発生しません。dump 出力を見るには、about:config ページか user.js ファイル で、browser.dom.window.dump.enabled 設定の値を true にしなければなりません。注記: この設定は既定では about:config のリストに表示されないので、新たに作成してください (about:config ページのコンテンツ領域を右クリックし、"新規作成" から "真偽値" を選択します)。

Windows では、dump の出力を見るにはコンソールを開く必要があります。まだコンソールを開いていなければ、一旦アプリケーションを閉じ、コマンドライン引数に -console を追加して再度開いてください。アプリケーションと同時にコンソールが開きます。または、-attach-console を追加すると既存のコンソールを使用します。他のオペレーティングシステムでは、ターミナルからプリケーションを開くだけです。

コンソール出力をファイルへリダイレクトするには、Firefox を -console オプション無しで起動し、次のコマンドで stderr と stdout の出力をファイルへリダイレクトしてください:

firefox > console.txt 2>&1

仕様

これは、どの仕様にも含まれません。