如何了解App.listen函数的Expressjs文档

时间:2018-12-01 23:53:49

标签: javascript node.js documentation

我正在阅读expressjs API并遇到以下函数语法:

app.listen([port[, host[, backlog]]][, callback])

老实说,我将上述语法解释为app.listen(port, host, backlog, callback),并且由于所有4个参数都是可选的,因此将其重写为app.listen([port[, host[, backlog[, callback]]]])

我不知道我所理解的是正确的还是不正确的,你能给我一些启示吗?

我发现这种文档风格非常丑陋,难以阅读,有时会引起误解。

1 个答案:

答案 0 :(得分:1)

首先,如果您认为可以改进文档,则可以对ExpressJS.com github repo提出合并请求,并提出更正和改进建议。

第二,所有4个变量都是可选的,除了只有提供backlog的情况下才可以提供host(请注意,两个变量之间被额外一对{{1 }}?)。同样,如果您提供了[],则只能提供hostbacklog。 这只是显示参数之间依赖性的一种非常实用的方法。