Mention other sort methods in sort argument error (#34290)

mdn · Jun 21, 2024 · d311eae · d311eae
1 parent f07f4a0
commit d311eae
Showing 1 changed file with 14 additions and 2 deletions.
diff --git a/files/en-us/web/javascript/reference/errors/array_sort_argument/index.md b/files/en-us/web/javascript/reference/errors/array_sort_argument/index.md
@@ -6,14 +6,21 @@ page-type: javascript-error
 
 {{jsSidebar("Errors")}}
 
-The JavaScript exception "invalid Array.prototype.sort argument" occurs when the argument of {{jsxref("Array.prototype.sort()")}} isn't either {{jsxref("undefined")}} or a function which compares its operands.
+The JavaScript exception "invalid Array.prototype.sort argument" occurs when the argument of {{jsxref("Array.prototype.sort()")}} (and its related methods: {{jsxref("Array.prototype.toSorted()")}}, {{jsxref("TypedArray.prototype.sort()")}}, {{jsxref("TypedArray.prototype.toSorted()")}}) isn't either {{jsxref("undefined")}} or a function which compares its operands.
 
 ## Message
 
 ```plain
 TypeError: The comparison function must be either a function or undefined (V8-based)
+
 TypeError: invalid Array.prototype.sort argument (Firefox)
+TypeError: non-function passed to Array.prototype.toSorted (Firefox)
+TypeError: invalid %TypedArray%.prototype.sort argument (Firefox)
+
 TypeError: Array.prototype.sort requires the comparator argument to be a function or undefined (Safari)
+TypeError: Array.prototype.toSorted requires the comparator argument to be a function or undefined (Safari)
+TypeError: TypedArray.prototype.sort requires the comparator argument to be a function or undefined (Safari)
+TypeError: TypedArray.prototype.toSorted requires the comparator argument to be a function or undefined (Safari)
 ```
 
 ## Error type
@@ -22,23 +29,28 @@ TypeError: Array.prototype.sort requires the comparator argument to be a functio
 
 ## What went wrong?
 
-The argument of {{jsxref("Array.prototype.sort()")}} is expected to be either {{jsxref("undefined")}} or a function which compares its operands.
+The argument of {{jsxref("Array.prototype.sort()")}} (and its related methods: {{jsxref("Array.prototype.toSorted()")}}, {{jsxref("TypedArray.prototype.sort()")}}, {{jsxref("TypedArray.prototype.toSorted()")}}) is expected to be either {{jsxref("undefined")}} or a function which compares its operands.
 
 ## Examples
 
 ### Invalid cases
 
 ```js example-bad
 [1, 3, 2].sort(5); // TypeError
+students.toSorted("name"); // TypeError
 ```
 
 ### Valid cases
 
 ```js example-good
 [1, 3, 2].sort(); // [1, 2, 3]
 [1, 3, 2].sort((a, b) => a - b); // [1, 2, 3]
+students.toSorted((a, b) => a.name.localeCompare(b.name));
 ```
 
 ## See also
 
 - {{jsxref("Array.prototype.sort()")}}
+- {{jsxref("Array.prototype.toSorted()")}}
+- {{jsxref("TypedArray.prototype.sort()")}}
+- {{jsxref("TypedArray.prototype.toSorted()")}}