This means that you shouldn’t write a lazy getter for a property whose value you
+
diff --git a/files/en-us/web/javascript/reference/global_objects/array/every/index.html b/files/en-us/web/javascript/reference/global_objects/array/every/index.html
index fa54e049f326e7e..84b30dbdf1528f7 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/every/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/every/index.html
@@ -71,7 +71,7 @@
diff --git a/files/en-us/web/javascript/reference/global_objects/array/findindex/index.html b/files/en-us/web/javascript/reference/global_objects/array/findindex/index.html
index 7d019598abb9282..e94648bec98b577 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/findindex/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/findindex/index.html
@@ -84,7 +84,7 @@
diff --git a/files/en-us/web/javascript/reference/global_objects/array/foreach/index.html b/files/en-us/web/javascript/reference/global_objects/array/foreach/index.html
index 26f3efb9e5e7f9e..f1e9819fa77376e 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/foreach/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/foreach/index.html
@@ -104,7 +104,7 @@
-
forEach expects a synchronous function
-
-
forEach does not wait for promises. Kindly make sure you are aware of the
- implications while using promises(or async functions) as
forEach callback.
-
-
Example Code
+
Note: forEach expects a synchronous function.
+
forEach does not wait for promises. Make sure you are aware of the
+ implications while using promises (or async functions) as forEach callback.
let ratings = [5, 4, 5];
let sum = 0;
diff --git a/files/en-us/web/javascript/reference/global_objects/array/from/index.html b/files/en-us/web/javascript/reference/global_objects/array/from/index.html
index 5d06b2159273467..01c8162200d61f4 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/from/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/from/index.html
@@ -73,7 +73,7 @@ Description
as Array.from(obj).map(mapFn, thisArg),
except that it does not create an intermediate array.
-
@@ -196,7 +196,7 @@ Polyfill
natively support it.
-
Polyfill Notes: This algorithm is exactly as specified in
+
Note: This algorithm is exactly as specified in
ECMA-262 6th Edition (assuming Object and
TypeError have their original values and that
callback.call() evaluates to the original value of
diff --git a/files/en-us/web/javascript/reference/global_objects/array/reduce/index.html b/files/en-us/web/javascript/reference/global_objects/array/reduce/index.html
index bb1d88f499271f1..db07b012a50a6ad 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/reduce/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/reduce/index.html
@@ -348,7 +348,7 @@
Polyfill
-
Caution: If you need to support truly obsolete JavaScript engines
+
Note: If you need to support truly obsolete JavaScript engines
that do not support {{domxref("Object.defineProperty()")}}, it is best not to polyfill
Array.prototype methods at all, as you cannot make them
non-enumerable.
diff --git a/files/en-us/web/javascript/reference/global_objects/array/some/index.html b/files/en-us/web/javascript/reference/global_objects/array/some/index.html
index c9bfb73af29c40c..f7a6ac2630c1f12 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/some/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/some/index.html
@@ -97,7 +97,7 @@
Description
visits that element's index. Elements that are deleted are not visited.
-
Caution: Calling this method on an empty array returns
+
Note: Calling this method on an empty array returns
false for any condition!
diff --git a/files/en-us/web/javascript/reference/global_objects/array/sort/index.html b/files/en-us/web/javascript/reference/global_objects/array/sort/index.html
index e7a6b5494e2e668..ee1d9833f3825e5 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/sort/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/sort/index.html
@@ -67,7 +67,7 @@
Description
-
Note : In UTF-16, Unicode characters above \uFFFF are
+
Note: In UTF-16, Unicode characters above \uFFFF are
encoded as two surrogate code units, of the range
\uD800-\uDFFF. The value of each code unit is taken
separately into account for the comparison. Thus the character formed by the surrogate
@@ -271,7 +271,7 @@
Sort stability
After sorting this array by grade in ascending order:
-
students.sort((firstItem, secondItem) => firstItem.grade - secondItem.grade);
+students.sort((firstItem, secondItem) => firstItem.grade - secondItem.grade);
The students variable will then have the following value:
diff --git a/files/en-us/web/javascript/reference/global_objects/array/values/index.html b/files/en-us/web/javascript/reference/global_objects/array/values/index.html
index 4ba72ed168592f4..22891c3bf013bb9 100644
--- a/files/en-us/web/javascript/reference/global_objects/array/values/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/array/values/index.html
@@ -91,7 +91,7 @@ Iteration using .next()
-
if the values in the array changed the array iterator object values change too.
+
Note: If the values in the array changed the array iterator object values change too.
diff --git a/files/en-us/web/javascript/reference/global_objects/date/index.html b/files/en-us/web/javascript/reference/global_objects/date/index.html
index 6f7e21d77601e80..eb0d1f386a29399 100644
--- a/files/en-us/web/javascript/reference/global_objects/date/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/date/index.html
@@ -15,7 +15,7 @@
JavaScript Date objects represent a single moment in time in a platform-independent format. Date objects contain a Number that represents milliseconds since 1 January 1970 UTC.
-
TC39 is working on Temporal, a new Date/Time API. Read more about it on the Igalia blog. It is not yet ready for production use!
+
Note: TC39 is working on Temporal, a new Date/Time API. Read more about it on the Igalia blog. It is not yet ready for production use!
Description
diff --git a/files/en-us/web/javascript/reference/global_objects/date/parse/index.html b/files/en-us/web/javascript/reference/global_objects/date/parse/index.html
index 699da510ebbc365..df153bf7d52b223 100644
--- a/files/en-us/web/javascript/reference/global_objects/date/parse/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/date/parse/index.html
@@ -85,7 +85,7 @@
-
This section contains implementation-specific behavior that can be inconsistent
+
Note: This section contains implementation-specific behavior that can be inconsistent
across implementations.
@@ -139,7 +139,7 @@
-
Some browsers include the CustomError constructor in the stack trace when using ES2015 classes.
+
Note: Some browsers include the CustomError constructor in the stack trace when using ES2015 classes.
class CustomError extends Error {
diff --git a/files/en-us/web/javascript/reference/global_objects/function/call/index.html b/files/en-us/web/javascript/reference/global_objects/function/call/index.html
index e1b1261c99c4a51..5e269a0879cbc28 100644
--- a/files/en-us/web/javascript/reference/global_objects/function/call/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/function/call/index.html
@@ -28,7 +28,7 @@ Parameters
-
Caution: In certain cases, thisArg may
+
Note: In certain cases, thisArg may
not be the actual value seen by the method.
If the method is a function in {{jsxref("Strict_mode", "non-strict mode", "",
@@ -110,7 +110,7 @@
Using call to i
-
Passing the object as this value is not strictly necessary, but is done
+
Note: Passing the object as this value is not strictly necessary, but is done
for explanatory purpose.
-
Caution: In strict mode, the value of this will be
+
Note: In strict mode, the value of this will be
undefined. See below.
{{js_property_attributes(0,0,1)}}
-
Note that in non-standard, pre-ES2015 implementations the configurable attribute was false as well.
+
Note: In non-standard, pre-ES2015 implementations the configurable attribute was false as well.
JavaScript compressors and minifiers
diff --git a/files/en-us/web/javascript/reference/global_objects/intl/collator/collator/index.html b/files/en-us/web/javascript/reference/global_objects/intl/collator/collator/index.html
index 54a1832f20162d6..20b6544abe0af19 100644
--- a/files/en-us/web/javascript/reference/global_objects/intl/collator/collator/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/intl/collator/collator/index.html
@@ -37,7 +37,7 @@ Parameters
The following Unicode extension keys are allowed:
-
These keys can usually also be set with options (as listed
+
Note: These keys can usually also be set with options (as listed
below). When both are set, the options property takes
precedence.
Parameters
"10". Possible values are true and false; the
default is false.
-
This option can also be set through the kn Unicode
+
Note: This option can also be set through the kn Unicode
extension key; if both are provided, this options
property takes precedence.
Parameters
key; if both are provided, the options property
takes precedence.
-
This option can also be set through the kf Unicode
+
Note: This option can also be set through the kf Unicode
extension key; if both are provided, this options
property takes precedence.
Parameters
"reformed", "searchjl", "stroke",
"trad", "unihan".
-
This option can also be set through the co Unicode
+
Note: This option can also be set through the co Unicode
extension key; if both are provided, this options
property takes precedence.
Parameters
-
dateStyle can be used with timeStyle, but
+
Note: dateStyle can be used with timeStyle, but
not with other options (e.g. weekday,
hour, month, etc.).
Parameters
-
timeStyle can be used with dateStyle, but
+
Note: timeStyle can be used with dateStyle, but
not with other options (e.g. weekday,
hour, month, etc.).
Parameters
The representation of the second. Possible values are
"numeric", "2-digit".
fractionalSecondDigits
-
-
-
Added in Firefox 84, Chrome 84, etc. See
- compatibility table for more information.
-
diff --git a/files/en-us/web/javascript/reference/global_objects/map/index.html b/files/en-us/web/javascript/reference/global_objects/map/index.html
index 2f88f9869241c6a..be46a2581257411 100644
--- a/files/en-us/web/javascript/reference/global_objects/map/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/map/index.html
@@ -380,7 +380,7 @@ Cloning and merging Maps
console.log(original === clone) // false (useful for shallow comparison)
-
Important: Keep in mind that the data itself is not cloned.
+
Note: Keep in mind that the data itself is not cloned.
{{EmbedInteractiveExample("pages/js/math-random.html")}}
-
Math.random() does not provide cryptographically secure random
+
Note: Math.random() does not provide cryptographically secure random
numbers. Do not use them for anything related to security. Use the Web Crypto API
instead, and more precisely the {{domxref("Crypto.getRandomValues",
"window.crypto.getRandomValues()")}} method.
@@ -79,7 +79,7 @@
Getting a random integer be
-
It might be tempting to use Math.round() to accomplish that, but doing
+
Note: It might be tempting to use Math.round() to accomplish that, but doing
so would cause your random numbers to follow a non-uniform distribution, which may not
be acceptable for your needs.
Changing the constructor of a fu
-
Summary: Manually updating or setting the constructor can lead to different and sometimes confusing consequences. To prevent this, just define the role of constructor in each specific case. In most cases, constructor is not used and reassignment of it is not necessary.
+
Note: Manually updating or setting the constructor can lead to different and sometimes confusing consequences. To prevent this, just define the role of constructor in each specific case. In most cases, constructor is not used and reassignment of it is not necessary.
Specifications
diff --git a/files/en-us/web/javascript/reference/global_objects/object/isprototypeof/index.html b/files/en-us/web/javascript/reference/global_objects/object/isprototypeof/index.html
index acd540ea77df153..61c364ec98048e5 100644
--- a/files/en-us/web/javascript/reference/global_objects/object/isprototypeof/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/object/isprototypeof/index.html
@@ -18,7 +18,7 @@
-
isPrototypeOf() differs from the {{jsxref("Operators/instanceof",
+
Note: isPrototypeOf() differs from the {{jsxref("Operators/instanceof",
"instanceof")}} operator. In the expression
"object instanceof AFunction", the object prototype chain is
checked against AFunction.prototype, not against AFunction
diff --git a/files/en-us/web/javascript/reference/global_objects/object/valueof/index.html b/files/en-us/web/javascript/reference/global_objects/object/valueof/index.html
index 8ad9a95ec08b366..85912261dde70b2 100644
--- a/files/en-us/web/javascript/reference/global_objects/object/valueof/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/object/valueof/index.html
@@ -23,7 +23,7 @@
Return value
The primitive value of the specified object.
-
A Note: A (unary)
plus sign can sometimes be used as a shorthand for valueOf, e.g. in
+new Number(). Also see Using unary plus.
diff --git a/files/en-us/web/javascript/reference/global_objects/promise/index.html b/files/en-us/web/javascript/reference/global_objects/promise/index.html
index cb00b791ce52c36..b1b9d4a2ad958be 100644
--- a/files/en-us/web/javascript/reference/global_objects/promise/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/promise/index.html
@@ -36,7 +36,7 @@
Description
-
Not to be confused with: Several other languages have mechanisms for lazy evaluation and deferring a computation, which they also call "promises", e.g. Scheme. Promises in JavaScript represent processes that are already happening, which can be chained with callback functions. If you are looking to lazily evaluate an expression, consider the arrow function with no arguments: f = () => expression to create the lazily-evaluated expression, and f() to evaluate.
+
Note: Several other languages have mechanisms for lazy evaluation and deferring a computation, which they also call "promises", e.g. Scheme. Promises in JavaScript represent processes that are already happening, which can be chained with callback functions. If you are looking to lazily evaluate an expression, consider the arrow function with no arguments: f = () => expression to create the lazily-evaluated expression, and f() to evaluate.
diff --git a/files/en-us/web/javascript/reference/global_objects/promise/then/index.html b/files/en-us/web/javascript/reference/global_objects/promise/then/index.html
index 04114be2c43a11c..3ceec285fce824f 100644
--- a/files/en-us/web/javascript/reference/global_objects/promise/then/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/promise/then/index.html
@@ -18,7 +18,7 @@
-
If one or both arguments are omitted or are provided non-functions, then
+
Note: If one or both arguments are omitted or are provided non-functions, then
then will be missing the handler(s), but will not generate any errors. If
the Promise that then is called on adopts a state
(fulfillment or rejection) for which then has
diff --git a/files/en-us/web/javascript/reference/global_objects/proxy/proxy/set/index.html b/files/en-us/web/javascript/reference/global_objects/proxy/proxy/set/index.html
index 28de60d9b40d868..22b29ad17bfcbb6 100644
--- a/files/en-us/web/javascript/reference/global_objects/proxy/proxy/set/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/proxy/proxy/set/index.html
@@ -40,14 +40,11 @@
Parameters
The object to which the assignment was originally directed. This is usually the
proxy itself. But a set() handler can also be called indirectly, via
the prototype chain or various other ways.
-
-
-
For example: Suppose a script does
+
For example, suppose a script does
obj.name = "jen", and obj is not a
proxy, and has no own property .name, but it has a proxy on its
prototype chain. That proxy's set() handler will be called, and
obj will be passed as the receiver.
-
diff --git a/files/en-us/web/javascript/reference/global_objects/reflect/defineproperty/index.html b/files/en-us/web/javascript/reference/global_objects/reflect/defineproperty/index.html
index bfa2bab35439295..3593cd6d994fb54 100644
--- a/files/en-us/web/javascript/reference/global_objects/reflect/defineproperty/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/reflect/defineproperty/index.html
@@ -49,7 +49,7 @@
Description
{{jsxref("Object.defineProperty")}} which is similar.
-
One key difference: Object.defineProperty returns the
+
Note: Object.defineProperty returns the
object or throws a {{jsxref("TypeError")}} if the property has not been successfully
defined. Reflect.defineProperty, however, returns a {{jsxref("Boolean")}}
indicating whether or not the property was successfully defined.
diff --git a/files/en-us/web/javascript/reference/global_objects/regexp/index.html b/files/en-us/web/javascript/reference/global_objects/regexp/index.html
index 1a72ece8d896e4d..e5d3d517ce839e2 100644
--- a/files/en-us/web/javascript/reference/global_objects/regexp/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/regexp/index.html
@@ -210,7 +210,7 @@
Extracting sub-domain name from URL
-
Instead of using regular expressions for parsing URLs, it is usually better to use the browsers built-in URL parser by using the URL API.
+
Note: Instead of using regular expressions for parsing URLs, it is usually better to use the browsers built-in URL parser by using the URL API.
Specifications
diff --git a/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/planned_changes/index.html b/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/planned_changes/index.html
index 175f00036b5c8a1..b1baa0fb39f2427 100644
--- a/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/planned_changes/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/planned_changes/index.html
@@ -16,7 +16,7 @@
There is standardization work ongoing that enables developers to create SharedArrayBuffer objects again, but changes are needed in order to be use these across threads (i.e., postMessage() for SharedArrayBuffer objects throws by default). These changes provide further isolation between sites and help reduce the impact of attacks with high-resolution timers, which can be created with shared memory.
-
Starting with Firefox 79, the features described in this document are enabled by default.
+
Note: Starting with Firefox 79, the features described in this document are enabled by default.
Chrome intends to implement similar restrictions.
diff --git a/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/sharedarraybuffer/index.html b/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/sharedarraybuffer/index.html
index 1b6123769d9ca6b..e9ad93cc71c3874 100644
--- a/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/sharedarraybuffer/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/sharedarraybuffer/sharedarraybuffer/index.html
@@ -10,7 +10,7 @@
{{JSRef}}
-
Note that SharedArrayBuffer was disabled by default in all major
+
Note: SharedArrayBuffer was disabled by default in all major
browsers on 5 January, 2018 in response to Spectre. Chrome re-enabled it in
diff --git a/files/en-us/web/javascript/reference/global_objects/string/big/index.html b/files/en-us/web/javascript/reference/global_objects/string/big/index.html
index 6329ec4ceced96b..ecd83fa024d5d0e 100644
--- a/files/en-us/web/javascript/reference/global_objects/string/big/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/string/big/index.html
@@ -16,7 +16,7 @@
element that causes a string to be displayed in a big font.
-
Usage note: The <big> element has been removed in Note: The <big> element has been removed in HTML5 and shouldn't be used anymore.
Instead web developers should use CSS properties.
diff --git a/files/en-us/web/javascript/reference/global_objects/string/fontcolor/index.html b/files/en-us/web/javascript/reference/global_objects/string/fontcolor/index.html
index 8ad38c86223001c..d827c269f7781a8 100644
--- a/files/en-us/web/javascript/reference/global_objects/string/fontcolor/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/string/fontcolor/index.html
@@ -16,7 +16,7 @@
HTML element that causes a string to be displayed in the specified font color.
-
Usage note: The <font> element has been removed in Note: The <font> element has been removed in HTML5 and shouldn't be used anymore.
Instead web developers should use CSS properties.
diff --git a/files/en-us/web/javascript/reference/global_objects/string/fontsize/index.html b/files/en-us/web/javascript/reference/global_objects/string/fontsize/index.html
index 6ff319ee00dd1a1..087f72e5b09e42f 100644
--- a/files/en-us/web/javascript/reference/global_objects/string/fontsize/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/string/fontsize/index.html
@@ -16,7 +16,7 @@
HTML element that causes a string to be displayed in the specified font size.
-
Usage note: The <font> element has been removed in Note: The <font> element has been removed in HTML5 and shouldn't be used anymore.
Instead web developers should use CSS properties.
diff --git a/files/en-us/web/javascript/reference/global_objects/string/index.html b/files/en-us/web/javascript/reference/global_objects/string/index.html
index d7f4c7a46d72ee0..d01e057d0f09372 100644
--- a/files/en-us/web/javascript/reference/global_objects/string/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/string/index.html
@@ -413,8 +413,8 @@
Instance methods
HTML wrapper methods
-
-
Deprecated. Avoid these methods.
+
+
Warning: Deprecated. Avoid these methods.
They are of limited use, as they provide only a subset of the available HTML tags
and attributes.
diff --git a/files/en-us/web/javascript/reference/global_objects/string/replaceall/index.html b/files/en-us/web/javascript/reference/global_objects/string/replaceall/index.html
index 3a3cc9d866ec50c..9ed8f148d44460e 100644
--- a/files/en-us/web/javascript/reference/global_objects/string/replaceall/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/string/replaceall/index.html
@@ -27,7 +27,7 @@
Syntax
-
when using a `regexp` you have to set the global ("g") flag; otherwise, it
+
Note: When using a `regexp` you have to set the global ("g") flag; otherwise, it
will throw a TypeError: "replaceAll must be called with a global RegExp".
diff --git a/files/en-us/web/javascript/reference/global_objects/typedarray/values/index.html b/files/en-us/web/javascript/reference/global_objects/typedarray/values/index.html
index 45bd190bee8b4fc..e219876d9f8dbd5 100644
--- a/files/en-us/web/javascript/reference/global_objects/typedarray/values/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/typedarray/values/index.html
@@ -56,7 +56,7 @@
Iteration using .next()
iteraror.next().value; // undefined
-
One-use: the array iterator object is one use or temporary object
+
Note: The array iterator object is a one use or temporary object
example:
@@ -89,7 +89,7 @@
Iteration using .next()
-
if the values in the array changed the array iterator object values change too.
+
Note: If the values in the array changed the array iterator object values change too.
diff --git a/files/en-us/web/javascript/reference/global_objects/undefined/index.html b/files/en-us/web/javascript/reference/global_objects/undefined/index.html
index 2a8615851c0d0da..48a2b7895f9fa4f 100644
--- a/files/en-us/web/javascript/reference/global_objects/undefined/index.html
+++ b/files/en-us/web/javascript/reference/global_objects/undefined/index.html
@@ -37,7 +37,7 @@
Description
a value was not {{jsxref("Statements/return", "returned")}}.
-
Be careful. While it is possible to use it as an
+
Note: While you can use undefined as an
{{Glossary("identifier")}} (variable name) in any scope other than the global scope
(because undefined is not a {{jsxref("Reserved_Words", "reserved word",
"", 1)}}), doing so is a very bad idea that will make your code difficult to maintain
diff --git a/files/en-us/web/javascript/reference/operators/destructuring_assignment/index.html b/files/en-us/web/javascript/reference/operators/destructuring_assignment/index.html
index dcdb1c240a31045..0ea9df1f744e3a4 100644
--- a/files/en-us/web/javascript/reference/operators/destructuring_assignment/index.html
+++ b/files/en-us/web/javascript/reference/operators/destructuring_assignment/index.html
@@ -218,7 +218,7 @@
Assignment without declaration
({a, b} = {a: 1, b: 2});
-
Notes: The parentheses ( ... ) around the assignment statement are required when using object literal destructuring assignment without a declaration.
+
Note: The parentheses ( ... ) around the assignment statement are required when using object literal destructuring assignment without a declaration.
{a, b} = {a: 1, b: 2} is not valid stand-alone syntax, as the {a, b} on the left-hand side is considered a block and not an object literal.
@@ -300,7 +300,7 @@
Setting a function paramete
});
-
In the function signature for drawChart above, the destructured left-hand side is assigned to an empty object literal on the right-hand side: {size = 'big', coords = {x: 0, y: 0}, radius = 25} = {}. You could have also written the function without the right-hand side assignment. However, if you leave out the right-hand side assignment, the function will look for at least one argument to be supplied when invoked, whereas in its current form, you can call drawChart() without supplying any parameters. The current design is useful if you want to be able to call the function without supplying any parameters, the other can be useful when you want to ensure an object is passed to the function.
+
Note: In the function signature for drawChart above, the destructured left-hand side is assigned to an empty object literal on the right-hand side: {size = 'big', coords = {x: 0, y: 0}, radius = 25} = {}. You could have also written the function without the right-hand side assignment. However, if you leave out the right-hand side assignment, the function will look for at least one argument to be supplied when invoked, whereas in its current form, you can call drawChart() without supplying any parameters. The current design is useful if you want to be able to call the function without supplying any parameters, the other can be useful when you want to ensure an object is passed to the function.
Nested object and array destructuring
diff --git a/files/en-us/web/javascript/reference/operators/new/index.html b/files/en-us/web/javascript/reference/operators/new/index.html
index ad1142bef795cb2..6b0efadb014b462 100644
--- a/files/en-us/web/javascript/reference/operators/new/index.html
+++ b/files/en-us/web/javascript/reference/operators/new/index.html
@@ -39,7 +39,7 @@ Description
- Creates a blank, plain JavaScript object.
- Adds a property to the new object (
__proto__) that links to the constructor function's prototype object
-
Properties/objects added to the construction function prototype are therefore accessible to all instances created from the constructor function (using new).
+
Note: Properties/objects added to the construction function prototype are therefore accessible to all instances created from the constructor function (using new).
- Binds the newly created object instance as the
this context
@@ -63,7 +63,7 @@ Description
-
An object can have a property that is itself another object. See the
+
Note: An object can have a property that is itself another object. See the
examples below.
Description
-
While the constructor function can be invoked like any regular function (i.e. without the new operator),
+
Note: While the constructor function can be invoked like any regular function (i.e. without the new operator),
in this case a new Object is not created and the value of this is also different.
Function context
f2() === undefined; // true
-In the second example,
this should be
+
+
Note: In the second example, this should be
{{jsxref("undefined")}}, because f2 was called directly and not as a method
or property of an object (e.g. window.f2()). This feature wasn't
implemented in some browsers when they first started to support strict mode. As a result,
- they incorrectly returned the window object.
+ they incorrectly returned the
window object.
To set the value of this to a particular value when calling a function,
use {{jsxref("Function.prototype.call()", "call()")}}, or
@@ -253,7 +254,7 @@
Arrow functions
console.log(foo() === globalObject); // true
-
Note: if this arg is passed to call, bind, or
+
Note: If this arg is passed to call, bind, or
apply on invocation of an arrow function it will be ignored. You can
still prepend arguments to the call, but the first argument (thisArg)
should be set to null.
@@ -418,7 +419,7 @@
As a constructor
keyword), its
this is bound to the new object being constructed.
-
While the default for a constructor is to return the object referenced by
+
Note: While the default for a constructor is to return the object referenced by
this, it can instead return some other object (if the return value isn't
an object, then the this object is returned).
diff --git a/files/en-us/web/javascript/reference/statements/async_function/index.html b/files/en-us/web/javascript/reference/statements/async_function/index.html
index 28428895c61b5b7..effa2bf4e7912e5 100644
--- a/files/en-us/web/javascript/reference/statements/async_function/index.html
+++ b/files/en-us/web/javascript/reference/statements/async_function/index.html
@@ -48,12 +48,12 @@
Description
Async functions can contain zero or more {{jsxref("Operators/await", "await")}} expressions. Await expressions make promise-returning functions behave as though they're synchronous by suspending execution until the returned promise is fulfilled or rejected. The resolved value of the promise is treated as the return value of the await expression. Use of async and await enables the use of ordinary try / catch blocks around asynchronous code.
-
The await keyword is only valid inside async functions within regular JavaScript code. If you use it outside of an async function's body, you will get a {{jsxref("SyntaxError")}}.
+
Note: The await keyword is only valid inside async functions within regular JavaScript code. If you use it outside of an async function's body, you will get a {{jsxref("SyntaxError")}}.
await can be used on its own with JavaScript modules.
-
The purpose of async/await is to simplify the syntax
+
Note: The purpose of async/await is to simplify the syntax
necessary to consume promise-based APIs. The behavior
of async/await is similar to combining generators and
@@ -294,10 +294,7 @@
Rewriting a Promise ch
it's not already a promise itself (as in this example).
-
return await promiseValue vs.
- return promiseValue
-
-
The implicit wrapping of return values in {{jsxref("Promise.resolve")}} does not
+
Note: The implicit wrapping of return values in {{jsxref("Promise.resolve")}} does not
imply that return await promiseValue is functionally equivalent to
return promiseValue.
diff --git a/files/en-us/web/javascript/reference/statements/for-await...of/index.html b/files/en-us/web/javascript/reference/statements/for-await...of/index.html
index ac6b496a93267ff..e764b3c4c19b14a 100644
--- a/files/en-us/web/javascript/reference/statements/for-await...of/index.html
+++ b/files/en-us/web/javascript/reference/statements/for-await...of/index.html
@@ -16,7 +16,7 @@
The for await...of statement creates a loop iterating over async iterable objects as well as on sync iterables, including: built-in {{jsxref("String")}}, {{jsxref("Array")}}, Array-like objects (e.g., {{jsxref("Functions/arguments", "arguments")}} or {{DOMxRef("NodeList")}}), {{jsxref("TypedArray")}}, {{jsxref("Map")}}, {{jsxref("Set")}}, and user-defined async/sync iterables. It invokes a custom iteration hook with statements to be executed for the value of each distinct property of the object. This statement can only be used inside an {{jsxref("Statements/async_function", "async function", "", 1)}}.
-
for await...of doesn't work with async iterators that are not async
+
Note: for await...of doesn't work with async iterators that are not async
iterables.
@@ -166,7 +166,7 @@
Iterating over sync iterab
-
Note: be aware of yielding rejected promises from sync generator. In
+
Note: Be aware of yielding rejected promises from sync generator. In
such case for await...of throws when consuming rejected promise and
DOESN'T CALL finally blocks within that generator. This can be
undesirable if you need to free some allocated resources with
diff --git a/files/en-us/web/javascript/reference/statements/let/index.html b/files/en-us/web/javascript/reference/statements/let/index.html
index 1fa51b1a37b0c98..05351a52749d9e5 100644
--- a/files/en-us/web/javascript/reference/statements/let/index.html
+++ b/files/en-us/web/javascript/reference/statements/let/index.html
@@ -60,7 +60,7 @@
Description
-
Many issues with let variables can be avoided by declaring them at the
+
Note: Many issues with let variables can be avoided by declaring them at the
top of the scope in which they are used (doing so may impact readibility).
@@ -202,7 +202,7 @@
Temporal dead zone (TDZ)
{{jsxref("ReferenceError")}}.
-
This differs from {{jsxref("Statements/var", "var", "var_hoisting")}} variables,
+
Note: This differs from {{jsxref("Statements/var", "var", "var_hoisting")}} variables,
which will return a value of undefined if they are accessed before they
are declared.
diff --git a/files/en-us/web/javascript/reference/statements/return/index.html b/files/en-us/web/javascript/reference/statements/return/index.html
index e99636394bfbbe6..ee7b9a972be7594 100644
--- a/files/en-us/web/javascript/reference/statements/return/index.html
+++ b/files/en-us/web/javascript/reference/statements/return/index.html
@@ -68,8 +68,10 @@
Automatic Semicolon Insertion
The console will warn "unreachable code after return statement".
-
Starting with Firefox 40, a warning is shown in the console if
- unreachable code is found after a return statement.
+
+
Note: Starting with Firefox 40, a warning is shown in the console if
+ unreachable code is found after a return statement.
+
To avoid this problem (to prevent ASI), you could use parentheses:
diff --git a/files/en-us/web/javascript/reference/statements/with/index.html b/files/en-us/web/javascript/reference/statements/with/index.html
index a0e0116ef08d2ee..d6db47f133ad96a 100644
--- a/files/en-us/web/javascript/reference/statements/with/index.html
+++ b/files/en-us/web/javascript/reference/statements/with/index.html
@@ -40,11 +40,13 @@
Description
scope chain, then the name is bound to the property and the object containing the
property. Otherwise a {{jsxref("ReferenceError")}} is thrown.
-
Using
with is not recommended, and is forbidden in
+
+
Note: Using with is not recommended, and is forbidden in
ECMAScript 5 strict
mode. The recommended alternative is to assign the object whose properties you
- want to access to a temporary variable.
+ want to access to a temporary variable.
+
diff --git a/files/en-us/web/javascript/reference/strict_mode/index.html b/files/en-us/web/javascript/reference/strict_mode/index.html
index f3fdacc88626546..8ad440fcc6a92d1 100644
--- a/files/en-us/web/javascript/reference/strict_mode/index.html
+++ b/files/en-us/web/javascript/reference/strict_mode/index.html
@@ -12,8 +12,7 @@
Strict Mode Overview
-
Note
-
Sometimes you'll see the default, non-strict mode referred to as "Note: Sometimes you'll see the default, non-strict mode referred to as "
sloppy mode". This isn't an official term, but be
aware of it, just in case.
From 15645fc38b0b4da2aa799ef951d07ecf2b40f2ed Mon Sep 17 00:00:00 2001
From: Will <>
Date: Mon, 26 Apr 2021 19:24:21 -0700
Subject: [PATCH 2/5] Update some more Note: magic words
---
.../guide/expressions_and_operators/index.html | 2 +-
files/en-us/web/javascript/guide/modules/index.html | 12 ++++++------
.../global_objects/bigint/bigint/index.html | 2 +-
.../global_objects/date/tolocalestring/index.html | 2 +-
.../intl/datetimeformat/format/index.html | 2 +-
.../global_objects/json/stringify/index.html | 12 ++++++------
.../reference/global_objects/math/floor/index.html | 2 +-
.../object/propertyisenumerable/index.html | 2 +-
.../reference/global_objects/promise/index.html | 4 ++--
.../reference/global_objects/set/values/index.html | 2 +-
.../reference/global_objects/string/split/index.html | 2 +-
.../global_objects/typedarray/values/index.html | 1 +
.../global_objects/webassembly/compile/index.html | 2 +-
.../webassembly/global/global/index.html | 2 +-
.../global_objects/webassembly/global/index.html | 2 +-
.../webassembly/instance/exports/index.html | 2 +-
.../webassembly/instantiate/index.html | 2 +-
.../webassembly/instantiatestreaming/index.html | 2 +-
.../webassembly/memory/memory/index.html | 2 +-
.../global_objects/webassembly/table/index.html | 2 +-
.../javascript/reference/lexical_grammar/index.html | 2 +-
.../web/javascript/reference/operators/index.html | 2 +-
.../javascript/reference/operators/void/index.html | 2 +-
23 files changed, 34 insertions(+), 33 deletions(-)
diff --git a/files/en-us/web/javascript/guide/expressions_and_operators/index.html b/files/en-us/web/javascript/guide/expressions_and_operators/index.html
index 145d64589af016a..81a0950539887f9 100644
--- a/files/en-us/web/javascript/guide/expressions_and_operators/index.html
+++ b/files/en-us/web/javascript/guide/expressions_and_operators/index.html
@@ -349,7 +349,7 @@
Comparison operators