import v1.0.0-RC4 | 2009-05-20
This commit is contained in:
14
webdir/javascript/yui/profiler/README
Normal file
14
webdir/javascript/yui/profiler/README
Normal file
@ -0,0 +1,14 @@
|
||||
YUI Library - Profiler - Release Notes
|
||||
|
||||
2.4.0
|
||||
|
||||
* Beta release
|
||||
|
||||
2.5.0
|
||||
|
||||
* No changes
|
||||
|
||||
2.6.0
|
||||
|
||||
* Fixed issue with leaking global "object" variable.
|
||||
* Out of beta
|
||||
380
webdir/javascript/yui/profiler/profiler-debug.js
vendored
Normal file
380
webdir/javascript/yui/profiler/profiler-debug.js
vendored
Normal file
@ -0,0 +1,380 @@
|
||||
/*
|
||||
Copyright (c) 2008, Yahoo! Inc. All rights reserved.
|
||||
Code licensed under the BSD License:
|
||||
http://developer.yahoo.net/yui/license.txt
|
||||
version: 2.6.0
|
||||
*/
|
||||
YAHOO.namespace("tool");
|
||||
|
||||
/**
|
||||
* The YUI JavaScript profiler.
|
||||
* @module profiler
|
||||
* @namespace YAHOO.tool
|
||||
* @requires yahoo
|
||||
*/
|
||||
|
||||
/**
|
||||
* Profiles functions in JavaScript.
|
||||
* @namespace YAHOO.tool
|
||||
* @class Profiler
|
||||
* @static
|
||||
*/
|
||||
YAHOO.tool.Profiler = {
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Private Properties
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Container object on which to put the original unprofiled methods.
|
||||
* @type Object
|
||||
* @private
|
||||
* @static
|
||||
* @property _container
|
||||
*/
|
||||
_container : new Object(),
|
||||
|
||||
/**
|
||||
* Call information for functions.
|
||||
* @type Object
|
||||
* @private
|
||||
* @static
|
||||
* @property _report
|
||||
*/
|
||||
_report : new Object(),
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Private Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Called when a method ends execution. Marks the start and end time of the
|
||||
* method so it can calculate how long the function took to execute. Also
|
||||
* updates min/max/avg calculations for the function.
|
||||
* @param {String} name The name of the function to mark as stopped.
|
||||
* @param {int} duration The number of milliseconds it took the function to
|
||||
* execute.
|
||||
* @return {Void}
|
||||
* @private
|
||||
* @static
|
||||
*/
|
||||
_saveData : function (name /*:String*/, duration /*:int*/){
|
||||
|
||||
//get the function data
|
||||
var functionData /*:Object*/ = this._report[name];
|
||||
|
||||
//increment the calls
|
||||
functionData.calls++;
|
||||
functionData.points.push(duration);
|
||||
|
||||
//if it's already been called at least once, do more complex calculations
|
||||
if (functionData.calls > 1) {
|
||||
functionData.avg = ((functionData.avg*(functionData.calls-1))+duration)/functionData.calls;
|
||||
functionData.min = Math.min(functionData.min, duration);
|
||||
functionData.max = Math.max(functionData.max, duration);
|
||||
} else {
|
||||
functionData.avg = duration;
|
||||
functionData.min = duration;
|
||||
functionData.max = duration;
|
||||
}
|
||||
|
||||
},
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Reporting Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Returns the average amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The average time it takes the function to execute.
|
||||
* @static
|
||||
*/
|
||||
getAverage : function (name /*:String*/) /*:float*/ {
|
||||
return this._report[name].avg;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the number of times that the given function has been called.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* @return {int} The number of times the function was called.
|
||||
* @static
|
||||
*/
|
||||
getCallCount : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].calls;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the maximum amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The maximum time it takes the function to execute.
|
||||
*/
|
||||
getMax : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].max;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the minimum amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The minimum time it takes the function to execute.
|
||||
*/
|
||||
getMin : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].min;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns an object containing profiling data for a single function.
|
||||
* The object has an entry for min, max, avg, calls, and points).
|
||||
* @return {Object} An object containing profile data for a given function.
|
||||
* @static
|
||||
*/
|
||||
getFunctionReport : function (name /*:String*/) /*:Object*/ {
|
||||
return this._report[name];
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns an object containing profiling data for all of the functions
|
||||
* that were profiled. The object has an entry for each function and
|
||||
* returns all information (min, max, average, calls, etc.) for each
|
||||
* function.
|
||||
* @return {Object} An object containing all profile data.
|
||||
* @static
|
||||
*/
|
||||
getFullReport : function (filter /*:Function*/) /*:Object*/ {
|
||||
filter = filter || function(){return true;};
|
||||
|
||||
if (YAHOO.lang.isFunction(filter)) {
|
||||
var report = {};
|
||||
|
||||
for (var name in this._report){
|
||||
if (filter(this._report[name])){
|
||||
report[name] = this._report[name];
|
||||
}
|
||||
}
|
||||
|
||||
return report;
|
||||
}
|
||||
},
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Profiling Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Sets up a constructor for profiling, including all properties and methods on the prototype.
|
||||
* @param {string} name The fully-qualified name of the function including namespace information.
|
||||
* @param {Object} owner (Optional) The object that owns the function (namespace or containing object).
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
registerConstructor : function (name /*:String*/, owner /*:Object*/) /*:Void*/ {
|
||||
this.registerFunction(name, owner, true);
|
||||
},
|
||||
|
||||
/**
|
||||
* Sets up a function for profiling. It essentially overwrites the function with one
|
||||
* that has instrumentation data. This method also creates an entry for the function
|
||||
* in the profile report. The original function is stored on the _container object.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @param {Object} owner (Optional) The object that owns the function. If the function
|
||||
* isn't global then this argument is required. This could be the namespace that
|
||||
* the function belongs to, such as YAHOO.util.Dom, or the object on which it's
|
||||
* a method.
|
||||
* @return {Void}
|
||||
* @method registerFunction
|
||||
*/
|
||||
registerFunction : function(name /*:String*/, owner /*:Object*/, registerPrototype /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//figure out the function name without namespacing
|
||||
var funcName /*:String*/ = (name.indexOf(".") > -1 ? name.substring(name.lastIndexOf(".")+1) : name);
|
||||
if (!YAHOO.lang.isObject(owner)){
|
||||
owner = eval(name.substring(0, name.lastIndexOf(".")));
|
||||
}
|
||||
|
||||
//get the method and prototype
|
||||
var method /*:Function*/ = owner[funcName];
|
||||
var prototype /*:Object*/ = method.prototype;
|
||||
|
||||
//see if the method has already been registered
|
||||
if (YAHOO.lang.isFunction(method) && !method.__yuiProfiled){
|
||||
|
||||
//create a new slot for the original method
|
||||
this._container[name] = method;
|
||||
|
||||
//replace the function with the profiling one
|
||||
owner[funcName] = function () {
|
||||
|
||||
var start = new Date();
|
||||
var retval = method.apply(this, arguments);
|
||||
var stop = new Date();
|
||||
|
||||
YAHOO.tool.Profiler._saveData(name, stop-start);
|
||||
|
||||
return retval;
|
||||
|
||||
};
|
||||
|
||||
//copy the function properties over
|
||||
YAHOO.lang.augmentObject(owner[funcName], method);
|
||||
owner[funcName].__yuiProfiled = true;
|
||||
owner[funcName].prototype = prototype;
|
||||
this._container[name].__yuiOwner = owner;
|
||||
this._container[name].__yuiFuncName = funcName;
|
||||
|
||||
//register prototype if necessary
|
||||
if (registerPrototype) {
|
||||
this.registerObject(name + ".prototype", prototype);
|
||||
}
|
||||
|
||||
//store function information
|
||||
this._report[name] = {
|
||||
calls: 0,
|
||||
max: 0,
|
||||
min: 0,
|
||||
avg: 0,
|
||||
points: []
|
||||
};
|
||||
}
|
||||
|
||||
return method;
|
||||
|
||||
},
|
||||
|
||||
|
||||
/**
|
||||
* Sets up an object for profiling. It takes the object and looks for functions.
|
||||
* When a function is found, registerMethod() is called on it. If set to recrusive
|
||||
* mode, it will also setup objects found inside of this object for profiling,
|
||||
* using the same methodology.
|
||||
* @param {String} name The name of the object to profile (shows up in report).
|
||||
* @param {Object} owner (Optional) The object represented by the name.
|
||||
* @param {Boolean} recurse (Optional) Determines if subobject methods are also profiled.
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
registerObject : function (name /*:String*/, object /*:Object*/, recurse /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//get the object
|
||||
object = (YAHOO.lang.isObject(object) ? object : eval(name));
|
||||
|
||||
//save the object
|
||||
this._container[name] = object;
|
||||
|
||||
for (var prop in object) {
|
||||
if (typeof object[prop] == "function"){
|
||||
if (prop != "constructor" && prop != "superclass"){ //don't do constructor or superclass, it's recursive
|
||||
this.registerFunction(name + "." + prop, object);
|
||||
}
|
||||
} else if (typeof object[prop] == "object" && recurse){
|
||||
this.registerObject(name + "." + prop, object[prop], recurse);
|
||||
}
|
||||
}
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Removes a constructor function from profiling. Reverses the registerConstructor() method.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @return {Void}
|
||||
* @method unregisterFunction
|
||||
*/
|
||||
unregisterConstructor : function(name /*:String*/) /*:Void*/{
|
||||
|
||||
//see if the method has been registered
|
||||
if (YAHOO.lang.isFunction(this._container[name])){
|
||||
|
||||
//get original data
|
||||
//var owner /*:Object*/ = this._container[name].__yuiOwner;
|
||||
//var funcName /*:String*/ = this._container[name].__yuiFuncName;
|
||||
//delete this._container[name].__yuiOwner;
|
||||
//delete this._container[name].__yuiFuncName;
|
||||
|
||||
//replace instrumented function
|
||||
//owner[funcName] = this._container[name];
|
||||
//delete this._container[name];
|
||||
this.unregisterFunction(name, true);
|
||||
|
||||
}
|
||||
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Removes function from profiling. Reverses the registerFunction() method.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @return {Void}
|
||||
* @method unregisterFunction
|
||||
*/
|
||||
unregisterFunction : function(name /*:String*/, unregisterPrototype /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//see if the method has been registered
|
||||
if (YAHOO.lang.isFunction(this._container[name])){
|
||||
|
||||
//check to see if you should unregister the prototype
|
||||
if (unregisterPrototype){
|
||||
this.unregisterObject(name + ".prototype", this._container[name].prototype);
|
||||
}
|
||||
|
||||
//get original data
|
||||
var owner /*:Object*/ = this._container[name].__yuiOwner;
|
||||
var funcName /*:String*/ = this._container[name].__yuiFuncName;
|
||||
delete this._container[name].__yuiOwner;
|
||||
delete this._container[name].__yuiFuncName;
|
||||
|
||||
//replace instrumented function
|
||||
owner[funcName] = this._container[name];
|
||||
|
||||
//delete supporting information
|
||||
delete this._container[name];
|
||||
delete this._report[name];
|
||||
|
||||
}
|
||||
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Unregisters an object for profiling. It takes the object and looks for functions.
|
||||
* When a function is found, unregisterMethod() is called on it. If set to recrusive
|
||||
* mode, it will also unregister objects found inside of this object,
|
||||
* using the same methodology.
|
||||
* @param {String} name The name of the object to unregister.
|
||||
* @param {Boolean} recurse (Optional) Determines if subobject methods should also be
|
||||
* unregistered.
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
unregisterObject : function (name /*:String*/, recurse /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//get the object
|
||||
if (YAHOO.lang.isObject(this._container[name])){
|
||||
var object = this._container[name];
|
||||
|
||||
for (var prop in object) {
|
||||
if (typeof object[prop] == "function"){
|
||||
this.unregisterFunction(name + "." + prop);
|
||||
} else if (typeof object[prop] == "object" && recurse){
|
||||
this.unregisterObject(name + "." + prop, recurse);
|
||||
}
|
||||
}
|
||||
|
||||
delete this._container[name];
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
||||
};
|
||||
YAHOO.register("profiler", YAHOO.tool.Profiler, {version: "2.6.0", build: "1321"});
|
||||
7
webdir/javascript/yui/profiler/profiler-min.js
vendored
Normal file
7
webdir/javascript/yui/profiler/profiler-min.js
vendored
Normal file
@ -0,0 +1,7 @@
|
||||
/*
|
||||
Copyright (c) 2008, Yahoo! Inc. All rights reserved.
|
||||
Code licensed under the BSD License:
|
||||
http://developer.yahoo.net/yui/license.txt
|
||||
version: 2.6.0
|
||||
*/
|
||||
YAHOO.namespace("tool");YAHOO.tool.Profiler={_container:new Object(),_report:new Object(),_saveData:function(B,C){var A=this._report[B];A.calls++;A.points.push(C);if(A.calls>1){A.avg=((A.avg*(A.calls-1))+C)/A.calls;A.min=Math.min(A.min,C);A.max=Math.max(A.max,C);}else{A.avg=C;A.min=C;A.max=C;}},getAverage:function(A){return this._report[A].avg;},getCallCount:function(A){return this._report[A].calls;},getMax:function(A){return this._report[A].max;},getMin:function(A){return this._report[A].min;},getFunctionReport:function(A){return this._report[A];},getFullReport:function(C){C=C||function(){return true;};if(YAHOO.lang.isFunction(C)){var A={};for(var B in this._report){if(C(this._report[B])){A[B]=this._report[B];}}return A;}},registerConstructor:function(B,A){this.registerFunction(B,A,true);},registerFunction:function(name,owner,registerPrototype){var funcName=(name.indexOf(".")>-1?name.substring(name.lastIndexOf(".")+1):name);if(!YAHOO.lang.isObject(owner)){owner=eval(name.substring(0,name.lastIndexOf(".")));}var method=owner[funcName];var prototype=method.prototype;if(YAHOO.lang.isFunction(method)&&!method.__yuiProfiled){this._container[name]=method;owner[funcName]=function(){var start=new Date();var retval=method.apply(this,arguments);var stop=new Date();YAHOO.tool.Profiler._saveData(name,stop-start);return retval;};YAHOO.lang.augmentObject(owner[funcName],method);owner[funcName].__yuiProfiled=true;owner[funcName].prototype=prototype;this._container[name].__yuiOwner=owner;this._container[name].__yuiFuncName=funcName;if(registerPrototype){this.registerObject(name+".prototype",prototype);}this._report[name]={calls:0,max:0,min:0,avg:0,points:[]};}return method;},registerObject:function(name,object,recurse){object=(YAHOO.lang.isObject(object)?object:eval(name));this._container[name]=object;for(var prop in object){if(typeof object[prop]=="function"){if(prop!="constructor"&&prop!="superclass"){this.registerFunction(name+"."+prop,object);}}else{if(typeof object[prop]=="object"&&recurse){this.registerObject(name+"."+prop,object[prop],recurse);}}}},unregisterConstructor:function(A){if(YAHOO.lang.isFunction(this._container[A])){this.unregisterFunction(A,true);}},unregisterFunction:function(B,C){if(YAHOO.lang.isFunction(this._container[B])){if(C){this.unregisterObject(B+".prototype",this._container[B].prototype);}var A=this._container[B].__yuiOwner;var D=this._container[B].__yuiFuncName;delete this._container[B].__yuiOwner;delete this._container[B].__yuiFuncName;A[D]=this._container[B];delete this._container[B];delete this._report[B];}},unregisterObject:function(B,C){if(YAHOO.lang.isObject(this._container[B])){var A=this._container[B];for(var D in A){if(typeof A[D]=="function"){this.unregisterFunction(B+"."+D);}else{if(typeof A[D]=="object"&&C){this.unregisterObject(B+"."+D,C);}}}delete this._container[B];}}};YAHOO.register("profiler",YAHOO.tool.Profiler,{version:"2.6.0",build:"1321"});
|
||||
380
webdir/javascript/yui/profiler/profiler.js
vendored
Normal file
380
webdir/javascript/yui/profiler/profiler.js
vendored
Normal file
@ -0,0 +1,380 @@
|
||||
/*
|
||||
Copyright (c) 2008, Yahoo! Inc. All rights reserved.
|
||||
Code licensed under the BSD License:
|
||||
http://developer.yahoo.net/yui/license.txt
|
||||
version: 2.6.0
|
||||
*/
|
||||
YAHOO.namespace("tool");
|
||||
|
||||
/**
|
||||
* The YUI JavaScript profiler.
|
||||
* @module profiler
|
||||
* @namespace YAHOO.tool
|
||||
* @requires yahoo
|
||||
*/
|
||||
|
||||
/**
|
||||
* Profiles functions in JavaScript.
|
||||
* @namespace YAHOO.tool
|
||||
* @class Profiler
|
||||
* @static
|
||||
*/
|
||||
YAHOO.tool.Profiler = {
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Private Properties
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Container object on which to put the original unprofiled methods.
|
||||
* @type Object
|
||||
* @private
|
||||
* @static
|
||||
* @property _container
|
||||
*/
|
||||
_container : new Object(),
|
||||
|
||||
/**
|
||||
* Call information for functions.
|
||||
* @type Object
|
||||
* @private
|
||||
* @static
|
||||
* @property _report
|
||||
*/
|
||||
_report : new Object(),
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Private Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Called when a method ends execution. Marks the start and end time of the
|
||||
* method so it can calculate how long the function took to execute. Also
|
||||
* updates min/max/avg calculations for the function.
|
||||
* @param {String} name The name of the function to mark as stopped.
|
||||
* @param {int} duration The number of milliseconds it took the function to
|
||||
* execute.
|
||||
* @return {Void}
|
||||
* @private
|
||||
* @static
|
||||
*/
|
||||
_saveData : function (name /*:String*/, duration /*:int*/){
|
||||
|
||||
//get the function data
|
||||
var functionData /*:Object*/ = this._report[name];
|
||||
|
||||
//increment the calls
|
||||
functionData.calls++;
|
||||
functionData.points.push(duration);
|
||||
|
||||
//if it's already been called at least once, do more complex calculations
|
||||
if (functionData.calls > 1) {
|
||||
functionData.avg = ((functionData.avg*(functionData.calls-1))+duration)/functionData.calls;
|
||||
functionData.min = Math.min(functionData.min, duration);
|
||||
functionData.max = Math.max(functionData.max, duration);
|
||||
} else {
|
||||
functionData.avg = duration;
|
||||
functionData.min = duration;
|
||||
functionData.max = duration;
|
||||
}
|
||||
|
||||
},
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Reporting Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Returns the average amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The average time it takes the function to execute.
|
||||
* @static
|
||||
*/
|
||||
getAverage : function (name /*:String*/) /*:float*/ {
|
||||
return this._report[name].avg;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the number of times that the given function has been called.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* @return {int} The number of times the function was called.
|
||||
* @static
|
||||
*/
|
||||
getCallCount : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].calls;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the maximum amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The maximum time it takes the function to execute.
|
||||
*/
|
||||
getMax : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].max;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns the minimum amount of time (in milliseconds) that the function
|
||||
* with the given name takes to execute.
|
||||
* @param {String} name The name of the function whose data should be returned.
|
||||
* If an object type method, it should be 'constructor.prototype.methodName';
|
||||
* a normal object method would just be 'object.methodName'.
|
||||
* @return {float} The minimum time it takes the function to execute.
|
||||
*/
|
||||
getMin : function (name /*:String*/) /*:int*/ {
|
||||
return this._report[name].min;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns an object containing profiling data for a single function.
|
||||
* The object has an entry for min, max, avg, calls, and points).
|
||||
* @return {Object} An object containing profile data for a given function.
|
||||
* @static
|
||||
*/
|
||||
getFunctionReport : function (name /*:String*/) /*:Object*/ {
|
||||
return this._report[name];
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns an object containing profiling data for all of the functions
|
||||
* that were profiled. The object has an entry for each function and
|
||||
* returns all information (min, max, average, calls, etc.) for each
|
||||
* function.
|
||||
* @return {Object} An object containing all profile data.
|
||||
* @static
|
||||
*/
|
||||
getFullReport : function (filter /*:Function*/) /*:Object*/ {
|
||||
filter = filter || function(){return true;};
|
||||
|
||||
if (YAHOO.lang.isFunction(filter)) {
|
||||
var report = {};
|
||||
|
||||
for (var name in this._report){
|
||||
if (filter(this._report[name])){
|
||||
report[name] = this._report[name];
|
||||
}
|
||||
}
|
||||
|
||||
return report;
|
||||
}
|
||||
},
|
||||
|
||||
//-------------------------------------------------------------------------
|
||||
// Profiling Methods
|
||||
//-------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Sets up a constructor for profiling, including all properties and methods on the prototype.
|
||||
* @param {string} name The fully-qualified name of the function including namespace information.
|
||||
* @param {Object} owner (Optional) The object that owns the function (namespace or containing object).
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
registerConstructor : function (name /*:String*/, owner /*:Object*/) /*:Void*/ {
|
||||
this.registerFunction(name, owner, true);
|
||||
},
|
||||
|
||||
/**
|
||||
* Sets up a function for profiling. It essentially overwrites the function with one
|
||||
* that has instrumentation data. This method also creates an entry for the function
|
||||
* in the profile report. The original function is stored on the _container object.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @param {Object} owner (Optional) The object that owns the function. If the function
|
||||
* isn't global then this argument is required. This could be the namespace that
|
||||
* the function belongs to, such as YAHOO.util.Dom, or the object on which it's
|
||||
* a method.
|
||||
* @return {Void}
|
||||
* @method registerFunction
|
||||
*/
|
||||
registerFunction : function(name /*:String*/, owner /*:Object*/, registerPrototype /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//figure out the function name without namespacing
|
||||
var funcName /*:String*/ = (name.indexOf(".") > -1 ? name.substring(name.lastIndexOf(".")+1) : name);
|
||||
if (!YAHOO.lang.isObject(owner)){
|
||||
owner = eval(name.substring(0, name.lastIndexOf(".")));
|
||||
}
|
||||
|
||||
//get the method and prototype
|
||||
var method /*:Function*/ = owner[funcName];
|
||||
var prototype /*:Object*/ = method.prototype;
|
||||
|
||||
//see if the method has already been registered
|
||||
if (YAHOO.lang.isFunction(method) && !method.__yuiProfiled){
|
||||
|
||||
//create a new slot for the original method
|
||||
this._container[name] = method;
|
||||
|
||||
//replace the function with the profiling one
|
||||
owner[funcName] = function () {
|
||||
|
||||
var start = new Date();
|
||||
var retval = method.apply(this, arguments);
|
||||
var stop = new Date();
|
||||
|
||||
YAHOO.tool.Profiler._saveData(name, stop-start);
|
||||
|
||||
return retval;
|
||||
|
||||
};
|
||||
|
||||
//copy the function properties over
|
||||
YAHOO.lang.augmentObject(owner[funcName], method);
|
||||
owner[funcName].__yuiProfiled = true;
|
||||
owner[funcName].prototype = prototype;
|
||||
this._container[name].__yuiOwner = owner;
|
||||
this._container[name].__yuiFuncName = funcName;
|
||||
|
||||
//register prototype if necessary
|
||||
if (registerPrototype) {
|
||||
this.registerObject(name + ".prototype", prototype);
|
||||
}
|
||||
|
||||
//store function information
|
||||
this._report[name] = {
|
||||
calls: 0,
|
||||
max: 0,
|
||||
min: 0,
|
||||
avg: 0,
|
||||
points: []
|
||||
};
|
||||
}
|
||||
|
||||
return method;
|
||||
|
||||
},
|
||||
|
||||
|
||||
/**
|
||||
* Sets up an object for profiling. It takes the object and looks for functions.
|
||||
* When a function is found, registerMethod() is called on it. If set to recrusive
|
||||
* mode, it will also setup objects found inside of this object for profiling,
|
||||
* using the same methodology.
|
||||
* @param {String} name The name of the object to profile (shows up in report).
|
||||
* @param {Object} owner (Optional) The object represented by the name.
|
||||
* @param {Boolean} recurse (Optional) Determines if subobject methods are also profiled.
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
registerObject : function (name /*:String*/, object /*:Object*/, recurse /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//get the object
|
||||
object = (YAHOO.lang.isObject(object) ? object : eval(name));
|
||||
|
||||
//save the object
|
||||
this._container[name] = object;
|
||||
|
||||
for (var prop in object) {
|
||||
if (typeof object[prop] == "function"){
|
||||
if (prop != "constructor" && prop != "superclass"){ //don't do constructor or superclass, it's recursive
|
||||
this.registerFunction(name + "." + prop, object);
|
||||
}
|
||||
} else if (typeof object[prop] == "object" && recurse){
|
||||
this.registerObject(name + "." + prop, object[prop], recurse);
|
||||
}
|
||||
}
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Removes a constructor function from profiling. Reverses the registerConstructor() method.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @return {Void}
|
||||
* @method unregisterFunction
|
||||
*/
|
||||
unregisterConstructor : function(name /*:String*/) /*:Void*/{
|
||||
|
||||
//see if the method has been registered
|
||||
if (YAHOO.lang.isFunction(this._container[name])){
|
||||
|
||||
//get original data
|
||||
//var owner /*:Object*/ = this._container[name].__yuiOwner;
|
||||
//var funcName /*:String*/ = this._container[name].__yuiFuncName;
|
||||
//delete this._container[name].__yuiOwner;
|
||||
//delete this._container[name].__yuiFuncName;
|
||||
|
||||
//replace instrumented function
|
||||
//owner[funcName] = this._container[name];
|
||||
//delete this._container[name];
|
||||
this.unregisterFunction(name, true);
|
||||
|
||||
}
|
||||
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Removes function from profiling. Reverses the registerFunction() method.
|
||||
* @param {String} name The full name of the function including namespacing. This
|
||||
* is the name of the function that is stored in the report.
|
||||
* @return {Void}
|
||||
* @method unregisterFunction
|
||||
*/
|
||||
unregisterFunction : function(name /*:String*/, unregisterPrototype /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//see if the method has been registered
|
||||
if (YAHOO.lang.isFunction(this._container[name])){
|
||||
|
||||
//check to see if you should unregister the prototype
|
||||
if (unregisterPrototype){
|
||||
this.unregisterObject(name + ".prototype", this._container[name].prototype);
|
||||
}
|
||||
|
||||
//get original data
|
||||
var owner /*:Object*/ = this._container[name].__yuiOwner;
|
||||
var funcName /*:String*/ = this._container[name].__yuiFuncName;
|
||||
delete this._container[name].__yuiOwner;
|
||||
delete this._container[name].__yuiFuncName;
|
||||
|
||||
//replace instrumented function
|
||||
owner[funcName] = this._container[name];
|
||||
|
||||
//delete supporting information
|
||||
delete this._container[name];
|
||||
delete this._report[name];
|
||||
|
||||
}
|
||||
|
||||
|
||||
},
|
||||
|
||||
/**
|
||||
* Unregisters an object for profiling. It takes the object and looks for functions.
|
||||
* When a function is found, unregisterMethod() is called on it. If set to recrusive
|
||||
* mode, it will also unregister objects found inside of this object,
|
||||
* using the same methodology.
|
||||
* @param {String} name The name of the object to unregister.
|
||||
* @param {Boolean} recurse (Optional) Determines if subobject methods should also be
|
||||
* unregistered.
|
||||
* @return {Void}
|
||||
* @static
|
||||
*/
|
||||
unregisterObject : function (name /*:String*/, recurse /*:Boolean*/) /*:Void*/{
|
||||
|
||||
//get the object
|
||||
if (YAHOO.lang.isObject(this._container[name])){
|
||||
var object = this._container[name];
|
||||
|
||||
for (var prop in object) {
|
||||
if (typeof object[prop] == "function"){
|
||||
this.unregisterFunction(name + "." + prop);
|
||||
} else if (typeof object[prop] == "object" && recurse){
|
||||
this.unregisterObject(name + "." + prop, recurse);
|
||||
}
|
||||
}
|
||||
|
||||
delete this._container[name];
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
||||
};
|
||||
YAHOO.register("profiler", YAHOO.tool.Profiler, {version: "2.6.0", build: "1321"});
|
||||
Reference in New Issue
Block a user