From 978aab8dcddc381ee15bd499acd721ccc264c3f9 Mon Sep 17 00:00:00 2001 From: asos-craigmorten Date: Fri, 29 May 2020 22:00:35 +0100 Subject: [PATCH] feat: support passing no parameters to `app.listen()` --- .github/API/application.md | 4 +- .github/CHANGELOG.md | 4 + docs/classes/_response_.response.html | 54 +++---- docs/interfaces/_types_.application.html | 131 +++++++++-------- docs/interfaces/_types_.byterange.html | 4 +- docs/interfaces/_types_.handler.html | 2 +- docs/interfaces/_types_.iroute.html | 54 +++---- docs/interfaces/_types_.irouter.html | 74 +++++----- docs/interfaces/_types_.irouterhandler.html | 4 +- docs/interfaces/_types_.iroutermatcher.html | 6 +- docs/interfaces/_types_.mediatype.html | 8 +- docs/interfaces/_types_.nextfunction.html | 4 +- docs/interfaces/_types_.opine.html | 136 ++++++++++-------- docs/interfaces/_types_.request.html | 90 ++++++------ docs/interfaces/_types_.requesthandler.html | 2 +- docs/interfaces/_types_.response.html | 54 +++---- docs/interfaces/_types_.router.html | 76 +++++----- .../interfaces/_types_.routerconstructor.html | 78 +++++----- docs/interfaces/_types_.routeroptions.html | 6 +- docs/modules/_application_.html | 8 +- docs/modules/_methods_.html | 2 +- .../_middleware_bodyparser_getcharset_.html | 2 +- .../modules/_middleware_bodyparser_json_.html | 10 +- docs/modules/_middleware_bodyparser_raw_.html | 2 +- .../modules/_middleware_bodyparser_read_.html | 6 +- .../modules/_middleware_bodyparser_text_.html | 2 +- .../_middleware_bodyparser_typechecker_.html | 2 +- .../_middleware_bodyparser_urlencoded_.html | 2 +- docs/modules/_middleware_init_.html | 6 +- docs/modules/_middleware_query_.html | 2 +- docs/modules/_middleware_servestatic_.html | 10 +- docs/modules/_opine_.html | 4 +- docs/modules/_request_.html | 2 +- docs/modules/_router_index_.html | 22 +-- docs/modules/_router_layer_.html | 4 +- docs/modules/_router_route_.html | 2 +- docs/modules/_types_.html | 24 ++-- docs/modules/_utils_compileetag_.html | 8 +- docs/modules/_utils_contentdisposition_.html | 2 +- docs/modules/_utils_definegetter_.html | 2 +- docs/modules/_utils_etag_.html | 8 +- docs/modules/_utils_finalhandler_.html | 22 +-- docs/modules/_utils_fresh_.html | 8 +- docs/modules/_utils_merge_.html | 2 +- docs/modules/_utils_mergedescriptors_.html | 4 +- docs/modules/_utils_normalizetype_.html | 6 +- docs/modules/_utils_parseurl_.html | 8 +- docs/modules/_utils_pathtoregex_.html | 10 +- docs/modules/_utils_stringify_.html | 2 +- examples/README.md | 1 + examples/assigned-port/README.md | 19 +++ examples/assigned-port/index.ts | 27 ++++ src/application.ts | 6 +- src/types.ts | 1 + version.ts | 2 +- 55 files changed, 557 insertions(+), 484 deletions(-) create mode 100644 examples/assigned-port/README.md create mode 100644 examples/assigned-port/index.ts diff --git a/.github/API/application.md b/.github/API/application.md index 03074e02..0bb20c6f 100644 --- a/.github/API/application.md +++ b/.github/API/application.md @@ -452,9 +452,9 @@ app.listen = function (options) { }; ``` -#### app.listen(port, [callback]) +#### app.listen([port], [callback]) -Binds and listens for connections on the specified numerical port. This method is nearly identical to Deno's [http.listenAndServe()](https://doc.deno.land/https/deno.land/std/http/server.ts#listenAndServe). +Binds and listens for connections on the specified numerical port. If no port is provided, an available port is assigned for you. This method is similar to Deno's [http.listenAndServe()](https://doc.deno.land/https/deno.land/std/http/server.ts#listenAndServe). This method is supported for legacy reasons to aid in transitions from Express on Node. diff --git a/.github/CHANGELOG.md b/.github/CHANGELOG.md index 317f81fe..6ba8881c 100644 --- a/.github/CHANGELOG.md +++ b/.github/CHANGELOG.md @@ -1,5 +1,9 @@ # ChangeLog +## [0.7.0] - 29-05-2020 + +- feat: support passing no parameters to `app.listen()` and being automatically assigned a port. + ## [0.6.3] - 29-05-2020 - fix: set versions on all deps to prevent adopting breaking changes from `master`. diff --git a/docs/classes/_response_.response.html b/docs/classes/_response_.response.html index 1ed809c0..2b5ae139 100644 --- a/docs/classes/_response_.response.html +++ b/docs/classes/_response_.response.html @@ -140,7 +140,7 @@

app

app: Application
@@ -150,7 +150,7 @@

body

body: DenoResponseBody
@@ -160,7 +160,7 @@

headers

headers: Headers = new Headers()
@@ -170,7 +170,7 @@

locals

locals: any
@@ -180,7 +180,7 @@

req

req: Request
@@ -190,7 +190,7 @@

status

status: Status = 200
@@ -207,7 +207,7 @@

append

  • @@ -242,7 +242,7 @@

    attachment

  • @@ -271,7 +271,7 @@

    clearCookie

  • @@ -300,7 +300,7 @@

    cookie

  • @@ -332,7 +332,7 @@

    download

  • @@ -368,7 +368,7 @@

    end

  • @@ -396,7 +396,7 @@

    etag

  • @@ -425,7 +425,7 @@

    format

  • @@ -493,7 +493,7 @@

    get

  • @@ -522,7 +522,7 @@

    json

  • @@ -554,7 +554,7 @@

    jsonp

  • @@ -586,7 +586,7 @@

    links

  • @@ -620,7 +620,7 @@

    location

  • @@ -655,7 +655,7 @@

    send

  • @@ -687,7 +687,7 @@

    sendFile

  • @@ -716,7 +716,7 @@

    sendStatus

  • @@ -750,7 +750,7 @@

    set

  • @@ -785,7 +785,7 @@

    setStatus

  • @@ -816,7 +816,7 @@

    type

  • @@ -851,7 +851,7 @@

    unset

  • @@ -880,7 +880,7 @@

    vary

  • diff --git a/docs/interfaces/_types_.application.html b/docs/interfaces/_types_.application.html index c353eee8..756f57ae 100644 --- a/docs/interfaces/_types_.application.html +++ b/docs/interfaces/_types_.application.html @@ -97,7 +97,7 @@

    Callable

  • @@ -202,7 +202,7 @@

    _params

    @@ -212,7 +212,7 @@

    _router

    _router: Router
    @@ -228,7 +228,7 @@

    all

    @@ -244,7 +244,7 @@

    cache

    cache: any
    @@ -255,7 +255,7 @@

    caseSensitive

    @@ -266,7 +266,7 @@

    checkout

    @@ -277,7 +277,7 @@

    connect

    @@ -288,7 +288,7 @@

    copy

    @@ -299,7 +299,7 @@

    delete

    @@ -310,7 +310,7 @@

    get

    @@ -321,7 +321,7 @@

    head

    @@ -331,7 +331,7 @@

    locals

    locals: any
    @@ -342,7 +342,7 @@

    lock

    @@ -353,7 +353,7 @@

    m-search

    @@ -364,7 +364,7 @@

    merge

    @@ -375,7 +375,7 @@

    mergeParams

    @@ -386,7 +386,7 @@

    mkactivity

    @@ -397,7 +397,7 @@

    mkcol

    @@ -407,7 +407,7 @@

    mountpath

    mountpath: string | string[]
    @@ -423,7 +423,7 @@

    move

    @@ -434,7 +434,7 @@

    notify

    @@ -445,7 +445,7 @@

    options

    @@ -456,7 +456,7 @@

    params

    @@ -466,7 +466,7 @@

    parent

    parent: any
    @@ -477,7 +477,7 @@

    patch

    @@ -488,7 +488,7 @@

    post

    @@ -499,7 +499,7 @@

    propfind

    @@ -510,7 +510,7 @@

    proppatch

    @@ -521,7 +521,7 @@

    purge

    @@ -532,7 +532,7 @@

    put

    @@ -543,7 +543,7 @@

    report

    @@ -553,7 +553,7 @@

    router

    router: string
    @@ -563,7 +563,7 @@

    routes

    routes: any
    @@ -584,7 +584,7 @@

    search

    @@ -594,7 +594,7 @@

    settings

    settings: any
    @@ -605,7 +605,7 @@

    stack

    @@ -621,7 +621,7 @@

    strict

    @@ -632,7 +632,7 @@

    subscribe

    @@ -643,7 +643,7 @@

    trace

    @@ -654,7 +654,7 @@

    unlock

    @@ -665,7 +665,7 @@

    unsubscribe

    @@ -676,7 +676,7 @@

    use

    @@ -693,7 +693,7 @@

    defaultConfiguration

  • @@ -715,7 +715,7 @@

    disable

  • @@ -743,7 +743,7 @@

    disabled

  • @@ -776,7 +776,7 @@

    emit

  • @@ -810,7 +810,7 @@

    enable

  • @@ -838,7 +838,7 @@

    enabled

  • @@ -872,7 +872,7 @@

    Private handle

    @@ -908,7 +908,7 @@

    init

  • @@ -935,7 +935,7 @@

    lazyrouter

  • @@ -953,6 +953,7 @@

    Returns void

    listen

      +
    • listen(): Server
    • listen(port: number, callback?: Function): Server
    • listen(addr: string, callback?: Function): Server
    • listen(options: HTTPOptions, callback?: Function): Server
    • @@ -962,7 +963,7 @@

      listen

    • @@ -971,6 +972,14 @@

      listen

      A Deno Server is returned.

    +

    Returns Server

    +
  • +
  • +

    Parameters