net.eidiot.etracer包中的顶级函数用来初始化ETracer和使用ETracer输出日志和调试信息。 只能使用 initETracer() 或 initLcETracer() 之一初始化 ETracer。 若要禁止输出只需删除该初始化函数。
公共函数
 函数定义方
  
eerror(e:Error):void
输出错误信息。
net.eidiot.etracer
  
einfo(value:Object, title:String = "", depth:int = 0, ... params):void
输出调试信息。
net.eidiot.etracer
  
elog(value:Object, ... rest):void
输出日志信息。
net.eidiot.etracer
  
etrace(... arguments):void
输出调试信息,类似官方trace()方法。
net.eidiot.etracer
  
ewarn(e:Error):void
输出警告信息。
net.eidiot.etracer
  
initETracer(target:DisplayObjectContainer, w:Number = 640, h:Number = 480, initX:Number = -1, initY:Number = -1, autoHide:Boolean = true):void
初始化ETracer,在相同swf内显示信息。
net.eidiot.etracer
  
初始化ETracer,通过LocalConnection 在其它swf内显示信息。
net.eidiot.etracer
函数详细信息
eerror()函数
public function eerror(e:Error):void

输出错误信息。

参数
e:Error — 包含错误信息的Error对象。

示例
下面的代码输出捕获到的错误。
  try
  {
   loader.unload();
  }
  catch (e:Error)
  {
   eerror(e);
  }
  
einfo()函数 
public function einfo(value:Object, title:String = "", depth:int = 0, ... params):void

输出调试信息。

参数
value:Object — 要输出的调试信息。
 
title:String (default = "") — 此次输出的标题
 
depth:int (default = 0) — 深层遍历的深度。若要得到对象{a:"a", b:{c:"c"}}中的"c"则需设置depth为1。
 
... params — 要输出的属性名称,比如"name"、"alpha"。

示例
下面的代码创建一个 URLRequest 对象并且对其设置一些变量。
  var requset:URLRequest = new URLRequest("http://www.getImage.com");
  var vars:URLVariables = new URLVariables();
  vars.method = "GetImage";
  vars.ID = 123;
  requset.data = vars;
  
输出这个URLRequest 对象和它的url和data属性。
einfo(requset, "Info request and deep loop depth 0", 0, "url", "data");
ETracer中显示:
  [flash.net::URLRequest]
  url = http://www.getImage.com
  data = [flash.net::URLVariables]
  
输出时将depth设置为1:
einfo(requset, "Info request and deep loop depth 1", 1, "url", "data");
ETracer中显示:
  [flash.net::URLRequest]
  url = http://www.getImage.com
  data = [flash.net::URLVariables]
   ID = 123
   method = GetImage
  
elog()函数 
public function elog(value:Object, ... rest):void

输出日志信息。

参数
value:Object — 要输出的日志信息。
 
... rest — 要同时输出的其它附加信息。

示例
下面的代码记录图片上传成功的日志信息和服务器的返回值。
  private function onUploadCompleteData(e:DataEvent):void
  {
   elog("Upload complete data", e.data);
  }
  
etrace()函数 
public function etrace(... arguments):void

输出调试信息,类似官方trace()方法。

参数
... arguments — 要输出的一个或多个(用逗号隔开) 表达式。

示例
下面的代码输出mouseX和mouseY属性的值。
etrace(mouseX, mouseY);
ewarn()函数 
public function ewarn(e:Error):void

输出警告信息。

参数
e:Error — 包含警告信息的Error对象。

示例
下面的代码输出一个警告。
ewarn(new Error("The target is not loaded yet."));
initETracer()函数 
public function initETracer(target:DisplayObjectContainer, w:Number = 640, h:Number = 480, initX:Number = -1, initY:Number = -1, autoHide:Boolean = true):void

初始化ETracer,在相同swf内显示信息。 如果已经调用一次initETracer()或者initLcETracer()方法此次调用将被忽略。 隐藏或显示ETracer的热键是 "Ctrl + Alt + X" 。

参数
target:DisplayObjectContainer — 将显示ETracer的DisplayObjectContainer。推荐设置为stage。
 
w:Number (default = 640) — ETracer的宽度。
 
h:Number (default = 480) — ETracer的高度。
 
initX:Number (default = -1) — ETracer的x坐标。如果小于零则水平居中。
 
initY:Number (default = -1) — ETracer的y坐标。如果小于零则垂直居中。
 
autoHide:Boolean (default = true) — 自动隐藏ETracer。

示例
下面的代码初始化ETracer在相同的swf中显示输出信息,并且设置宽高为640×480,居中于舞台显示,不自动隐藏。
initETracer(stage, 640, 480, -1, -1, false);
initLcETracer()函数 
public function initLcETracer():void

初始化ETracer,通过LocalConnection 在其它swf内显示信息。 如果已经调用一次initETracer()或者initLcETracer()方法此次调用将被忽略。