src/third_party/WebKit/Source/devtools/front_end/TracingAgent.js

   1 /*
   2  * Copyright (C) 2013 Google Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions are
   6  * met:
   7  *
   8  *     * Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *     * Redistributions in binary form must reproduce the above
  11  * copyright notice, this list of conditions and the following disclaimer
  12  * in the documentation and/or other materials provided with the
  13  * distribution.
  14  *     * Neither the name of Google Inc. nor the names of its
  15  * contributors may be used to endorse or promote products derived from
  16  * this software without specific prior written permission.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  */
  30
  31 /**
  32  * @constructor
  33  */
  34 WebInspector.TracingAgent = function()
  35 {
  36     this._active = false;
  37     InspectorBackend.registerTracingDispatcher(new WebInspector.TracingDispatcher(this));
  38 }
  39
  40 WebInspector.TracingAgent.prototype = {
  41     /**
  42      * @param {string} categoryPatterns
  43      * @param {string} options
  44      * @param {function(?string)=} callback
  45      */
  46     start: function(categoryPatterns, options, callback)
  47     {
  48         TracingAgent.start(categoryPatterns, options, callback);
  49         this._active = true;
  50         this._events = [];
  51     },
  52
  53     /**
  54      * @param {function()} callback
  55      */
  56     stop: function(callback)
  57     {
  58         if (!this._active) {
  59             callback();
  60             return;
  61         }
  62         this._pendingStopCallback = callback;
  63         TracingAgent.end();
  64     },
  65
  66     /**
  67      * @return {!Array.<!{cat: string, args: !Object, ph: string, ts: number}>}
  68      */
  69     events: function()
  70     {
  71         return this._events;
  72     },
  73
  74     _eventsCollected: function(events)
  75     {
  76         Array.prototype.push.apply(this._events, events);
  77     },
  78
  79     _tracingComplete: function()
  80     {
  81         this._active = false;
  82         if (this._pendingStopCallback) {
  83             this._pendingStopCallback();
  84             this._pendingStopCallback = null;
  85         }
  86     }
  87 }
  88
  89 /**
  90  * @constructor
  91  * @implements {TracingAgent.Dispatcher}
  92  * @param {!WebInspector.TracingAgent} tracingAgent
  93  */
  94 WebInspector.TracingDispatcher = function(tracingAgent)
  95 {
  96     this._tracingAgent = tracingAgent;
  97 }
  98
  99 WebInspector.TracingDispatcher.prototype = {
 100     dataCollected: function(data)
 101     {
 102         this._tracingAgent._eventsCollected(data);
 103     },
 104
 105     tracingComplete: function()
 106     {
 107         this._tracingAgent._tracingComplete();
 108     }
 109 }
 110
 111 /**
 112  * @type {!WebInspector.TracingAgent}
 113  */
 114 WebInspector.tracingAgent;