我在哪里可以找到有关 JS 文档中语法的一些信息?
Where can I find some info about a syntax in JS docs?
像arr.fill(value[, start = 0[, end = this.length]])
这样的语法我在JS文档等里面遇到过很多次了,逼着自己去理解。我的意思是函数参数的拼写。
反正这不是什么大问题,但我想知道更多关于这个语法的信息。
arr.fill(value[, start = 0[, end = this.length]])
^---^
required argument
^--------------------------------^
optional arguments
此表示法指定参数的顺序、要求和默认值。没有括号意味着参数是必需的。括号表示参数是可选的。等号后面是可选参数的默认值。
鉴于该签名,您有以下选择:
arr.fill(value) // start = 0, end = this.length
arr.fill(value, start) // end = this.length
arr.fill(value, start, end)
这种文档风格是基于命令行工具和 man
页面中使用的风格,这似乎是基于 this standard (following the links from this question)。一段时间以来,该表示法一直是 API 和使用文档的标准。
方括号 ([,start = 0 ...]
) 表示语法的可选部分,尽管顺序很重要。在您的示例中,嵌套括号表明如果您要指定稍后的参数,则需要前面的部分。
对于 MDN 文档,这与 name = value
符号相结合以显示函数中引用了哪些参数。
像arr.fill(value[, start = 0[, end = this.length]])
这样的语法我在JS文档等里面遇到过很多次了,逼着自己去理解。我的意思是函数参数的拼写。
反正这不是什么大问题,但我想知道更多关于这个语法的信息。
arr.fill(value[, start = 0[, end = this.length]])
^---^
required argument
^--------------------------------^
optional arguments
此表示法指定参数的顺序、要求和默认值。没有括号意味着参数是必需的。括号表示参数是可选的。等号后面是可选参数的默认值。
鉴于该签名,您有以下选择:
arr.fill(value) // start = 0, end = this.length
arr.fill(value, start) // end = this.length
arr.fill(value, start, end)
这种文档风格是基于命令行工具和 man
页面中使用的风格,这似乎是基于 this standard (following the links from this question)。一段时间以来,该表示法一直是 API 和使用文档的标准。
方括号 ([,start = 0 ...]
) 表示语法的可选部分,尽管顺序很重要。在您的示例中,嵌套括号表明如果您要指定稍后的参数,则需要前面的部分。
对于 MDN 文档,这与 name = value
符号相结合以显示函数中引用了哪些参数。