DevTools: add an API for extension-supplied trace providers

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 39 matching lines @@
     };
 
     /** @enum {string} */
     apiPrivate.Events = {
         AuditStarted: "audit-started-",
         ButtonClicked: "button-clicked-",
         PanelObjectSelected: "panel-objectSelected-",
         NetworkRequestFinished: "network-request-finished",
         OpenResource: "open-resource",
         PanelSearch: "panel-search-",
+        RecordingStarted: "trace-recording-started-",
+        RecordingStopped: "trace-recording-stopped-",
         ResourceAdded: "resource-added",
         ResourceContentCommitted: "resource-content-committed",
         ViewShown: "view-shown-",
         ViewHidden: "view-hidden-"
     };
 
     /** @enum {string} */
     apiPrivate.Commands = {
         AddAuditCategory: "addAuditCategory",
         AddAuditResult: "addAuditResult",
         AddRequestHeaders: "addRequestHeaders",
+        AddTraceProvider: "addTraceProvider",
         ApplyStyleSheet: "applyStyleSheet",
         CreatePanel: "createPanel",
         CreateSidebarPane: "createSidebarPane",
         CreateToolbarButton: "createToolbarButton",
         EvaluateOnInspectedPage: "evaluateOnInspectedPage",
         ForwardKeyboardEvent: "_forwardKeyboardEvent",
         GetHAR: "getHAR",
         GetPageResources: "getPageResources",
         GetRequestContent: "getRequestContent",
         GetResourceContent: "getResourceContent",
@@ skipping 95 matching lines @@
 
 /**
  * @constructor
  */
 function InspectorExtensionAPI()
 {
     this.audits = new Audits();
     this.inspectedWindow = new InspectedWindow();
     this.panels = new Panels();
     this.network = new Network();
+    this.timeline = new Timeline();
     defineDeprecatedProperty(this, "webInspector", "resources", "network");
 }
 
 /**
  * @constructor
  */
 function Network()
 {
     /**
      * @this {EventSinkImpl}
@@ skipping 346 matching lines @@
             tooltip: tooltipText,
             disabled: !!disabled
         };
         extensionServer.sendRequest(request);
     }
 };
 
 /**
  * @constructor
  */
+function Timeline()
+{
+}
+
+Timeline.prototype = {
+    /**
+     * @param {string} categoryName
+     * @param {string} categoryTooltip
+     * @return {!TraceProvider}
+     */
+    addTraceProvider: function(categoryName, categoryTooltip)
+    {
+        var id = "extension-trace-provider-" + extensionServer.nextObjectId();
+        extensionServer.sendRequest({ command: commands.AddTraceProvider, id: id, categoryName: categoryName, categoryTooltip: categoryTooltip});
+        return new TraceProvider(id);
+    }
+}
+
+/**
+ * @constructor
+ * @param {string} id
+ */
+function TraceProvider(id)
+{
+    this.onRecordingStarted = new EventSink(events.RecordingStarted + id);
+    this.onRecordingStopped = new EventSink(events.RecordingStopped + id);
+}
+
+/**
+ * @constructor
+ */
 function Audits()
 {
 }
 
 Audits.prototype = {
     /**
      * @return {!AuditCategory}
      */
     addCategory: function(displayName, resultCount)
     {
@@ skipping 436 matching lines @@
 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);" +
         "})";
 }