javascript-log教程

80酷酷网    80kuku.com

  //----------------------------------开发背景----------------------------------------------//
在javascript开发过程中,如果总是使用alert的方式调试程序,很难满足企业级开发的需要。  
比如ajax项目中,存在一个3000行左右JS文件,其中存在各种自定义的javascript对象。
开发的过程中,总是需要在js程序执行到某个关键点的时候,监视自定义对象的值或状态,
判断执行结果是否是预期的样子.
alert的方式存在以下两个明显的缺点:  
1.假如一次执行中有n个关键点的值都想随时监视,使用alert您就不的不点够n次确认,
- 给开发者的感觉是很不连贯也不直观,很难流畅发现隐藏很深的问题。  
2.用于调试的alert语句,在发布的时候必须删除掉,等有朝一日需要再次调试的时候,
- 您就不得不回忆之前的关键点,分别加上alert,艰难的调试。  

鉴于以上需求,本着简单实用的原则,自己动手编写了这个javascript调试工具,全部程序只有10kb左右。
使用该工具之后,以上两个问题,变得迎刃而解。您或许会发现,IE下调试javascript程序变的便利。  
该工具主要有以下特点:  
1.完全的可插入式思想,对目标程序没有任何负作用。  
2.使用方法简单,方便,只需要引入一行JS代码。  

//----------------------------------使用方法---------------------------------------------//
  
步骤1.将类似于下面这样的一行script标签加入到您的目标页面(JSP,ASP,HTML,PHP等)中

<SCRIPT language=javascript src="debugInner.js"></script>  

关于script标签参数的说明:
/**
-------------------------------------------
[String]param -- url  
-------------------------------------------
将url指向的网页的body.innerHTML加入到targetpage div中
[初始化时]时可以设定

例:
    url="http://www.baidu.com"
    url="http://www.126.com"
    url="http://www.sina.com.cn"
    ...
-------------------------------------------
[Boolean]param -- debug  
-------------------------------------------
用来控制是否开启javascript的log功能
[初始化时]时可以设定

例:
    debug = true (DEFAULT)
    debug = false

-------------------------------------------
[Boolean]param -- showtime
-------------------------------------------
用来控制是否在每条log信息前显示当前时间
[初始化]或[运行时]均可以设定

例:
    showtime = false (DEFAULT)
    showtime = true

-------------------------------------------
[String]param -- local
-------------------------------------------
设置界面的语言
[初始化]或[运行时]均可以设定

例:
    local = "CN"  
    local = "EN" (DEFAULT)
         
-------------------------------------------
[String]param -- src
-------------------------------------------
设置debugInner.js的路径
[初始化]时可以设定

例:
    src = "D:/jslog/debugInner.js"
    src = "../javascriptlog-tool/debugInner.js"
    src = "http://localhost:8080/myproject/debugInner.js"
    ...
--------------------------------------------------
*/

步骤2.测试代码如下:  
<!--TEST begin-->  
<script>  
    function test(){  
        var head = document.getElementsByTagName('HEAD').item(0);  
        $Log.loginfo(null,"red");//null  
        $Log.loginfo(1/3,"red");//number  
        $Log.loginfo(1==2,"red");//boolean  
        $Log.loginfo(test,"blue");//function  
        $Log.loginfo("hello world!","red");//string  
        $Log.loginfo(head);//object  
    }  
</script>  
<input type="button" value="TEST" >  
<!--TEST end-->
项目庞大的时候,需要总是在程序中保留一些调试信息,必要的时候进行调试。  
所以,能够让关键点的信息随时打印出来也是很重要的,同时保证在Release之后,
对目标脚本执行性能没有任何影响是必须要考虑的问题。  
本工具提供的print接口是:jslog(msg,color);//msg:信息 color:信息的颜色
如果release的时候,你希望将"步骤2"加入到目标程序中的script标签删除,您也可以
选择在您的程序中重构一个类似于下面的方法,名字随意.比如:  
function $out(message,color){
     $Log.loginfo(message,color);
}
统一使用自己的定义的方法也可以,比如:  
function test(){  
    $out(null,"red");//null  
    $out(1/3,"red");//number  
    $out(1==2,"red");//boolean  
    $out(test,"blue");//function  
    $out("hello world!","red");//string  
}  
不过通常来说Release的时候将debug开关设置为:debug=false,不需要删除目标程序中的调试代码,对目标JS程序执行性能无任何影响;需要再次调试时,只需要将debug开关设置为:debug=true 即可.

//----------------------------------最新下载---------------------------------------//
下载:
//----------------------------------更新履历---------------------------------------//
附加说明:
1.jslog中,对的内部事件进行统一管理.
-内测阶段,留了一个测试"取消事件注册"的接口-通过双击console 可以调用
2.console上方链接的说明:
- [移动控制台]:可以移动控制台或改变控制台的宽度
- [增大高度]/[减小高度]:可以根据需要调整控制台的高度
- MaxHeight:屏幕高度,MinHeight:100px
- [清除信息]:清除控制台中的信息
- [显示/隐藏时刻]:可以在运行时设定是否显示输出log时的时刻
3.document的onscroll事件发生时,只有在console不在可见范围内时才响应.
4.快捷键[ctrl+shift+s],再console中显示当前活动元素的HTML代码
5.该工具所有功能只在IE下测试通过.

2008/02/14更新:
1.加入性能测试组件,支持嵌套调用,可参照example.htm中的应用
/* performance testing */
  $PF.begin();
  $PF.end(message,color);//default color is red
2.代码重构,处理重复加载相关的问题.

2008/04/01更新:
控制台折叠

技术说明:
1.javascript面向对象编程思想,进行严谨的对象封装.通过组件的松耦合设计,实现组件间($Log,$AjaxUrl,$Performance)的可插接性.
2.采用了先进的DeanEdwards事件模型,并对它进行丰富,封装工具的所有内部事件,使得对已经注册的事件(包括匿名事件)进行统一管理成为可能.
3.不直接在闭包函数中引用dom元素,避免IE内存泄漏.重复加载等问题.
4.提供了一种客户端脚本实现多语言的思路.
5.在<script src=..></script>标签中,加入自定义参数,使得脚本加载参数变为可配置.并在运行时动态加载CSS.
6.在对象内部构建了_msgCached,确保了,即便是在页面未初始化完成的状况下,log也可以被正确记录.
7.控制台拖拽,控制台高度控制,信息清除,时间输出选择,滚动条事件处理,快捷键查就看活动元素HTML,时间format扩展....
8.Ajax方式的URL站点解码组件.
9.客户端脚本执行性能测试组件.


分享到
  • 微信分享
  • 新浪微博
  • QQ好友
  • QQ空间
点击: