Removed methods and properties:
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 by req.acceptsCharsets()
.
req.acceptsEncoding()
is replaced by req.acceptsEncodings()
.
req.acceptsLanguage()
is replaced by req.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 inreq.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.