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:

<link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/http://yui.yahooapis.com/2.5.1//build/calendar/assets/skins/sam/calendar.css"> <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.5.1/build/profilerviewer/assets/skins/sam/profilerviewer.css"> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/utilities/utilities.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/element/element-beta-min.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/calendar/calendar.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/yuiloader/yuiloader-beta-min.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/profiler/profiler-beta-min.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.1/build/profilerviewer/profilerviewer-beta-min.js"></script>

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

<div id="profiler"> <!--ProfilerViewer will be inserted here.--> </div> <div id="cal1container"> <!--Calendar instance will be inserted here.--> </div>

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

//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();

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

//instantiate ProfilerViewer: var pv = new YAHOO.widget.ProfilerViewer("profiler", { showChart: true, //we want to see the pretty charts! base:"../../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: "../../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)); } });

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:"../../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: "../../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);