ultimate-express 1.2.16 → 1.2.17

package/README.md

@@ -1,315 +1,315 @@
-# µExpress / Ultimate Express
-
-The *Ultimate* Express. Fastest http server with **full** Express compatibility, based on µWebSockets.
-
-This library is a very fast re-implementation of Express.js 4.
-It is designed to be a drop-in replacement for Express.js, with the same API and functionality, while being much faster. It is not a fork of Express.js.  
-To make sure µExpress matches behavior of Express in all cases, we run all tests with Express first, and then with µExpress and compare results to make sure they match.  
-
-`npm install ultimate-express` -> replace `express` with `ultimate-express` -> done[*](https://github.com/dimdenGD/ultimate-express?tab=readme-ov-file#differences-from-express)  
-
-[![Node.js >= 16.0.0](https://img.shields.io/badge/Node.js-%3E=16.0.0-green)](https://nodejs.org)
-[![npm](https://img.shields.io/npm/v/ultimate-express?label=last+version)](https://npmjs.com/package/ultimate-express)
-[![Patreon](https://img.shields.io/badge/donate-Patreon-orange)](https://patreon.com/dimdendev)
-
-## Difference from similar projects
-
-Similar projects based on uWebSockets:
-
-- `express` on Bun - since Bun uses uWS for its HTTP module, Express is about 2-3 times faster than on Node.js, but still slower than µExpress because it doesn't do uWS-specific optimizations.
-- `hyper-express` - while having a similar API to Express, it's very far from being a drop-in replacement, and implements most of the functionality differently. This creates a lot of random quirks and issues, making the switch quite difficult. Built in middlewares are also very different, middlewares for Express are mostly not supported.
-- `uwebsockets-express` - this library is closer to being a drop-in replacement, but misses a lot of APIs, depends on Express by calling it's methods under the hood and doesn't try to optimize routing by using native uWS router.
-
-## Performance
-
-### Test results
-
-Tested using [wrk](https://github.com/wg/wrk) (`-d 60 -t 1 -c 200`). Etag was disabled in both Express and µExpress. Tested on Ubuntu 22.04, Node.js 20.17.0, AMD Ryzen 5 3600, 64GB RAM.
-
-| Test                                          | Express req/sec | µExpress req/sec | Express throughput | µExpress throughput | µExpress speedup |
-| --------------------------------------------- | --------------- | ---------------- | ------------------ | ------------------- | ---------------- |
-| routing/simple-routes (/)                     | 11.16k          | 70.75k           | 2.08 MB/sec        | 13.62 MB/sec        | **6.34X**        |
-| routing/lot-of-routes (/999)                  | 4.63k           | 51.37k           | 0.84 MB/sec        | 9.45 MB/sec         | **11.10X**       |
-| routing/some-middlewares (/90)                | 10.12k          | 61.92k           | 1.79 MB/sec        | 11.32 MB/sec        | **6.12X**        |
-| routers/nested-routers (/abccc/nested/ddd)    | 10.18k          | 51.15k           | 1.82 MB/sec        | 9.40 MB/sec         | **5.02X**        |
-| middlewares/express-static (/static/index.js) | 6.58k           | 32.45k           | 10.15 MB/sec       | 49.43 MB/sec        | **4.87X**        |
-| engines/ejs (/test)                           | 5.50k           | 40.82k           | 2.45 MB/sec        | 18.38 MB/sec        | **7.42X**        |
-| middlewares/body-urlencoded (/abc)            | 8.07k           | 50.52k           | 1.68 MB/sec        | 10.78 MB/sec        | **6.26X**        |
-
-### Performance against other frameworks
-
-Tested using [bun-http-framework-benchmark](https://github.com/dimdenGD/bun-http-framework-benchmark). This table only includes Node.js results.
-For full table with other runtimes, check [here](https://github.com/dimdenGD/bun-http-framework-benchmark?tab=readme-ov-file#results).
-
-|  Framework           | Average        | Ping          | Query         | Body          |
-| -------------------- | -------------- | ------------- | ------------- | ------------- |
-| uws                  | 94,296.49      | 108,551.92    | 104,756.22    | 69,581.33     |
-| hyper-express        | 66,356.707     | 80,002.53     | 69,953.76     | 49,113.83     |
-| **ultimate-express** | **57,343.813** | **64,608.03** | **60,234.78** | **47,188.63** |
-| h3                   | 35,423.263     | 41,243.68     | 34,429.26     | 30,596.85     |
-| fastify              | 33,094.62      | 40,147.67     | 40,076.35     | 19,059.84     |
-| hono                 | 26,576.02      | 36,215.35     | 34,656.12     | 8,856.59      |
-| koa                  | 24,045.08      | 28,202.12     | 24,590.84     | 19,342.28     |
-| express              | 10,411.313     | 11,245.57     | 10,598.74     | 9,389.63      |
-
-### Performance on real-world application
-
-Also tested on a [real-world application](https://nekoweb.org) with templates, static files and dynamic pages with data from database, and showed 1.5-4X speedup in requests per second depending on the page.
-
-## Differences from Express
-
-In a lot of cases, you can just replace `require("express")` with `require("ultimate-express")` and everything works the same. But there are some differences:
-
-- `case sensitive routing` is enabled by default.
-- request body is only read for POST, PUT and PATCH requests by default. You can add additional methods by setting `body methods` to array with uppercased methods.
-- For HTTPS, instead of doing this:  
-```js
-const https = require("https");
-const express = require("express");
-
-const app = express();
-
-https.createServer({
-    key: fs.readFileSync('path/to/key.pem'),
-    cert: fs.readFileSync('path/to/cert.pem')
-}, app).listen(3000, () => {
-    console.log('Server is running on port 3000');
-});
-```
-
-You have to pass `uwsOptions` to the `express()` constructor:
-```js
-const express = require("u-express");
-
-const app = express({
-    uwsOptions: {
-        // https://unetworking.github.io/uWebSockets.js/generated/interfaces/AppOptions.html
-        key_file_name: 'path/to/key.pem',
-        cert_file_name: 'path/to/cert.pem'
-    }
-});
-
-app.listen(3000, () => {
-    console.log('Server is running on port 3000');
-});
-```
-
-- This also applies to non-SSL HTTP too. Do not create http server manually, use `app.listen()` instead.
-
-## Performance tips
-
-1. µExpress tries to optimize routing as much as possible, but it's only possible if:
-- `case sensitive routing` is enabled (it is by default, unlike in normal Express).
-- only string paths without regex characters like *, +, (), {}, etc. can be optimized.
-- only 1-level deep routers can be optimized.  
-  
-Optimized routes can be up to 10 times faster than normal routes, as they're using native uWS router and have pre-calculated path.
-
-2. Do not use external `serve-static` module. Instead use built-in `express.static()` middleware, which is optimized for uExpress.
-
-3. Do not use `body-parser` module. Instead use built-in `express.text()`, `express.json()` etc.
-
-4. Do not set `body methods` to read body of requests with GET method or other methods that don't need a body. Reading body makes endpoint about 15% slower.
-
-5. By default, µExpress creates 1 (or 0 if your CPU has only 1 core) child thread to improve performance of reading files. You can change this number by setting `threads` to a different number in `express()`, or set to 0 to disable thread pool (`express({ threads: 0 })`). Threads are shared between all express() instances, with largest `threads` number being used. Using more threads will not necessarily improve performance. Sometimes not using threads at all is faster, please [test](https://github.com/wg/wrk/) both options.
-
-6. Don't read `req.connection.remoteAddress` (or `req.ip` if `trust proxy` is disabled) after response is finished. In general, reading IP in uWS is quite slow (~15% slower), and you should only read it when you need it while request is still open. If you'll read it after response, it'll make µExpress read IP for every single request after, even when it's not needed.
-
-## WebSockets
-
-Since you don't create http server manually, you can't properly use http.on("upgrade") to handle WebSockets. To solve this, there's currently 2 options:
-
-- There's currently another library in works: [Ultimate WS](https://github.com/dimdenGD/ultimate-ws) that implements `ws` module. It's same concept as this library, but for WebSockets: fast drop-in replacement for `ws` module with support for uExpress upgrades.
-- You can simply use `app.uwsApp` to access uWebSockets.js `App` instance and call its `ws()` method directly.
-
-## Compatibility
-
-In general, basically all features and options are supported. Use [Express 4.x documentation](https://expressjs.com/en/4x/api.html) for API reference.
-
-✅ - Full support (all features and options are supported)  
-🚧 - Partial support (some options are not supported)  
-❌ - Not supported  
-
-### express
-
-- ✅ express()
-- ✅ express.Router()
-- ✅ express.json()
-- ✅ express.urlencoded()
-- ✅ express.static()
-- ✅ express.text()
-- ✅ express.raw()
-- 🚧 express.request (this is not a constructor but a prototype for replacing methods)
-- 🚧 express.response (this is not a constructor but a prototype for replacing methods)
-
-### Application
-
-- ✅ app.listen()
-- ✅ app.METHOD() (app.get, app.post, etc.)
-- ✅ app.route()
-- ✅ app.all()
-- ✅ app.use()
-- ✅ app.mountpath
-- ✅ app.set()
-- ✅ app.get()
-- ✅ app.enable()
-- ✅ app.disable()
-- ✅ app.enabled()
-- ✅ app.disabled()
-- ✅ app.path()
-- ✅ app.param(name, callback)
-- ✅ app.param(callback)
-- ✅ app.engine()
-- ✅ app.render()
-- ✅ app.locals
-- ✅ app.settings
-- ✅ app.engines
-- ✅ app.on("mount")
-- ✅ HEAD method
-
-### Application settings
-
-- ✅ case sensitive routing
-- ✅ env
-- ✅ etag
-- ✅ jsonp callback name
-- ✅ json escape
-- ✅ json replacer
-- ✅ json spaces
-- ✅ query parser
-- ✅ strict routing
-- ✅ subdomain offset
-- ✅ trust proxy
-- ✅ views
-- ✅ view cache
-- ✅ view engine
-- ✅ x-powered-by
-
-### Request
-- ✅ implements Readable stream
-- ✅ req.app
-- ✅ req.baseUrl
-- ✅ req.body
-- ✅ req.cookies
-- ✅ req.fresh
-- ✅ req.hostname
-- ✅ req.headers
-- ✅ req.headersDistinct
-- ✅ req.rawHeaders
-- ✅ req.ip
-- ✅ req.ips
-- ✅ req.method
-- ✅ req.url
-- ✅ req.originalUrl
-- ✅ req.params
-- ✅ req.path
-- ✅ req.protocol
-- ✅ req.query
-- ✅ req.res
-- ✅ req.secure
-- ✅ req.signedCookies
-- ✅ req.stale
-- ✅ req.subdomains
-- ✅ req.xhr
-- 🚧 req.route (route implementation is different from Express)
-- 🚧 req.connection, req.socket (only `encrypted`, `remoteAddress`, `localPort` and `remotePort` are supported)
-- ✅ req.accepts()
-- ✅ req.acceptsCharsets()
-- ✅ req.acceptsEncodings()
-- ✅ req.acceptsLanguages()
-- ✅ req.get()
-- ✅ req.is()
-- ✅ req.param()
-- ✅ req.range()
-
-### Response
-
-- ✅ implements Writable stream
-- ✅ res.app
-- ✅ res.headersSent
-- ✅ res.req
-- ✅ res.locals
-- ✅ res.append()
-- ✅ res.attachment()
-- ✅ res.cookie()
-- ✅ res.clearCookie()
-- ✅ res.download()
-- ✅ res.end()
-- ✅ res.format()
-- ✅ res.getHeader(), res.get()
-- ✅ res.json()
-- ✅ res.jsonp()
-- ✅ res.links()
-- ✅ res.location()
-- ✅ res.redirect()
-- ✅ res.render()
-- ✅ res.send()
-- ✅ res.sendFile()
-- - ✅ options.maxAge
-- - ✅ options.root
-- - ✅ options.lastModified
-- - ✅ options.headers
-- - ✅ options.dotfiles
-- - ✅ options.acceptRanges
-- - ✅ options.cacheControl
-- - ✅ options.immutable
-- - ✅ Range header
-- - ✅ Setting ETag header
-- - ✅ If-Match header
-- - ✅ If-Modified-Since header
-- - ✅ If-Unmodified-Since header
-- - ✅ If-Range header
-- ✅ res.sendStatus()
-- ✅ res.header(), res.setHeader(), res.set()
-- ✅ res.status()
-- ✅ res.type()
-- ✅ res.vary()
-- ✅ res.removeHeader()
-- ✅ res.write()
-- ✅ res.writeHead()
-
-### Router
-
-- ✅ router.all()
-- ✅ router.METHOD() (router.get, router.post, etc.)
-- ✅ router.route()
-- ✅ router.use()
-- ✅ router.param(name, callback)
-- ✅ router.param(callback)
-- ✅ options.caseSensitive
-- ✅ options.strict
-- ✅ options.mergeParams
-
-## Tested middlewares
-
-Most of the middlewares that are compatible with Express are compatible with µExpress. Here's list of middlewares that we test for compatibility:
-
-- ✅ [body-parser](https://npmjs.com/package/body-parser) (use `express.text()` etc instead for better performance)
-- ✅ [cookie-parser](https://npmjs.com/package/cookie-parser)
-- ✅ [cookie-session](https://npmjs.com/package/cookie-session)
-- ✅ [serve-static](https://npmjs.com/package/serve-static) (use `express.static()` instead for better performance)
-- ✅ [serve-index](https://npmjs.com/package/serve-index)
-- ✅ [cors](https://npmjs.com/package/cors)
-- ✅ [errorhandler](https://npmjs.com/package/errorhandler)
-- ✅ [method-override](https://npmjs.com/package/method-override)
-- ✅ [multer](https://npmjs.com/package/multer)
-- ✅ [response-time](https://npmjs.com/package/response-time)
-- ✅ [express-fileupload](https://npmjs.com/package/express-fileupload)
-- ✅ [express-session](https://npmjs.com/package/express-session)
-- ✅ [express-rate-limit](https://npmjs.com/package/express-rate-limit)
-- ✅ [vhost](https://npmjs.com/package/vhost)
-
-Middlewares that are confirmed to not work:
-
-- ❌ [compression](https://npmjs.com/package/compression) (doesn't error, but doesn't compress)
-
-## Tested view engines
-
-Any Express view engine should work. Here's list of engines we include in our test suite:
-
-- ✅ [ejs](https://npmjs.com/package/ejs)
-- ✅ [pug](https://npmjs.com/package/pug)
-- ✅ [express-dot-engine](https://npmjs.com/package/express-dot-engine)
-- ✅ [express-art-template](https://npmjs.com/package/express-art-template)
-- ✅ [express-handlebars](https://npmjs.com/package/express-handlebars)
+# µExpress / Ultimate Express
+
+The *Ultimate* Express. Fastest http server with **full** Express compatibility, based on µWebSockets.
+
+This library is a very fast re-implementation of Express.js 4.
+It is designed to be a drop-in replacement for Express.js, with the same API and functionality, while being much faster. It is not a fork of Express.js.  
+To make sure µExpress matches behavior of Express in all cases, we run all tests with Express first, and then with µExpress and compare results to make sure they match.  
+
+`npm install ultimate-express` -> replace `express` with `ultimate-express` -> done[*](https://github.com/dimdenGD/ultimate-express?tab=readme-ov-file#differences-from-express)  
+
+[![Node.js >= 16.0.0](https://img.shields.io/badge/Node.js-%3E=16.0.0-green)](https://nodejs.org)
+[![npm](https://img.shields.io/npm/v/ultimate-express?label=last+version)](https://npmjs.com/package/ultimate-express)
+[![Patreon](https://img.shields.io/badge/donate-Patreon-orange)](https://patreon.com/dimdendev)
+
+## Difference from similar projects
+
+Similar projects based on uWebSockets:
+
+- `express` on Bun - since Bun uses uWS for its HTTP module, Express is about 2-3 times faster than on Node.js, but still slower than µExpress because it doesn't do uWS-specific optimizations.
+- `hyper-express` - while having a similar API to Express, it's very far from being a drop-in replacement, and implements most of the functionality differently. This creates a lot of random quirks and issues, making the switch quite difficult. Built in middlewares are also very different, middlewares for Express are mostly not supported.
+- `uwebsockets-express` - this library is closer to being a drop-in replacement, but misses a lot of APIs, depends on Express by calling it's methods under the hood and doesn't try to optimize routing by using native uWS router.
+
+## Performance
+
+### Test results
+
+Tested using [wrk](https://github.com/wg/wrk) (`-d 60 -t 1 -c 200`). Etag was disabled in both Express and µExpress. Tested on Ubuntu 22.04, Node.js 20.17.0, AMD Ryzen 5 3600, 64GB RAM.
+
+| Test                                          | Express req/sec | µExpress req/sec | Express throughput | µExpress throughput | µExpress speedup |
+| --------------------------------------------- | --------------- | ---------------- | ------------------ | ------------------- | ---------------- |
+| routing/simple-routes (/)                     | 11.16k          | 75.14k           | 2.08 MB/sec        | 14.46 MB/sec        | **6.73X**        |
+| routing/lot-of-routes (/999)                  | 4.63k           | 54.57k           | 0.84 MB/sec        | 10.03 MB/sec        | **11.78X**       |
+| routing/some-middlewares (/90)                | 10.12k          | 61.92k           | 1.79 MB/sec        | 11.32 MB/sec        | **6.12X**        |
+| routers/nested-routers (/abccc/nested/ddd)    | 10.18k          | 51.15k           | 1.82 MB/sec        | 9.40 MB/sec         | **5.02X**        |
+| middlewares/express-static (/static/index.js) | 6.58k           | 32.45k           | 10.15 MB/sec       | 49.43 MB/sec        | **4.87X**        |
+| engines/ejs (/test)                           | 5.50k           | 40.82k           | 2.45 MB/sec        | 18.38 MB/sec        | **7.42X**        |
+| middlewares/body-urlencoded (/abc)            | 8.07k           | 50.52k           | 1.68 MB/sec        | 10.78 MB/sec        | **6.26X**        |
+
+### Performance against other frameworks
+
+Tested using [bun-http-framework-benchmark](https://github.com/dimdenGD/bun-http-framework-benchmark). This table only includes Node.js results.
+For full table with other runtimes, check [here](https://github.com/dimdenGD/bun-http-framework-benchmark?tab=readme-ov-file#results).
+
+|  Framework           | Average        | Ping          | Query         | Body          |
+| -------------------- | -------------- | ------------- | ------------- | ------------- |
+| uws                  | 94,296.49      | 108,551.92    | 104,756.22    | 69,581.33     |
+| hyper-express        | 66,356.707     | 80,002.53     | 69,953.76     | 49,113.83     |
+| **ultimate-express** | **57,343.813** | **64,608.03** | **60,234.78** | **47,188.63** |
+| h3                   | 35,423.263     | 41,243.68     | 34,429.26     | 30,596.85     |
+| fastify              | 33,094.62      | 40,147.67     | 40,076.35     | 19,059.84     |
+| hono                 | 26,576.02      | 36,215.35     | 34,656.12     | 8,856.59      |
+| koa                  | 24,045.08      | 28,202.12     | 24,590.84     | 19,342.28     |
+| express              | 10,411.313     | 11,245.57     | 10,598.74     | 9,389.63      |
+
+### Performance on real-world application
+
+Also tested on a [real-world application](https://nekoweb.org) with templates, static files and dynamic pages with data from database, and showed 1.5-4X speedup in requests per second depending on the page.
+
+## Differences from Express
+
+In a lot of cases, you can just replace `require("express")` with `require("ultimate-express")` and everything works the same. But there are some differences:
+
+- `case sensitive routing` is enabled by default.
+- request body is only read for POST, PUT and PATCH requests by default. You can add additional methods by setting `body methods` to array with uppercased methods.
+- For HTTPS, instead of doing this:  
+```js
+const https = require("https");
+const express = require("express");
+
+const app = express();
+
+https.createServer({
+    key: fs.readFileSync('path/to/key.pem'),
+    cert: fs.readFileSync('path/to/cert.pem')
+}, app).listen(3000, () => {
+    console.log('Server is running on port 3000');
+});
+```
+
+You have to pass `uwsOptions` to the `express()` constructor:
+```js
+const express = require("u-express");
+
+const app = express({
+    uwsOptions: {
+        // https://unetworking.github.io/uWebSockets.js/generated/interfaces/AppOptions.html
+        key_file_name: 'path/to/key.pem',
+        cert_file_name: 'path/to/cert.pem'
+    }
+});
+
+app.listen(3000, () => {
+    console.log('Server is running on port 3000');
+});
+```
+
+- This also applies to non-SSL HTTP too. Do not create http server manually, use `app.listen()` instead.
+
+## Performance tips
+
+1. µExpress tries to optimize routing as much as possible, but it's only possible if:
+- `case sensitive routing` is enabled (it is by default, unlike in normal Express).
+- only string paths without regex characters like *, +, (), {}, etc. can be optimized.
+- only 1-level deep routers can be optimized.  
+  
+Optimized routes can be up to 10 times faster than normal routes, as they're using native uWS router and have pre-calculated path.
+
+2. Do not use external `serve-static` module. Instead use built-in `express.static()` middleware, which is optimized for uExpress.
+
+3. Do not use `body-parser` module. Instead use built-in `express.text()`, `express.json()` etc.
+
+4. Do not set `body methods` to read body of requests with GET method or other methods that don't need a body. Reading body makes endpoint about 15% slower.
+
+5. By default, µExpress creates 1 (or 0 if your CPU has only 1 core) child thread to improve performance of reading files. You can change this number by setting `threads` to a different number in `express()`, or set to 0 to disable thread pool (`express({ threads: 0 })`). Threads are shared between all express() instances, with largest `threads` number being used. Using more threads will not necessarily improve performance. Sometimes not using threads at all is faster, please [test](https://github.com/wg/wrk/) both options.
+
+6. Don't read `req.connection.remoteAddress` (or `req.ip` if `trust proxy` is disabled) after response is finished. In general, reading IP in uWS is quite slow (~15% slower), and you should only read it when you need it while request is still open. If you'll read it after response, it'll make µExpress read IP for every single request after, even when it's not needed.
+
+## WebSockets
+
+Since you don't create http server manually, you can't properly use http.on("upgrade") to handle WebSockets. To solve this, there's currently 2 options:
+
+- There's currently another library in works: [Ultimate WS](https://github.com/dimdenGD/ultimate-ws) that implements `ws` module. It's same concept as this library, but for WebSockets: fast drop-in replacement for `ws` module with support for uExpress upgrades.
+- You can simply use `app.uwsApp` to access uWebSockets.js `App` instance and call its `ws()` method directly.
+
+## Compatibility
+
+In general, basically all features and options are supported. Use [Express 4.x documentation](https://expressjs.com/en/4x/api.html) for API reference.
+
+✅ - Full support (all features and options are supported)  
+🚧 - Partial support (some options are not supported)  
+❌ - Not supported  
+
+### express
+
+- ✅ express()
+- ✅ express.Router()
+- ✅ express.json()
+- ✅ express.urlencoded()
+- ✅ express.static()
+- ✅ express.text()
+- ✅ express.raw()
+- 🚧 express.request (this is not a constructor but a prototype for replacing methods)
+- 🚧 express.response (this is not a constructor but a prototype for replacing methods)
+
+### Application
+
+- ✅ app.listen()
+- ✅ app.METHOD() (app.get, app.post, etc.)
+- ✅ app.route()
+- ✅ app.all()
+- ✅ app.use()
+- ✅ app.mountpath
+- ✅ app.set()
+- ✅ app.get()
+- ✅ app.enable()
+- ✅ app.disable()
+- ✅ app.enabled()
+- ✅ app.disabled()
+- ✅ app.path()
+- ✅ app.param(name, callback)
+- ✅ app.param(callback)
+- ✅ app.engine()
+- ✅ app.render()
+- ✅ app.locals
+- ✅ app.settings
+- ✅ app.engines
+- ✅ app.on("mount")
+- ✅ HEAD method
+
+### Application settings
+
+- ✅ case sensitive routing
+- ✅ env
+- ✅ etag
+- ✅ jsonp callback name
+- ✅ json escape
+- ✅ json replacer
+- ✅ json spaces
+- ✅ query parser
+- ✅ strict routing
+- ✅ subdomain offset
+- ✅ trust proxy
+- ✅ views
+- ✅ view cache
+- ✅ view engine
+- ✅ x-powered-by
+
+### Request
+- ✅ implements Readable stream
+- ✅ req.app
+- ✅ req.baseUrl
+- ✅ req.body
+- ✅ req.cookies
+- ✅ req.fresh
+- ✅ req.hostname
+- ✅ req.headers
+- ✅ req.headersDistinct
+- ✅ req.rawHeaders
+- ✅ req.ip
+- ✅ req.ips
+- ✅ req.method
+- ✅ req.url
+- ✅ req.originalUrl
+- ✅ req.params
+- ✅ req.path
+- ✅ req.protocol
+- ✅ req.query
+- ✅ req.res
+- ✅ req.secure
+- ✅ req.signedCookies
+- ✅ req.stale
+- ✅ req.subdomains
+- ✅ req.xhr
+- 🚧 req.route (route implementation is different from Express)
+- 🚧 req.connection, req.socket (only `encrypted`, `remoteAddress`, `localPort` and `remotePort` are supported)
+- ✅ req.accepts()
+- ✅ req.acceptsCharsets()
+- ✅ req.acceptsEncodings()
+- ✅ req.acceptsLanguages()
+- ✅ req.get()
+- ✅ req.is()
+- ✅ req.param()
+- ✅ req.range()
+
+### Response
+
+- ✅ implements Writable stream
+- ✅ res.app
+- ✅ res.headersSent
+- ✅ res.req
+- ✅ res.locals
+- ✅ res.append()
+- ✅ res.attachment()
+- ✅ res.cookie()
+- ✅ res.clearCookie()
+- ✅ res.download()
+- ✅ res.end()
+- ✅ res.format()
+- ✅ res.getHeader(), res.get()
+- ✅ res.json()
+- ✅ res.jsonp()
+- ✅ res.links()
+- ✅ res.location()
+- ✅ res.redirect()
+- ✅ res.render()
+- ✅ res.send()
+- ✅ res.sendFile()
+- - ✅ options.maxAge
+- - ✅ options.root
+- - ✅ options.lastModified
+- - ✅ options.headers
+- - ✅ options.dotfiles
+- - ✅ options.acceptRanges
+- - ✅ options.cacheControl
+- - ✅ options.immutable
+- - ✅ Range header
+- - ✅ Setting ETag header
+- - ✅ If-Match header
+- - ✅ If-Modified-Since header
+- - ✅ If-Unmodified-Since header
+- - ✅ If-Range header
+- ✅ res.sendStatus()
+- ✅ res.header(), res.setHeader(), res.set()
+- ✅ res.status()
+- ✅ res.type()
+- ✅ res.vary()
+- ✅ res.removeHeader()
+- ✅ res.write()
+- ✅ res.writeHead()
+
+### Router
+
+- ✅ router.all()
+- ✅ router.METHOD() (router.get, router.post, etc.)
+- ✅ router.route()
+- ✅ router.use()
+- ✅ router.param(name, callback)
+- ✅ router.param(callback)
+- ✅ options.caseSensitive
+- ✅ options.strict
+- ✅ options.mergeParams
+
+## Tested middlewares
+
+Almost all middlewares that are compatible with Express are compatible with µExpress. Here's list of middlewares that we test for compatibility:
+
+- ✅ [body-parser](https://npmjs.com/package/body-parser) (use `express.text()` etc instead for better performance)
+- ✅ [cookie-parser](https://npmjs.com/package/cookie-parser)
+- ✅ [cookie-session](https://npmjs.com/package/cookie-session)
+- ✅ [serve-static](https://npmjs.com/package/serve-static) (use `express.static()` instead for better performance)
+- ✅ [serve-index](https://npmjs.com/package/serve-index)
+- ✅ [cors](https://npmjs.com/package/cors)
+- ✅ [errorhandler](https://npmjs.com/package/errorhandler)
+- ✅ [method-override](https://npmjs.com/package/method-override)
+- ✅ [multer](https://npmjs.com/package/multer)
+- ✅ [response-time](https://npmjs.com/package/response-time)
+- ✅ [express-fileupload](https://npmjs.com/package/express-fileupload)
+- ✅ [express-session](https://npmjs.com/package/express-session)
+- ✅ [express-rate-limit](https://npmjs.com/package/express-rate-limit)
+- ✅ [vhost](https://npmjs.com/package/vhost)
+
+Middlewares that are confirmed to not work:
+
+- ❌ [compression](https://npmjs.com/package/compression) (doesn't error, but doesn't compress)
+
+## Tested view engines
+
+Any Express view engine should work. Here's list of engines we include in our test suite:
+
+- ✅ [ejs](https://npmjs.com/package/ejs)
+- ✅ [pug](https://npmjs.com/package/pug)
+- ✅ [express-dot-engine](https://npmjs.com/package/express-dot-engine)
+- ✅ [express-art-template](https://npmjs.com/package/express-art-template)
+- ✅ [express-handlebars](https://npmjs.com/package/express-handlebars)
 - ✅ [swig](https://npmjs.com/package/swig)