Fix globals, part 6: performance (#33339)

* move * Update package.json * Apply suggestions from code review Co-authored-by: wbamberg <[email protected]> * fix * Update files/en-us/web/api/workerglobalscope/index.md * Update files/en-us/web/api/workerglobalscope/performance/index.md * Update files/en-us/web/api/workerglobalscope/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --------- Co-authored-by: wbamberg <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
mdn · May 6, 2024 · 54962bb · 54962bb
1 parent fb82244
commit 54962bb
Show file tree

Hide file tree

Showing 13 changed files with 103 additions and 87 deletions.
diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt
@@ -2196,7 +2196,7 @@
 /en-US/docs/DOM/window.outerHeight	/en-US/docs/Web/API/Window/outerHeight
 /en-US/docs/DOM/window.outerWidth	/en-US/docs/Web/API/Window/outerWidth
 /en-US/docs/DOM/window.parent	/en-US/docs/Web/API/Window/parent
-/en-US/docs/DOM/window.performance	/en-US/docs/Web/API/performance_property
+/en-US/docs/DOM/window.performance	/en-US/docs/Web/API/Window/performance
 /en-US/docs/DOM/window.performance.now	/en-US/docs/Web/API/Performance/now
 /en-US/docs/DOM/window.personalbar	/en-US/docs/Web/API/Window/personalbar
 /en-US/docs/DOM/window.postMessage	/en-US/docs/Web/API/Window/postMessage
@@ -10210,7 +10210,6 @@
 /en-US/docs/Web/API/Window/openDialog	/en-US/docs/Web/API/Window
 /en-US/docs/Web/API/Window/pageXOffset	/en-US/docs/Web/API/Window/scrollX
 /en-US/docs/Web/API/Window/pageYOffset	/en-US/docs/Web/API/Window/scrollY
-/en-US/docs/Web/API/Window/performance	/en-US/docs/Web/API/performance_property
 /en-US/docs/Web/API/Window/removeEventListener	/en-US/docs/Web/API/EventTarget/removeEventListener
 /en-US/docs/Web/API/Window/resolveLocalFileSystemURL	/en-US/docs/Web/API/File_and_Directory_Entries_API#resolvelocalfilesystemurl()
 /en-US/docs/Web/API/Window/restore	/en-US/docs/Web/API/Window/moveTo
@@ -10303,7 +10302,7 @@
 /en-US/docs/Web/API/WorkerGlobalScope.onlanguagechange	/en-US/docs/Web/API/WorkerGlobalScope/languagechange_event
 /en-US/docs/Web/API/WorkerGlobalScope.onoffline	/en-US/docs/Web/API/WorkerGlobalScope/offline_event
 /en-US/docs/Web/API/WorkerGlobalScope.ononline	/en-US/docs/Web/API/WorkerGlobalScope/online_event
-/en-US/docs/Web/API/WorkerGlobalScope.performance	/en-US/docs/Web/API/performance_property
+/en-US/docs/Web/API/WorkerGlobalScope.performance	/en-US/docs/Web/API/WorkerGlobalScope/performance
 /en-US/docs/Web/API/WorkerGlobalScope.self	/en-US/docs/Web/API/WorkerGlobalScope/self
 /en-US/docs/Web/API/WorkerGlobalScope/WorkerGlobalScope.caches	/en-US/docs/Web/API/caches
 /en-US/docs/Web/API/WorkerGlobalScope/atob	/en-US/docs/Web/API/atob
@@ -10319,7 +10318,6 @@
 /en-US/docs/Web/API/WorkerGlobalScope/onlanguagechange	/en-US/docs/Web/API/WorkerGlobalScope/languagechange_event
 /en-US/docs/Web/API/WorkerGlobalScope/onoffline	/en-US/docs/Web/API/WorkerGlobalScope/offline_event
 /en-US/docs/Web/API/WorkerGlobalScope/ononline	/en-US/docs/Web/API/WorkerGlobalScope/online_event
-/en-US/docs/Web/API/WorkerGlobalScope/performance	/en-US/docs/Web/API/performance_property
 /en-US/docs/Web/API/WorkerGlobalScope/requestFileSystemSync	/en-US/docs/Web/API/File_and_Directory_Entries_API
 /en-US/docs/Web/API/WorkerGlobalScope/setInterval	/en-US/docs/Web/API/setInterval
 /en-US/docs/Web/API/WorkerGlobalScope/setTimeout	/en-US/docs/Web/API/setTimeout
@@ -10707,6 +10705,7 @@
 /en-US/docs/Web/API/onMSVideoOptimalLayoutChanged	/en-US/docs/Web/API/HTMLVideoElement
 /en-US/docs/Web/API/onMSVideoOptimalLayoutChanged_	/en-US/docs/Web/API/HTMLVideoElement
 /en-US/docs/Web/API/origin	/en-US/docs/Web/API/Window/origin
+/en-US/docs/Web/API/performance_property	/en-US/docs/Web/API/Window/performance
 /en-US/docs/Web/API/range.cloneContents	/en-US/docs/Web/API/range/cloneContents
 /en-US/docs/Web/API/range.cloneRange	/en-US/docs/Web/API/range/cloneRange
 /en-US/docs/Web/API/range.collapse	/en-US/docs/Web/API/range/collapse
@@ -10888,7 +10887,7 @@
 /en-US/docs/Web/API/window.outerHeight	/en-US/docs/Web/API/Window/outerHeight
 /en-US/docs/Web/API/window.outerWidth	/en-US/docs/Web/API/Window/outerWidth
 /en-US/docs/Web/API/window.parent	/en-US/docs/Web/API/Window/parent
-/en-US/docs/Web/API/window.performance	/en-US/docs/Web/API/performance_property
+/en-US/docs/Web/API/window.performance	/en-US/docs/Web/API/Window/performance
 /en-US/docs/Web/API/window.performance.now	/en-US/docs/Web/API/Performance/now
 /en-US/docs/Web/API/window.personalbar	/en-US/docs/Web/API/Window/personalbar
 /en-US/docs/Web/API/window.postMessage	/en-US/docs/Web/API/Window/postMessage

diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json
@@ -67960,6 +67960,26 @@
     "modified": "2020-10-15T22:16:14.230Z",
     "contributors": ["mfuji09", "wbamberg"]
   },
