Refresh Performance

Author: armanbilge

api-reports/2_13.txt

@@ -15764,17 +15764,17 @@ Performance[JC] def clearMarks(markName: String?): Unit
 Performance[JC] def clearMeasures(measureName: String?): Unit
 Performance[JC] def clearResourceTimings(): Unit
 Performance[JC] def getEntries(): js.Array[PerformanceEntry]
-Performance[JC] def getEntriesByName(name: String, entryType: String?): js.Array[PerformanceEntry]
+Performance[JC] def getEntriesByName(name: String, `type`: String?): js.Array[PerformanceEntry]
 Performance[JC] def getEntriesByType(entryType: String): js.Array[PerformanceEntry]
-Performance[JC] def getMarks(markName: String?): js.Dynamic
-Performance[JC] def getMeasures(measureName: String?): js.Dynamic
-Performance[JC] def mark(markName: String): Unit
-Performance[JC] def measure(measureName: String, startMarkName: String?, endMarkName: String?): Unit
+Performance[JC] def getMarks(markName: String?): js.Dynamic  (@deprecated in 2.4.0)
+Performance[JC] def getMeasures(measureName: String?): js.Dynamic  (@deprecated in 2.4.0)
+Performance[JC] def mark(markName: String): PerformanceMark
+Performance[JC] def measure(measureName: String, startMarkName: String?, endMarkName: String?): PerformanceMeasure
 Performance[JC] def navigation: PerformanceNavigation
 Performance[JC] def now(): Double
 Performance[JC] def setResourceTimingBufferSize(maxSize: Int): Unit
 Performance[JC] def timing: PerformanceTiming
-Performance[JC] def toJSON(): js.Dynamic
+Performance[JC] def toJSON(): js.Object
 PerformanceEntry[JC] def duration: Int
 PerformanceEntry[JC] def entryType: String
 PerformanceEntry[JC] def name: String

dom/src/main/scala/org/scalajs/dom/Performance.scala

@@ -28,29 +28,49 @@ class Performance private[this] () extends js.Object {
     */
   def timing: PerformanceTiming = js.native
 
+  /** Returns an array of [[PerformanceEntry]] objects currently present in the performance timeline for a given type */
   def getEntriesByType(entryType: String): js.Array[PerformanceEntry] = js.native
 
   /** Is a jsonizer returning a json object representing the Performance object. */
-  def toJSON(): js.Dynamic = js.native
+  def toJSON(): js.Object = js.native
 
+  @deprecated("No such API in the spec", "2.4.0")
   def getMeasures(measureName: String = js.native): js.Dynamic = js.native
 
+  /** Removes all or specific [[PerformanceMark]] objects from the browser's performance timeline. */
   def clearMarks(markName: String = js.native): Unit = js.native
 
+  @deprecated("No such API in the spec", "2.4.0")
   def getMarks(markName: String = js.native): js.Dynamic = js.native
 
+  /** Removes all performance entries with an `entryType` of "resource" from the browser's performance timeline and sets
+    * the size of the performance resource data buffer to zero.
+    */
   def clearResourceTimings(): Unit = js.native
 
-  def mark(markName: String): Unit = js.native
+  /** Creates a named [[PerformanceMark]] object representing a high resolution timestamp marker in the browser's
+    * performance timeline.
+    */
+  def mark(markName: String): PerformanceMark = js.native
 
-  def measure(measureName: String, startMarkName: String = js.native, endMarkName: String = js.native): Unit = js.native
+  /** Creates a named [[PerformanceMeasure]] object representing a time measurement between two marks in the browser's
+    * performance timeline.
+    */
+  def measure(measureName: String, startMarkName: String = js.native,
+      endMarkName: String = js.native): PerformanceMeasure = js.native
 
-  def getEntriesByName(name: String, entryType: String = js.native): js.Array[PerformanceEntry] = js.native
+  /** Returns an array of [[PerformanceEntry]] objects currently present in the performance timeline with the given name
+    * and type.
+    */
+  def getEntriesByName(name: String, `type`: String = js.native): js.Array[PerformanceEntry] = js.native
 
+  /** All [[PerformanceEntry]] objects currently present in the performance timeline. */
   def getEntries(): js.Array[PerformanceEntry] = js.native
 
+  /** Removes all or specific [[PerformanceMeasure]] objects from the browser's performance timeline. */
   def clearMeasures(measureName: String = js.native): Unit = js.native
 
+  /** sets the desired size of the browser's resource timing buffer which stores the "resource" performance entries. */
   def setResourceTimingBufferSize(maxSize: Int): Unit = js.native
 
   /** Returns a DOMHighResTimeStamp representing the amount of milliseconds elapsed since the start of the navigation,