From c9dbeeee84419fa3ceebaf2002ac6dfefbf4a3e4 Mon Sep 17 00:00:00 2001 From: Hao Cheng Date: Fri, 6 Oct 2023 01:40:00 +0200 Subject: [PATCH 01/24] Fix typo: "Multiple Choice" to "Multiple Choices" (#29483) --- files/en-us/web/http/redirections/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/en-us/web/http/redirections/index.md b/files/en-us/web/http/redirections/index.md index 2a37d2fad93fb4f..181fa0a0fa83c80 100644 --- a/files/en-us/web/http/redirections/index.md +++ b/files/en-us/web/http/redirections/index.md @@ -54,12 +54,12 @@ Search engine robots and other crawlers don't memorize the new, temporary URL. T ### Special redirections -{{HTTPStatus("304")}} (Not Modified) redirects a page to the locally cached copy (that was stale), and {{HTTPStatus("300")}} (Multiple Choice) is a manual redirection: the body, presented by the browser as a Web page, lists the possible redirections and the user clicks on one to select it. +{{HTTPStatus("304")}} (Not Modified) redirects a page to the locally cached copy (that was stale), and {{HTTPStatus("300")}} (Multiple Choices) is a manual redirection: the body, presented by the browser as a Web page, lists the possible redirections and the user clicks on one to select it. -| Code | Text | Typical use case | -| ----- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `300` | `Multiple Choice` | Not many: the choices are listed in an HTML page in the body. Machine-readable choices are encouraged to be sent as {{HTTPHeader("Link")}} headers with `rel=alternate`. | -| `304` | `Not Modified` | Sent for revalidated conditional requests. Indicates that the cached response is still fresh and can be used. | +| Code | Text | Typical use case | +| ----- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `300` | `Multiple Choices` | Not many: the choices are listed in an HTML page in the body. Machine-readable choices are encouraged to be sent as {{HTTPHeader("Link")}} headers with `rel=alternate`. | +| `304` | `Not Modified` | Sent for revalidated conditional requests. Indicates that the cached response is still fresh and can be used. | ## Alternative way of specifying redirections From 79c16bc3fe69050f3cb29ddcb162c6ad91f9d40a Mon Sep 17 00:00:00 2001 From: DanKaplanSES Date: Thu, 5 Oct 2023 17:36:35 -0700 Subject: [PATCH 02/24] Renamed `method` because it is not a real method (#29485) --- .../javascript/reference/functions/method_definitions/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/javascript/reference/functions/method_definitions/index.md b/files/en-us/web/javascript/reference/functions/method_definitions/index.md index a5087e47286e12f..63f8551d9515483 100644 --- a/files/en-us/web/javascript/reference/functions/method_definitions/index.md +++ b/files/en-us/web/javascript/reference/functions/method_definitions/index.md @@ -82,7 +82,7 @@ const obj = { __proto__: { prop: "foo", }, - method: function () { + notAMethod: function () { console.log(super.prop); // SyntaxError: 'super' keyword unexpected here }, }; From e85b95300b7817bd048b54729a5e69a289828e84 Mon Sep 17 00:00:00 2001 From: DanKaplanSES Date: Thu, 5 Oct 2023 17:54:00 -0700 Subject: [PATCH 03/24] Document which `then` handler is called after a `catch` is handled (#29507) Document which `then` handler is called after a catch is handled --- .../reference/global_objects/promise/catch/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/en-us/web/javascript/reference/global_objects/promise/catch/index.md b/files/en-us/web/javascript/reference/global_objects/promise/catch/index.md index 0496e53f064320e..615687e3572bb2c 100644 --- a/files/en-us/web/javascript/reference/global_objects/promise/catch/index.md +++ b/files/en-us/web/javascript/reference/global_objects/promise/catch/index.md @@ -83,7 +83,7 @@ p1.then((value) => { console.error(e.message); // "oh, no!" }) .then( - () => console.log("after a catch the chain is restored"), + () => console.log("after a catch the chain is restored"), // "after a catch the chain is restored" () => console.log("Not fired due to the catch"), ); @@ -96,7 +96,7 @@ p1.then((value) => { console.error(e); // "oh, no!" }) .then( - () => console.log("after a catch the chain is restored"), + () => console.log("after a catch the chain is restored"), // "after a catch the chain is restored" () => console.log("Not fired due to the catch"), ); ``` From 2f9c996ee520ac3bb41347c873958bad175711d0 Mon Sep 17 00:00:00 2001 From: Zach Fox Date: Fri, 6 Oct 2023 08:48:41 -0400 Subject: [PATCH 04/24] Remove "or refreshes" example language from `overscroll-behavior: contain` docs (#29474) * Remove "or refreshes" example language from `overscroll-behavior: contain` docs * Integrate helpful PR feedback --- files/en-us/web/css/overscroll-behavior-block/index.md | 2 +- files/en-us/web/css/overscroll-behavior-inline/index.md | 2 +- files/en-us/web/css/overscroll-behavior-x/index.md | 2 +- files/en-us/web/css/overscroll-behavior-y/index.md | 2 +- files/en-us/web/css/overscroll-behavior/index.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/files/en-us/web/css/overscroll-behavior-block/index.md b/files/en-us/web/css/overscroll-behavior-block/index.md index 6797047c40341ea..ead4ca56b550127 100644 --- a/files/en-us/web/css/overscroll-behavior-block/index.md +++ b/files/en-us/web/css/overscroll-behavior-block/index.md @@ -34,7 +34,7 @@ The `overscroll-behavior-block` property is specified as a keyword chosen from t - `auto` - : The default scroll overflow behavior occurs as normal. - `contain` - - : Default scroll overflow behavior is observed inside the element this value is set on (e.g. "bounce" effects or refreshes), but no scroll chaining occurs to neighboring scrolling areas, e.g. underlying elements will not scroll. + - : Default scroll overflow behavior (e.g., "bounce" effects) is observed inside the element where this value is set. However, no scroll chaining occurs on neighboring scrolling areas; the underlying elements will not scroll. The `contain` value disables native browser navigation, including the vertical pull-to-refresh gesture and horizontal swipe navigation. - `none` - : No scroll chaining occurs to neighboring scrolling areas, and default scroll overflow behavior is prevented. diff --git a/files/en-us/web/css/overscroll-behavior-inline/index.md b/files/en-us/web/css/overscroll-behavior-inline/index.md index 925d9313bb03514..e85287e888e0139 100644 --- a/files/en-us/web/css/overscroll-behavior-inline/index.md +++ b/files/en-us/web/css/overscroll-behavior-inline/index.md @@ -34,7 +34,7 @@ The `overscroll-behavior-inline` property is specified as a keyword chosen from - `auto` - : The default scroll overflow behavior occurs as normal. - `contain` - - : Default scroll overflow behavior is observed inside the element this value is set on (e.g. "bounce" effects or refreshes), but no scroll chaining occurs to neighboring scrolling areas, e.g. underlying elements will not scroll. + - : Default scroll overflow behavior (e.g., "bounce" effects) is observed inside the element where this value is set. However, no scroll chaining occurs on neighboring scrolling areas; the underlying elements will not scroll. The `contain` value disables native browser navigation, including the vertical pull-to-refresh gesture and horizontal swipe navigation. - `none` - : No scroll chaining occurs to neighboring scrolling areas, and default scroll overflow behavior is prevented. diff --git a/files/en-us/web/css/overscroll-behavior-x/index.md b/files/en-us/web/css/overscroll-behavior-x/index.md index 4658060ad603846..eb5d3e0f58a5d94 100644 --- a/files/en-us/web/css/overscroll-behavior-x/index.md +++ b/files/en-us/web/css/overscroll-behavior-x/index.md @@ -34,7 +34,7 @@ The `overscroll-behavior-x` property is specified as a keyword chosen from the l - `auto` - : The default scroll overflow behavior occurs as normal. - `contain` - - : Default scroll overflow behavior is observed inside the element this value is set on (e.g. "bounce" effects or refreshes), but no scroll chaining occurs to neighboring scrolling areas, e.g. underlying elements will not scroll. + - : Default scroll overflow behavior (e.g., "bounce" effects) is observed inside the element where this value is set. However, no scroll chaining occurs on neighboring scrolling areas; the underlying elements will not scroll. The `contain` value disables native browser navigation, including the vertical pull-to-refresh gesture and horizontal swipe navigation. - `none` - : No scroll chaining occurs to neighboring scrolling areas, and default scroll overflow behavior is prevented. diff --git a/files/en-us/web/css/overscroll-behavior-y/index.md b/files/en-us/web/css/overscroll-behavior-y/index.md index 4f5f576bca7afe5..eabaca89ce442cd 100644 --- a/files/en-us/web/css/overscroll-behavior-y/index.md +++ b/files/en-us/web/css/overscroll-behavior-y/index.md @@ -34,7 +34,7 @@ The `overscroll-behavior-y` property is specified as a keyword chosen from the l - `auto` - : The default scroll overflow behavior occurs as normal. - `contain` - - : Default scroll overflow behavior is observed inside the element this value is set on (e.g. "bounce" effects or refreshes), but no scroll chaining occurs to neighboring scrolling areas, e.g. underlying elements will not scroll. + - : Default scroll overflow behavior (e.g., "bounce" effects) is observed inside the element where this value is set. However, no scroll chaining occurs on neighboring scrolling areas; the underlying elements will not scroll. The `contain` value disables native browser navigation, including the vertical pull-to-refresh gesture and horizontal swipe navigation. - `none` - : No scroll chaining occurs to neighboring scrolling areas, and default scroll overflow behavior is prevented. diff --git a/files/en-us/web/css/overscroll-behavior/index.md b/files/en-us/web/css/overscroll-behavior/index.md index 2d5fd2e570581ac..1d7dfd0345e0508 100644 --- a/files/en-us/web/css/overscroll-behavior/index.md +++ b/files/en-us/web/css/overscroll-behavior/index.md @@ -46,7 +46,7 @@ Two keywords specifies the `overscroll-behavior` value on the `x` and `y` axes r - `auto` - : The default scroll overflow behavior occurs as normal. - `contain` - - : Default scroll overflow behavior is observed inside the element this value is set on (e.g. "bounce" effects or refreshes), but no scroll chaining occurs to neighboring scrolling areas, e.g. underlying elements will not scroll. + - : Default scroll overflow behavior (e.g., "bounce" effects) is observed inside the element where this value is set. However, no scroll chaining occurs on neighboring scrolling areas; the underlying elements will not scroll. The `contain` value disables native browser navigation, including the vertical pull-to-refresh gesture and horizontal swipe navigation. - `none` - : No scroll chaining occurs to neighboring scrolling areas, and default scroll overflow behavior is prevented. From b195721acf6cc4829f55168a415f3578c5b32a09 Mon Sep 17 00:00:00 2001 From: Dave Letorey Date: Fri, 6 Oct 2023 15:06:33 +0100 Subject: [PATCH 05/24] =?UTF-8?q?added=20release=20note=20for=20content-bo?= =?UTF-8?q?x=20and=20stroke-box=20in=20transform-box=20pr=E2=80=A6=20(#293?= =?UTF-8?q?13)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * added release note for content-box and stroke-box in transform-box property * Update files/en-us/mozilla/firefox/releases/118/index.md Co-authored-by: Dipika Bhattacharya * updated the transform-box release not and added links to table-wrapper-box to the values on transform-box * Update files/en-us/mozilla/firefox/releases/118/index.md Co-authored-by: Dipika Bhattacharya * Update files/en-us/mozilla/firefox/releases/118/index.md Co-authored-by: Dipika Bhattacharya --------- Co-authored-by: Dipika Bhattacharya --- files/en-us/mozilla/firefox/releases/118/index.md | 2 ++ files/en-us/web/css/transform-box/index.md | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/files/en-us/mozilla/firefox/releases/118/index.md b/files/en-us/mozilla/firefox/releases/118/index.md index ef3bce3caad9748..e6c653e45448be0 100644 --- a/files/en-us/mozilla/firefox/releases/118/index.md +++ b/files/en-us/mozilla/firefox/releases/118/index.md @@ -18,6 +18,8 @@ This article provides information about the changes in Firefox 118 that affect d - The {{cssxref("font-synthesis-position")}} property and `position` value for {{cssxref("font-synthesis")}} shorthand property are now supported. These allow subscript and superscript typefaces to be disabled for fonts that do not have glyphs for them when using {{cssxref("font-variant-position")}} ([Firefox bug 1849010](https://bugzil.la/1849010)). - Multiple CSS [math functions](/en-US/docs/Web/CSS/CSS_Functions#math_functions) are now supported: [`abs()`](/en-US/docs/Web/CSS/abs), [`sign()`](/en-US/docs/Web/CSS/sign), [`round()`](/en-US/docs/Web/CSS/round), [`mod()`](/en-US/docs/Web/CSS/mod), [`rem()`](/en-US/docs/Web/CSS/rem), [`pow()`](/en-US/docs/Web/CSS/pow), [`sqrt()`](/en-US/docs/Web/CSS/sqrt), [`hypot()`](/en-US/docs/Web/CSS/hypot), [`log()`](/en-US/docs/Web/CSS/log), and [`exp()`](/en-US/docs/Web/CSS/exp) (Firefox bug [1814589](https://bugzil.la/1814589)). +- A new keyword `from-font` in the CSS property [`font-size-adjust`](/en-US/docs/Web/CSS/font-size-adjust) enables picking the desired `` from the first available font (Firefox bug [1708240](https://bugzil.la/1708240)). +- The CSS property [`transform-box`](/en-US/docs/Web/CSS/transform-box) now supports the values `content-box` and `stroke-box`. For the reference box, the `content-box` value uses the [content box](/en-US/docs/Learn/CSS/Building_blocks/The_box_model#parts_of_a_box) and the `stroke-box` value uses the stroke bounding box that contains an SVG's shape (Firefox bug [1819464](https://bugzil.la/1819464)). - The CSS property [`font-size-adjust`](/en-US/docs/Web/CSS/font-size-adjust) supports the keyword `from-font` that enables picking the desired `` from the first available font (Firefox bug [1708240](https://bugzil.la/1708240)). ### JavaScript diff --git a/files/en-us/web/css/transform-box/index.md b/files/en-us/web/css/transform-box/index.md index 3598d9ef990100c..246dcd35bc88a3c 100644 --- a/files/en-us/web/css/transform-box/index.md +++ b/files/en-us/web/css/transform-box/index.md @@ -32,9 +32,9 @@ The `transform-box` property is specified as one of the keyword values listed be ### Values - `content-box` - - : The content box is used as the reference box. The reference box of a {{htmlElement("table")}} is the border box of its table wrapper box, not its table box. + - : The content box is used as the reference box. The reference box of a {{htmlElement("table")}} is the border box of its [table wrapper box](/en-US/docs/Glossary/Table_Wrapper_Box), not its table box. - `border-box` - - : The border box is used as the reference box. The reference box of a {{htmlElement("table")}} is the border box of its table wrapper box, not its table box. + - : The border box is used as the reference box. The reference box of a {{htmlElement("table")}} is the border box of its [table wrapper box](/en-US/docs/Glossary/Table_Wrapper_Box), not its table box. - `fill-box` - : The object bounding box is used as the reference box. For elements with associated CSS layout box, acts as `content-box`. - `stroke-box` From 1ca97c134e6d5cbc5ccdbf2dcbfdd39d94bf50d3 Mon Sep 17 00:00:00 2001 From: Murphy <44449850+mfmyip@users.noreply.github.com> Date: Fri, 6 Oct 2023 12:02:53 -0400 Subject: [PATCH 06/24] fix small typo in webauthn_extensions (#29517) --- .../web/api/web_authentication_api/webauthn_extensions/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/web_authentication_api/webauthn_extensions/index.md b/files/en-us/web/api/web_authentication_api/webauthn_extensions/index.md index 9d30e0d06fa524e..8492ec332804cd5 100644 --- a/files/en-us/web/api/web_authentication_api/webauthn_extensions/index.md +++ b/files/en-us/web/api/web_authentication_api/webauthn_extensions/index.md @@ -19,7 +19,7 @@ Behind the scenes, the inputs are processed by the user agent and/or the authent For example, in a `publicKey` object for a `create()` call, we might want to request the use of two extensions: -1. The `credProps` extension. Relying parties set `credProps` to request that the browser tells the relying party whether the credential is resident/discoverable after registration. This is useful when calling `create()` with `publicKey.authenticatorSelection.residentKey = "preferred"`. To request it, you also need to set `publicKey.extensions.credProps = true` when. The browser makes a credential and, depending on the type of authenticator used, it will be discoverable (for example, the FIDO2 authenticator would typically make it discoverable; FIDO1/U2F security key would be non-discoverable). `credProps` is processed by the user agent only. +1. The `credProps` extension. Relying parties set `credProps` to request that the browser tells the relying party whether the credential is resident/discoverable after registration. This is useful when calling `create()` with `publicKey.authenticatorSelection.residentKey = "preferred"`. To request it, you also need to set `publicKey.extensions.credProps = true` when the browser makes a credential and, depending on the type of authenticator used, it will be discoverable (for example, the FIDO2 authenticator would typically make it discoverable; FIDO1/U2F security key would be non-discoverable). `credProps` is processed by the user agent only. 2. The `minPinLength` extension allows relying parties to request the authenticator's minimum PIN length. This requires `extensions.minPinLength` to be set to `true`. `minPinLength` is processed by the authenticator, with the user agent only serving to pass the input data along to it. ```js From c5e672cc4ea5d566669f885b0a82c8fa94b9aa9d Mon Sep 17 00:00:00 2001 From: curious-broccoli <77789413+curious-broccoli@users.noreply.github.com> Date: Fri, 6 Oct 2023 18:08:51 +0200 Subject: [PATCH 07/24] Fix wrong description for example in index.md (#29511) --- files/en-us/web/javascript/closures/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/javascript/closures/index.md b/files/en-us/web/javascript/closures/index.md index 63d091ae51c060d..065bf818c382d35 100644 --- a/files/en-us/web/javascript/closures/index.md +++ b/files/en-us/web/javascript/closures/index.md @@ -144,7 +144,7 @@ const size14 = makeSizer(14); const size16 = makeSizer(16); ``` -`size12`, `size14`, and `size16` are now functions that resize the body text to 12, 14, and 16 pixels, respectively. You can attach them to buttons (in this case hyperlinks) as demonstrated in the following code example. +`size12`, `size14`, and `size16` are now functions that resize the body text to 12, 14, and 16 pixels, respectively. You can attach them to buttons as demonstrated in the following code example. ```js document.getElementById("size-12").onclick = size12; From dacaf5298a5d0a1fe2397fa0eb91bdae2702843c Mon Sep 17 00:00:00 2001 From: Zach Fox Date: Fri, 6 Oct 2023 16:47:19 -0400 Subject: [PATCH 08/24] Remove 'Reflecting ARIA attributes' from experimental FX relnotes; add ARIA reflection to FX119 relnotes (#29521) * Remove 'Reflecting ARIA attributes' from experimental FX relnotes; add ARIA reflection to FX119 relnotes * FX119 release note changes based on PR feedback --- .../firefox/experimental_features/index.md | 40 ------------------- .../mozilla/firefox/releases/119/index.md | 2 + 2 files changed, 2 insertions(+), 40 deletions(-) diff --git a/files/en-us/mozilla/firefox/experimental_features/index.md b/files/en-us/mozilla/firefox/experimental_features/index.md index 7458fb910fb83e9..af74243f79a16ed 100644 --- a/files/en-us/mozilla/firefox/experimental_features/index.md +++ b/files/en-us/mozilla/firefox/experimental_features/index.md @@ -99,46 +99,6 @@ HTML password input elements ([``](/en-US/docs/Web/HTML/E -### Reflecting ARIA attributes - -[ARIA](/en-US/docs/Web/Accessibility/ARIA) reflection is enabled for non-IDREF attributes which allows authors to get and set ARIA attributes on DOM elements directly via JavaScript APIs, rather than by using `setAttribute` and `getAttribute`, (see [Firefox bug 1824980](https://bugzil.la/1824980) for more details.) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Release channelVersion addedEnabled by default?
Nightly114Yes
Developer Edition114No
Beta114No
Release114No
Preference nameaccessibility.ARIAReflection.enabled
- ## CSS ### Hex boxes to display stray control characters diff --git a/files/en-us/mozilla/firefox/releases/119/index.md b/files/en-us/mozilla/firefox/releases/119/index.md index 1cf939df17b3d28..e6fdd971a7537c0 100644 --- a/files/en-us/mozilla/firefox/releases/119/index.md +++ b/files/en-us/mozilla/firefox/releases/119/index.md @@ -51,6 +51,8 @@ This article provides information about the changes in Firefox 119 that affect d #### DOM +- [ARIA](/en-US/docs/Web/Accessibility/ARIA) reflection is now supported by default for attributes that do not reference other elements; only non-IDREF attributes are reflected. You can now get and set ARIA attributes on DOM elements directly via JavaScript APIs, rather than by using `setAttribute` and `getAttribute`. For example, `buttonElement.ariaPressed = "true";` is now supported in addition to `buttonElement.setAttribute("aria-pressed", "true");` ([Firefox bug 1785412](https://bugzil.la/1785412)). + #### Media, WebRTC, and Web Audio #### Removals From 8e1184924387f88e2ee63a3c786b007aaf573105 Mon Sep 17 00:00:00 2001 From: Logicer Date: Sun, 8 Oct 2023 07:19:27 +1100 Subject: [PATCH 09/24] Fix linking `===` to `Strict_equality` operator page (#29526) fix link to strict_equality page --- .../web/javascript/equality_comparisons_and_sameness/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/javascript/equality_comparisons_and_sameness/index.md b/files/en-us/web/javascript/equality_comparisons_and_sameness/index.md index 879da6944fb1f13..40b0c11e669ac16 100644 --- a/files/en-us/web/javascript/equality_comparisons_and_sameness/index.md +++ b/files/en-us/web/javascript/equality_comparisons_and_sameness/index.md @@ -181,7 +181,7 @@ However, this way of thinking implies that the equality comparisons form a one-d ### When to use Object.is() versus triple equals -In general, the only time {{jsxref("Object.is")}}'s special behavior towards zeros is likely to be of interest is in the pursuit of certain meta-programming schemes, especially regarding property descriptors, when it is desirable for your work to mirror some of the characteristics of {{jsxref("Object.defineProperty")}}. If your use case does not require this, it is suggested to avoid {{jsxref("Object.is")}} and use [`===`](/en-US/docs/Web/JavaScript/Reference/Operators) instead. Even if your requirements involve having comparisons between two {{jsxref("NaN")}} values evaluate to `true`, generally it is easier to special-case the {{jsxref("NaN")}} checks (using the {{jsxref("isNaN")}} method available from previous versions of ECMAScript) than it is to work out how surrounding computations might affect the sign of any zeros you encounter in your comparison. +In general, the only time {{jsxref("Object.is")}}'s special behavior towards zeros is likely to be of interest is in the pursuit of certain meta-programming schemes, especially regarding property descriptors, when it is desirable for your work to mirror some of the characteristics of {{jsxref("Object.defineProperty")}}. If your use case does not require this, it is suggested to avoid {{jsxref("Object.is")}} and use [`===`](/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality) instead. Even if your requirements involve having comparisons between two {{jsxref("NaN")}} values evaluate to `true`, generally it is easier to special-case the {{jsxref("NaN")}} checks (using the {{jsxref("isNaN")}} method available from previous versions of ECMAScript) than it is to work out how surrounding computations might affect the sign of any zeros you encounter in your comparison. Here's a non-exhaustive list of built-in methods and operators that might cause a distinction between `-0` and `+0` to manifest itself in your code: From f1d6263254646ef9c03cfd4b684716a13fe56686 Mon Sep 17 00:00:00 2001 From: DanKaplanSES Date: Sat, 7 Oct 2023 13:19:37 -0700 Subject: [PATCH 10/24] Removed the phrase, ", enabling the first mistake." (#29525) - The full sentence was, `The second mistake is to nest unnecessarily, enabling the first mistake.` --- files/en-us/web/javascript/guide/using_promises/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/javascript/guide/using_promises/index.md b/files/en-us/web/javascript/guide/using_promises/index.md index 7674c7a7ecf3c06..f0bb07b861fba1d 100644 --- a/files/en-us/web/javascript/guide/using_promises/index.md +++ b/files/en-us/web/javascript/guide/using_promises/index.md @@ -223,7 +223,7 @@ doSomething() The first mistake is to not chain things together properly. This happens when we create a new promise but forget to return it. As a consequence, the chain is broken — or rather, we have two independent chains racing. This means `doFourthThing()` won't wait for `doSomethingElse()` or `doThirdThing()` to finish, and will run concurrently with them — which is likely unintended. Separate chains also have separate error handling, leading to uncaught errors. -The second mistake is to nest unnecessarily, enabling the first mistake. Nesting also limits the scope of inner error handlers, which—if unintended—can lead to uncaught errors. A variant of this is the [promise constructor anti-pattern](https://stackoverflow.com/questions/23803743/what-is-the-explicit-promise-construction-antipattern-and-how-do-i-avoid-it), which combines nesting with redundant use of the promise constructor to wrap code that already uses promises. +The second mistake is to nest unnecessarily. Nesting also limits the scope of inner error handlers, which—if unintended—can lead to uncaught errors. A variant of this is the [promise constructor anti-pattern](https://stackoverflow.com/questions/23803743/what-is-the-explicit-promise-construction-antipattern-and-how-do-i-avoid-it), which combines nesting with redundant use of the promise constructor to wrap code that already uses promises. The third mistake is forgetting to terminate chains with `catch`. Unterminated promise chains lead to uncaught promise rejections in most browsers. See [error handling](#error_handling) below. From ae4248a024a14e259701b41da2b14d6b8a8a3ac8 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 8 Oct 2023 00:32:04 +0200 Subject: [PATCH 11/24] Few typofixes for Using CSS gradients (#29535) Few typofixes --- .../web/css/css_images/using_css_gradients/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/files/en-us/web/css/css_images/using_css_gradients/index.md b/files/en-us/web/css/css_images/using_css_gradients/index.md index 0a73e3602850895..c9bb15bbae5cdde 100644 --- a/files/en-us/web/css/css_images/using_css_gradients/index.md +++ b/files/en-us/web/css/css_images/using_css_gradients/index.md @@ -110,7 +110,7 @@ div { When using an angle, `0deg` creates a vertical gradient running bottom to top, `90deg` creates a horizontal gradient running left to right, and so on in a clockwise direction. Negative angles run in the counterclockwise direction. -![Four boxes listing angle and showing associated gradient. 0deg starts and top and goes to bottom. 90deg starts at right and goes left. 180deg starts and bottom and goes to the top. -90deg starts at left and goes right.](linear_red_angles.png) +![Four boxes listing angle and showing associated gradient from red to white. 0deg starts at the bottom and goes up. 90deg starts at left and goes right. 180deg starts at the top and goes down. -90deg starts at right and goes left.](linear_red_angles.png) ## Declaring colors & creating effects @@ -368,7 +368,7 @@ Radial gradients are similar to linear gradients, except that they radiate out f ### A basic radial gradient -As with linear gradients, all you need to create a radial gradient are two colors. By default, the center of the gradient is at the 50% 50% mark, and the gradient is elliptical matching the aspect ratio of it's box: +As with linear gradients, all you need to create a radial gradient are two colors. By default, the center of the gradient is at the 50% 50% mark, and the gradient is elliptical matching the aspect ratio of its box: ```html hidden
@@ -439,7 +439,7 @@ div { Unlike linear gradients, you can specify the size of radial gradients. Possible values include `closest-corner`, `closest-side`, `farthest-corner`, and `farthest-side`, with `farthest-corner` being the default. Circles can also be sized with a length, and ellipses a length or percentage. -#### Example: closest-side for ellipses +#### Example: `closest-side` for ellipses This example uses the `closest-side` size value, which means the size is set by the distance from the starting point (the center) to the closest side of the enclosing box. @@ -468,7 +468,7 @@ div { {{ EmbedLiveSample('Example_closest-side_for_ellipses', 240, 100) }} -#### Example: farthest-corner for ellipses +#### Example: `farthest-corner` for ellipses This example is similar to the previous one, except that its size is specified as `farthest-corner`, which sets the size of the gradient by the distance from the starting point to the farthest corner of the enclosing box from the starting point. @@ -497,7 +497,7 @@ div { {{ EmbedLiveSample('Example_farthest-corner_for_ellipses', 240, 100) }} -#### Example: closest-side for circles +#### Example: `closest-side` for circles This example uses `closest-side`, which makes the circle's radius to be the distance between the center of the gradient and the closest side. In this case the radius is the distance between the center and the bottom edge, because the gradient is placed 25% from the left and 25% from the bottom, and the div element's height is smaller than the width. @@ -936,5 +936,5 @@ div { - Gradient-related CSS data types: {{cssxref("<gradient>")}}, {{cssxref("<image>")}} - Gradient-related CSS properties: {{cssxref("background")}}, {{cssxref("background-image")}} - [CSS Gradients Patterns Gallery, by Lea Verou](https://projects.verou.me/css3patterns/) -- [CSS Gradients Library, by Estelle Weyl](http://standardista.com/cssgradients/) +- [CSS Gradients Library, by Estelle Weyl](https://standardista.com/cssgradients/) - [Gradient CSS Generator](https://cssgenerator.org/gradient-css-generator.html) From b81ce97c7b37b6339c95cf7a0ee0b72963dd0186 Mon Sep 17 00:00:00 2001 From: Sideways S Date: Sat, 7 Oct 2023 16:35:28 -0600 Subject: [PATCH 12/24] jump-none removes step, step-end svg fix (#29523) * jump-none removes step, step-end svg fix * analogous to easing-function page --------- Co-authored-by: Sideways S --- files/en-us/web/css/animation-timing-function/index.md | 6 +++--- files/en-us/web/css/easing-function/index.md | 6 +++--- files/en-us/web/css/easing-function/step.svg | 2 +- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/files/en-us/web/css/animation-timing-function/index.md b/files/en-us/web/css/animation-timing-function/index.md index d22e52b4fdb535e..7cc3592017102d5 100644 --- a/files/en-us/web/css/animation-timing-function/index.md +++ b/files/en-us/web/css/animation-timing-function/index.md @@ -73,11 +73,11 @@ animation-timing-function: unset; - : Displays an animation iteration along _n_ stops along the transition, displaying each stop for equal lengths of time. For example, if _n_ is 5, there are 5 steps. Whether the animation holds temporarily at 0%, 20%, 40%, 60% and 80%, on the 20%, 40%, 60%, 80% and 100%, or makes 5 stops between the 0% and 100% along the animation, or makes 5 stops including the 0% and 100% marks (on the 0%, 25%, 50%, 75%, and 100%) depends on which of the following jump terms is used: - `jump-start` - - : Denotes a left-continuous function, so that the first jump happens when the animation begins; + - : Denotes a left-continuous function, so that the first jump happens when the animation begins. - `jump-end` - - : Denotes a right-continuous function, so that the last jump happens when the animation ends; + - : Denotes a right-continuous function, so that the last jump happens when the animation ends. This is the default. - `jump-none` - - : There is no jump on either end. Instead, holding at both the 0% mark and the 100% mark, each for 1/n of the duration. + - : There is no jump on either end, effectively removing a step during the interpolation iteration. Instead, it holds at both the 0% mark and the 100% mark, each for 1/n of the duration. - `jump-both` - : Includes pauses at both the 0% and 100% marks, effectively adding a step during the animation iteration. - `start` diff --git a/files/en-us/web/css/easing-function/index.md b/files/en-us/web/css/easing-function/index.md index f5cff09235f78be..574cc66c59c1223 100644 --- a/files/en-us/web/css/easing-function/index.md +++ b/files/en-us/web/css/easing-function/index.md @@ -76,11 +76,11 @@ step-end - : One of the following keywords that indicate when the jumps occur: - `jump-start` denotes that the first step or jump happens when the interpolation begins. - - `jump-end` denotes that the last step or jump happens when the interpolation ends. + - `jump-end` denotes that the last step or jump happens when the interpolation ends. This is the default. - `jump-both` denotes that jumps occur at both the 0% and 100% marks, effectively adding a step during the interpolation iteration. - - `jump-none` denotes no jump on either end. Instead, holding at both the 0% mark and the 100% mark, each for 1/n of the duration. + - `jump-none` denotes no jump on either end, effectively removing a step during the interpolation iteration. Instead, it holds at both the 0% mark and the 100% mark, each for 1/n of the duration. - `start` is the equivalent of `jump-start`. - - `end` is the equivalent of `jump-end`. This is the default. + - `end` is the equivalent of `jump-end`. - `step-start` diff --git a/files/en-us/web/css/easing-function/step.svg b/files/en-us/web/css/easing-function/step.svg index f99fc73c96bd5db..b0cea5a153d5a27 100644 --- a/files/en-us/web/css/easing-function/step.svg +++ b/files/en-us/web/css/easing-function/step.svg @@ -1 +1 @@ -10.500.51Output progressInput progressstep-startstep-start +10.500.51Output progressInput progressstep-startstep-end From 505984d77363cbce87d0b3e2e0607eb662b99a9c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E3=81=BF=E3=81=91CAT?= Date: Sun, 8 Oct 2023 08:35:38 +0900 Subject: [PATCH 13/24] Fix 424 Failed Dependency (#29462) * Fix 424 Failed Dependency * Update files/en-us/web/http/status/424/index.md Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --------- Co-authored-by: Hamish Willee Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- files/en-us/web/http/status/424/index.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/files/en-us/web/http/status/424/index.md b/files/en-us/web/http/status/424/index.md index 7a1311d242921b5..45a6b2160a96a29 100644 --- a/files/en-us/web/http/status/424/index.md +++ b/files/en-us/web/http/status/424/index.md @@ -13,6 +13,12 @@ Regular web servers will normally not return this status code. But some other pr ## Status +```http +424 Failed Dependency +``` + +## Specifications + {{Specifications}} ## See also From 5062632c038be08f512d6e3128ff6ae1b1ddd5b4 Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Mon, 9 Oct 2023 00:01:12 +0800 Subject: [PATCH 14/24] `Client.postMessage` also support passing an options param (#29187) --- files/en-us/web/api/client/postmessage/index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/files/en-us/web/api/client/postmessage/index.md b/files/en-us/web/api/client/postmessage/index.md index a732ea1b8703887..11c7025dd0fe2f4 100644 --- a/files/en-us/web/api/client/postmessage/index.md +++ b/files/en-us/web/api/client/postmessage/index.md @@ -18,6 +18,7 @@ message is received in the "`message`" event on ```js-nolint postMessage(message) +postMessage(message, options) postMessage(message, transferables) ``` @@ -25,10 +26,10 @@ postMessage(message, transferables) - `message` - : The message to send to the client. This can be any [structured-cloneable type](/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm). +- `options` {{optional_inline}} + - : An optional object containing a `transfer` field with an [array](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array) of [transferable objects](/en-US/docs/Web/API/Web_Workers_API/Transferable_objects) to transfer ownership of. The ownership of these objects is given to the destination side and they are no longer usable on the sending side. - `transferables` {{optional_inline}} - - : A sequence of objects that are [transferred](/en-US/docs/Web/API/Web_Workers_API/Transferable_objects) with the message. The - ownership of these objects is given to the destination side and they are no longer - usable on the sending side. + - : An optional [array](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array) of [transferable objects](/en-US/docs/Web/API/Web_Workers_API/Transferable_objects) to transfer ownership of. The ownership of these objects is given to the destination side and they are no longer usable on the sending side. ### Return value From 194ea6cb5ddaf20e4f551cc93574be50b8b4f339 Mon Sep 17 00:00:00 2001 From: robmats99 <142125291+robmats99@users.noreply.github.com> Date: Sun, 8 Oct 2023 14:43:52 -0400 Subject: [PATCH 15/24] Replaced anchor example for an image example (#29157) * Replaced anchor example for an image example * Apply suggestions from code review Co-authored-by: wbamberg * Changed anchor examples down the page to not reference the one that was replaced * Small rephrases --------- Co-authored-by: Robert Matsibekker Co-authored-by: wbamberg --- .../getting_started/index.md | 35 ++++++++++--------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/files/en-us/learn/html/introduction_to_html/getting_started/index.md b/files/en-us/learn/html/introduction_to_html/getting_started/index.md index 1431a804166cff1..e35d6e77e54bc86 100644 --- a/files/en-us/learn/html/introduction_to_html/getting_started/index.md +++ b/files/en-us/learn/html/introduction_to_html/getting_started/index.md @@ -245,22 +245,25 @@ An attribute should have: ### Active learning: Adding attributes to an element -Another example of an element is {{htmlelement("a")}}. This stands for _anchor_. An anchor can make the text it encloses into a hyperlink. Anchors can take a number of attributes, but several are as follows: +The `` element can take a number of attributes, including: -- `href` - - : This attribute's value specifies the web address for the link. For example: `href="https://www.mozilla.org/"`. -- `title` - - : The `title` attribute specifies extra information about the link, such as a description of the page that is being linked to. For example, `title="The Mozilla homepage"`. This appears as a tooltip when a cursor hovers over the element. -- `target` - - : The `target` attribute specifies the browsing context used to display the link. For example, `target="_blank"` will display the link in a new tab. If you want to display the linked content in the current tab, just omit this attribute. +- `src` + - : The `src` attribute is a **required** attribute that specifies the location of the image. For example: `src="https://raw.githubusercontent.com/mdn/beginner-html-site/gh-pages/images/firefox-icon.png"`. +- `alt` + - : The `alt` attribute specifies a text description of the image. For example: `alt="The Firefox icon"`. +- `width` + - : The `width` attribute specifies the width of the image with the unit being pixels. For example: `width="300"`. +- `height` + - : The `height` attribute specifies the height of the image with the unit being pixels. For example: `height="300"`. -Edit the line below in the _Input_ area to turn it into a link to your favorite website. +Edit the line below in the _Input_ area to turn it into an image. -1. Add the `` element. -2. Add the `href` attribute and the `title` attribute. -3. Specify the `target` attribute to open the link in the new tab. +1. Find your favorite image online, right click it, and press _Copy Image Link/Address_. +2. Back in the area below, add the `src` attribute and fill it with the link from step 1. +3. Set the `alt` attribute. +4. Add the `width` and `height` attributes. -You will be able to see your changes live in the _Output_ area. You should see a link—that when hovered over—displays the value of the `title` attribute and, when clicked, opens a new tab and navigates to the web address in the `href` attribute. Remember that you need to include a space between the element name and between each attribute. +You will be able to see your changes live in the _Output_ area. If you make a mistake, you can always reset it using the _Reset_ button. If you get really stuck, press the _Show solution_ button to see the answer. @@ -275,7 +278,7 @@ If you make a mistake, you can always reset it using the _Reset_ button. If you

@@ -319,7 +322,7 @@ function updateCode() { } const htmlSolution = - '

A link to my favorite website.

'; + 'Firefox icon'; let solutionEntry = htmlSolution; reset.addEventListener("click", () => { @@ -416,13 +419,13 @@ For reference, the example above also includes a non-disabled form input element ### Omitting quotes around attribute values -If you look at code for a lot of other sites, you might come across a number of strange markup styles, including attribute values without quotes. This is permitted in certain circumstances, but it can also break your markup in other circumstances. For example, if we revisit our link example from earlier, we could write a basic version with _only_ the `href` attribute, like this: +If you look at code for a lot of other sites, you might come across a number of strange markup styles, including attribute values without quotes. This is permitted in certain circumstances, but it can also break your markup in other circumstances. The element in the code snippet below, ``, is called an anchor. Anchors enclose text and turn them into links. The `href` attribute specifies the web address the link points to. You can write this basic version below with _only_ the `href` attribute, like this: ```html favorite website ``` -However, as soon as we add the `title` attribute in this way, there are problems: +Anchors can also have a `title` attribute, a description of the linked page. However, as soon as we add the `title` in the same fashion as the `href` attribute there are problems: ```html-nolint example-bad favorite website From 86dd5c98a18e70297b79b34a2da653f556827bc1 Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Mon, 9 Oct 2023 06:28:35 +0800 Subject: [PATCH 16/24] Update Attribute Order according to Alphabetical Order of `` `