如何理解函数的 Expressjs 文档 app.listen

How to understand the Expressjs documentation for function app.listen

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

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

老实说,我将上面的语法解释为 app.listen(port, host, backlog, callback),因为所有 4 个参数都是可选的,所以它会被重写为 app.listen([port[, host[, backlog[, callback]]]])

我不知道我的理解是否正确,你能解释一下这件事吗?

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

首先,如果您认为可以改进文档,可以在 ExpressJS.com github repo.

上以拉取请求的形式提出更正和改进建议

其次,所有 4 个变量都是可选的,但如果您提供了 host,则只能提供 backlog(请注意 2 被一对额外的 []?)。同样,如果您提供了 port,则只能提供 hostbacklog。 这只是显示参数之间依赖关系的一种非常实用的方式。