如何阅读React.Children.map api符号？

Question

看着code for React.Children.map，该函数最多需要3个参数。

React.Children.map的api文档显示

React.Children.map(children, function[(thisArg)])

如果可能需要3个参数，我希望在那里能看到2个逗号。

我的问题是

您如何用普通英语阅读React.Children.map(children, function[(thisArg)])？

到目前为止，我有“ React.Children.map是一个...的功能”

Answer 1

function[(thisArg)]不是标准符号。正如the documentation所述，map

  

对此设置为thisArg的子代中包含的每个直接子代调用一个函数。

Children.map签名类似于JavaScript Array.prototype.map。有3个参数，第3个参数是可选的this上下文，用于回调函数（如果需要）。

Children.map在source code中有更好的记录：

/**
 * Maps children that are typically specified as `props.children`.
 *
 * See https://reactjs.org/docs/react-api.html#reactchildrenmap
 *
 * The provided mapFunction(child, key, index) will be called for each
 * leaf child.
 *
 * @param {?*} children Children tree container.
 * @param {function(*, int)} func The map function.
 * @param {*} context Context for mapFunction.
 * @return {object} Object containing the ordered map of results.
 */
function mapChildren(children, func, context) {...}