---
title: Window.dump()
slug: Web/API/Window/dump
tags:
  - DOM
translation_of: Web/API/Window/dump
---
<div>{{ApiRef}}</div>

<h2 id="Summary" name="Summary">Übersicht</h2>

<p>Schreibt eine Nachricht auf die (systemeigene) Konsole.</p>

<h2 id="Syntax" name="Syntax">Syntax</h2>

<pre class="syntaxbox">window.dump(<em>message</em>);

dump(<em>message</em>);
</pre>

<ul>
 <li><code>message</code> ist die zu protokollierende Nachricht.</li>
</ul>

<h2 id="Notes" name="Notes">Bemerkungen</h2>

<p><code>dump</code> wird normalerweise verwendet um JavaScript zu debuggen. Privilegierter Code kann auch <code><a href="/en-US/docs/Components.utils.reportError" title="Components.utils.reportError">Components.utils.reportError</a></code> und <code><a href="/en-US/docs/XPCOM_Interface_Reference/nsIConsoleService" title="nsIConsoleService">nsIConsoleService</a></code> verwenden, um Nachrichten in die <a href="/en-US/docs/Error_Console" title="Error_Console">Fehler-Konsole</a> zu schreiben.</p>

<p>In <a href="/en-US/docs/Gecko" title="Gecko">Gecko</a> ist <code>dump</code> standardmäßig deaktiviert – beim Aufruf passiert also nichts und es wird auch kein Fehler erzeugt. Um die <code>dump</code> Ausgabe zu sehen, muss die Einstellung <code>browser.dom.window.dump.enabled</code> auf <code>true</code> gesetzt werden. Diese Einstellung kann in <a href="http://kb.mozillazine.org/About:config">about:config</a> oder in der <a href="http://kb.mozillazine.org/User.js_file">user.js Datei</a> vorgenommen werden. Anmerkung: Diese Einstellung ist in <code>about:config</code> normalerweise nicht enthalten, sie muss erst erzeugt werden (Rechtsklick in den Fensterbereich -&gt; Neu -&gt; Boolean).</p>

<p>In Windows benötigt man eine Konsole, um überhaupt etwas zu sehen. Wenn noch keine vorhanden ist, kann durch einen Neustart der Anwendung mit dem Parameter  <code>-console</code> eine Konsole erzeugt werden. Auf anderen Betriebssystemen ist es ausreichend die Anwendung aus einem Terminal aufzurufen.</p>

<p>Um die Konsolenausgabe in eine Datei umzuleiten, muss Firefox <em>ohne</em> den Parameter <code>-console</code> gestartet und folgende Syntax zum Umleiten von stderr und stdout in eine Datei verwendet werden, zB.:</p>

<pre>firefox &gt; console.txt 2&gt;&amp;1
</pre>

<p><code>dump</code> steht auch in JavaScript geschriebenen XPCOM Komponenten zur verfügbar, obwohl <code><a href="/en-US/docs/DOM/window" title="DOM/window">window</a></code> nicht das globale Objekt in Komponenten ist. Allerdings wird diese Verwendung von <code>dump</code> nicht durch die oben genannte Einstellung beeinflusst -- die Ausgabe findet immer statt. Deshalb ist es anzuraten, diese Einstellung selbst zu prüfen oder eine eigene Debug-Einstellung zu erzeugen. Damit sichergestellt ist, dass nicht unnötig viele Debug-Daten in die Konsole des Benutzers geschrieben werden, wenn dieser überhaupt nicht an diesen interessiert ist. Achtung, die Ausgabe von <code>dump</code> von XPCOM Komponenten wird zu <code>stderr</code> geleitet, während ein Aufruf von <code>dump </code>an andere Stelle auf <code>stdout</code> ausgibt.</p>

<h2 id="Specification" name="Specification">Spezifikation</h2>

<p>{{DOM0}}</p>