Merge branch 'main' into update-beforeinstallpromptevent

wbamberg · May 20, 2023 · f2a83f7 · f2a83f7
2 parents 6a51987 + 4bbb203
commit f2a83f7
Show file tree

Hide file tree

Showing 126 changed files with 927 additions and 787 deletions.
diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml
@@ -7,6 +7,7 @@ on:
     paths:
       - .markdownlint-cli2.jsonc
       - .nvmrc
+      - .prettier*
       - package.json
       - yarn.lock
       - .github/workflows/markdown-lint.yml

diff --git a/.github/workflows/pr-check_markdownlint.yml b/.github/workflows/pr-check_markdownlint.yml
@@ -45,3 +45,8 @@ jobs:
           yarn markdownlint-cli2 ${files_to_lint}
           echo "Linting front-matter"
           node scripts/front-matter_linter.js ${files_to_lint}
+
+      - name: Prettier markdown files
+        run: |
+          files_to_lint="${{ env.DIFF_DOCUMENTS }}"
+          yarn prettier -c ${files_to_lint}
diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt
@@ -3667,7 +3667,6 @@
 /en-US/docs/HTML/Element/acronym-redirect-1	/en-US/docs/Web/HTML/Element/acronym
 /en-US/docs/HTML/Element/acronym2	/en-US/docs/Web/HTML/Element/acronym
 /en-US/docs/HTML/Element/address	/en-US/docs/Web/HTML/Element/address
-/en-US/docs/HTML/Element/applet	/en-US/docs/Web/HTML/Element/applet
 /en-US/docs/HTML/Element/area	/en-US/docs/Web/HTML/Element/area
 /en-US/docs/HTML/Element/area-redirect-1	/en-US/docs/Web/HTML/Element/area
 /en-US/docs/HTML/Element/article	/en-US/docs/Web/HTML/Element/article
@@ -3939,7 +3938,6 @@
 /en-US/docs/HTML:Element:abbr	/en-US/docs/Web/HTML/Element/abbr
 /en-US/docs/HTML:Element:acronym	/en-US/docs/Web/HTML/Element/acronym
 /en-US/docs/HTML:Element:address	/en-US/docs/Web/HTML/Element/address
-/en-US/docs/HTML:Element:applet	/en-US/docs/Web/HTML/Element/applet
 /en-US/docs/HTML:Element:area	/en-US/docs/Web/HTML/Element/area
 /en-US/docs/HTML:Element:b	/en-US/docs/Web/HTML/Element/b
 /en-US/docs/HTML:Element:base	/en-US/docs/Web/HTML/Element/base

diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json
@@ -94100,34 +94100,6 @@
       "alecananian"
     ]
   },
-  "Web/HTML/Element/applet": {
-    "modified": "2020-10-15T21:12:10.376Z",
-    "contributors": [
-      "alattalatta",
-      "sideshowbarker",
-      "ddbeck",
-      "mfuji09",
-      "ExE-Boss",
-      "Sheppy",
-      "teoli",
-      "mfluehr",
-      "chrisdavidmills",
-      "erikadoyle",
-      "brunoais",
-      "kscarfone",
-      "ethertank",
-      "tregagnon",
-      "avsaro",
-      "cers",
-      "fscholz",
-      "osdm",
-      "Taken",
-      "Ptak82",
-      "Um4Sm1",
-      "Witia",
-      "PablO"
-    ]
-  },
   "Web/HTML/Element/area": {
     "modified": "2020-11-09T11:29:48.831Z",
     "contributors": [
@@ -126782,10 +126754,6 @@
       "Manuel_Strehl"
     ]
   },
