diff -r 000000000000 -r 40c8f766c9b8 src/cm/media/js/lib/yui/yui_3.0.0b1/api/Profiler.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cm/media/js/lib/yui/yui_3.0.0b1/api/Profiler.html Mon Nov 23 15:14:29 2009 +0100 @@ -0,0 +1,1174 @@ + + + + + API: profiler Profiler (YUI Library) + + + + + + + + + + +
+
+

Yahoo! UI Library

+

profiler  3.0.0b1

+ Yahoo! UI Library + > profiler + > Profiler + +
+
+ Search: +
+   +
+
+
+
+ +
+
+
+
+
+ Filters + + + +
+
+ +

+ + + static + + Class Profiler + + + +

+ + + + + +
+ Profiles functions in JavaScript. +
+ + +
+ +
+ +
+
+

Methods

+
+
+

+ clear

+
+ + + static + + Void + clear + ( + + + name + + + ) + + +
+ Removes all report data from the profiler. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + (Optional) The name of the report to clear. If +omitted, then all report data is cleared. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ getAverage

+
+ + + static + + float + getAverage + ( + + + name + + + ) + + +
+ Returns the average amount of time (in milliseconds) that the function +with the given name takes to execute. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + 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'. +
+
+ +
+
Returns: + + float +
+
The average time it takes the function to execute.
+
+ + + + +
+ +
+
+
+
+

+ getCallCount

+
+ + + static + + int + getCallCount + ( + + + name + + + ) + + +
+ Returns the number of times that the given function has been called. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the function whose data should be returned. +
+
+ +
+
Returns: + + int +
+
The number of times the function was called.
+
+ + + + +
+ +
+
+
+
+

+ getFullReport

+
+ + + static + + Object + getFullReport + ( + ) + + +
+ 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. +
+ +
+ + +
+
Returns: + + Object +
+
An object containing all profile data.
+
+ + + + +
+ +
+
+
+
+

+ getFunctionReport

+
+ + + static + + Object + getFunctionReport + ( + ) + + +
+ Returns an object containing profiling data for a single function. +The object has an entry for min, max, avg, calls, and points). +
+ +
+ + +
+
Returns: + + Object +
+
An object containing profile data for a given function.
+
+ + + +
+ Deprecated Use getReport() instead. +
+ +
+ +
+
+
+
+

+ getMax

+
+ + + static + + float + getMax + ( + + + name + + + ) + + +
+ Returns the maximum amount of time (in milliseconds) that the function +with the given name takes to execute. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + 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'. +
+
+ +
+
Returns: + + float +
+
The maximum time it takes the function to execute.
+
+ + + + +
+ +
+
+
+
+

+ getMin

+
+ + + static + + float + getMin + ( + + + name + + + ) + + +
+ Returns the minimum amount of time (in milliseconds) that the function +with the given name takes to execute. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + 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'. +
+
+ +
+
Returns: + + float +
+
The minimum time it takes the function to execute.
+
+ + + + +
+ +
+
+
+
+

+ getOriginal

+
+ + + static + + Function|Object + getOriginal + ( + + + name + + + ) + + +
+ Returns the uninstrumented version of a function/object. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the function/object to retrieve. +
+
+ +
+
Returns: + + Function|Object +
+
The uninstrumented version of a function/object.
+
+ + + + +
+ +
+
+
+
+

+ getReport

+
+ + + static + + Object + getReport + ( + ) + + +
+ Returns an object containing profiling data for a single function. +The object has an entry for min, max, avg, calls, and points). +
+ +
+ + +
+
Returns: + + Object +
+
An object containing profile data for a given function.
+
+ + + + +
+ +
+
+
+
+

+ instrument

+
+ + + static + + Function + instrument + ( + + + name + + + , + method + + + ) + + +
+ Instruments a method to have profiling calls. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the report for the function. +
+
+ method + <Function> + + The function to instrument. +
+
+ +
+
Returns: + + Function +
+
An instrumented version of the function.
+
+ + + + +
+ +
+
+
+
+

+ pause

+
+ + + static + + Void + pause + ( + + + name + + + ) + + +
+ Pauses profiling information for a given name. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the data point. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ registerConstructor

+
+ + + static + + Void + registerConstructor + ( + + + name + + + , + owner + + + ) + + +
+ Sets up a constructor for profiling, including all properties and methods on the prototype. +
+ +
+ +
+
Parameters:
+
+ name + <string> + + The fully-qualified name of the function including namespace information. +
+
+ owner + <Object> + + (Optional) The object that owns the function (namespace or containing object). +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ registerFunction

+
+ + + static + + Void + registerFunction + ( + + + name + + + , + owner + + + , + registerPrototype + + + ) + + +
+ 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. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The full name of the function including namespacing. This +is the name of the function that is stored in the report. +
+
+ owner + <Object> + + (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 or the object on which it's +a method. +
+
+ registerPrototype + <Boolean> + + (Optional) Indicates that the prototype should +also be instrumented. Setting to true has the same effect as calling +registerConstructor(). +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ registerObject

+
+ + + static + + Void + registerObject + ( + + + name + + + , + owner + + + , + recurse + + + ) + + +
+ 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. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the object to profile (shows up in report). +
+
+ owner + <Object> + + (Optional) The object represented by the name. +
+
+ recurse + <Boolean> + + (Optional) Determines if subobject methods are also profiled. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ start

+
+ + + static + + Void + start + ( + + + name + + + ) + + +
+ Start profiling information for a given name. The name cannot be the name +of a registered function or object. This is used to start timing for a +particular block of code rather than instrumenting the entire function. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the data point. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ stop

+
+ + + static + + Void + stop + ( + + + name + + + ) + + +
+ Stops profiling information for a given name. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the data point. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ unregisterFunction

+
+ + + static + + Void + unregisterFunction + ( + + + name + + + ) + + +
+ Removes a constructor function from profiling. Reverses the registerConstructor() method. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The full name of the function including namespacing. This +is the name of the function that is stored in the report. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+

+ unregisterObject

+
+ + + static + + Void + unregisterObject + ( + + + name + + + , + recurse + + + ) + + +
+ 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. +
+ +
+ +
+
Parameters:
+
+ name + <String> + + The name of the object to unregister. +
+
+ recurse + <Boolean> + + (Optional) Determines if subobject methods should also be +unregistered. +
+
+ +
+
Returns: + + Void +
+
+
+ + + + +
+ +
+
+
+
+
+ +
+ +
+ + +
+ +
+ +
+ +
+
+ +
+
+
+ Copyright © 2009 Yahoo! Inc. All rights reserved. +
+
+ + +