window方法:dump()
dump()方法
dump()方法可以将消息打印到(本机)控制台。
注意:dump()方法是非标准的,不要在面向Web的生产站点上使用它:它不适用于每个用户。实现之间可能存在很大的不兼容性,并且行为可能在将来发生变化。
dump()方法语法
window.dump(message);
dump(message);
- message表示要记录的字符串消息。
笔记
dump()的一个常见用途是调试JavaScript。如果使用该-console选项启动Firefox进程,则传递给dump()的消息将发送到系统控制台(本机控制台)。如果未指定该-console选项,则输出将转至stderr。dump()的输出不会发送到浏览器控制台。可以使用console.log()将输出发送到浏览器控制台。特权代码还可以使用Components.utils.reportError和nsIConsoleService将消息记录到Error Console/Browser Console。
dump()也可用于在JavaScript中实现的XPCOM组件,即使window不是组件中的全局对象。它也明确地在沙盒中可用。但是,dump的使用不会受到下面提到的首选项的影响——它将始终显示。因此,建议您自己检查此首选项或使用自己的调试首选项,以确保在用户可能根本不感兴趣时,不会向用户的控制台发送大量调试内容。请注意,XPCOM组件的dump输出转到stderr,而其他地方的dump调用将输出到stdout。
在默认情况下,Gecko dump()被禁用 - 它不会执行任何操作,但也不会引发错误。要查看dump输出你必须通过设置首选项browser.dom.window.dump.enabled为true来启用它。您可以在about:config或user.js文件中设置首选项。注意:默认情况下不会在about:config列出此首选项,您可能需要创建它(右键单击内容区域->新建->布尔值)。
在Windows上,您将需要一个控制台来实际查看任何内容。如果您还没有,则关闭应用程序并使用命令行参数-console重新打开它,应创建控制台或使用-attach-console命令来使用现有的控制台。在其他操作系统上,从终端启动应用程序就足够了。
要将控制台输出重定向到文件,无需-console选项即可运行firefox,并使用语法将stderr和stdout重定向到文件,即:
firefox > console.txt 2>&1
如果您希望控制台消息显示在用于启动应用程序的控制台中,则可以使用Gecko控制台重定向器。预编译的二进制文件位于压缩存档 :https://github.com/matthewkastor/Redirector/archive/master.zip,这在Redirector-master\Gecko\Console Redirector\bin\Release下,你可以将所有dll和exe复制到任意位置。然后运行:Console Redirector.exe /?
规范
这不是任何规范的一部分。