+  "Web/API/Window/performance": {
+    "modified": "2020-10-15T21:22:10.802Z",
+    "contributors": [
+      "sideshowbarker",
+      "connorshea",
+      "Sheppy",
+      "anonyco",
+      "kmag",
+      "sarafec",
+      "smarts",
+      "jsantell",
+      "fscholz",
+      "paul.irish",
+      "teoli",
+      "julienw",
+      "iamanupmenon",
+      "ethertank",
+      "MattBrubeck"
+    ]
+  },
   "Web/API/Window/personalbar": {
     "modified": "2020-10-15T21:14:01.101Z",
     "contributors": [
@@ -71578,26 +71598,6 @@
       "kscarfone"
     ]
   },
-  "Web/API/performance_property": {
-    "modified": "2020-10-15T21:22:10.802Z",
-    "contributors": [
-      "sideshowbarker",
-      "connorshea",
-      "Sheppy",
-      "anonyco",
-      "kmag",
-      "sarafec",
-      "smarts",
-      "jsantell",
-      "fscholz",
-      "paul.irish",
-      "teoli",
-      "julienw",
-      "iamanupmenon",
-      "ethertank",
-      "MattBrubeck"
-    ]
-  },
   "Web/API/queueMicrotask": {
     "modified": "2020-10-15T22:21:06.789Z",
     "contributors": [

diff --git a/files/en-us/web/api/performance/index.md b/files/en-us/web/api/performance/index.md
@@ -9,7 +9,7 @@ browser-compat: api.Performance
 
 The **`Performance`** interface provides access to performance-related information for the current page.
 
-An object of this type can be obtained by calling `window.performance` or `self.performance` in workers. Note that Performance entries are per context. If you create a mark on the main thread (or other worker), you cannot see it in a worker thread, and vice versa. See [`self.performance`](/en-US/docs/Web/API/performance_property) for which APIs are available in window and worker contexts.
+Performance entries are specific to each execution context. You can access performance information for code running in a window via {{domxref("Window.performance")}}, and for code running in a worker via {{domxref("WorkerGlobalScope.performance")}}.
 
 {{InheritanceDiagram}}
 

diff --git a/files/en-us/web/api/performance_api/index.md b/files/en-us/web/api/performance_api/index.md
@@ -29,7 +29,7 @@ Each performance metric is represented by a single {{domxref("PerformanceEntry")
 
 Most of the performance entries are recorded for you without you having to do anything, and are then accessible either through {{domxref("Performance.getEntries()")}} or (preferably) through {{domxref("PerformanceObserver")}}. For example, {{domxref("PerformanceEventTiming")}} entries are recorded for events that take longer than a set threshold. But the Performance API also enables you to define and record your own custom events, using the {{domxref("PerformanceMark")}} and {{domxref("PerformanceMeasure")}} interfaces.
 
-The main {{domxref("Performance")}} interface is available for each global using {{domxref("performance_property", "self.performance")}} and enables you to add custom performance entries, to clear performance entries, and to retrieve performance entries.
+The main {{domxref("Performance")}} interface is available in both {{domxref("Window.performance", "Window")}} and {{domxref("WorkerGlobalScope.performance", "Worker")}} global scopes, and enables you to add custom performance entries, to clear performance entries, and to retrieve performance entries.
 
 The {{domxref("PerformanceObserver")}} interface enables you to listen for various types of performance entry as they are recorded.
 
@@ -50,7 +50,7 @@ The following interfaces are present in the Performance API:
 - {{domxref("LayoutShiftAttribution")}}
   - : Provides debugging information about elements which have shifted.
 - {{domxref("Performance")}}
-  - : Main interface to access performance measurements. Available to window and worker contexts using {{domxref("performance_property", "self.performance")}}.
+  - : Main interface to access performance measurements. Available to window and worker contexts using {{domxref("Window.performance")}} or {{domxref("WorkerGlobalScope.performance")}}.
 - {{domxref("PerformanceElementTiming")}}
   - : Measures rendering timestamps of specific elements.
 - {{domxref("PerformanceEntry")}}

diff --git a/files/en-us/web/api/performance_api/performance_data/index.md b/files/en-us/web/api/performance_api/performance_data/index.md
@@ -22,7 +22,7 @@ For some metrics you do have to tell the browser what to measure:
 
 ## Performance data structure
 
-The Performance API collects performance data for each global object (`window.performance` or `self.performance` in workers). See [`self.performance`](/en-US/docs/Web/API/performance_property) for which APIs are available in window and worker contexts. If you are collecting performance metrics for multiple contexts, also take a look at [`performance.timeOrigin`](/en-US/docs/Web/API/Performance/timeOrigin) to synchronize time origins between contexts.
+With the Performance API you can collect performance data in both {{domxref("Window.performance", "Window")}} and {{domxref("WorkerGlobalScope.performance", "Worker")}} global contexts. If you are collecting performance metrics for multiple contexts, take a look at {{domxref("performance.timeOrigin")}} to synchronize time origins between contexts.
 
 Within these contexts, individual performance data is represented by performance entries.
 

diff --git a/files/en-us/web/api/performance_property/index.md b/files/en-us/web/api/performance_property/index.md
diff --git a/files/en-us/web/api/window/index.md b/files/en-us/web/api/window/index.md
@@ -105,7 +105,7 @@ Note that properties which are objects (e.g., for overriding the prototype of bu
   - : An alias for {{domxref("window.scrollY")}}.
 - {{domxref("Window.parent")}} {{ReadOnlyInline}}
   - : Returns a reference to the parent of the current window or subframe.
-- {{domxref("performance_property", "Window.performance")}} {{ReadOnlyInline}}
+- {{domxref("Window.performance")}} {{ReadOnlyInline}}
   - : Returns a {{domxref("Performance")}} object, which includes the {{domxref("Performance.timing", "timing")}} and {{domxref("Performance.navigation", "navigation")}} attributes, each of which is an object providing [performance-related](/en-US/docs/Web/API/Performance_API/Navigation_timing) data. See also [Using Navigation Timing](/en-US/docs/Web/API/Performance_API/Navigation_timing) for additional information and examples.
 - {{domxref("Window.personalbar")}} {{ReadOnlyInline}}
   - : Returns the personalbar object.

diff --git a/files/en-us/web/api/window/performance/index.md b/files/en-us/web/api/window/performance/index.md
@@ -0,0 +1,29 @@
+---
+title: "Window: performance property"
+short-title: performance
+slug: Web/API/Window/performance
+page-type: web-api-instance-property
+browser-compat: api.performance
+---
+
+{{APIRef("Performance API")}}
+
+The **`performance`** property of the {{domxref("Window")}} interface returns a {{domxref("Performance")}} object, which can be used to gather performance information about code running in the window's scope.
+
+Performance entries are per context. If you create a mark on the main thread (or other worker), you cannot see it in a worker thread, and vice versa.
+
+## Value
+
+A {{domxref("Performance")}} object offering access to performance and timing-related information about code running in the window's scope.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("WorkerGlobalScope.performance")}}
diff --git a/files/en-us/web/api/workerglobalscope/index.md b/files/en-us/web/api/workerglobalscope/index.md
@@ -37,8 +37,8 @@ _This interface inherits properties from the {{domxref("EventTarget")}} interfac
   - : Returns the {{domxref("WorkerNavigator")}} associated with the worker. It is a specific navigator object, mostly a subset of the {{domxref("Navigator")}} for browsing scopes, but adapted to workers.
 - {{domxref("WorkerGlobalScope.origin")}} {{ReadOnlyInline}}
   - : Returns the global object's origin, serialized as a string.
-- {{domxref("performance_property", "WorkerGlobalScope.performance")}} {{ReadOnlyInline}}
-  - : Returns the {{domxref("Performance")}} associated with the worker. It is a regular performance object, except that only a subset of its property and methods are available to workers.
+- {{domxref("WorkerGlobalScope.performance")}} {{ReadOnlyInline}}
+  - : Returns the {{domxref("Performance")}} associated with the worker. Only a subset of the properties and methods of the `Performance` interface are available to workers.
 - {{domxref("scheduler_property", "WorkerGlobalScope.scheduler")}} {{ReadOnlyInline}}
   - : Returns the {{domxref("Scheduler")}} object associated with the current context. This is the entry point for using the [Prioritized Task Scheduling API](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API).
 - {{domxref("WorkerGlobalScope.self")}} {{ReadOnlyInline}}

diff --git a/files/en-us/web/api/workerglobalscope/performance/index.md b/files/en-us/web/api/workerglobalscope/performance/index.md
@@ -0,0 +1,40 @@
+---
+title: "WorkerGlobalScope: performance property"
+short-title: performance
+slug: Web/API/WorkerGlobalScope/performance
+page-type: web-api-instance-property
+browser-compat: api.performance
+---
+
+{{APIRef("Performance API")}}
+
+The **`performance`** property of the {{domxref("WorkerGlobalScope")}} interface returns a {{domxref("Performance")}} object, which can be used to gather performance information about code running in the worker's scope.
+
+Performance entries are per context. If you create a mark on a worker thread, you will not see it in the main thread or any other workers.
+
+Note that only the following performance interfaces are available in worker contexts:
+
+- {{domxref("Performance")}}
+- {{domxref("PerformanceEntry")}}
+- {{domxref("PerformanceMark")}}
+- {{domxref("PerformanceMeasure")}}
+- {{domxref("PerformanceObserver")}}
+- {{domxref("PerformanceObserverEntryList")}}
+- {{domxref("PerformanceResourceTiming")}}
+- {{domxref("PerformanceServerTiming")}}
+
+## Value
+
+A {{domxref("Performance")}} object offering access to performance and timing-related information for the context it is called on.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("Window.performance")}}
diff --git a/files/en-us/web/javascript/reference/global_objects/date/gettime/index.md b/files/en-us/web/javascript/reference/global_objects/date/gettime/index.md
@@ -78,7 +78,7 @@ end = new Date();
 console.log(`Operation took ${end.getTime() - start.getTime()} msec`);
 ```
 
-> **Note:** In browsers that support the {{domxref("performance_property", "Web Performance API", "", 1)}}'s high-resolution time feature, {{domxref("Performance.now()")}} can provide more reliable and precise measurements of elapsed time than {{jsxref("Date.now()")}}.
+> **Note:** In browsers that support the {{domxref("Performance API", "", "", "nocode")}}'s high-resolution time feature, {{domxref("Performance.now()")}} can provide more reliable and precise measurements of elapsed time than {{jsxref("Date.now()")}}.
 
 ## Specifications
 

diff --git a/files/en-us/web/javascript/reference/global_objects/date/index.md b/files/en-us/web/javascript/reference/global_objects/date/index.md
@@ -409,7 +409,7 @@ function printElapsedTime(testFn) {
 const yourFunctionReturn = printElapsedTime(yourFunction);
 ```
 
-> **Note:** In browsers that support the {{domxref("performance_property", "Web Performance API", "", 1)}}'s high-resolution time feature, {{domxref("Performance.now()")}} can provide more reliable and precise measurements of elapsed time than {{jsxref("Date.now()")}}.
+> **Note:** In browsers that support the {{domxref("Performance API", "", "", "nocode")}}'s high-resolution time feature, {{domxref("Performance.now()")}} can provide more reliable and precise measurements of elapsed time than {{jsxref("Date.now()")}}.
 
 ### Get the number of seconds since the ECMAScript Epoch
 

diff --git a/files/jsondata/GroupData.json b/files/jsondata/GroupData.json
@@ -1108,7 +1108,7 @@
         "VisibilityStateEntry"
       ],
       "methods": [],
-      "properties": ["performance_property"],
+      "properties": ["Window.performance", "WorkerGlobalScope.performance"],
       "events": []
     },
     "Periodic Background Sync": {