Skip to content

Commit 1f0a9e3

Browse files
Add MDN links, update web.dev & developer.chrome.com links (#3552)
* flag some links to update * /webdriver-chromium/ * Revert "/webdriver-chromium/" This reverts commit ef4620c. * flag all web.dev * flag developer.chrome.com * Remove some todos and links * todo pattern for web-dev links * some flagged web.dev links * add mdn link near web.dev link * web.dev update links * update web.dev links * developer.chrome.com * Handle todos * format web.dev comments * Format chrome link comments * fix yaml * condense comments * event is fired * roll back service workers change * Update microsoft-edge/devtools/speed/get-started.md * Removed outdated glitch link --------- Co-authored-by: Patrick Brosset <[email protected]>
1 parent cbdf636 commit 1f0a9e3

38 files changed

+418
-231
lines changed

microsoft-edge/dev-videos/index.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -685,8 +685,7 @@ The Microsoft Edge team specified and implemented the new EyeDropper API in coll
685685
Many creative applications enable users to pick colors from parts of an app window or even from the entire screen, typically using an eyedropper metaphor. The EyeDropper API enables authors to use a browser-supplied eyedropper in the construction of custom color pickers on the web.
686686

687687
See also:
688-
* [Picking colors of any pixel on the screen with the EyeDropper API | web.dev](https://web.dev/eyedropper/)
689-
* [EyeDropper API - Web APIs | MDN developer.mozilla.org](https://developer.mozilla.org/docs/Web/API/EyeDropper_API)
688+
* [EyeDropper API](https://developer.mozilla.org/docs/Web/API/EyeDropper_API) at MDN.
690689
* [EyeDropper API demos](https://github.com/MicrosoftEdge/Demos/tree/main/eyedropper)
691690

692691

microsoft-edge/devtools/device-mode/testing-other-browsers.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,9 @@ Browser emulators don't emulate differences in web API support or CSS support.
4949

5050
Here are some browser emulators you can use to test your website on other browsers:
5151

52-
* [Firefox Responsive Design Mode](https://firefox-source-docs.mozilla.org/devtools-user/responsive_design_mode/index.html).
53-
* [Chrome Device Mode](https://developer.chrome.com/docs/devtools/device-mode).
54-
* [Safari Responsive Design Mode](https://developer.apple.com/documentation/safari-developer-tools/responsive-design-mode).
52+
* [Firefox Responsive Design Mode](https://firefox-source-docs.mozilla.org/devtools-user/responsive_design_mode/index.html)
53+
* [Chrome Device Mode](https://developer.chrome.com/docs/devtools/device-mode)
54+
* [Safari Responsive Design Mode](https://developer.apple.com/documentation/safari-developer-tools/responsive-design-mode)
5555

5656

5757
<!-- ====================================================================== -->

microsoft-edge/devtools/javascript/background-services.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,9 +109,13 @@ After a **service worker** has received a [Push Message](https://developer.mozil
109109
<!-- ====================================================================== -->
110110
## Payment Handler
111111

112-
The [Payment Handler API](https://web.dev/web-based-payment-apps-overview/) allows web applications to handle payment requests on behalf of users. To log the payment request and response events for 3 days, even when DevTools isn't open:
112+
The Payment Handler API allows web applications to handle payment requests on behalf of users. See [Payment Handler API](https://developer.mozilla.org/docs/Web/API/Payment_Handler_API) at MDN.
113113

114-
1. Open DevTools by right-clicking the webpage and selecting **Inspect**. Or by pressing **Ctrl+Shift+I** (Windows, Linux) or **Command+Option+I** (macOS).
114+
To log the payment request and response events for 3 days, even when DevTools isn't open:
115+
116+
1. Right-click the webpage, and then select **Inspect**. DevTools opens.
117+
118+
Or, press **Ctrl+Shift+I** (Windows, Linux) or **Command+Option+I** (macOS).
115119

116120
1. In DevTools, on the main toolbar, select the **Application** tab. If that tab isn't visible, click the **More tabs** (![More tabs icon](./background-services-images/more-tabs-icon-light-theme.png)) button, or else the **More Tools** (![More Tools icon](./background-services-images/more-tools-icon-light-theme.png)) button.
117121

microsoft-edge/devtools/javascript/guides/mark-content-scripts-library-code.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,10 @@ To avoid pausing on extension code:
4545
## See also
4646

4747
* [Step 4: Step through the code](../index.md#step-4-step-through-the-code) in _Get started debugging JavaScript_
48-
* [Content scripts](https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts) in Chrome Extensions docs.
48+
* [Content scripts](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/Content_scripts) at MDN.
49+
<!--
50+
* [Sample: Picture inserter using content script](../../../extensions/getting-started/picture-inserter-content-script.md)
51+
-->
4952

5053

5154
<!-- ====================================================================== -->

microsoft-edge/devtools/performance/index.md

Lines changed: 11 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,12 @@ ms.date: 09/04/2023
2626

2727
_Runtime performance_ is how your page performs when it's running, as opposed to loading. The following tutorial teaches you how to use the DevTools **Performance** tool to analyze runtime performance.
2828

29-
The skills you learn in this tutorial are useful for analyzing loading, interactivity, and visual stability of your web content, which are also key indicators for [Core Web Vitals](https://web.dev/vitals/). Each of the Core Web Vitals represents a distinct facet of the user experience, is measurable in the field, and reflects the real-world experience of a critical user-centric outcome. You can see these Core Web Vitals in the **Performance** tool.
29+
The skills you learn in this tutorial are useful for analyzing loading, interactivity, and visual stability of your web content, which are also key indicators for Core Web Vitals. Each of the Core Web Vitals represents a distinct facet of the user experience, is measurable in the field, and reflects the real-world experience of a critical user-centric outcome. You can see these Core Web Vitals in the **Performance** tool.
3030

3131
See also:
32-
- [Optimize website speed using Lighthouse](../speed/get-started.md)
32+
* [Web Vitals](https://web.dev/articles/vitals)<!-- web.dev link ok, only doc'd there --> at web.dev.
33+
* [Terminology](./overview.md#terminology) in _Performance tool: Analyze your website's performance_.
34+
* [Optimize website speed using Lighthouse](../speed/get-started.md)
3335

3436

3537
<!-- ====================================================================== -->
@@ -184,9 +186,9 @@ Continuing from above:
184186
![The line of code that caused the forced layout](./index-images/sources-app-update.png)
185187

186188
The problem with the unoptimized code is that, in each animation frame, it changes the style for each icon, and then queries the position of each icon on the page. Because the styles changed, the browser doesn't know if each icon position changed, so it has to re-layout the icon in order to compute the new position.
187-
<!--
188-
> To learn more, see [Avoid forced synchronous layouts](https://web.dev/avoid-large-complex-layouts-and-layout-thrashing/#avoid-forced-synchronous-layouts).
189-
-->
189+
190+
See also:
191+
* [Avoid forced synchronous layouts](https://web.dev/articles/avoid-large-complex-layouts-and-layout-thrashing#avoid_forced_synchronous_layouts)<!-- web.dev link ok, no perf doc'n at mdn --> in _Avoid large, complex layouts and layout thrashing_ at web.dev.
190192

191193

192194
<!-- ------------------------------ -->
@@ -267,15 +269,14 @@ We then adjust the direction of the icon, but this time we don't read `element.o
267269

268270
Finally, we set the new position of the icon, but this time we use `element.style.transform` instead of `element.style.top`. Using `element.style.transform` is faster, because the CSS `transform` property can be applied by the browser rendering engine without having to recalculate the layout of the page. When using the `transform` property, the browser considers each icon as an individual layer, and then displays these layers in the correct positions by re-compositing the final image.
269271

270-
To learn more, see [Use transform and opacity changes for animations](https://web.dev/stick-to-compositor-only-properties-and-manage-layer-count/#use-transform-and-opacity-changes-for-animations).
272+
See also:
273+
* [Avoid properties that trigger layout or paint](https://web.dev/articles/animations-guide#triggers)<!-- web.dev link ok, not doc'd at mdn --> in _How to create high-performance CSS animations_ at web.dev.
274+
* [Transitioning opacity](https://developer.mozilla.org/docs/Web/CSS/opacity#transitioning_opacity) in _opacity_ at MDN.
271275

272276

273277
<!-- ====================================================================== -->
274278
## Next steps
275279

276-
<!--The foundation for understanding performance is the RAIL model. The RAIL model teaches you the performance metrics that are most important to your users.
277-
To learn more, see [Measure Performance With The RAIL Model](https://web.dev/rail/). -->
278-
279280
To get more comfortable with the **Performance** tool, practice profiling your pages and analyzing the results.
280281

281282
If you have any questions about your results, in the **Activity Bar**, select **Help** (![the Help icon in the Activity Bar](./index-images/help-icon.png)) > **Feedback**. Or, press **Alt+Shift+I** (Windows, Linux) or **Option+Shift+I** (macOS).
@@ -284,16 +285,7 @@ Or, [file an issue on the MicrosoftEdge / DevTools repo](https://github.com/Micr
284285

285286
In your feedback, include screenshots or links to reproducible pages, if possible.
286287

287-
There are many ways to improve runtime performance. This article focused on one particular animation bottleneck to give you a focused tour of the **Performance** tool, but it's only one of many bottlenecks you may encounter. <!-- The rest of the Rendering Performance series has a lot of good tips for improving various aspects of runtime performance, such as: -->
288-
289-
<!--
290-
* [Optimize JavaScript execution](https://web.dev/optimize-javascript-execution/)
291-
* [Reduce the scope and complexity of style calculations](https://web.dev/reduce-the-scope-and-complexity-of-style-calculations/)
292-
* [Avoid large, complex layouts and layout thrashing](https://web.dev/avoid-large-complex-layouts-and-layout-thrashing/)
293-
* [Simplify paint complexity and reduce paint areas](https://web.dev/simplify-paint-complexity-and-reduce-paint-areas/)
294-
* [Stick to Compositor-Only Properties and Manage Layer Count](https://web.dev/stick-to-compositor-only-properties-and-manage-layer-count/)
295-
* [Debounce your input handlers](https://web.dev/debounce-your-input-handlers/)
296-
-->
288+
There are many ways to improve runtime performance. This article focused on one particular animation bottleneck to give you a focused tour of the **Performance** tool, but it's only one of many bottlenecks you may encounter.
297289

298290

299291
<!-- ====================================================================== -->

microsoft-edge/devtools/performance/overview.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ ms.date: 03/31/2025
2323
limitations under the License. -->
2424
# Performance tool: Analyze your website's performance
2525
<!-- https://developer.chrome.com/docs/devtools/performance/overview -->
26-
<!-- https://microsoftedge.github.io/Demos/exploring-the-universe/ -->
2726

2827
Use the **Performance** tool to analyze your website's performance. There are two main views:
2928

@@ -32,15 +31,11 @@ Use the **Performance** tool to analyze your website's performance. There are t
3231

3332
**Detailed contents:**
3433
* [Overview](#overview)
35-
3634
* [Open the Performance tool](#open-the-performance-tool)
3735
* [Using the Command Menu](#using-the-command-menu)
38-
3936
* [Local metrics for page interactions](#local-metrics-for-page-interactions)
4037
* [Recorded profile timeline](#recorded-profile-timeline)
4138
* [Switching to viewing local metrics or another profile](#switching-to-viewing-local-metrics-or-another-profile)
42-
43-
4439
* [Monitor Core Web Vitals metrics](#monitor-core-web-vitals-metrics)
4540
* [Terminology](#terminology)
4641
* [Use the demo page](#use-the-demo-page)
@@ -50,15 +45,14 @@ Use the **Performance** tool to analyze your website's performance. There are t
5045
* [Record a performance profile](#record-a-performance-profile)
5146
* [Change capture settings](#change-capture-settings)
5247
* [Analyze a performance report](#analyze-a-performance-report)
53-
* [Improve performance with these tools](#improve-performance-with-these-tools) -->
48+
* [Improve performance with these tools](#improve-performance-with-these-tools)
5449

5550
For a walkthrough of using the **Performance** tool to improve your website's performance, see [Analyze runtime performance (tutorial)](./index.md).
5651

5752

5853
<!-- ====================================================================== -->
5954
## Overview
6055
<!-- https://developer.chrome.com/docs/devtools/performance/overview#overview -->
61-
<!-- https://microsoftedge.github.io/Demos/exploring-the-universe/ -->
6256
<!-- covers basic nav between the two states, and what to use them for, not how to use either view -->
6357

6458
The **Performance** tool displays local metrics for page interactions, and lets you record CPU performance profiles of your web applications. Analyze profiles to find potential performance bottlenecks and ways that you can optimize resource use.
@@ -159,14 +153,15 @@ Use the **Performance** tool to view Core Web Vitals metrics in the initial, **L
159153

160154
<!-- ---------------------------------- -->
161155
#### Terminology
156+
<!-- not in upstream -->
162157

163158
| Term | Description | Docs |
164159
|---|---|---|
165-
| Web Vitals | A large set of metrics giving unified guidance to delivering a great user experience on the web. | [Web Vitals](https://web.dev/articles/vitals) |
166-
| Core Web Vitals | The subset of Web Vitals that apply to all web pages, and should be measured by all site owners. Each of the Core Web Vitals represents a distinct facet of the user experience, is measurable in the field, and reflects the real-world experience of a critical user-centric outcome. | [Core Web Vitals](https://web.dev/articles/vitals#core-web-vitals) in _Web Vitals_ |
167-
| Largest Contentful Paint (LCP) | Measures _loading_ performance. To provide a good user experience, LCP should occur within 2.5 seconds of when the page first starts loading. The render time of the largest image, text block, or video visible in the viewport, relative to when the user first navigated to the page. | [Largest Contentful Paint (LCP)](https://web.dev/articles/lcp), [Optimize LCP](https://web.dev/articles/optimize-lcp) |
168-
| Cumulative Layout Shift (CLS) | Measures _visual stability_. To provide a good user experience, pages should maintain a CLS of 0.1. or less. The largest burst of layout shift scores for every unexpected layout shift that occurs during the entire lifecycle of a page. | [Cumulative Layout Shift (CLS)](https://web.dev/articles/cls), [Optimize CLS](https://web.dev/articles/optimize-cls) |
169-
| Interaction to Next Paint (INP) | Measures _interactivity_. To provide a good user experience, pages should have a INP of 200 milliseconds or less. The page's overall responsiveness to user interactions, based on the latency of all click, tap, and keyboard interactions that occur throughout the lifespan of a user's visit to a page. | [Interaction to Next Paint (INP)](https://web.dev/articles/inp), [Optimize INP](https://web.dev/articles/optimize-inp) |
160+
| Web Vitals | A large set of metrics giving unified guidance to delivering a great user experience on the web. | [Web Vitals](https://web.dev/articles/vitals)<!-- web.dev link ok, cwv not doc'd at mdn --> at web.dev. |
161+
| Core Web Vitals | The subset of Web Vitals that apply to all web pages, and should be measured by all site owners. Each of the Core Web Vitals represents a distinct facet of the user experience, is measurable in the field, and reflects the real-world experience of a critical user-centric outcome. | [Core Web Vitals](https://web.dev/articles/vitals#core-web-vitals)<!-- web.dev link ok, cwv not doc'd at mdn --> in _Web Vitals_ at web.dev. |
162+
| Largest Contentful Paint (LCP) | Measures _loading_ performance. To provide a good user experience, LCP should occur within 2.5 seconds of when the page first starts loading. The render time of the largest image, text block, or video visible in the viewport, relative to when the user first navigated to the page. | [Largest Contentful Paint (LCP)](https://developer.mozilla.org/docs/Glossary/Largest_contentful_paint) in Glossary at MDN. [LargestContentfulPaint](https://developer.mozilla.org/docs/Web/API/LargestContentfulPaint) at MDN. |
163+
| Cumulative Layout Shift (CLS) | Measures _visual stability_. To provide a good user experience, pages should maintain a CLS of 0.1. or less. The largest burst of layout shift scores for every unexpected layout shift that occurs during the entire lifecycle of a page. | [Cumulative Layout Shift (CLS)](https://developer.mozilla.org/docs/Glossary/CLS) in Glossary at MDN. [LayoutShift](https://developer.mozilla.org/docs/Web/API/LayoutShift) at MDN. |
164+
| Interaction to Next Paint (INP) | Measures _interactivity_. To provide a good user experience, pages should have a INP of 200 milliseconds or less. The page's overall responsiveness to user interactions, based on the latency of all click, tap, and keyboard interactions that occur throughout the lifespan of a user's visit to a page. | [Interaction to Next Paint (INP)](https://developer.mozilla.org/docs/Glossary/Interaction_to_next_paint) in Glossary at MDN. [PerformanceEventTiming](https://developer.mozilla.org/docs/Web/API/PerformanceEventTiming) at MDN. |
170165
| local metrics, local data | The LCP, CLS, and INP metrics. They are captured locally on the inspected webpage, and are updated as you interact with the page. | |
171166

172167

@@ -177,7 +172,7 @@ To produce a **poor** or **needs improvement** metric on the **LCP**, **CLS**, a
177172

178173
1. Open a webpage, such as the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo, in a new window or tab.
179174

180-
The [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo page is designed to load and handle interactions slowly on purpose, in order to illustrate how the LCP, CLS, and INP metrics can be used in the **Performance** tool to identify and fix performance issues.
175+
The "Exploring the universe" demo page is designed to load and handle interactions slowly on purpose, in order to illustrate how the LCP, CLS, and INP metrics can be used in the **Performance** tool to identify and fix performance issues.
181176

182177
1. Right-click the webpage and then select **Inspect**.
183178

@@ -366,6 +361,12 @@ Discover other tools that can help you improve your website's performance:
366361
| **Performance** tool | [View layers information](../performance/reference.md#view-layers-information) in _Performance features reference_ |
367362

368363

364+
<!-- ====================================================================== -->
365+
## See also
366+
367+
* [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo page
368+
369+
369370
<!-- ====================================================================== -->
370371
> [!NOTE]
371372
> Portions of this page are modifications based on work created and [shared by Google](https://developers.google.com/terms/site-policies) and used according to terms described in the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0).

0 commit comments

Comments
 (0)