From 8ccfa93045a6c119303566370999f59a0aae3b25 Mon Sep 17 00:00:00 2001 From: Irvin Date: Wed, 16 Feb 2022 02:13:18 +0800 Subject: adjust dl/dt/dd tags for zh-CN --- .../web/javascript/reference/functions/index.html | 18 ------------------ .../javascript/reference/functions/set/index.html | 3 --- .../global_objects/array/copywithin/index.html | 9 +++------ .../global_objects/array/filter/index.html | 19 +++++++++---------- .../global_objects/array/flatmap/index.html | 1 - .../global_objects/array/foreach/index.html | 19 +++++++++---------- .../global_objects/array/lastindexof/index.html | 9 ++++----- .../global_objects/array/reduce/index.html | 8 ++------ .../reference/global_objects/array/slice/index.html | 14 ++------------ .../global_objects/array/splice/index.html | 5 +---- .../reference/global_objects/arraybuffer/index.html | 6 ------ .../global_objects/arraybuffer/slice/index.html | 3 --- .../global_objects/dataview/setbigint64/index.html | 1 - .../reference/global_objects/date/index.html | 5 +---- .../global_objects/date/setminutes/index.html | 6 ------ .../global_objects/date/setmonth/index.html | 3 --- .../reference/global_objects/error/index.html | 21 --------------------- .../reference/global_objects/evalerror/index.html | 6 ------ .../reference/global_objects/int32array/index.html | 3 --- .../global_objects/intl/datetimeformat/index.html | 5 +---- .../global_objects/intl/numberformat/index.html | 13 ++++++------- .../global_objects/number/toexponential/index.html | 3 --- .../global_objects/number/tofixed/index.html | 3 --- .../object/defineproperties/index.html | 9 +-------- .../global_objects/object/getprototypeof/index.html | 3 +-- .../reference/global_objects/parseint/index.html | 3 --- .../global_objects/promise/catch/index.html | 12 ++++-------- .../reference/global_objects/promise/index.html | 15 --------------- .../reference/global_objects/regexp/index.html | 2 -- .../global_objects/regexp/regexp/index.html | 3 +-- .../reference/global_objects/set/foreach/index.html | 3 +-- .../reference/global_objects/set/set/index.html | 3 +-- .../sharedarraybuffer/slice/index.html | 9 ++------- .../global_objects/string/charat/index.html | 4 +--- .../reference/global_objects/string/index.html | 3 --- .../global_objects/string/indexof/index.html | 8 ++------ .../global_objects/string/localecompare/index.html | 18 ++++++------------ .../global_objects/string/replace/index.html | 9 --------- .../global_objects/string/search/index.html | 3 +-- .../global_objects/string/substr/index.html | 3 --- .../reference/global_objects/symbol/index.html | 9 +++------ .../global_objects/typedarray/set/index.html | 3 +-- .../global_objects/typedarray/slice/index.html | 9 ++------- .../reference/operators/delete/index.html | 3 --- .../javascript/reference/operators/in/index.html | 3 --- .../web/javascript/reference/operators/index.html | 6 ++---- .../reference/operators/instanceof/index.html | 3 --- .../javascript/reference/operators/new/index.html | 3 --- .../reference/statements/async_function/index.html | 6 ------ .../reference/statements/continue/index.html | 3 --- .../reference/statements/do...while/index.html | 3 --- .../reference/statements/for...in/index.html | 3 --- .../reference/statements/function/index.html | 6 ------ .../reference/statements/function_star_/index.html | 6 ------ .../reference/statements/if...else/index.html | 6 ------ .../web/javascript/reference/statements/index.html | 3 --- .../reference/statements/try...catch/index.html | 12 ------------ .../javascript/reference/statements/var/index.html | 3 --- .../reference/statements/while/index.html | 3 +-- 59 files changed, 68 insertions(+), 318 deletions(-) (limited to 'files/zh-cn/web/javascript/reference') diff --git a/files/zh-cn/web/javascript/reference/functions/index.html b/files/zh-cn/web/javascript/reference/functions/index.html index 7bf9d86f8e..876a0c42ee 100644 --- a/files/zh-cn/web/javascript/reference/functions/index.html +++ b/files/zh-cn/web/javascript/reference/functions/index.html @@ -73,14 +73,8 @@ translation_of: Web/JavaScript/Reference/Functions
name
函数名.
-
- -
param
传递给函数的参数的名称。
-
- -
statements
组成函数体的声明语句。
@@ -95,14 +89,8 @@ translation_of: Web/JavaScript/Reference/Functions
name
函数名,可以省略。当省略函数名的时候,该函数就成为了匿名函数。
-
- -
param
传递给函数的参数的名称。
-
- -
statements
组成函数体的声明语句。
@@ -187,9 +175,6 @@ translation_of: Web/JavaScript/Reference/Functions
arg1, arg2, ... argN
函数使用零个或多个名称作为正式的参数名称。每一个必须是一个符合有效的JavaScript标识符规则的字符串或用逗号分隔的字符串列表,例如“x”,“theValue”或“a,b”。
-
- -
functionBody
一个构成的函数定义的,包含JavaScript声明语句的字符串。
@@ -213,9 +198,6 @@ translation_of: Web/JavaScript/Reference/Functions
arg1, arg2, ... argN
函数使用零个或多个名称作为正式的参数名称。每一个必须是一个符合有效的JavaScript标识符规则的字符串或用逗号分隔的字符串列表,例如“x”,“theValue”或“a,b”。
-
- -
functionBody
一个构成的函数定义的,包含JavaScript声明语句的字符串。
diff --git a/files/zh-cn/web/javascript/reference/functions/set/index.html b/files/zh-cn/web/javascript/reference/functions/set/index.html index 76f67c2779..da011b8936 100644 --- a/files/zh-cn/web/javascript/reference/functions/set/index.html +++ b/files/zh-cn/web/javascript/reference/functions/set/index.html @@ -25,9 +25,6 @@ translation_of: Web/JavaScript/Reference/Functions/set
prop
要绑定到给定函数的属性名。
-
- -
val
用于保存尝试分配给prop的值的变量的一个别名。
表达式
diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/copywithin/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/copywithin/index.html index 63436145d7..85af69f912 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/copywithin/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/copywithin/index.html @@ -27,14 +27,11 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/copyWithin
target
-
0 为基底的索引,复制序列到该位置。如果是负数,target 将从末尾开始计算。
-
如果 target 大于等于 arr.length,将会不发生拷贝。如果 targetstart 之后,复制的序列将被修改以符合 arr.length
+
0 为基底的索引,复制序列到该位置。如果是负数,target 将从末尾开始计算。如果 target 大于等于 arr.length,将会不发生拷贝。如果 targetstart 之后,复制的序列将被修改以符合 arr.length
start
-
0 为基底的索引,开始复制元素的起始位置。如果是负数,start 将从末尾开始计算。
-
如果 start 被忽略,copyWithin 将会从0开始复制。
+
0 为基底的索引,开始复制元素的起始位置。如果是负数,start 将从末尾开始计算。如果 start 被忽略,copyWithin 将会从0开始复制。
end
-
0 为基底的索引,开始复制元素的结束位置。copyWithin 将会拷贝到该位置,但不包括 end 这个位置的元素。如果是负数, end 将从末尾开始计算。
-
如果 end 被忽略,copyWithin 方法将会一直复制至数组结尾(默认为 arr.length)。
+
0 为基底的索引,开始复制元素的结束位置。copyWithin 将会拷贝到该位置,但不包括 end 这个位置的元素。如果是负数, end 将从末尾开始计算。如果 end 被忽略,copyWithin 方法将会一直复制至数组结尾(默认为 arr.length)。

返回值

diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/filter/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/filter/index.html index acc86a9592..9d92a772c1 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/filter/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/filter/index.html @@ -26,16 +26,15 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/filter
callback
-
用来测试数组的每个元素的函数。返回 true 表示该元素通过测试,保留该元素,false 则不保留。它接受以下三个参数:
-
-
-
element
-
数组中当前正在处理的元素。
-
index{{optional_inline}}
-
正在处理的元素在数组中的索引。
-
array{{optional_inline}}
-
调用了 filter 的数组本身。
-
+
用来测试数组的每个元素的函数。返回 true 表示该元素通过测试,保留该元素,false 则不保留。它接受以下三个参数: +
+
element
+
数组中当前正在处理的元素。
+
index{{optional_inline}}
+
正在处理的元素在数组中的索引。
+
array{{optional_inline}}
+
调用了 filter 的数组本身。
+
thisArg{{optional_inline}}
执行 callback 时,用于 this 的值。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/flatmap/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/flatmap/index.html index d0c4cfc9b5..755ab88bad 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/flatmap/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/flatmap/index.html @@ -27,7 +27,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/flatMap
callback
可以生成一个新数组中的元素的函数,可以传入三个参数:
-
currentValue
当前正在数组中处理的元素
index{{optional_inline}}
diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/foreach/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/foreach/index.html index 020a7dc3cd..6f93bd4513 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/foreach/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/foreach/index.html @@ -26,16 +26,15 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/forEach
callback
-
为数组中每个元素执行的函数,该函数接收一至三个参数:
-
-
-
currentValue
-
数组中正在处理的当前元素。
-
index {{optional_inline}}
-
数组中正在处理的当前元素的索引。
-
array {{optional_inline}}
-
forEach() 方法正在操作的数组。
-
+
为数组中每个元素执行的函数,该函数接收一至三个参数: +
+
currentValue
+
数组中正在处理的当前元素。
+
index {{optional_inline}}
+
数组中正在处理的当前元素的索引。
+
array {{optional_inline}}
+
forEach() 方法正在操作的数组。
+
thisArg {{optional_inline}}
可选参数。当执行回调函数 callback 时,用作 this 的值。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/lastindexof/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/lastindexof/index.html index 8d3c63aab0..87021c1608 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/lastindexof/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/lastindexof/index.html @@ -22,13 +22,12 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/lastIndexOf
被查找的元素。
fromIndex {{optional_inline}}
从此位置开始逆向查找。默认为数组的长度减 1(arr.length - 1),即整个数组都被查找。如果该值大于或等于数组的长度,则整个数组会被查找。如果为负值,将其视为从数组末尾向前的偏移。即使该值为负,数组仍然会被从后向前查找。如果该值为负时,其绝对值大于数组长度,则方法返回 -1,即数组不会被查找。
-
-

返回值

- -

数组中该元素最后一次出现的索引,如未找到返回-1。

-
+

返回值

+ +

数组中该元素最后一次出现的索引,如未找到返回-1。

+

描述

lastIndexOf 使用严格相等(strict equality,即 ===)比较 searchElement 和数组中的元素。

diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/reduce/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/reduce/index.html index 11e8a7ac85..d52d65e268 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/reduce/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/reduce/index.html @@ -38,13 +38,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/Reduce
callback
-
执行数组中每个值 (如果没有提供 initialValue则第一个值除外)的函数,包含四个参数:
-
-
-
- accumulator - +
执行数组中每个值 (如果没有提供 initialValue则第一个值除外)的函数,包含四个参数:
+
accumulator

累计器累计回调的返回值; 它是上一次调用回调时返回的累积值,或initialValue(见于下方)。

diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/slice/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/slice/index.html index 74703cbe04..b20d27f664 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/slice/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/slice/index.html @@ -24,19 +24,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/slice
begin {{optional_inline}}
-
提取起始处的索引(从 0 开始),从该索引开始提取原数组元素。
-
如果该参数为负数,则表示从原数组中的倒数第几个元素开始提取,slice(-2) 表示提取原数组中的倒数第二个元素到最后一个元素(包含最后一个元素)。
-
如果省略 begin,则 slice 从索引 0 开始。
-
如果 begin 超出原数组的索引范围,则会返回空数组。
-
- -
+
提取起始处的索引(从 0 开始),从该索引开始提取原数组元素。如果该参数为负数,则表示从原数组中的倒数第几个元素开始提取,slice(-2) 表示提取原数组中的倒数第二个元素到最后一个元素(包含最后一个元素)。如果省略 begin,则 slice 从索引 0 开始。如果 begin 超出原数组的索引范围,则会返回空数组。
end {{optional_inline}}
-
提取终止处的索引(从 0 开始),在该索引处结束提取原数组元素。slice 会提取原数组中索引从 begin 到 end 的所有元素(包含 begin,但不包含 end)。
-
slice(1,4) 会提取原数组中从第二个元素开始一直到第四个元素的所有元素 (索引为 1, 2, 3的元素)。
-
如果该参数为负数, 则它表示在原数组中的倒数第几个元素结束抽取。 slice(-2,-1) 表示抽取了原数组中的倒数第二个元素到最后一个元素(不包含最后一个元素,也就是只有倒数第二个元素)。
-
如果 end 被省略,则 slice 会一直提取到原数组末尾。
-
如果 end 大于数组的长度,slice 也会一直提取到原数组末尾。
+
提取终止处的索引(从 0 开始),在该索引处结束提取原数组元素。slice 会提取原数组中索引从 begin 到 end 的所有元素(包含 begin,但不包含 end)。slice(1,4) 会提取原数组中从第二个元素开始一直到第四个元素的所有元素 (索引为 1, 2, 3的元素)。如果该参数为负数, 则它表示在原数组中的倒数第几个元素结束抽取。 slice(-2,-1) 表示抽取了原数组中的倒数第二个元素到最后一个元素(不包含最后一个元素,也就是只有倒数第二个元素)。如果 end 被省略,则 slice 会一直提取到原数组末尾。如果 end 大于数组的长度,slice 也会一直提取到原数组末尾。

返回值

diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/splice/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/splice/index.html index 6d660999b6..c29ef207fb 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/array/splice/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/array/splice/index.html @@ -27,10 +27,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice
start​
指定修改的开始位置(从0计数)。如果超出了数组的长度,则从数组末尾开始添加内容;如果是负值,则表示从数组末位开始的第几位(从-1计数,这意味着-n是倒数第n个元素并且等价于array.length-n);如果负数的绝对值大于数组的长度,则表示开始位置为第0位。
deleteCount {{optional_inline}}
-
整数,表示要移除的数组元素的个数。
-
如果 deleteCount 大于 start 之后的元素的总数,则从 start 后面的元素都将被删除(含第 start 位)。
-
如果 deleteCount 被省略了,或者它的值大于等于array.length - start(也就是说,如果它大于或者等于含start及之后的所有元素的数量),那么start及之后所有元素都会被删除。
-
如果 deleteCount 是 0 或者负数,则不移除元素。这种情况下,至少应添加一个新元素。
+
整数,表示要移除的数组元素的个数。如果 deleteCount 大于 start 之后的元素的总数,则从 start 后面的元素都将被删除(含第 start 位)。如果 deleteCount 被省略了,或者它的值大于等于array.length - start(也就是说,如果它大于或者等于start之后的所有元素的数量),那么start之后数组的所有元素都会被删除。如果 deleteCount 是 0 或者负数,则不移除元素。这种情况下,至少应添加一个新元素。
item1, item2, ... {{optional_inline}}
要添加进数组的元素,从start 位置开始。如果不指定,则 splice() 将只删除数组元素。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/index.html b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/index.html index f58f460328..1f5e0a12f1 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/index.html @@ -58,14 +58,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer
ArrayBuffer.length
ArrayBuffer 构造函数的 length 属性,其值为1。
-
- -
{{jsxref("ArrayBuffer.prototype.byteLength")}}
只读属性,表示 ArrayBuffer 的byte的大小,在ArrayBuffer构造完成时生成,不可改变。
-
- -
{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}
返回 ArrayBuffer 的构造函数。
{{jsxref("ArrayBuffer.prototype")}}
diff --git a/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/slice/index.html b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/slice/index.html index 2c03d1e13c..1530f9f5df 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/slice/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/slice/index.html @@ -20,9 +20,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/slice
begin
从零开始的字节索引,切片从这开始。
-
- -
end
结束切片的字节索引。如果没指定end,新的 ArrayBuffer 将包含这个 ArrayBuffer 从头到尾的所有字节。由begin和end指定的这个范围夹在当前数组的有效索引范围内。如果新ArrayBuffer的长度在计算后为负,它将强制为0 。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/dataview/setbigint64/index.html b/files/zh-cn/web/javascript/reference/global_objects/dataview/setbigint64/index.html index e97765e4be..fafcc0418f 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/dataview/setbigint64/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/dataview/setbigint64/index.html @@ -24,7 +24,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/DataView/setBigInt64
byteOffset
字节偏移量,为从视图的起始位置到数据存储位置的字节字节偏移量。
-
value
作为一个{{jsxref("BigInt")}}类型设置的数值。满足一个带符号的64位整数的最大可能数值是 2n ** (64n -1n) - 1n (9223372036854775807n)。当发生溢出时,将会变成负数(-9223372036854775808n)。
littleEndian
diff --git a/files/zh-cn/web/javascript/reference/global_objects/date/index.html b/files/zh-cn/web/javascript/reference/global_objects/date/index.html index f2b08d51d5..d7dd9f80b5 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/date/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/date/index.html @@ -41,10 +41,7 @@ new Date(year, monthIndex [, day [, hours<
value
一个 Unix 时间戳(Unix Time Stamp),它是一个整数值,表示自1970年1月1日00:00:00 UTC(the Unix epoch)以来的毫秒数,忽略了闰秒。请注意大多数 Unix 时间戳功能仅精确到最接近的秒。
-
-

时间戳字符串

-
-
dateString
+

时间戳字符串

dateString
表示日期的字符串值。该字符串应该能被 {{jsxref("Date.parse()")}} 正确方法识别(即符合 IETF-compliant RFC 2822 timestamps 或 version of ISO8601)。

注意: 由于浏览器之间的差异与不一致性,强烈不推荐使用Date构造函数来解析日期字符串 (或使用与其等价的Date.parse)。对 RFC 2822 格式的日期仅有约定俗成的支持。 对 ISO 8601 格式的支持中,仅有日期的串 (例如 "1970-01-01") 会被处理为 UTC 而不是本地时间,与其他格式的串的处理不同。

diff --git a/files/zh-cn/web/javascript/reference/global_objects/date/setminutes/index.html b/files/zh-cn/web/javascript/reference/global_objects/date/setminutes/index.html index cb791e5a9c..761c087c10 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/date/setminutes/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/date/setminutes/index.html @@ -24,14 +24,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMinutes
minutesValue
一个 0 到 59 的整数,表示分钟数。
-
- -
secondsValue
一个 0 到 59 的整数,表示秒数。如果指定了 secondsValue 参数,则必须同时指定 minutesValue 参数。
-
- -
msValue
一个 0 到 999 的数字,表示微秒数,如果指定了 msValue 参数,则必须同时指定 minutesValuesecondsValue 参数。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/date/setmonth/index.html b/files/zh-cn/web/javascript/reference/global_objects/date/setmonth/index.html index e7df1fc3d7..47db4665a8 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/date/setmonth/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/date/setmonth/index.html @@ -22,9 +22,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMonth
monthValue
介于 0 到 11 之间的整数(表示一月到十二月)。
-
- -
dayValue
从 1 到 31 之间的整数,表示月份中的第几天。0为上个月最后一天
返回值!
diff --git a/files/zh-cn/web/javascript/reference/global_objects/error/index.html b/files/zh-cn/web/javascript/reference/global_objects/error/index.html index 82acc4e18f..80da68f766 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/error/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/error/index.html @@ -20,14 +20,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Error
message
可选。人类可阅读的错误描述信息。
-
- -
fileName {{non-standard_inline}}
可选。被创建的Error对象的fileName属性值。默认是调用Error构造器代码所在的文件 的名字。
-
- -
lineNumber {{non-standard_inline}}
可选。被创建的Error对象的lineNumber属性值。默认是调用Error构造器代码所在的文件的行号。
@@ -56,29 +50,14 @@ const y = new Error('I was constructed via the "new" keyword!');
创建一个error实例,表示错误的原因:与 {{jsxref("Global_Objects/eval", "eval()")}} 有关。
{{jsxref("InternalError")}} {{non-standard_inline}}
创建一个代表Javascript引擎内部错误的异常抛出的实例。 如: "递归太多".
-
- -
{{jsxref("RangeError", "RangeError")}}
创建一个error实例,表示错误的原因:数值变量或参数超出其有效范围。
-
- -
{{jsxref("ReferenceError")}}
创建一个error实例,表示错误的原因:无效引用。
-
- -
{{jsxref("SyntaxError")}}
创建一个error实例,表示错误的原因:{{jsxref("Global_Objects/eval", "eval()")}}在解析代码的过程中发生的语法错误。
-
- -
{{jsxref("TypeError")}}
创建一个error实例,表示错误的原因:变量或参数不属于有效类型。
-
- -
{{jsxref("URIError")}}
创建一个error实例,表示错误的原因:给 {{jsxref("Global_Objects/encodeURI", "encodeURI()")}}或  {{jsxref("Global_Objects/decodeURI", "decodeURI()")}}传递的参数无效。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/evalerror/index.html b/files/zh-cn/web/javascript/reference/global_objects/evalerror/index.html index 490ed5e8b7..485edc82b0 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/evalerror/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/evalerror/index.html @@ -16,14 +16,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/EvalError
message
可选参数.人类可阅读的关于错误的描述.
-
- -
fileName(非标准)
可选参数.代码中导致异常的文件的文件名.
-
- -
lineNumber(非标准)
可选参数.代码中导致异常的代码的行号.
diff --git a/files/zh-cn/web/javascript/reference/global_objects/int32array/index.html b/files/zh-cn/web/javascript/reference/global_objects/int32array/index.html index 9c7e556a51..133969ba90 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/int32array/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/int32array/index.html @@ -53,9 +53,6 @@ new Int32Array(buffer [, byteOffset [, length]]);
返回从其{{jsxref("ArrayBuffer")}}开始的Int32Array长度的(以字节为单位)。在构造时被固定,因此只读。
{{jsxref("TypedArray.prototype.byteOffset", "Int32Array.prototype.byteOffset")}} {{readonlyInline}}
返回从其{{jsxref("ArrayBuffer")}}开始的偏移量(以字节为单位)。在构造时被固定,因此只读。
-
- -
{{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}} {{readonlyInline}}
     返回Int32ArrayInt32Array包含的元素个数。在构造时被固定,因此只读。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/intl/datetimeformat/index.html b/files/zh-cn/web/javascript/reference/global_objects/intl/datetimeformat/index.html index 874f0cdbf7..04d383b97d 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/intl/datetimeformat/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/intl/datetimeformat/index.html @@ -43,10 +43,7 @@ Intl.DateTimeFormat.call(this[, locales[, optionshour12
是否使用12小时时间制(而不是24小时的时间). 可能的值是true 或 false; 默认值是根据locale来自动决定的(译者注:中国地区的默认值为true).
formatMatcher
-
format的匹配算法.可能的值有"basic"和"best fit";默认值是"best fit".有关此属性使用的信息,参见以下段落。
-
-

日期时间插件被格式化输出时可以使用的属性集合描述。实现需要支持是以下子集中的其中一个(译者注:当weekday,year等这些属性一个也不使用的时候,在cmn-Hans-CN中相当于使用集合year, month, day, hour, minute, second并且它们的值都是numeric):

-
+
format的匹配算法.可能的值有"basic"和"best fit";默认值是"best fit".有关此属性使用的信息,参见以下段落。日期时间插件被格式化输出时可以使用的属性集合描述。实现需要支持是以下子集中的其中一个(译者注:当weekday,year等这些属性一个也不使用的时候,在cmn-Hans-CN中相当于使用集合year, month, day, hour, minute, second并且它们的值都是numeric):
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/intl/numberformat/index.html b/files/zh-cn/web/javascript/reference/global_objects/intl/numberformat/index.html index 0ab3691377..a4b2e509de 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/intl/numberformat/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/intl/numberformat/index.html @@ -51,13 +51,12 @@ Intl.NumberFormat.call(this[, locales[, options
    unit{{Experimental_inline}}
    unit 格式中使用的单位,可能的值为在 UTS #35, Part 2, Section 6 定义的核心单元标识符。已从完整列表中选择了一个单位子集以用于ECMAScript。可以将成对的简单单位与 “ -per-” 连接以组成一个复合单位。没有默认值;如果 style“unit”,必须提供unit 属性。
    unitDisplay{{Experimental_inline}}
    -
    unit 格式化中使用的单位格式化样式,默认值为“ short”。
    -
    -
      -
    • “long” (e.g., 16 litres)
    • -
    • “short“ (e.g., 16 l)
    • -
    • ”narrow“ (e.g., 16l)
    • -
    +
    unit 格式化中使用的单位格式化样式,默认值为“ short”。 +
      +
    • “long” (e.g., 16 litres)
    • +
    • “short“ (e.g., 16 l)
    • +
    • ”narrow“ (e.g., 16l)
    • +
    currency
    在货币格式化中使用的货币符号. 可能的值是ISO的货币代码 (the ISO 4217 currency codes,) 例如 "USD" 表示美元, "EUR" 表示欧元, 或者 "CNY"是人民币 — 更多请参考 Current currency & funds code list。没有默认值,如果 style“currency”,必须提 currency 属性.
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/number/toexponential/index.html b/files/zh-cn/web/javascript/reference/global_objects/number/toexponential/index.html index 1847290f1a..250b8ebc76 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/number/toexponential/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/number/toexponential/index.html @@ -33,9 +33,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Number/toExponential
    {{jsxref("Global_Objects/RangeError", "RangeError")}}
    如果 fractionDigits 太小或太大将会抛出该错误。介于 0 和 20(包括20)之间的值不会引起 RangeError 。 执行环境也可以支持更大或更小范围。
    -
    - -
    {{jsxref("Global_Objects/TypeError", "TypeError")}}
    如果该方法在一个非数值类型对象上调用。
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/number/tofixed/index.html b/files/zh-cn/web/javascript/reference/global_objects/number/tofixed/index.html index 95787ab74f..1203b0c4fc 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/number/tofixed/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/number/tofixed/index.html @@ -29,9 +29,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Number/toFixed
    {{jsxref("RangeError")}}
    如果 digits 参数太小或太大。0 到 20(包括)之间的值不会引起 {{jsxref("RangeError")}}。实现环境(implementations)也可以支持更大或更小的值。
    -
    - -
    {{jsxref("TypeError")}}
    如果该方法在一个非{{jsxref( "Number")}}类型的对象上调用。
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/object/defineproperties/index.html b/files/zh-cn/web/javascript/reference/global_objects/object/defineproperties/index.html index 81b3e2fe8b..b8927634b3 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/object/defineproperties/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/object/defineproperties/index.html @@ -22,8 +22,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Object/defineProperties
    obj
    在其上定义或修改属性的对象。
    props
    -
    要定义其可枚举属性或修改的属性描述符的对象。对象中存在的属性描述符主要有两种:数据描述符和访问器描述符(更多详情,请参阅{{jsxref("Object.defineProperty()")}})。描述符具有以下键:
    -
    +
    要定义其可枚举属性或修改的属性描述符的对象。对象中存在的属性描述符主要有两种:数据描述符和访问器描述符(更多详情,请参阅{{jsxref("Object.defineProperty()")}})。描述符具有以下键:
    configurable
    true 只有该属性描述符的类型可以被改变并且该属性可以从对应对象中删除。
    @@ -31,18 +30,12 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Object/defineProperties
    enumerable
    true 只有在枚举相应对象上的属性时该属性显现。
    默认为 false
    -
    - -
    value
    与属性关联的值。可以是任何有效的JavaScript值(数字,对象,函数等)。
    默认为 {{jsxref("undefined")}}.
    writable
    true只有与该属性相关联的值被{{jsxref("Operators/Assignment_Operators", "assignment operator", "", 1)}}改变时。
    默认为 false
    -
    - -
    get
    作为该属性的 getter 函数,如果没有 getter 则为{{jsxref("undefined")}}。函数返回值将被用作属性的值。
    默认为 {{jsxref("undefined")}}
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/object/getprototypeof/index.html b/files/zh-cn/web/javascript/reference/global_objects/object/getprototypeof/index.html index d644eb2f6c..ae9a9e5866 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/object/getprototypeof/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/object/getprototypeof/index.html @@ -19,9 +19,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Object/getPrototypeOf
    -

    参数

    +

    参数obj

    -
    obj
    要返回其原型的对象。

    返回值

    diff --git a/files/zh-cn/web/javascript/reference/global_objects/parseint/index.html b/files/zh-cn/web/javascript/reference/global_objects/parseint/index.html index 9a631e1e4f..6dd0b83e6b 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/parseint/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/parseint/index.html @@ -25,9 +25,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/parseInt
    string
    要被解析的值。如果参数不是一个字符串,则将其转换为字符串(使用  ToString 抽象操作)。字符串开头的空白符将会被忽略。
    -
    - -
    radix {{optional_inline}}
    236,表示字符串的基数。例如指定 16 表示被解析值是十六进制数。请注意,10不是默认值!
    文章后面的描述解释了当参数 radix 不传时该函数的具体行为。
    diff --git a/files/zh-cn/web/javascript/reference/global_objects/promise/catch/index.html b/files/zh-cn/web/javascript/reference/global_objects/promise/catch/index.html index 2beb165c9f..e48f5c2a61 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/promise/catch/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/promise/catch/index.html @@ -23,16 +23,12 @@ p.catch(function(reason) {
    onRejected
    -
    当Promise 被rejected时,被调用的一个{{jsxref("Function")}}。 该函数拥有一个参数:
    -
    reason    rejection 的原因。
    -
    -

     如果 onRejected 抛出一个错误或返回一个本身失败的 Promise ,  通过 catch() 返回的Promise 被rejected;否则,它将显示为成功(resolved)。 

    +
    当Promise 被rejected时,被调用的一个{{jsxref("Function")}}。 该函数拥有一个参数:reason    rejection 的原因。如果 onRejected 抛出一个错误或返回一个本身失败的 Promise ,  通过 catch() 返回的Promise 被rejected;否则,它将显示为成功(resolved)。
    +
    -

    返回值

    +

    返回值

    -

    一个{{jsxref("Promise")}}.

    -
    -
+

一个{{jsxref("Promise")}}.

描述

diff --git a/files/zh-cn/web/javascript/reference/global_objects/promise/index.html b/files/zh-cn/web/javascript/reference/global_objects/promise/index.html index a658fd4338..dd878cb92d 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/promise/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/promise/index.html @@ -113,30 +113,15 @@ console.log("immediate logging");
{{jsxref("Promise.all", "Promise.all(iterable)")}}
这个方法返回一个新的promise对象,该promise对象在iterable参数对象里所有的promise对象都成功的时候才会触发成功,一旦有任何一个iterable里面的promise对象失败则立即触发该promise对象的失败。这个新的promise对象在触发成功状态以后,会把一个包含iterable里所有promise返回值的数组作为成功回调的返回值,顺序跟iterable的顺序保持一致;如果这个新的promise对象触发了失败状态,它会把iterable里第一个触发失败的promise对象的错误信息作为它的失败错误信息。Promise.all方法常被用于处理多个promise对象的状态集合。(可以参考jQuery.when方法---译者注)
-
- -
{{jsxref("Promise.allSettled", "Promise.allSettled(iterable)")}}
等到所有promises都已敲定(settled)(每个promise都已兑现(fulfilled)或已拒绝(rejected))。
返回一个promise,该promise在所有promise完成后完成。并带有一个对象数组,每个对象对应每个promise的结果。
-
- -
{{jsxref("Promise.any", "Promise.any(iterable)")}}
接收一个Promise对象的集合,当其中的一个 promise 成功,就返回那个成功的promise的值。
-
- -
{{jsxref("Promise.race", "Promise.race(iterable)")}}
当iterable参数里的任意一个子promise被成功或失败后,父promise马上也会用子promise的成功返回值或失败详情作为参数调用父promise绑定的相应句柄,并返回该promise对象。
-
- -
{{jsxref("Promise.reject", "Promise.reject(reason)")}}
返回一个状态为失败的Promise对象,并将给定的失败信息传递给对应的处理方法
-
- -
{{jsxref("Promise.resolve", "Promise.resolve(value)")}}
返回一个状态由给定value决定的Promise对象。如果该值是thenable(即,带有then方法的对象),返回的Promise对象的最终状态由then方法执行决定;否则的话(该value为空,基本类型或者不带then方法的对象),返回的Promise对象状态为fulfilled,并且将该value传递给对应的then方法。通常而言,如果您不知道一个值是否是Promise对象,使用Promise.resolve(value) 来返回一个Promise对象,这样就能将该value以Promise对象形式使用。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/regexp/index.html b/files/zh-cn/web/javascript/reference/global_objects/regexp/index.html index 25f587ed4c..c697ad26c4 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/regexp/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/regexp/index.html @@ -78,8 +78,6 @@ var re = /\w+/;
. 是否要匹配新行(newlines)。
{{JSxRef("RegExp.prototype.global")}}
针对字符串中所有可能的匹配项测试正则表达式,还是仅针对第一个匹配项。
-
-
{{JSxRef("RegExp.prototype.ignoreCase")}}
匹配文本的时候是否忽略大小写。
{{JSxRef("RegExp.prototype.multiline")}}
diff --git a/files/zh-cn/web/javascript/reference/global_objects/regexp/regexp/index.html b/files/zh-cn/web/javascript/reference/global_objects/regexp/regexp/index.html index 008b4d7d76..85e5fccd83 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/regexp/regexp/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/regexp/regexp/index.html @@ -26,8 +26,7 @@ RegExp(pattern[, flags])
pattern
-
正则表达式的文本。
-
从ES5开始,这也可以是另一个RegExp对象或文字(仅用于两个RegExp构造函数符号)。模式可以包含特殊字符special characters来匹配比字面值字符串更广泛的值范围 。
+
正则表达式的文本。从ES5开始,这也可以是另一个RegExp对象或文字(仅用于两个RegExp构造函数符号)。模式可以包含特殊字符special characters来匹配比字面值字符串更广泛的值范围。
flags

如果指定, flags 是包含要添加的标志的字符串。

diff --git a/files/zh-cn/web/javascript/reference/global_objects/set/foreach/index.html b/files/zh-cn/web/javascript/reference/global_objects/set/foreach/index.html index 6f08ab121b..bfef87e0bd 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/set/foreach/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/set/foreach/index.html @@ -15,8 +15,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Set/forEach
callback
-
为集合中每个元素执行的回调函数,该函数接收三个参数:
-
+
为集合中每个元素执行的回调函数,该函数接收三个参数:
currentValuecurrentKey{{optional_inline}}
currentValue 是正在被操作的元素。并且由于集合没有索引,所以 currentKey 也表示这个正在被操作的元素。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/set/set/index.html b/files/zh-cn/web/javascript/reference/global_objects/set/set/index.html index 7a19f9526a..a8c2a723dd 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/set/set/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/set/set/index.html @@ -24,8 +24,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Set/Set
iterable {{optional_inline}}
-
如果传递一个可迭代对象,它的所有元素将不重复地被添加到新的 Set中。
-
如果不指定此参数或其值为null,则新的 Set为空。
+
如果传递一个可迭代对象,它的所有元素将不重复地被添加到新的 Set中。如果不指定此参数或其值为null,则新的 Set为空。

Return value

diff --git a/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html b/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html index a13b9885f3..59937c30c1 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html @@ -22,14 +22,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice
begin {{optional_inline}}
-
从零开始的索引,从该索引开始提取。
-
可以使用一个负索引,表示从序列末尾开始的偏移量。 slice(-2)提取序列中的最后两个元素。
-
If begin is undefined, slice begins from index 0.如果begin为undefined,slice则从索引为0处开始。
+
从零开始的索引,从该索引开始提取。可以使用一个负索引,表示从序列末尾开始的偏移量。 slice(-2)提取序列中的最后两个元素。If begin is undefined, slice begins from index 0.如果begin为undefined,slice则从索引为0处开始。
end {{optional_inline}}
-
从零开始的索引,在此索引之前终止提取。 slice 执行提取到索引为end的位置(不包含end)。
-
例如,slice(1,4)提取第二个元素到第四个元素(索引为1、2和3的元素)。
-
可以使用一个负索引,表示从序列末尾开始的偏移量。 slice(2,-1)提取序列中从第三个元素开始,到倒数第二个元素结束的全部元素。
-
如果省略end,则slice一直提取到序列的末尾(sab.byteLength)。
+
从零开始的索引,在此索引之前终止提取。 slice 执行提取到索引为end的位置(不包含end)。例如,slice(1,4)提取第二个元素到第四个元素(索引为1、2和3的元素)。可以使用一个负索引,表示从序列末尾开始的偏移量。 slice(2,-1)提取序列中从第三个元素开始,到倒数第二个元素结束的全部元素。如果省略end,则slice一直提取到序列的末尾(sab.byteLength)。

返回值

diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/charat/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/charat/index.html index ab72e58c81..0e024365f2 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/charat/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/charat/index.html @@ -19,9 +19,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/charAt
index
-
一个介于0 和字符串长度减1之间的整数。 (0~length-1)
-
如果没有提供索引,charAt() 将使用0。
-
 
+
一个介于0 和字符串长度减1之间的整数。 (0~length-1)如果没有提供索引,charAt() 将使用0。

描述

diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/index.html index 6b8d96b0ac..8a6daf8511 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/index.html @@ -217,9 +217,6 @@ console.log(eval(s2)); // returns the string "2 + 2"
{{jsxref("String.fromCharCode()")}}  
 通过一串 Unicode 创建字符串。
-
- -
{{jsxref("String.fromCodePoint()")}} {{experimental_inline}}
通过一串 码点 创建字符串。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/indexof/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/indexof/index.html index 40fceeeadd..b976a54b65 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/indexof/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/indexof/index.html @@ -28,13 +28,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/indexOf
searchValue
-
要被查找的字符串值。
-
如果没有提供确切地提供字符串,searchValue 会被强制设置为 "undefined", 然后在当前字符串中查找这个值。
-
举个例子:'undefined'.indexOf() 将会返回0,因为 undefined 在位置0处被找到,但是 'undefine'.indexOf() 将会返回 -1 ,因为字符串 'undefined' 未被找到。
+
要被查找的字符串值。如果没有提供确切地提供字符串,searchValue 会被强制设置为 "undefined", 然后在当前字符串中查找这个值。举个例子:'undefined'.indexOf() 将会返回0,因为 undefined 在位置0处被找到,但是 'undefine'.indexOf() 将会返回 -1 ,因为字符串 'undefined' 未被找到。
fromIndex {{optional_inline}}
-
数字表示开始查找的位置。可以是任意整数,默认值为 0
-
如果 fromIndex 的值小于 0,或者大于 str.length ,那么查找分别从 0 和str.length 开始。(译者注:  fromIndex 的值小于 0,等同于为空情况; fromIndex 的值大于或等于 str.length ,那么结果会直接返回 -1 。)
-
举个例子,'hello world'.indexOf('o', -5) 返回 4 ,因为它是从位置0处开始查找,然后 o 在位置4处被找到。另一方面,'hello world'.indexOf('o', 11) (或 fromIndex 填入任何大于11的值)将会返回 -1 ,因为开始查找的位置11处,已经是这个字符串的结尾了。
+
数字表示开始查找的位置。可以是任意整数,默认值为 0。如果 fromIndex 的值小于 0,或者大于 str.length ,那么查找分别从 0 和str.length 开始。(译者注:  fromIndex 的值小于 0,等同于为空情况; fromIndex 的值大于或等于 str.length ,那么结果会直接返回 -1 。)举个例子,'hello world'.indexOf('o', -5) 返回 4 ,因为它是从位置0处开始查找,然后 o 在位置4处被找到。另一方面,'hello world'.indexOf('o', 11) (或 fromIndex 填入任何大于11的值)将会返回 -1 ,因为开始查找的位置11处,已经是这个字符串的结尾了。

返回值

diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/localecompare/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/localecompare/index.html index bf0e8ad0fb..88644d61b8 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/localecompare/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/localecompare/index.html @@ -29,13 +29,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/localeCompare
compareString
用来比较的字符串
locales
-
可选。 用来表示一种或多种语言或区域的一个符合 BCP 47 标准的字符串或一个字符串数组。 locales参数的一般形式与解释, 详情请参考 Intl page。 下列的 Unicode 扩展关键词是允许的:
-
co
-
为了某些地域多样的排序规则。可能的值包括: "big5han""dict""direct""ducet""gb2312""phonebk""phonetic""pinyin""reformed""searchjl""stroke""trad""unihan"。 "standard" 和"search" 这两个值是被忽略的; 它们被 options 的属性 usage 代替(往下看)。
-
kn
-
指定数值排序是否应该被使用, 像是这样 "1" < "2" < "10"。 可能的值是 "true" 和 "false"。 这个选项能被通过options 属性设置或通过 Unicode 扩展。 假如两个都被设置了, 则 options 优先。("language-region-u-kn-true|false")
-
kf
-
指定是否优先对大写字母或小写字母排序。 可能的值有 "upper""lower", 或 "false" (use the locale's default)。这个选项能被通过options 属性设置或通过 Unicode 扩展。假如两个都被设置了, 则 options 优先。("language-region-u-kf-upper|lower|false")
+
可选。 用来表示一种或多种语言或区域的一个符合 BCP 47 标准的字符串或一个字符串数组。 locales参数的一般形式与解释, 详情请参考 Intl page。 下列的 Unicode 扩展关键词是允许的:co为了某些地域多样的排序规则。可能的值包括: "big5han""dict""direct""ducet""gb2312""phonebk""phonetic""pinyin""reformed""searchjl""stroke""trad""unihan"。 "standard" 和"search" 这两个值是被忽略的; 它们被 options 的属性 usage 代替(往下看)。kn指定数值排序是否应该被使用, 像是这样 "1" < "2" < "10"。 可能的值是 "true" 和 "false"。 这个选项能被通过options 属性设置或通过 Unicode 扩展。 假如两个都被设置了, 则 options 优先。("language-region-u-kn-true|false")kf指定是否优先对大写字母或小写字母排序。 可能的值有 "upper""lower", 或 "false" (use the locale's default)。这个选项能被通过options 属性设置或通过 Unicode 扩展。假如两个都被设置了, 则 options 优先。("language-region-u-kf-upper|lower|false")
options

可选。 支持下列的一些或全部属性的一个对象:

@@ -65,14 +59,14 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/localeCompare
caseFirst
指定大小写有限排序. 可能的值有 "upper""lower", or "false" (use the locale's default); 默认为 "false". 这个选项能被通过options 属性设置或通过 Unicode 扩展。假如两个都被设置了, 则 options 优先。 实现不用必须支持这个属性.
-
-
+
+ +

返回值

如果引用字符存在于比较字符之前则为负数; 如果引用字符存在于比较字符之后则为正数; 相等的时候返回 0 .

-
-
page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Collator', 'Parameters')}}
-
+ + {{page('/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Collator', 'Parameters')}}

描述

diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.html index 5e75b81d05..3bc425e928 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.html @@ -28,19 +28,10 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/replace
regexp (pattern)
一个{{jsxref("RegExp")}} 对象或者其字面量。该正则所匹配的内容会被第二个参数的返回值替换掉。
-
- -
substr (pattern)
一个将被 newSubStr 替换的 {{jsxref("String","字符串")}}。其被视为一整个字符串,而不是一个正则表达式。仅第一个匹配项会被替换。
-
- -
newSubStr (replacement)
用于替换掉第一个参数在原字符串中的匹配部分的{{jsxref("String", "字符串")}}。该字符串中可以内插一些特殊的变量名。参考下面的使用字符串作为参数
-
- -
function (replacement)
一个用来创建新子字符串的函数,该函数的返回值将替换掉第一个参数匹配到的结果。参考下面的指定一个函数作为参数
diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/search/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/search/index.html index 35a75549c2..a021bd662b 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/search/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/search/index.html @@ -26,8 +26,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/search
regexp
-
一个{{jsxref("RegExp", "正则表达式(regular expression)")}}对象
-
如果传入一个非正则表达式对象 regexp,则会使用 new RegExp(regexp) 隐式地将其转换为正则表达式对象。
+
一个{{jsxref("RegExp", "正则表达式(regular expression)")}}对象。如果传入一个非正则表达式对象 regexp,则会使用 new RegExp(regexp) 隐式地将其转换为正则表达式对象。

返回值

diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/substr/index.html b/files/zh-cn/web/javascript/reference/global_objects/string/substr/index.html index a21f6f1f87..5c94a75240 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/substr/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/string/substr/index.html @@ -20,9 +20,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/String/substr
start
开始提取字符的位置。如果为负值,则被看作 strLength + start,其中 strLength 为字符串的长度(例如,如果 start-3,则被看作 strLength + (-3))。
-
- -
length
可选。提取的字符数。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/symbol/index.html b/files/zh-cn/web/javascript/reference/global_objects/symbol/index.html index b44db6a349..a0165478d4 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/symbol/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/symbol/index.html @@ -77,16 +77,14 @@ typeof symObj; // "object"
-

迭代 symbols

+

迭代 symbols {{jsxref("Symbol.iterator")}}

-
{{jsxref("Symbol.iterator")}}
一个返回一个对象默认迭代器的方法。被 for...of 使用。
{{jsxref("Symbol.asyncIterator")}} {{experimental_inline}}
一个返回对象默认的异步迭代器的方法。被 for await of 使用。
-

正则表达式 symbols

+

正则表达式 symbols {{jsxref("Symbol.match")}}

-
{{jsxref("Symbol.match")}}
一个用于对字符串进行匹配的方法,也用于确定一个对象是否可以作为正则表达式使用。被 {{jsxref("String.prototype.match()")}} 使用。
{{jsxref("Symbol.replace")}}
一个替换匹配字符串的子串的方法. 被 {{jsxref("String.prototype.replace()")}} 使用。
@@ -95,9 +93,8 @@ typeof symObj; // "object"
{{jsxref("Symbol.split")}}
一个在匹配正则表达式的索引处拆分一个字符串的方法.。被 {{jsxref("String.prototype.split()")}} 使用。
-

其他 symbols

+

其他 symbols {{jsxref("Symbol.hasInstance")}}

-
{{jsxref("Symbol.hasInstance")}}
一个确定一个构造器对象识别的对象是否为它的实例的方法。被 {{jsxref("Operators/instanceof", "instanceof")}} 使用。
{{jsxref("Symbol.isConcatSpreadable")}}
一个布尔值,表明一个对象是否应该flattened为它的数组元素。被 {{jsxref("Array.prototype.concat()")}} 使用。
diff --git a/files/zh-cn/web/javascript/reference/global_objects/typedarray/set/index.html b/files/zh-cn/web/javascript/reference/global_objects/typedarray/set/index.html index 94827b7b23..bced96b90f 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/typedarray/set/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/typedarray/set/index.html @@ -16,8 +16,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/TypedArray/set
array
-
拷贝数据的源数组,源数组的所有值都会被复制到目标数组中,除非源数组的长度加上偏移量超过目标数组的长度,而在这种情况下会抛出异常。
-
参数array是源数组,指定从哪里拷贝值。源数组中的所有值都会被拷贝到目标数组中去。如果源数组的长度加上偏移值offset的结果超过目标数组的长度,则会抛出异常错误。
+
拷贝数据的源数组,源数组的所有值都会被复制到目标数组中,除非源数组的长度加上偏移量超过目标数组的长度,而在这种情况下会抛出异常。参数array是源数组,指定从哪里拷贝值。源数组中的所有值都会被拷贝到目标数组中去。如果源数组的长度加上偏移值offset的结果超过目标数组的长度,则会抛出异常错误。
typedarray
如果源数组是一个类型化数组(typed array),则源数组和目标数组可以共享同一个底层的{{jsxref("ArrayBuffer")}};JavaScript 引擎会智能地将 buffer 的指定区段拷贝到目标区段中去。
offset {{ optional_inline() }}
diff --git a/files/zh-cn/web/javascript/reference/global_objects/typedarray/slice/index.html b/files/zh-cn/web/javascript/reference/global_objects/typedarray/slice/index.html index 547cc36a8c..84f5d3ddd9 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/typedarray/slice/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/typedarray/slice/index.html @@ -19,14 +19,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/TypedArray/slice
begin {{optional_inline}}
-
从0开始的索引位置。
-
可以使用负值索引, 表示从数组末尾往前的偏移量。slice(-2) 表示提取数组中的末尾两个元素.
-
如果没有设定起始位置,则将从开始位置开始截取。
+
从0开始的索引位置。可以使用负值索引, 表示从数组末尾往前的偏移量。slice(-2) 表示提取数组中的末尾两个元素.如果没有设定起始位置,则将从开始位置开始截取。
end {{optional_inline}}
-
从0开始到尾元素前的索引值。 slice 取出的元素到此位置之前,不包含该位置。
-
例, slice(1,4) 表示读取第2个元素到第4个元素(元素索引:1, 2, 3)。
-
可以使用负值索引, 表示从数组末尾往前的偏移量。 slice(2,-1) 表示取出数组中的第3个到倒数第2个元素。
-
如果没有设定结束位置,则将从开始位置截取到序列尾部。(默认值为typedarray.length).
+
从0开始到尾元素前的索引值。 slice 取出的元素到此位置之前,不包含该位置。例, slice(1,4) 表示读取第2个元素到第4个元素(元素索引:1, 2, 3)。可以使用负值索引, 表示从数组末尾往前的偏移量。 slice(2,-1) 表示取出数组中的第3个到倒数第2个元素。如果没有设定结束位置,则将从开始位置截取到序列尾部。(默认值为typedarray.length).

返回值

diff --git a/files/zh-cn/web/javascript/reference/operators/delete/index.html b/files/zh-cn/web/javascript/reference/operators/delete/index.html index 1a088c94a3..f8b4e02e0c 100644 --- a/files/zh-cn/web/javascript/reference/operators/delete/index.html +++ b/files/zh-cn/web/javascript/reference/operators/delete/index.html @@ -34,9 +34,6 @@ delete object['property']
object
对象的名称,或计算结果为对象的表达式。
-
- -
property
要删除的属性。
diff --git a/files/zh-cn/web/javascript/reference/operators/in/index.html b/files/zh-cn/web/javascript/reference/operators/in/index.html index 8420c0d14b..a03e0b2c97 100644 --- a/files/zh-cn/web/javascript/reference/operators/in/index.html +++ b/files/zh-cn/web/javascript/reference/operators/in/index.html @@ -24,9 +24,6 @@ translation_of: Web/JavaScript/Reference/Operators/in
prop
一个字符串类型或者 symbol 类型的属性名或者数组索引(非symbol类型将会强制转为字符串)。
-
- -
objectName
检查它(或其原型链)是否包含具有指定名称的属性的对象。
diff --git a/files/zh-cn/web/javascript/reference/operators/index.html b/files/zh-cn/web/javascript/reference/operators/index.html index 5387a37f1a..810ccb74cd 100644 --- a/files/zh-cn/web/javascript/reference/operators/index.html +++ b/files/zh-cn/web/javascript/reference/operators/index.html @@ -241,14 +241,12 @@ translation_of: Web/JavaScript/Reference/Operators

解构赋值允许你分配数组或者对象变量的属性通过使用规定的语法,其看起来和数组和对象字面量很相似。

-

逗号操作符

+

逗号操作符 {{jsxref("Operators/Comma_Operator", ",")}}

-
{{jsxref("Operators/Comma_Operator", ",")}}
逗号操作符允许在一个判断状态中有多个表达式去进行运算并且最后返回最后一个表达式的值。
-

非标准化特性

+

非标准化特性 {{JSxRef("Operators/Expression_closures", "Expression closures", "", 1)}} {{non-standard_inline}}{{obsolete_inline(60)}}

-
{{JSxRef("Operators/Expression_closures", "Expression closures", "", 1)}} {{non-standard_inline}}{{obsolete_inline(60)}}
闭包表达式语法是一个缩写简单的函数。
{{JSxRef("Operators/Legacy_generator_function", "Legacy generator function", "", 1)}} {{non-standard_inline}}{{obsolete_inline(58)}}
function关键字能用来定义表达式内部未执行完的function的余下功能。 为了能执行function内部余下的代码, 这个function的内部至少包含一个{{jsxref("Operators/yield", "yield")}} 表达式。
diff --git a/files/zh-cn/web/javascript/reference/operators/instanceof/index.html b/files/zh-cn/web/javascript/reference/operators/instanceof/index.html index f8c5807b3c..f6f1f188f8 100644 --- a/files/zh-cn/web/javascript/reference/operators/instanceof/index.html +++ b/files/zh-cn/web/javascript/reference/operators/instanceof/index.html @@ -27,9 +27,6 @@ translation_of: Web/JavaScript/Reference/Operators/instanceof
object
某个实例对象
-
- -
constructor
某个构造函数
diff --git a/files/zh-cn/web/javascript/reference/operators/new/index.html b/files/zh-cn/web/javascript/reference/operators/new/index.html index e6833d4cc7..e44beb9763 100644 --- a/files/zh-cn/web/javascript/reference/operators/new/index.html +++ b/files/zh-cn/web/javascript/reference/operators/new/index.html @@ -26,9 +26,6 @@ translation_of: Web/JavaScript/Reference/Operators/new
constructor
一个指定对象实例的类型的类或函数。
-
- -
arguments
一个用于被 constructor 调用的参数列表。
diff --git a/files/zh-cn/web/javascript/reference/statements/async_function/index.html b/files/zh-cn/web/javascript/reference/statements/async_function/index.html index bca5f86818..ba79f6a5d2 100644 --- a/files/zh-cn/web/javascript/reference/statements/async_function/index.html +++ b/files/zh-cn/web/javascript/reference/statements/async_function/index.html @@ -31,14 +31,8 @@ translation_of: Web/JavaScript/Reference/Statements/async_function
name
函数名称。
-
- -
param
要传递给函数的参数的名称。
-
- -
statements
包含函数主体的表达式。可以使用await机制。
diff --git a/files/zh-cn/web/javascript/reference/statements/continue/index.html b/files/zh-cn/web/javascript/reference/statements/continue/index.html index 3d8d98de7d..9d8954fb84 100644 --- a/files/zh-cn/web/javascript/reference/statements/continue/index.html +++ b/files/zh-cn/web/javascript/reference/statements/continue/index.html @@ -15,9 +15,6 @@ translation_of: Web/JavaScript/Reference/Statements/continue
continue [ label ];
-
-
-
label
标识标号关联的语句
diff --git a/files/zh-cn/web/javascript/reference/statements/do...while/index.html b/files/zh-cn/web/javascript/reference/statements/do...while/index.html index 45eaec2221..9f013042b9 100644 --- a/files/zh-cn/web/javascript/reference/statements/do...while/index.html +++ b/files/zh-cn/web/javascript/reference/statements/do...while/index.html @@ -22,9 +22,6 @@ while (condition);
statement
执行至少一次的语句,并在每次 condition 值为真时重新执行。想执行多行语句,可使用{{jsxref("Statements/block", "block")}}语句({ ... })包裹这些语句。
-
- -
condition
循环中每次都会计算的表达式。如果 condition 值为真, statement 会再次执行。当 condition 值为假,则跳到do...while之后的语句。
diff --git a/files/zh-cn/web/javascript/reference/statements/for...in/index.html b/files/zh-cn/web/javascript/reference/statements/for...in/index.html index 2f9dba87ce..964a6d7a8d 100644 --- a/files/zh-cn/web/javascript/reference/statements/for...in/index.html +++ b/files/zh-cn/web/javascript/reference/statements/for...in/index.html @@ -18,9 +18,6 @@ translation_of: Web/JavaScript/Reference/Statements/for...in
variable
在每次迭代时,variable会被赋值为不同的属性名。
-
- -
object
非Symbol类型的可枚举属性被迭代的对象。
diff --git a/files/zh-cn/web/javascript/reference/statements/function/index.html b/files/zh-cn/web/javascript/reference/statements/function/index.html index e094148986..cb225706eb 100644 --- a/files/zh-cn/web/javascript/reference/statements/function/index.html +++ b/files/zh-cn/web/javascript/reference/statements/function/index.html @@ -27,14 +27,8 @@ translation_of: Web/JavaScript/Reference/Statements/function
name
函数名
-
- -
param
要传递给函数的参数的名称。不同引擎中的最大参数数量不同。
-
- -
statements
包含函数体的语句。
diff --git a/files/zh-cn/web/javascript/reference/statements/function_star_/index.html b/files/zh-cn/web/javascript/reference/statements/function_star_/index.html index 0ee47b290d..00e6c29196 100644 --- a/files/zh-cn/web/javascript/reference/statements/function_star_/index.html +++ b/files/zh-cn/web/javascript/reference/statements/function_star_/index.html @@ -31,14 +31,8 @@ translation_of: Web/JavaScript/Reference/Statements/function*
name
函数名
-
- -
param
要传递给函数的一个参数的名称,一个函数最多可以有255个参数。
-
- -
statements
普通JS语句。
diff --git a/files/zh-cn/web/javascript/reference/statements/if...else/index.html b/files/zh-cn/web/javascript/reference/statements/if...else/index.html index 3d5ebf6e8f..aca3f842f3 100644 --- a/files/zh-cn/web/javascript/reference/statements/if...else/index.html +++ b/files/zh-cn/web/javascript/reference/statements/if...else/index.html @@ -25,14 +25,8 @@ translation_of: Web/JavaScript/Reference/Statements/if...else
condition
值为真或假的表达式
-
- -
statement1
condition为真时执行的语句。可为任意语句,包括更深层的内部if语句。要执行多条语句,使用语句({ ... })将这些语句分组;若不想执行语句,则使用语句。 
-
- -
statement2
如果condition为假且 else从句存在时执行的语句。可为任意语句,包括块语句和嵌套的if语句。
diff --git a/files/zh-cn/web/javascript/reference/statements/index.html b/files/zh-cn/web/javascript/reference/statements/index.html index 570cb1adff..eadf850d86 100644 --- a/files/zh-cn/web/javascript/reference/statements/index.html +++ b/files/zh-cn/web/javascript/reference/statements/index.html @@ -93,9 +93,6 @@ translation_of: Web/JavaScript/Reference/Statements
向 JavaScript 模块公开上下文特定的元数据的元属性。
{{jsxref("Statements/label", "label")}}
带标识的语句,与 breakcontinue 语句一起使用。
-
- -
{{jsxref("Statements/with", "with")}} {{deprecated_inline}}
拓展一个语句的作用域。
diff --git a/files/zh-cn/web/javascript/reference/statements/try...catch/index.html b/files/zh-cn/web/javascript/reference/statements/try...catch/index.html index 587da47b18..6559e9cbb2 100644 --- a/files/zh-cn/web/javascript/reference/statements/try...catch/index.html +++ b/files/zh-cn/web/javascript/reference/statements/try...catch/index.html @@ -34,24 +34,12 @@ translation_of: Web/JavaScript/Reference/Statements/try...catch
try_statements
需要被执行的语句。
-
- -
catch_statements_1, catch_statements_2
如果在try块里有异常被抛出时执行的语句。
-
- -
exception_var_1, exception_var_2
用于保存关联catch子句的异常对象的标识符。
-
- -
condition_1
一个条件表达式。
-
- -
finally_statements
try语句块之后执行的语句块。无论是否有异常抛出或捕获这些语句都将执行。
diff --git a/files/zh-cn/web/javascript/reference/statements/var/index.html b/files/zh-cn/web/javascript/reference/statements/var/index.html index 95c4d22d88..ca6f3e3b45 100644 --- a/files/zh-cn/web/javascript/reference/statements/var/index.html +++ b/files/zh-cn/web/javascript/reference/statements/var/index.html @@ -22,9 +22,6 @@ translation_of: Web/JavaScript/Reference/Statements/var
varnameN
变量名。变量名可以定义为任何合法标识符。
-
- -
valueN
变量的初始化值。该值可以是任何合法的表达式。默认值为 undefined
diff --git a/files/zh-cn/web/javascript/reference/statements/while/index.html b/files/zh-cn/web/javascript/reference/statements/while/index.html index f5b6e3942e..f04c84750f 100644 --- a/files/zh-cn/web/javascript/reference/statements/while/index.html +++ b/files/zh-cn/web/javascript/reference/statements/while/index.html @@ -24,8 +24,7 @@ translation_of: Web/JavaScript/Reference/Statements/while
condition
条件表达式,在每次循环前被求值。如果求值为真,statement就会被执行。如果求值为假,则跳出while循环执行后面的语句。
statement
-
只要条件表达式求值为真,该语句就会一直被执行。要在循环中执行多条语句,可以使用块语句({ ... })包住多条语句。
-
注意:使用break语句在condition计算结果为真之前停止循环。
+
只要条件表达式求值为真,该语句就会一直被执行。要在循环中执行多条语句,可以使用块语句({ ... })包住多条语句。注意:使用break语句在condition计算结果为真之前停止循环。

示例

-- cgit v1.2.3-54-g00ecf