Как понять документацию Expressjs для функции app.listen

Question

Я читаю API Expressjs и сталкиваюсь с синтаксисом этой функции:

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

Честно говоря, я интерпретировал приведенный выше синтаксис как app.listen(port, host, backlog, callback) и поскольку все 4 аргумента являются необязательными, поэтому он будет переписан как app.listen([port[, host[, backlog[, callback]]]])

Я не знаю, правильно ли я понимаю или нет, можете ли вы пролить свет на этот вопрос?

Я обнаружил, что этот стиль документации очень уродлив, труден для чтения и иногда неправильно понимает.

Answer 1

Во-первых, если вы считаете, что можете улучшить документацию, вы можете предложить исправления и улучшения в виде запросов на извлечение на github repo ExpressJS.com .

Во-вторых, все 4 переменные являются необязательными.за исключением того, что вы можете указать backlog, только если вы указали host (см., что 2 окружены дополнительной парой []?).Точно так же вы можете указать host и backlog, только если вы указали port.Это просто очень функциональный способ показать зависимости между параметрами.