-  "Web/SVG/Element/discard": {
-    "modified": "2020-10-15T21:49:16.314Z",
-    "contributors": ["Tigt", "fscholz", "Sebastianz"]
-  },
   "Web/SVG/Element/ellipse": {
     "modified": "2020-10-15T21:11:04.607Z",
     "contributors": [

diff --git a/files/en-us/learn/html/tables/basics/index.md b/files/en-us/learn/html/tables/basics/index.md
@@ -203,7 +203,7 @@ td {
 }
 ```
 
-{{EmbedLiveSample("How_does_a_table_work", 100, 460)}}
+{{EmbedLiveSample("How_does_a_table_work", 100, 560)}}
 
 When implemented correctly, HTML tables are handled well by accessibility tools such as screen readers, so a successful HTML table should enhance the experience of sighted and visually impaired users alike.
 
@@ -526,7 +526,7 @@ Now it's time to have a go yourself.
 
 Below you can see the timetable of a languages teacher. On Friday she has a new class teaching Dutch all day, but she also teaches German for a few periods on Tuesday and Thursdays. She wants to highlight the columns containing the days she is teaching.
 
-{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 320)}}
+{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 350)}}
 
 Recreate the table by following the steps below.
 

diff --git a/files/en-us/learn/server-side/express_nodejs/mongoose/index.md b/files/en-us/learn/server-side/express_nodejs/mongoose/index.md
@@ -142,7 +142,7 @@ try {
 ```
 
 The asynchronous methods above are run in sequence.
-If the methods don't depends on each other then you can run them in parallel and finish the whole operation more quickly.
+If the methods don't depend on each other then you can run them in parallel and finish the whole operation more quickly.
 This done using the [`Promise.all()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all) method, which takes an iterable of promises as input and returns a single `Promise`.
 This returned promise fulfills when all of the input's promises fulfill, with an array of the fulfillment values.
 It rejects when any of the input's promises rejects, with this first rejection reason.

diff --git a/files/en-us/learn/server-side/first_steps/web_frameworks/index.md b/files/en-us/learn/server-side/first_steps/web_frameworks/index.md
@@ -137,7 +137,7 @@ def youngest(request):
 
 ### Rendering data
 
-Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of document.
+Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of documents.
 
 Web frameworks often provide a mechanism to make it easy to generate other formats from stored data, including {{glossary("JSON")}} and {{glossary("XML")}}.
 

diff --git a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md
@@ -52,7 +52,7 @@ Make sure that the opening paragraph(s) before the first heading adequately summ
 
 In a guide or tutorial, the introductory paragraph(s) should inform the reader about the topics that will be covered as well as the prerequisite knowledge the reader is expected to have, if any. The opening paragraph should mention the technologies and/or APIs that are being documented or discussed, with links to the related information, and it should offer hints to situations in which the article's contents might be useful.
 
-- **Example of short introduction** This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth.
+- **Example of short introduction**: This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth.
 
   > **`CanvasRenderingContext2D.strokeText()`** draws a string.
 

diff --git a/files/en-us/mozilla/firefox/releases/56/index.md b/files/en-us/mozilla/firefox/releases/56/index.md
@@ -80,7 +80,7 @@ _No changes._
 ### HTML
 
 - The {{htmlelement("isindex")}} element has been removed from the HTML parser, and from form submission ([Firefox bug 1266495](https://bugzil.la/1266495)).
-- The {{htmlelement("applet")}} element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)).
+- The `<applet>` element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)).
 
 ### APIs
 

diff --git a/files/en-us/web/api/analysernode/fftsize/index.md b/files/en-us/web/api/analysernode/fftsize/index.md
@@ -12,7 +12,7 @@ The **`fftSize`** property of the {{domxref("AnalyserNode")}} interface is an un
 
 ## Value
 
-An unsigned integer, representing the window size of the FFT, given in number of samples. A higher value will result in more details in the frequency domain but fewer details in the time domain.
+An unsigned integer, representing the window size of the FFT, given in number of samples. A higher value will result in more details in the frequency domain but fewer details in the amplitude domain.
 
 Must be a power of 2 between 2^5 and 2^15, so one of: `32`, `64`, `128`, `256`, `512`, `1024`, `2048`, `4096`, `8192`, `16384`, and `32768`. Defaults to `2048`.
 

diff --git a/files/en-us/web/api/animation/commitstyles/index.md b/files/en-us/web/api/animation/commitstyles/index.md
@@ -10,7 +10,7 @@ browser-compat: api.Animation.commitStyles
 
 The `commitStyles()` method of the [Web Animations API](/en-US/docs/Web/API/Web_Animations_API)'s {{domxref("Animation")}} interface writes the [computed values](/en-US/docs/Web/CSS/computed_value) of the animation's current styles into its target element's [`style`](/en-US/docs/Web/HTML/Global_attributes#style) attribute. `commitStyles()` works even if the animation has been [automatically removed](/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API#automatically_removing_filling_animations).
 
-`commitStyles()` can be used in combination with `fill` to cause the final state of an animation to persist after the animation ends. The same effect could be achieved with `fill` alone, but [using indefinitely filling animations is discouraged](https://w3c.github.io/csswg-drafts/web-animations-1/#fill-behavior). Animations [take precedence over all static styles](/en-US/docs/Web/CSS/Cascade#cascading_order), so an indefinite filling animation can prevent the target element from ever being styled normally.
+`commitStyles()` can be used in combination with `fill` to cause the final state of an animation to persist after the animation ends. The same effect could be achieved with `fill` alone, but [using indefinitely filling animations is discouraged](https://drafts.csswg.org/web-animations-1/#fill-behavior). Animations [take precedence over all static styles](/en-US/docs/Web/CSS/Cascade#cascading_order), so an indefinite filling animation can prevent the target element from ever being styled normally.
 
 Using `commitStyles()` writes the styling state into the element's [`style`](/en-US/docs/Web/HTML/Global_attributes#style) attribute, where they can be modified and replaced as normal.
 

diff --git a/files/en-us/web/api/clients/openwindow/index.md b/files/en-us/web/api/clients/openwindow/index.md
@@ -39,6 +39,15 @@ A {{jsxref("Promise")}} that resolves to a {{domxref("WindowClient")}} object if
 URL is from the same origin as the service worker or a {{Glossary("null", "null
   value")}} otherwise.
 
+### Exceptions
+
+- `InvalidAccessError` {{domxref("DOMException")}}
+  - : The promise is rejected with this exception if none of the windows in the app's origin have [transient activation](/en-US/docs/Web/Security/User_activation).
+
+## Security requirements
+
+- At least one window in the app's origin must have [transient activation](/en-US/docs/Web/Security/User_activation).
+
 ## Examples
 
 ```js

diff --git a/files/en-us/web/api/css_custom_highlight_api/index.md b/files/en-us/web/api/css_custom_highlight_api/index.md
@@ -8,7 +8,7 @@ browser-compat:
   - api.Highlight
   - api.HighlightRegistry
   - css.selectors.highlight
-spec-urls: https://w3c.github.io/csswg-drafts/css-highlight-api-1/
+spec-urls: https://drafts.csswg.org/css-highlight-api-1/
 ---
 
 {{DefaultAPISidebar("CSS Custom Highlight API")}}{{SeeCompatTable}}

diff --git a/files/en-us/web/api/document/afterscriptexecute_event/index.md b/files/en-us/web/api/document/afterscriptexecute_event/index.md
@@ -38,7 +38,7 @@ document.addEventListener("afterscriptexecute", finished, true);
 document.onafterscriptexecute = finished;
 ```
 
-[View Live Example](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html)
+[View Live Example](https://mdn.dev/archives/media/samples/html/currentScript.html)
 
 ## Browser compatibility
 

diff --git a/files/en-us/web/api/document/beforescriptexecute_event/index.md b/files/en-us/web/api/document/beforescriptexecute_event/index.md
@@ -38,7 +38,7 @@ document.addEventListener("beforescriptexecute", starting, true);
 document.onbeforescriptexecute = starting;
 ```
 
-[View Live Example](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html)
+[View Live Example](https://mdn.dev/archives/media/samples/html/currentScript.html)
 
 ## Browser compatibility
 

diff --git a/files/en-us/web/api/document/currentscript/index.md b/files/en-us/web/api/document/currentscript/index.md
@@ -30,7 +30,7 @@ if (document.currentScript.async) {
 }
 ```
 
-[View Live Examples](https://media.prod.mdn.mozit.cloud/samples/html/currentScript.html)
+[View Live Examples](https://mdn.dev/archives/media/samples/html/currentScript.html)
 
 ## Specifications
 

diff --git a/files/en-us/web/api/document/index.md b/files/en-us/web/api/document/index.md
@@ -132,7 +132,7 @@ _The `Document` interface for HTML documents inherits from the {{DOMxRef("HTMLDo
 - {{DOMxRef("Document.anchors")}} {{Deprecated_Inline}} {{ReadOnlyInline}}
   - : Returns a list of all of the anchors in the document.
 - {{DOMxRef("Document.applets")}} {{Deprecated_Inline}} {{ReadOnlyInline}}
-  - : Returns an ordered list of the applets within a document.
+  - : Returns an empty {{domxref("HTMLCollection")}}. Legacy property that used to return the list of applets within a document.
 - {{DOMxRef("Document.bgColor")}} {{Deprecated_Inline}}
   - : Gets/sets the background color of the current document.
 - {{DOMxRef("Document.characterSet","Document.charset")}} {{Deprecated_Inline}} {{ReadOnlyInline}}

diff --git a/files/en-us/web/api/document/mozsetimageelement/index.md b/files/en-us/web/api/document/mozsetimageelement/index.md
@@ -38,7 +38,7 @@ None ({{jsxref("undefined")}}).
 This example changes the background of a {{ HTMLElement("div") }} block each time the
 block is clicked by the user.
 
-[View this example live](https://media.prod.mdn.mozit.cloud/samples/domref/mozSetImageElement.html).
+[View this example live](https://mdn.dev/archives/media/samples/domref/mozSetImageElement.html).
 
 ```html
 <style>

diff --git a/files/en-us/web/api/domimplementation/createhtmldocument/index.md b/files/en-us/web/api/domimplementation/createhtmldocument/index.md
@@ -82,7 +82,7 @@ which we'll be injecting the new content. The next two lines handle importing th
 contents of our new document into the new document's context. Finally, line 20 actually
 replaces the contents of the frame with the new document's contents.
 
-[View Live Examples](https://media.prod.mdn.mozit.cloud/samples/domref/createHTMLDocument.html)
+[View Live Examples](https://mdn.dev/archives/media/samples/domref/createHTMLDocument.html)
 
 The returned document is pre-constructed with the following HTML:
 

diff --git a/files/en-us/web/api/dommatrixreadonly/scale/index.md b/files/en-us/web/api/dommatrixreadonly/scale/index.md
@@ -102,7 +102,7 @@ document
   .setAttribute("transform", scaledMatrixWithOrigin.toString());
 ```
 
-{{ EmbedLiveSample('Examples', '250', '250', 'screen_shot_2019-02-18_at_13.23.31.png') }}
+{{EmbedLiveSample('Examples', '250', '250')}}
 
 ## Specifications
 

diff --git a/files/en-us/web/api/dommatrixreadonly/scale/screen_shot_2019-02-18_at_13.23.31.png b/files/en-us/web/api/dommatrixreadonly/scale/screen_shot_2019-02-18_at_13.23.31.png
diff --git a/files/en-us/web/api/dommatrixreadonly/translate/index.md b/files/en-us/web/api/dommatrixreadonly/translate/index.md
@@ -62,8 +62,7 @@ document
   .setAttribute("transform", matrix.toString());
 ```
 
-{{ EmbedLiveSample('Examples', '250', '250',
-  'screen_shot_2019-02-19_at_11.20.40.png') }}
+{{EmbedLiveSample('Examples', '250', '250')}}
 
 ## Specifications
 

diff --git a/...n-us/web/api/dommatrixreadonly/translate/screen_shot_2019-02-19_at_11.20.40.png b/...n-us/web/api/dommatrixreadonly/translate/screen_shot_2019-02-19_at_11.20.40.png
diff --git a/files/en-us/web/api/element/setcapture/index.md b/files/en-us/web/api/element/setcapture/index.md
@@ -93,7 +93,7 @@ clicking and holding down on an element.
 </html>
 ```
 
-[View Live Examples](https://media.prod.mdn.mozit.cloud/samples/domref/mousecapture.html)
+[View Live Examples](https://mdn.dev/archives/media/samples/domref/mousecapture.html)
 
 ## Notes
 

diff --git a/files/en-us/web/api/fullscreen_api/guide/index.md b/files/en-us/web/api/fullscreen_api/guide/index.md
@@ -85,7 +85,7 @@ In addition, navigating to another page, changing tabs, or switching to another
 
 In this example, a video is presented in a web page. Pressing the <kbd>Return</kbd> or <kbd>Enter</kbd> key lets the user toggle between windowed and fullscreen presentation of the video.
 
-[View Live Examples](https://media.prod.mdn.mozit.cloud/samples/domref/fullscreen.html)
+[View Live Examples](https://mdn.dev/archives/media/samples/domref/fullscreen.html)
 
 ### Watching for the Enter key
 

diff --git a/files/en-us/web/api/rtcaudiosourcestats/audiolevel/index.md b/files/en-us/web/api/rtcaudiosourcestats/audiolevel/index.md
@@ -3,10 +3,12 @@ title: "RTCAudioSourceStats: audioLevel property"
 short-title: audioLevel
 slug: Web/API/RTCAudioSourceStats/audioLevel
 page-type: web-api-instance-property
+status:
+  - experimental
 browser-compat: api.RTCStatsReport.type_media-source.audioLevel
 ---
 
-{{APIRef("WebRTC")}}
+{{APIRef("WebRTC")}}{{SeeCompatTable}}
 
 The {{domxref("RTCAudioSourceStats")}} dictionary's **`audioLevel`** property represents the audio level of the media source.
 

diff --git a/files/en-us/web/api/rtcaudiosourcestats/index.md b/files/en-us/web/api/rtcaudiosourcestats/index.md
@@ -15,11 +15,11 @@ These statistics can be obtained by iterating the {{domxref("RTCStatsReport")}}
 
 ## Instance properties
 
-- {{domxref("RTCAudioSourceStats.audioLevel", "audioLevel")}}
+- {{domxref("RTCAudioSourceStats.audioLevel", "audioLevel")}} {{Experimental_Inline}}
   - : A number that represents the audio level of the media source.
-- {{domxref("RTCAudioSourceStats.totalAudioEnergy", "totalAudioEnergy")}}
+- {{domxref("RTCAudioSourceStats.totalAudioEnergy", "totalAudioEnergy")}} {{Experimental_Inline}}
   - : A number that represents the total audio energy of the media source over the lifetime of the stats object.
-- {{domxref("RTCAudioSourceStats.totalSamplesDuration", "totalSamplesDuration")}}
+- {{domxref("RTCAudioSourceStats.totalSamplesDuration", "totalSamplesDuration")}} {{Experimental_Inline}}
   - : A number that represents the total duration of all samples produced by the media source over the lifetime of the stats object.
 
 The following properties are present in both `RTCAudioSourceStats` and {{domxref("RTCVideoSourceStats")}}: <!-- RTCMediaSourceStats  -->

diff --git a/files/en-us/web/api/rtcaudiosourcestats/totalaudioenergy/index.md b/files/en-us/web/api/rtcaudiosourcestats/totalaudioenergy/index.md
@@ -3,10 +3,12 @@ title: "RTCAudioSourceStats: totalAudioEnergy property"
 short-title: totalAudioEnergy
 slug: Web/API/RTCAudioSourceStats/totalAudioEnergy
 page-type: web-api-instance-property
+status:
+  - experimental
 browser-compat: api.RTCStatsReport.type_media-source.totalAudioEnergy
 ---
 
-{{APIRef("WebRTC")}}
+{{APIRef("WebRTC")}}{{SeeCompatTable}}
 
 The {{domxref("RTCAudioSourceStats")}} dictionary's **`totalAudioEnergy`** property represents the total audio energy of the media source over the lifetime of this stats object.
 

diff --git a/files/en-us/web/api/rtcaudiosourcestats/totalsamplesduration/index.md b/files/en-us/web/api/rtcaudiosourcestats/totalsamplesduration/index.md
@@ -3,10 +3,12 @@ title: "RTCAudioSourceStats: totalSamplesDuration property"
 short-title: totalSamplesDuration
 slug: Web/API/RTCAudioSourceStats/totalSamplesDuration
 page-type: web-api-instance-property
+status:
+  - experimental
 browser-compat: api.RTCStatsReport.type_media-source.totalSamplesDuration
 ---
 
-{{APIRef("WebRTC")}}
+{{APIRef("WebRTC")}}{{SeeCompatTable}}
 
 The {{domxref("RTCAudioSourceStats")}} dictionary's **`totalSamplesDuration`** property represents the combined duration of all samples produced by the media source over the lifetime of this stats object, in seconds.
 It does not include samples dropped before reaching this media source. <!-- Dropped samples in `droppedSamplesDuration`; not implemented -->

diff --git a/files/en-us/web/api/serviceworkerglobalscope/activate_event/index.md b/files/en-us/web/api/serviceworkerglobalscope/activate_event/index.md
@@ -37,7 +37,7 @@ _Doesn't implement any specific properties, but inherits properties from its par
 The following snippet shows how you could use an `activate` event handler to upgrade a cache.
 
 ```js
-globalScope.addEventListener("activate", (event) => {
+self.addEventListener("activate", (event) => {
   const cacheAllowlist = ["v2"];
 
   event.waitUntil(
@@ -53,7 +53,7 @@ globalScope.addEventListener("activate", (event) => {
 You can also set up the event handler using the `onactivate` property:
 
 ```js
-globalScope.onactivate = (event) => {
+self.onactivate = (event) => {
   // ...
 };
 ```

diff --git a/files/en-us/web/api/serviceworkerglobalscope/install_event/index.md b/files/en-us/web/api/serviceworkerglobalscope/install_event/index.md
@@ -37,7 +37,7 @@ _Doesn't implement any specific properties, but inherits properties from its par
 The following snippet shows how an `install` event handler can be used to populate a cache with a number of responses, which the service worker can then use to serve assets offline:
 
 ```js
-this.addEventListener("install", (event) => {
+self.addEventListener("install", (event) => {
   event.waitUntil(
     caches
       .open("v1")
@@ -62,7 +62,7 @@ this.addEventListener("install", (event) => {
 You can also set up the event handler using the `oninstall` property:
 
 ```js
-globalScope.oninstall = (event) => {
+self.oninstall = (event) => {
   // ...
 };
 ```

diff --git a/files/en-us/web/api/storage_access_api/index.md b/files/en-us/web/api/storage_access_api/index.md
@@ -64,10 +64,11 @@ Several different security measures could cause a {{domxref("Document.requestSto
 5. Sandboxed {{htmlelement("iframe")}}s cannot be granted storage access by default for security reasons. The API therefore also adds the `allow-storage-access-by-user-activation` [sandbox token](/en-US/docs/Web/HTML/Element/iframe#sandbox). The embedding website needs to add this to allow storage access requests to be successful, along with `allow-scripts` and `allow-same-origin` to allow it to execute a script to call the API and execute it in an origin that can have cookies:
 
    ```html
-   <iframe sandbox="allow-storage-access-by-user-activation
+   <iframe
+     sandbox="allow-storage-access-by-user-activation
                    allow-scripts
                    allow-same-origin">
-    …
+     …
    </iframe>
    ```