JavaScriptのシグネチャの読み方

前置き

axiosというHTTPクライアントのREADMEを読んでいると、以下のようなシグネチャがでてきた。

どう読むんだろう、、��

axios#post(url[, data[, config]])

axiosのGitHub
https://github.com/axios/axios

断っておくとこの書き方はaxiosだけに出てくるものではなく、

MDNのようなサイトでもこのような記法が随所にでてくる。

MDNのforEach()
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach

というわけで調べた。

結論、[]の部分は任意ということになる。

axiosの例であれば、以下のような書き方は問題ない。

axios#post(url) 
 
axios#post(url, data) 
 
axios#post(url, data, config)

反対に以下のようなdataを飛ばして、その先のconfigを指定するといった書き方はできない。

axios#post(url, config)