Removed methods and properties:
app.del()
app.param(fn)
- Pluralized method names
- Leading : in name for app.param(name, fn)
req.param(name)
res.json(obj, status)
res.jsonp(obj, status)
res.send(body, status)
res.send(status)
res.sendfile()
Changed:
Improvements:
Removed methods and properties
If you use any of these methods or properties in your app, it will crash. So, you’ll need to go through and change your app once you update to version 5.
app.del()
Express 5 no longer supports
app.del()
. Using it will throw an error. For registering HTTP DELETE routes, use app.delete()
instead.
Initially del was used instead of delete considering delete is a reserved keyword in JavaScript. However, as of ECMAScript 6, delete and other reserved keywords can legally be used as a property names. You can read the discussion which lead to the deprecation of app.del here.
app.param(fn)
The
app.param(fn)
signature was used for modifying the behavior ofapp.param(name, fn)
. It has been deprecated since v4.11.0, and Express 5 no longer supports it at all.Pluralized method names
The following method names have been pluralized. In Express 4, using the old methods resulted in a deprecation warning. Express 5 no longer supports them at all:
req.acceptsCharset()
is replaced byreq.acceptsCharsets()
.req.acceptsEncoding()
is replaced byreq.acceptsEncodings()
.req.acceptsLanguage()
is replaced byreq.acceptsLanguages()
.
Leading colon (:) in name for app.param(name, fn)
A leading colon character (:) in name for
app.param(name, fn)
is remnant of Express 3, and for the sake of backwards compatibility, Express 4 supported it with a deprecation notice. Express 5 will silently ignore it; use the name parameter without prefixing it with a colon.
This should not affect your code, if you have been following the Express 4 documentation of
app.param
, as it makes no mention of the leading colon.
req.param(name)
This potentially confusing and dangerous method of retrieving form data has been removed. You will now need to specifically look for the submitted parameter name in
req.params
, req.body
, or req.query
.
res.json(obj, status)
Express 5 no longer supports the signature
res.json(obj, status)
. Instead, set the status and then chain it to the res.json()
method like this:res.status(status).json(obj)
.
res.jsonp(obj, status)
Express 5 no longer supports the signature
res.jsonp(obj, status)
. Instead, set the status and then chain it to the res.jsonp()
method like this:res.status(status).jsonp(obj)
.
res.send(body, status)
Express 5 no longer supports the signature
res.send(obj, status)
. Instead, set the status and then chain it to the res.send()
method like this:res.status(status).send(obj)
.
res.send(status)
Express 5 no longer supports the signature
res.send(status)
, where status is a number. Instead, use res.sendStatus(status)
, which sets the HTTP response header code and sends the text version of the code: “Not Found,” “Internal Server Error,” and so on.
If you need to send a number using
res.send()
, quote the number to convert it to a string, so that Express does not interpret it as an attempt at using the unsupported old signature.
res.sendfile()
res.sendfile()
has been replaced by a camel-cased version res.sendFile()
in Express 5.Changed
app.router
The
app.router
object, which was removed in Express 4, has made a comeback in Express 5. In the new version, it is a just a reference to the base Express router, unlike in Express 3, where an app had to explicitly load it.
req.host
In Express 4,
req.host
incorrectly stripped off the port number if it was present. In Express 5 the port number is maintained.
req.query
In Express 4.7 and Express 5 onwards, the query parser option can accept false to disable query string parsing, and instead use your own function for query string parsing logic.
Improvements
res.render()
This method now enforces asynchronous behavior for all view engines, avoiding bugs caused by view engines which had a synchronous implementation and violated the recommended interface.