Sync core/timing/ interfaces with their specs, or lack thereof

Source/core/timing/WorkerPerformance.idl

 /*
  * Copyright (C) 2013 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 10 matching lines @@
  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+// TODO(philipj): There is no spec for Performance in workers:
+// https://github.com/w3c/hr-time/issues/10
+// For now, this interface is a subset of the Performance interface.
+
+// https://w3c.github.io/hr-time/#the-performance-interface
+
+// TODO(philipj): None of the optional DOMString arguments in this interface
+// should have a default value.
 [
     GarbageCollected,
     NoInterfaceObject
 ] interface WorkerPerformance : EventTarget {
-    // See https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/HighResolutionTime2/Overview.html for details.
-    double now();
+    DOMHighResTimeStamp now();
 
-    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] sequence<PerformanceEntry> getEntries();
-    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] sequence<PerformanceEntry> getEntriesByType(DOMString entryType);
-    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] sequence<PerformanceEntry> getEntriesByName(DOMString name, optional DOMString entryType = null);
+    // Performance Timeline
+    // https://w3c.github.io/performance-timeline/#the-performance-interface
+    // TODO(philipj): getEntries() should take an optional FilterOptions argument.
+    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] PerformanceEntryList getEntries();
+    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] PerformanceEntryList getEntriesByType(DOMString entryType);
+    [RuntimeEnabled=ServiceWorkerPerformanceTimeline] PerformanceEntryList getEntriesByName(DOMString name, optional DOMString entryType = null);
 
-    // See http://www.w3.org/TR/resource-timing/
+    // Resource Timing
+    // https://w3c.github.io/resource-timing/#extensions-performance-interface
+    // TODO(philipj): Unprefix thes APIs.
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline, MeasureAs=PrefixedPerformanceClearResourceTimings] void webkitClearResourceTimings();
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline, MeasureAs=PrefixedPerformanceSetResourceTimingBufferSize] void webkitSetResourceTimingBufferSize(unsigned long maxSize);
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline] attribute EventHandler onwebkitresourcetimingbufferfull;
 
-    // See http://www.w3.org/TR/2012/CR-user-timing-20120726/
+    // User Timing
+    // https://w3c.github.io/user-timing/#extensions-performance-interface
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline, RaisesException] void mark(DOMString markName);
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline] void clearMarks(optional DOMString markName = null);
 
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline, RaisesException] void measure(DOMString measureName, optional DOMString startMark = null, optional DOMString endMark = null);
     [RuntimeEnabled=ServiceWorkerPerformanceTimeline] void clearMeasures(optional DOMString measureName = null);
 
+    // TODO(philipj): There is no spec for the Memory Info API, see blink-dev:
+    // https://groups.google.com/a/chromium.org/d/msg/blink-dev/g5YRCGpC9vs/b4OJz71NmPwJ
     [RuntimeEnabled=MemoryInfoInWorkers] readonly attribute MemoryInfo memory;
 };
-