DevTools: add extension API to contribute trace events to timeline

third_party/WebKit/Source/devtools/front_end/extensions/ExtensionAPI.js

 /*
  * Copyright (C) 2012 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 49 matching lines @@
     ViewHidden: 'view-hidden-'
   };
 
   /** @enum {string} */
   apiPrivate.Commands = {
     AddAuditCategory: 'addAuditCategory',
     AddAuditResult: 'addAuditResult',
     AddRequestHeaders: 'addRequestHeaders',
     AddTraceProvider: 'addTraceProvider',
     ApplyStyleSheet: 'applyStyleSheet',
+    CompleteTraceSession: 'completeTraceSession',
     CreatePanel: 'createPanel',
     CreateSidebarPane: 'createSidebarPane',
     CreateToolbarButton: 'createToolbarButton',
     EvaluateOnInspectedPage: 'evaluateOnInspectedPage',
     ForwardKeyboardEvent: '_forwardKeyboardEvent',
     GetHAR: 'getHAR',
     GetPageResources: 'getPageResources',
     GetRequestContent: 'getRequestContent',
     GetResourceContent: 'getResourceContent',
     InspectedURLChanged: 'inspectedURLChanged',
@@ skipping 281 matching lines @@
 
   var AuditCategory = declareInterfaceClass(AuditCategoryImpl);
   var AuditResult = declareInterfaceClass(AuditResultImpl);
   var Button = declareInterfaceClass(ButtonImpl);
   var EventSink = declareInterfaceClass(EventSinkImpl);
   var ExtensionPanel = declareInterfaceClass(ExtensionPanelImpl);
   var ExtensionSidebarPane = declareInterfaceClass(ExtensionSidebarPaneImpl);
   var PanelWithSidebar = declareInterfaceClass(PanelWithSidebarImpl);
   var Request = declareInterfaceClass(RequestImpl);
   var Resource = declareInterfaceClass(ResourceImpl);
+  var TraceSession = declareInterfaceClass(TraceSessionImpl);
 
   /**
    * @constructor
    * @extends {PanelWithSidebar}
    */
   function ElementsPanel() {
     PanelWithSidebar.call(this, 'elements');
   }
 
   ElementsPanel.prototype = {__proto__: PanelWithSidebar.prototype};
@@ skipping 117 matching lines @@
       extensionServer.sendRequest(
           {command: commands.AddTraceProvider, id: id, categoryName: categoryName, categoryTooltip: categoryTooltip});
       return new TraceProvider(id);
     }
   };
 
   /**
    * @constructor
    * @param {string} id
    */
+  function TraceSessionImpl(id) {
+    this._id = id;
+  }
+
+  TraceSessionImpl.prototype = {
+    /**
+     * @param {string=} url
+     * @param {number=} timeOffset
+     */
+    complete: function(url, timeOffset) {
+      var request = {
+        command: commands.CompleteTraceSession,
+        id: this._id,
+        url: url || '',
+        timeOffset: timeOffset || 0
+      };
+      extensionServer.sendRequest(request);
+    }
+  }
+
+  /**
+   * @constructor
+   * @param {string} id
+   */
   function TraceProvider(id) {
-    this.onRecordingStarted = new EventSink(events.RecordingStarted + id);
+    /**
+     * @this {EventSinkImpl}
+     */
+    function dispatchRecordingStarted(message) {
+      var sessionId = message.arguments[0];
+      this._fire(new TraceSession(sessionId));
+    }
+
+    this.onRecordingStarted = new EventSink(events.RecordingStarted + id, dispatchRecordingStarted);
     this.onRecordingStopped = new EventSink(events.RecordingStopped + id);
   }
 
   /**
    * @constructor
    */
   function Audits() {
   }
 
   Audits.prototype = {
@@ skipping 392 matching lines @@
  * @return {string}
  */
 function buildExtensionAPIInjectedScript(extensionInfo, inspectedTabId, themeName, testHook) {
   var argumentsJSON = [extensionInfo, inspectedTabId || null, themeName].map(_ => JSON.stringify(_)).join(',');
   if (!testHook)
     testHook = () => {};
   return '(function(injectedScriptId){ ' + defineCommonExtensionSymbols.toString() + ';' +
       '(' + injectedExtensionAPI.toString() + ')(' + argumentsJSON + ',' + testHook + ', injectedScriptId);' +
       '})';
 }