YUI Library Examples: ProfilerViewer Control: Simple Profiling

A Simple Use Case: Profiling Calendar

One of the nice things about the YUI Profiler is that it makes it simple to profile any JavaScript function or object structure. ProfilerViewer's job is to make it just as easy to explore that data.

In this example, we create an instance of YUI's Calendar Control, tell Profiler to profile our Calendar instance, and then use ProfilerViewer to experience that data.

This example has the following dependencies:

We begin with empty div elements for Calendar and Profiler to use:

In JavaScript, we instantiate our Calendar and then pass the instance to Profiler for profiling:

Finally, we set up ProfilerViewer to consume the profiling information and make it visible in the interface:

The full JavaScript block for this example is as follows:

YAHOO.namespace("example.calendar");

YAHOO.example.calendar.init = function() {
    //instantiate Calendar:
    YAHOO.example.calendar.cal1 = new YAHOO.widget.Calendar("cal1","cal1container");
    
    //profile the instance, labeling it "cal1":
    YAHOO.tool.Profiler.registerObject("cal1", YAHOO.example.calendar.cal1 );
    
    //render the Calendar; after this line, the Calendar is on the page,
    //ready to be used; all the while, Profiler will be tracking the time
    //spent in each function:
    YAHOO.example.calendar.cal1.render();
    
    YAHOO.example.pv = new YAHOO.widget.ProfilerViewer("profiler", {
        showChart: true, //we want to see the pretty charts!
        base:"http://yui.yahooapis.com/2.9.0/build/", //path to YUI assets; if you leave this
                             //blank, files will be drawn from 
                             //yui.yahooapis.com.
        //path to Charts Control swf file; if left blank, we'll
        //use the one from yui.yahooapis.com; this path is relative
        //to your current HTML page:
        swfUrl: "http://yui.yahooapis.com/2.9.0/build/charts/assets/charts.swf",
        
        //In this case we only want to see functions that have
        //been called at least once and that have the "cal1"
        //label associated with them in Profiler:
        filter: function(o) {
            //Only show functions that have been called at least
            //once and that are part of the cal1 object:
            return ((o.calls > 0) && (o.fn.indexOf("cal1") > -1));
        }
    });

}

//Run the calendar.innit function only when the Dom is fully loaded:
YAHOO.util.Event.onDOMReady(YAHOO.example.calendar.init);

ProfilerViewer Control Examples:

More ProfilerViewer Control Resources:

All YUI 2.x users should review the YUI 2.8.2 security bulletin, which discusses a vulnerability present in YUI 2.4.0-2.8.1.