js 语法规则，比如str.substr(start[, length]) 是什么意思？

Question

js的api文档会讲api的语法，比如String.substr的语法是：
str.substr(start[, length])
大致能猜到是什么意思.两个参数start和length, length可不传。
但是为什么要用这种形式表示[, length]，遵循了什么规范？

更复杂的语法就有点不清楚了，比如
arr.push(element1[, ...[, elementN]])

接口文档
https://devdocs.io/javascript...
https://devdocs.io/javascript...

Answer 1

中括弧就是可选参数，前端的api文档都这么表示嘛。

arr.push(element1\[, ...[, elementN]])

这个就表示参数第一个之后的参数是非必传部分，并且这部分的参数个数是随意的。