javascript - 我想问一个逗比问题...如何看懂js-api文档中提供的函数的所需参数？

Question

LocalSearch(location:Map|Point|String[, opts:LocalSearchOptions])

上面这句，应该是接受两个参数吧？一个是location，一个是opts？第一个可以接收3种类型，第二个是一个数组？

我的问题是，为什么中括号把逗号也括起来了？中括号在这里是干嘛的？第二个参数到底是什么类型的？

还是说，这里其实是一个参数？那中括号里的是什么意思？

ps.例子摘自百度地图极速版api

Answer 1

中括弧括起来表示可选参数：

LocalSearch(location:Map|Point|String[, opts:LocalSearchOptions])

LocalSearch 方法支持参数 location 和 opts， opts非必须。
location参数可以是表示Map、Point或者String类型， opts 参考 LocalSearchOptions 格式。

至于 LocalSearchOptions 是一个神马样子的，得去文档中继续寻找。

Answer 2

我不是很确定，可是确实很像是BNF 巴克斯范式的写法...我都是这么看的..