Add "root" option to res.download
[express.git] / History.md
blobd7a2e43c35062f4de692b59d8e11c35d8e2b34e6
1 unreleased
2 ==========
4   * Add "root" option to `res.download`
5   * Deprecate string and non-integer arguments to `res.status`
6   * Ignore `Object.prototype` values in settings through `app.set`/`app.get`
7   * Support proper 205 responses using `res.send`
9 4.17.3 / 2022-02-16
10 ===================
12   * deps: accepts@~1.3.8
13     - deps: mime-types@~2.1.34
14     - deps: negotiator@0.6.3
15   * deps: body-parser@1.19.2
16     - deps: bytes@3.1.2
17     - deps: qs@6.9.7
18     - deps: raw-body@2.4.3
19   * deps: cookie@0.4.2
20   * deps: qs@6.9.7
21     * Fix handling of `__proto__` keys
22   * pref: remove unnecessary regexp for trust proxy
24 4.17.2 / 2021-12-16
25 ===================
27   * Fix handling of `undefined` in `res.jsonp`
28   * Fix handling of `undefined` when `"json escape"` is enabled
29   * Fix incorrect middleware execution with unanchored `RegExp`s
30   * Fix `res.jsonp(obj, status)` deprecation message
31   * Fix typo in `res.is` JSDoc
32   * deps: body-parser@1.19.1
33     - deps: bytes@3.1.1
34     - deps: http-errors@1.8.1
35     - deps: qs@6.9.6
36     - deps: raw-body@2.4.2
37     - deps: safe-buffer@5.2.1
38     - deps: type-is@~1.6.18
39   * deps: content-disposition@0.5.4
40     - deps: safe-buffer@5.2.1
41   * deps: cookie@0.4.1
42     - Fix `maxAge` option to reject invalid values
43   * deps: proxy-addr@~2.0.7
44     - Use `req.socket` over deprecated `req.connection`
45     - deps: forwarded@0.2.0
46     - deps: ipaddr.js@1.9.1
47   * deps: qs@6.9.6
48   * deps: safe-buffer@5.2.1
49   * deps: send@0.17.2
50     - deps: http-errors@1.8.1
51     - deps: ms@2.1.3
52     - pref: ignore empty http tokens
53   * deps: serve-static@1.14.2
54     - deps: send@0.17.2
55   * deps: setprototypeof@1.2.0
57 4.17.1 / 2019-05-25
58 ===================
60   * Revert "Improve error message for `null`/`undefined` to `res.status`"
62 4.17.0 / 2019-05-16
63 ===================
65   * Add `express.raw` to parse bodies into `Buffer`
66   * Add `express.text` to parse bodies into string
67   * Improve error message for non-strings to `res.sendFile`
68   * Improve error message for `null`/`undefined` to `res.status`
69   * Support multiple hosts in `X-Forwarded-Host`
70   * deps: accepts@~1.3.7
71   * deps: body-parser@1.19.0
72     - Add encoding MIK
73     - Add petabyte (`pb`) support
74     - Fix parsing array brackets after index
75     - deps: bytes@3.1.0
76     - deps: http-errors@1.7.2
77     - deps: iconv-lite@0.4.24
78     - deps: qs@6.7.0
79     - deps: raw-body@2.4.0
80     - deps: type-is@~1.6.17
81   * deps: content-disposition@0.5.3
82   * deps: cookie@0.4.0
83     - Add `SameSite=None` support
84   * deps: finalhandler@~1.1.2
85     - Set stricter `Content-Security-Policy` header
86     - deps: parseurl@~1.3.3
87     - deps: statuses@~1.5.0
88   * deps: parseurl@~1.3.3
89   * deps: proxy-addr@~2.0.5
90     - deps: ipaddr.js@1.9.0
91   * deps: qs@6.7.0
92     - Fix parsing array brackets after index
93   * deps: range-parser@~1.2.1
94   * deps: send@0.17.1
95     - Set stricter CSP header in redirect & error responses
96     - deps: http-errors@~1.7.2
97     - deps: mime@1.6.0
98     - deps: ms@2.1.1
99     - deps: range-parser@~1.2.1
100     - deps: statuses@~1.5.0
101     - perf: remove redundant `path.normalize` call
102   * deps: serve-static@1.14.1
103     - Set stricter CSP header in redirect response
104     - deps: parseurl@~1.3.3
105     - deps: send@0.17.1
106   * deps: setprototypeof@1.1.1
107   * deps: statuses@~1.5.0
108     - Add `103 Early Hints`
109   * deps: type-is@~1.6.18
110     - deps: mime-types@~2.1.24
111     - perf: prevent internal `throw` on invalid type
113 4.16.4 / 2018-10-10
114 ===================
116   * Fix issue where `"Request aborted"` may be logged in `res.sendfile`
117   * Fix JSDoc for `Router` constructor
118   * deps: body-parser@1.18.3
119     - Fix deprecation warnings on Node.js 10+
120     - Fix stack trace for strict json parse error
121     - deps: depd@~1.1.2
122     - deps: http-errors@~1.6.3
123     - deps: iconv-lite@0.4.23
124     - deps: qs@6.5.2
125     - deps: raw-body@2.3.3
126     - deps: type-is@~1.6.16
127   * deps: proxy-addr@~2.0.4
128     - deps: ipaddr.js@1.8.0
129   * deps: qs@6.5.2
130   * deps: safe-buffer@5.1.2
132 4.16.3 / 2018-03-12
133 ===================
135   * deps: accepts@~1.3.5
136     - deps: mime-types@~2.1.18
137   * deps: depd@~1.1.2
138     - perf: remove argument reassignment
139   * deps: encodeurl@~1.0.2
140     - Fix encoding `%` as last character
141   * deps: finalhandler@1.1.1
142     - Fix 404 output for bad / missing pathnames
143     - deps: encodeurl@~1.0.2
144     - deps: statuses@~1.4.0
145   * deps: proxy-addr@~2.0.3
146     - deps: ipaddr.js@1.6.0
147   * deps: send@0.16.2
148     - Fix incorrect end tag in default error & redirects
149     - deps: depd@~1.1.2
150     - deps: encodeurl@~1.0.2
151     - deps: statuses@~1.4.0
152   * deps: serve-static@1.13.2
153     - Fix incorrect end tag in redirects
154     - deps: encodeurl@~1.0.2
155     - deps: send@0.16.2
156   * deps: statuses@~1.4.0
157   * deps: type-is@~1.6.16
158     - deps: mime-types@~2.1.18
160 4.16.2 / 2017-10-09
161 ===================
163   * Fix `TypeError` in `res.send` when given `Buffer` and `ETag` header set
164   * perf: skip parsing of entire `X-Forwarded-Proto` header
166 4.16.1 / 2017-09-29
167 ===================
169   * deps: send@0.16.1
170   * deps: serve-static@1.13.1
171     - Fix regression when `root` is incorrectly set to a file
172     - deps: send@0.16.1
174 4.16.0 / 2017-09-28
175 ===================
177   * Add `"json escape"` setting for `res.json` and `res.jsonp`
178   * Add `express.json` and `express.urlencoded` to parse bodies
179   * Add `options` argument to `res.download`
180   * Improve error message when autoloading invalid view engine
181   * Improve error messages when non-function provided as middleware
182   * Skip `Buffer` encoding when not generating ETag for small response
183   * Use `safe-buffer` for improved Buffer API
184   * deps: accepts@~1.3.4
185     - deps: mime-types@~2.1.16
186   * deps: content-type@~1.0.4
187     - perf: remove argument reassignment
188     - perf: skip parameter parsing when no parameters
189   * deps: etag@~1.8.1
190     - perf: replace regular expression with substring
191   * deps: finalhandler@1.1.0
192     - Use `res.headersSent` when available
193   * deps: parseurl@~1.3.2
194     - perf: reduce overhead for full URLs
195     - perf: unroll the "fast-path" `RegExp`
196   * deps: proxy-addr@~2.0.2
197     - Fix trimming leading / trailing OWS in `X-Forwarded-For`
198     - deps: forwarded@~0.1.2
199     - deps: ipaddr.js@1.5.2
200     - perf: reduce overhead when no `X-Forwarded-For` header
201   * deps: qs@6.5.1
202     - Fix parsing & compacting very deep objects
203   * deps: send@0.16.0
204     - Add 70 new types for file extensions
205     - Add `immutable` option
206     - Fix missing `</html>` in default error & redirects
207     - Set charset as "UTF-8" for .js and .json
208     - Use instance methods on steam to check for listeners
209     - deps: mime@1.4.1
210     - perf: improve path validation speed
211   * deps: serve-static@1.13.0
212     - Add 70 new types for file extensions
213     - Add `immutable` option
214     - Set charset as "UTF-8" for .js and .json
215     - deps: send@0.16.0
216   * deps: setprototypeof@1.1.0
217   * deps: utils-merge@1.0.1
218   * deps: vary@~1.1.2
219     - perf: improve header token parsing speed
220   * perf: re-use options object when generating ETags
221   * perf: remove dead `.charset` set in `res.jsonp`
223 4.15.5 / 2017-09-24
224 ===================
226   * deps: debug@2.6.9
227   * deps: finalhandler@~1.0.6
228     - deps: debug@2.6.9
229     - deps: parseurl@~1.3.2
230   * deps: fresh@0.5.2
231     - Fix handling of modified headers with invalid dates
232     - perf: improve ETag match loop
233     - perf: improve `If-None-Match` token parsing
234   * deps: send@0.15.6
235     - Fix handling of modified headers with invalid dates
236     - deps: debug@2.6.9
237     - deps: etag@~1.8.1
238     - deps: fresh@0.5.2
239     - perf: improve `If-Match` token parsing
240   * deps: serve-static@1.12.6
241     - deps: parseurl@~1.3.2
242     - deps: send@0.15.6
243     - perf: improve slash collapsing
245 4.15.4 / 2017-08-06
246 ===================
248   * deps: debug@2.6.8
249   * deps: depd@~1.1.1
250     - Remove unnecessary `Buffer` loading
251   * deps: finalhandler@~1.0.4
252     - deps: debug@2.6.8
253   * deps: proxy-addr@~1.1.5
254     - Fix array argument being altered
255     - deps: ipaddr.js@1.4.0
256   * deps: qs@6.5.0
257   * deps: send@0.15.4
258     - deps: debug@2.6.8
259     - deps: depd@~1.1.1
260     - deps: http-errors@~1.6.2
261   * deps: serve-static@1.12.4
262     - deps: send@0.15.4
264 4.15.3 / 2017-05-16
265 ===================
267   * Fix error when `res.set` cannot add charset to `Content-Type`
268   * deps: debug@2.6.7
269     - Fix `DEBUG_MAX_ARRAY_LENGTH`
270     - deps: ms@2.0.0
271   * deps: finalhandler@~1.0.3
272     - Fix missing `</html>` in HTML document
273     - deps: debug@2.6.7
274   * deps: proxy-addr@~1.1.4
275     - deps: ipaddr.js@1.3.0
276   * deps: send@0.15.3
277     - deps: debug@2.6.7
278     - deps: ms@2.0.0
279   * deps: serve-static@1.12.3
280     - deps: send@0.15.3
281   * deps: type-is@~1.6.15
282     - deps: mime-types@~2.1.15
283   * deps: vary@~1.1.1
284     - perf: hoist regular expression
286 4.15.2 / 2017-03-06
287 ===================
289   * deps: qs@6.4.0
290     - Fix regression parsing keys starting with `[`
292 4.15.1 / 2017-03-05
293 ===================
295   * deps: send@0.15.1
296     - Fix issue when `Date.parse` does not return `NaN` on invalid date
297     - Fix strict violation in broken environments
298   * deps: serve-static@1.12.1
299     - Fix issue when `Date.parse` does not return `NaN` on invalid date
300     - deps: send@0.15.1
302 4.15.0 / 2017-03-01
303 ===================
305   * Add debug message when loading view engine
306   * Add `next("router")` to exit from router
307   * Fix case where `router.use` skipped requests routes did not
308   * Remove usage of `res._headers` private field
309     - Improves compatibility with Node.js 8 nightly
310   * Skip routing when `req.url` is not set
311   * Use `%o` in path debug to tell types apart
312   * Use `Object.create` to setup request & response prototypes
313   * Use `setprototypeof` module to replace `__proto__` setting
314   * Use `statuses` instead of `http` module for status messages
315   * deps: debug@2.6.1
316     - Allow colors in workers
317     - Deprecated `DEBUG_FD` environment variable set to `3` or higher
318     - Fix error when running under React Native
319     - Use same color for same namespace
320     - deps: ms@0.7.2
321   * deps: etag@~1.8.0
322     - Use SHA1 instead of MD5 for ETag hashing
323     - Works with FIPS 140-2 OpenSSL configuration
324   * deps: finalhandler@~1.0.0
325     - Fix exception when `err` cannot be converted to a string
326     - Fully URL-encode the pathname in the 404
327     - Only include the pathname in the 404 message
328     - Send complete HTML document
329     - Set `Content-Security-Policy: default-src 'self'` header
330     - deps: debug@2.6.1
331   * deps: fresh@0.5.0
332     - Fix false detection of `no-cache` request directive
333     - Fix incorrect result when `If-None-Match` has both `*` and ETags
334     - Fix weak `ETag` matching to match spec
335     - perf: delay reading header values until needed
336     - perf: enable strict mode
337     - perf: hoist regular expressions
338     - perf: remove duplicate conditional
339     - perf: remove unnecessary boolean coercions
340     - perf: skip checking modified time if ETag check failed
341     - perf: skip parsing `If-None-Match` when no `ETag` header
342     - perf: use `Date.parse` instead of `new Date`
343   * deps: qs@6.3.1
344     - Fix array parsing from skipping empty values
345     - Fix compacting nested arrays
346   * deps: send@0.15.0
347     - Fix false detection of `no-cache` request directive
348     - Fix incorrect result when `If-None-Match` has both `*` and ETags
349     - Fix weak `ETag` matching to match spec
350     - Remove usage of `res._headers` private field
351     - Support `If-Match` and `If-Unmodified-Since` headers
352     - Use `res.getHeaderNames()` when available
353     - Use `res.headersSent` when available
354     - deps: debug@2.6.1
355     - deps: etag@~1.8.0
356     - deps: fresh@0.5.0
357     - deps: http-errors@~1.6.1
358   * deps: serve-static@1.12.0
359     - Fix false detection of `no-cache` request directive
360     - Fix incorrect result when `If-None-Match` has both `*` and ETags
361     - Fix weak `ETag` matching to match spec
362     - Remove usage of `res._headers` private field
363     - Send complete HTML document in redirect response
364     - Set default CSP header in redirect response
365     - Support `If-Match` and `If-Unmodified-Since` headers
366     - Use `res.getHeaderNames()` when available
367     - Use `res.headersSent` when available
368     - deps: send@0.15.0
369   * perf: add fast match path for `*` route
370   * perf: improve `req.ips` performance
372 4.14.1 / 2017-01-28
373 ===================
375   * deps: content-disposition@0.5.2
376   * deps: finalhandler@0.5.1
377     - Fix exception when `err.headers` is not an object
378     - deps: statuses@~1.3.1
379     - perf: hoist regular expressions
380     - perf: remove duplicate validation path
381   * deps: proxy-addr@~1.1.3
382     - deps: ipaddr.js@1.2.0
383   * deps: send@0.14.2
384     - deps: http-errors@~1.5.1
385     - deps: ms@0.7.2
386     - deps: statuses@~1.3.1
387   * deps: serve-static@~1.11.2
388     - deps: send@0.14.2
389   * deps: type-is@~1.6.14
390     - deps: mime-types@~2.1.13
392 4.14.0 / 2016-06-16
393 ===================
395   * Add `acceptRanges` option to `res.sendFile`/`res.sendfile`
396   * Add `cacheControl` option to `res.sendFile`/`res.sendfile`
397   * Add `options` argument to `req.range`
398     - Includes the `combine` option
399   * Encode URL in `res.location`/`res.redirect` if not already encoded
400   * Fix some redirect handling in `res.sendFile`/`res.sendfile`
401   * Fix Windows absolute path check using forward slashes
402   * Improve error with invalid arguments to `req.get()`
403   * Improve performance for `res.json`/`res.jsonp` in most cases
404   * Improve `Range` header handling in `res.sendFile`/`res.sendfile`
405   * deps: accepts@~1.3.3
406     - Fix including type extensions in parameters in `Accept` parsing
407     - Fix parsing `Accept` parameters with quoted equals
408     - Fix parsing `Accept` parameters with quoted semicolons
409     - Many performance improvements
410     - deps: mime-types@~2.1.11
411     - deps: negotiator@0.6.1
412   * deps: content-type@~1.0.2
413     - perf: enable strict mode
414   * deps: cookie@0.3.1
415     - Add `sameSite` option
416     - Fix cookie `Max-Age` to never be a floating point number
417     - Improve error message when `encode` is not a function
418     - Improve error message when `expires` is not a `Date`
419     - Throw better error for invalid argument to parse
420     - Throw on invalid values provided to `serialize`
421     - perf: enable strict mode
422     - perf: hoist regular expression
423     - perf: use for loop in parse
424     - perf: use string concatenation for serialization
425   * deps: finalhandler@0.5.0
426     - Change invalid or non-numeric status code to 500
427     - Overwrite status message to match set status code
428     - Prefer `err.statusCode` if `err.status` is invalid
429     - Set response headers from `err.headers` object
430     - Use `statuses` instead of `http` module for status messages
431   * deps: proxy-addr@~1.1.2
432     - Fix accepting various invalid netmasks
433     - Fix IPv6-mapped IPv4 validation edge cases
434     - IPv4 netmasks must be contiguous
435     - IPv6 addresses cannot be used as a netmask
436     - deps: ipaddr.js@1.1.1
437   * deps: qs@6.2.0
438     - Add `decoder` option in `parse` function
439   * deps: range-parser@~1.2.0
440     - Add `combine` option to combine overlapping ranges
441     - Fix incorrectly returning -1 when there is at least one valid range
442     - perf: remove internal function
443   * deps: send@0.14.1
444     - Add `acceptRanges` option
445     - Add `cacheControl` option
446     - Attempt to combine multiple ranges into single range
447     - Correctly inherit from `Stream` class
448     - Fix `Content-Range` header in 416 responses when using `start`/`end` options
449     - Fix `Content-Range` header missing from default 416 responses
450     - Fix redirect error when `path` contains raw non-URL characters
451     - Fix redirect when `path` starts with multiple forward slashes
452     - Ignore non-byte `Range` headers
453     - deps: http-errors@~1.5.0
454     - deps: range-parser@~1.2.0
455     - deps: statuses@~1.3.0
456     - perf: remove argument reassignment
457   * deps: serve-static@~1.11.1
458     - Add `acceptRanges` option
459     - Add `cacheControl` option
460     - Attempt to combine multiple ranges into single range
461     - Fix redirect error when `req.url` contains raw non-URL characters
462     - Ignore non-byte `Range` headers
463     - Use status code 301 for redirects
464     - deps: send@0.14.1
465   * deps: type-is@~1.6.13
466     - Fix type error when given invalid type to match against
467     - deps: mime-types@~2.1.11
468   * deps: vary@~1.1.0
469     - Only accept valid field names in the `field` argument
470   * perf: use strict equality when possible
472 4.13.4 / 2016-01-21
473 ===================
475   * deps: content-disposition@0.5.1
476     - perf: enable strict mode
477   * deps: cookie@0.1.5
478     - Throw on invalid values provided to `serialize`
479   * deps: depd@~1.1.0
480     - Support web browser loading
481     - perf: enable strict mode
482   * deps: escape-html@~1.0.3
483     - perf: enable strict mode
484     - perf: optimize string replacement
485     - perf: use faster string coercion
486   * deps: finalhandler@0.4.1
487     - deps: escape-html@~1.0.3
488   * deps: merge-descriptors@1.0.1
489     - perf: enable strict mode
490   * deps: methods@~1.1.2
491     - perf: enable strict mode
492   * deps: parseurl@~1.3.1
493     - perf: enable strict mode
494   * deps: proxy-addr@~1.0.10
495     - deps: ipaddr.js@1.0.5
496     - perf: enable strict mode
497   * deps: range-parser@~1.0.3
498     - perf: enable strict mode
499   * deps: send@0.13.1
500     - deps: depd@~1.1.0
501     - deps: destroy@~1.0.4
502     - deps: escape-html@~1.0.3
503     - deps: range-parser@~1.0.3
504   * deps: serve-static@~1.10.2
505     - deps: escape-html@~1.0.3
506     - deps: parseurl@~1.3.0
507     - deps: send@0.13.1
509 4.13.3 / 2015-08-02
510 ===================
512   * Fix infinite loop condition using `mergeParams: true`
513   * Fix inner numeric indices incorrectly altering parent `req.params`
515 4.13.2 / 2015-07-31
516 ===================
518   * deps: accepts@~1.2.12
519     - deps: mime-types@~2.1.4
520   * deps: array-flatten@1.1.1
521     - perf: enable strict mode
522   * deps: path-to-regexp@0.1.7
523     - Fix regression with escaped round brackets and matching groups
524   * deps: type-is@~1.6.6
525     - deps: mime-types@~2.1.4
527 4.13.1 / 2015-07-05
528 ===================
530   * deps: accepts@~1.2.10
531     - deps: mime-types@~2.1.2
532   * deps: qs@4.0.0
533     - Fix dropping parameters like `hasOwnProperty`
534     - Fix various parsing edge cases
535   * deps: type-is@~1.6.4
536     - deps: mime-types@~2.1.2
537     - perf: enable strict mode
538     - perf: remove argument reassignment
540 4.13.0 / 2015-06-20
541 ===================
543   * Add settings to debug output
544   * Fix `res.format` error when only `default` provided
545   * Fix issue where `next('route')` in `app.param` would incorrectly skip values
546   * Fix hiding platform issues with `decodeURIComponent`
547     - Only `URIError`s are a 400
548   * Fix using `*` before params in routes
549   * Fix using capture groups before params in routes
550   * Simplify `res.cookie` to call `res.append`
551   * Use `array-flatten` module for flattening arrays
552   * deps: accepts@~1.2.9
553     - deps: mime-types@~2.1.1
554     - perf: avoid argument reassignment & argument slice
555     - perf: avoid negotiator recursive construction
556     - perf: enable strict mode
557     - perf: remove unnecessary bitwise operator
558   * deps: cookie@0.1.3
559     - perf: deduce the scope of try-catch deopt
560     - perf: remove argument reassignments
561   * deps: escape-html@1.0.2
562   * deps: etag@~1.7.0
563     - Always include entity length in ETags for hash length extensions
564     - Generate non-Stats ETags using MD5 only (no longer CRC32)
565     - Improve stat performance by removing hashing
566     - Improve support for JXcore
567     - Remove base64 padding in ETags to shorten
568     - Support "fake" stats objects in environments without fs
569     - Use MD5 instead of MD4 in weak ETags over 1KB
570   * deps: finalhandler@0.4.0
571     - Fix a false-positive when unpiping in Node.js 0.8
572     - Support `statusCode` property on `Error` objects
573     - Use `unpipe` module for unpiping requests
574     - deps: escape-html@1.0.2
575     - deps: on-finished@~2.3.0
576     - perf: enable strict mode
577     - perf: remove argument reassignment
578   * deps: fresh@0.3.0
579     - Add weak `ETag` matching support
580   * deps: on-finished@~2.3.0
581     - Add defined behavior for HTTP `CONNECT` requests
582     - Add defined behavior for HTTP `Upgrade` requests
583     - deps: ee-first@1.1.1
584   * deps: path-to-regexp@0.1.6
585   * deps: send@0.13.0
586     - Allow Node.js HTTP server to set `Date` response header
587     - Fix incorrectly removing `Content-Location` on 304 response
588     - Improve the default redirect response headers
589     - Send appropriate headers on default error response
590     - Use `http-errors` for standard emitted errors
591     - Use `statuses` instead of `http` module for status messages
592     - deps: escape-html@1.0.2
593     - deps: etag@~1.7.0
594     - deps: fresh@0.3.0
595     - deps: on-finished@~2.3.0
596     - perf: enable strict mode
597     - perf: remove unnecessary array allocations
598   * deps: serve-static@~1.10.0
599     - Add `fallthrough` option
600     - Fix reading options from options prototype
601     - Improve the default redirect response headers
602     - Malformed URLs now `next()` instead of 400
603     - deps: escape-html@1.0.2
604     - deps: send@0.13.0
605     - perf: enable strict mode
606     - perf: remove argument reassignment
607   * deps: type-is@~1.6.3
608     - deps: mime-types@~2.1.1
609     - perf: reduce try block size
610     - perf: remove bitwise operations
611   * perf: enable strict mode
612   * perf: isolate `app.render` try block
613   * perf: remove argument reassignments in application
614   * perf: remove argument reassignments in request prototype
615   * perf: remove argument reassignments in response prototype
616   * perf: remove argument reassignments in routing
617   * perf: remove argument reassignments in `View`
618   * perf: skip attempting to decode zero length string
619   * perf: use saved reference to `http.STATUS_CODES`
621 4.12.4 / 2015-05-17
622 ===================
624   * deps: accepts@~1.2.7
625     - deps: mime-types@~2.0.11
626     - deps: negotiator@0.5.3
627   * deps: debug@~2.2.0
628     - deps: ms@0.7.1
629   * deps: depd@~1.0.1
630   * deps: etag@~1.6.0
631     - Improve support for JXcore
632     - Support "fake" stats objects in environments without `fs`
633   * deps: finalhandler@0.3.6
634     - deps: debug@~2.2.0
635     - deps: on-finished@~2.2.1
636   * deps: on-finished@~2.2.1
637     - Fix `isFinished(req)` when data buffered
638   * deps: proxy-addr@~1.0.8
639     - deps: ipaddr.js@1.0.1
640   * deps: qs@2.4.2
641    - Fix allowing parameters like `constructor`
642   * deps: send@0.12.3
643     - deps: debug@~2.2.0
644     - deps: depd@~1.0.1
645     - deps: etag@~1.6.0
646     - deps: ms@0.7.1
647     - deps: on-finished@~2.2.1
648   * deps: serve-static@~1.9.3
649     - deps: send@0.12.3
650   * deps: type-is@~1.6.2
651     - deps: mime-types@~2.0.11
653 4.12.3 / 2015-03-17
654 ===================
656   * deps: accepts@~1.2.5
657     - deps: mime-types@~2.0.10
658   * deps: debug@~2.1.3
659     - Fix high intensity foreground color for bold
660     - deps: ms@0.7.0
661   * deps: finalhandler@0.3.4
662     - deps: debug@~2.1.3
663   * deps: proxy-addr@~1.0.7
664     - deps: ipaddr.js@0.1.9
665   * deps: qs@2.4.1
666     - Fix error when parameter `hasOwnProperty` is present
667   * deps: send@0.12.2
668     - Throw errors early for invalid `extensions` or `index` options
669     - deps: debug@~2.1.3
670   * deps: serve-static@~1.9.2
671     - deps: send@0.12.2
672   * deps: type-is@~1.6.1
673     - deps: mime-types@~2.0.10
675 4.12.2 / 2015-03-02
676 ===================
678   * Fix regression where `"Request aborted"` is logged using `res.sendFile`
680 4.12.1 / 2015-03-01
681 ===================
683   * Fix constructing application with non-configurable prototype properties
684   * Fix `ECONNRESET` errors from `res.sendFile` usage
685   * Fix `req.host` when using "trust proxy" hops count
686   * Fix `req.protocol`/`req.secure` when using "trust proxy" hops count
687   * Fix wrong `code` on aborted connections from `res.sendFile`
688   * deps: merge-descriptors@1.0.0
690 4.12.0 / 2015-02-23
691 ===================
693   * Fix `"trust proxy"` setting to inherit when app is mounted
694   * Generate `ETag`s for all request responses
695     - No longer restricted to only responses for `GET` and `HEAD` requests
696   * Use `content-type` to parse `Content-Type` headers
697   * deps: accepts@~1.2.4
698     - Fix preference sorting to be stable for long acceptable lists
699     - deps: mime-types@~2.0.9
700     - deps: negotiator@0.5.1
701   * deps: cookie-signature@1.0.6
702   * deps: send@0.12.1
703     - Always read the stat size from the file
704     - Fix mutating passed-in `options`
705     - deps: mime@1.3.4
706   * deps: serve-static@~1.9.1
707     - deps: send@0.12.1
708   * deps: type-is@~1.6.0
709     - fix argument reassignment
710     - fix false-positives in `hasBody` `Transfer-Encoding` check
711     - support wildcard for both type and subtype (`*/*`)
712     - deps: mime-types@~2.0.9
714 4.11.2 / 2015-02-01
715 ===================
717   * Fix `res.redirect` double-calling `res.end` for `HEAD` requests
718   * deps: accepts@~1.2.3
719     - deps: mime-types@~2.0.8
720   * deps: proxy-addr@~1.0.6
721     - deps: ipaddr.js@0.1.8
722   * deps: type-is@~1.5.6
723     - deps: mime-types@~2.0.8
725 4.11.1 / 2015-01-20
726 ===================
728   * deps: send@0.11.1
729     - Fix root path disclosure
730   * deps: serve-static@~1.8.1
731     - Fix redirect loop in Node.js 0.11.14
732     - Fix root path disclosure
733     - deps: send@0.11.1
735 4.11.0 / 2015-01-13
736 ===================
738   * Add `res.append(field, val)` to append headers
739   * Deprecate leading `:` in `name` for `app.param(name, fn)`
740   * Deprecate `req.param()` -- use `req.params`, `req.body`, or `req.query` instead
741   * Deprecate `app.param(fn)`
742   * Fix `OPTIONS` responses to include the `HEAD` method properly
743   * Fix `res.sendFile` not always detecting aborted connection
744   * Match routes iteratively to prevent stack overflows
745   * deps: accepts@~1.2.2
746     - deps: mime-types@~2.0.7
747     - deps: negotiator@0.5.0
748   * deps: send@0.11.0
749     - deps: debug@~2.1.1
750     - deps: etag@~1.5.1
751     - deps: ms@0.7.0
752     - deps: on-finished@~2.2.0
753   * deps: serve-static@~1.8.0
754     - deps: send@0.11.0
756 4.10.8 / 2015-01-13
757 ===================
759   * Fix crash from error within `OPTIONS` response handler
760   * deps: proxy-addr@~1.0.5
761     - deps: ipaddr.js@0.1.6
763 4.10.7 / 2015-01-04
764 ===================
766   * Fix `Allow` header for `OPTIONS` to not contain duplicate methods
767   * Fix incorrect "Request aborted" for `res.sendFile` when `HEAD` or 304
768   * deps: debug@~2.1.1
769   * deps: finalhandler@0.3.3
770     - deps: debug@~2.1.1
771     - deps: on-finished@~2.2.0
772   * deps: methods@~1.1.1
773   * deps: on-finished@~2.2.0
774   * deps: serve-static@~1.7.2
775     - Fix potential open redirect when mounted at root
776   * deps: type-is@~1.5.5
777     - deps: mime-types@~2.0.7
779 4.10.6 / 2014-12-12
780 ===================
782   * Fix exception in `req.fresh`/`req.stale` without response headers
784 4.10.5 / 2014-12-10
785 ===================
787   * Fix `res.send` double-calling `res.end` for `HEAD` requests
788   * deps: accepts@~1.1.4
789     - deps: mime-types@~2.0.4
790   * deps: type-is@~1.5.4
791     - deps: mime-types@~2.0.4
793 4.10.4 / 2014-11-24
794 ===================
796   * Fix `res.sendfile` logging standard write errors
798 4.10.3 / 2014-11-23
799 ===================
801   * Fix `res.sendFile` logging standard write errors
802   * deps: etag@~1.5.1
803   * deps: proxy-addr@~1.0.4
804     - deps: ipaddr.js@0.1.5
805   * deps: qs@2.3.3
806     - Fix `arrayLimit` behavior
808 4.10.2 / 2014-11-09
809 ===================
811   * Correctly invoke async router callback asynchronously
812   * deps: accepts@~1.1.3
813     - deps: mime-types@~2.0.3
814   * deps: type-is@~1.5.3
815     - deps: mime-types@~2.0.3
817 4.10.1 / 2014-10-28
818 ===================
820   * Fix handling of URLs containing `://` in the path
821   * deps: qs@2.3.2
822     - Fix parsing of mixed objects and values
824 4.10.0 / 2014-10-23
825 ===================
827   * Add support for `app.set('views', array)`
828     - Views are looked up in sequence in array of directories
829   * Fix `res.send(status)` to mention `res.sendStatus(status)`
830   * Fix handling of invalid empty URLs
831   * Use `content-disposition` module for `res.attachment`/`res.download`
832     - Sends standards-compliant `Content-Disposition` header
833     - Full Unicode support
834   * Use `path.resolve` in view lookup
835   * deps: debug@~2.1.0
836     - Implement `DEBUG_FD` env variable support
837   * deps: depd@~1.0.0
838   * deps: etag@~1.5.0
839     - Improve string performance
840     - Slightly improve speed for weak ETags over 1KB
841   * deps: finalhandler@0.3.2
842     - Terminate in progress response only on error
843     - Use `on-finished` to determine request status
844     - deps: debug@~2.1.0
845     - deps: on-finished@~2.1.1
846   * deps: on-finished@~2.1.1
847     - Fix handling of pipelined requests
848   * deps: qs@2.3.0
849     - Fix parsing of mixed implicit and explicit arrays
850   * deps: send@0.10.1
851     - deps: debug@~2.1.0
852     - deps: depd@~1.0.0
853     - deps: etag@~1.5.0
854     - deps: on-finished@~2.1.1
855   * deps: serve-static@~1.7.1
856     - deps: send@0.10.1
858 4.9.8 / 2014-10-17
859 ==================
861   * Fix `res.redirect` body when redirect status specified
862   * deps: accepts@~1.1.2
863     - Fix error when media type has invalid parameter
864     - deps: negotiator@0.4.9
866 4.9.7 / 2014-10-10
867 ==================
869   * Fix using same param name in array of paths
871 4.9.6 / 2014-10-08
872 ==================
874   * deps: accepts@~1.1.1
875     - deps: mime-types@~2.0.2
876     - deps: negotiator@0.4.8
877   * deps: serve-static@~1.6.4
878     - Fix redirect loop when index file serving disabled
879   * deps: type-is@~1.5.2
880     - deps: mime-types@~2.0.2
882 4.9.5 / 2014-09-24
883 ==================
885   * deps: etag@~1.4.0
886   * deps: proxy-addr@~1.0.3
887     - Use `forwarded` npm module
888   * deps: send@0.9.3
889     - deps: etag@~1.4.0
890   * deps: serve-static@~1.6.3
891     - deps: send@0.9.3
893 4.9.4 / 2014-09-19
894 ==================
896   * deps: qs@2.2.4
897     - Fix issue with object keys starting with numbers truncated
899 4.9.3 / 2014-09-18
900 ==================
902   * deps: proxy-addr@~1.0.2
903     - Fix a global leak when multiple subnets are trusted
904     - deps: ipaddr.js@0.1.3
906 4.9.2 / 2014-09-17
907 ==================
909   * Fix regression for empty string `path` in `app.use`
910   * Fix `router.use` to accept array of middleware without path
911   * Improve error message for bad `app.use` arguments
913 4.9.1 / 2014-09-16
914 ==================
916   * Fix `app.use` to accept array of middleware without path
917   * deps: depd@0.4.5
918   * deps: etag@~1.3.1
919   * deps: send@0.9.2
920     - deps: depd@0.4.5
921     - deps: etag@~1.3.1
922     - deps: range-parser@~1.0.2
923   * deps: serve-static@~1.6.2
924     - deps: send@0.9.2
926 4.9.0 / 2014-09-08
927 ==================
929   * Add `res.sendStatus`
930   * Invoke callback for sendfile when client aborts
931     - Applies to `res.sendFile`, `res.sendfile`, and `res.download`
932     - `err` will be populated with request aborted error
933   * Support IP address host in `req.subdomains`
934   * Use `etag` to generate `ETag` headers
935   * deps: accepts@~1.1.0
936     - update `mime-types`
937   * deps: cookie-signature@1.0.5
938   * deps: debug@~2.0.0
939   * deps: finalhandler@0.2.0
940     - Set `X-Content-Type-Options: nosniff` header
941     - deps: debug@~2.0.0
942   * deps: fresh@0.2.4
943   * deps: media-typer@0.3.0
944     - Throw error when parameter format invalid on parse
945   * deps: qs@2.2.3
946     - Fix issue where first empty value in array is discarded
947   * deps: range-parser@~1.0.2
948   * deps: send@0.9.1
949     - Add `lastModified` option
950     - Use `etag` to generate `ETag` header
951     - deps: debug@~2.0.0
952     - deps: fresh@0.2.4
953   * deps: serve-static@~1.6.1
954     - Add `lastModified` option
955     - deps: send@0.9.1
956   * deps: type-is@~1.5.1
957     - fix `hasbody` to be true for `content-length: 0`
958     - deps: media-typer@0.3.0
959     - deps: mime-types@~2.0.1
960   * deps: vary@~1.0.0
961     - Accept valid `Vary` header string as `field`
963 4.8.8 / 2014-09-04
964 ==================
966   * deps: send@0.8.5
967     - Fix a path traversal issue when using `root`
968     - Fix malicious path detection for empty string path
969   * deps: serve-static@~1.5.4
970     - deps: send@0.8.5
972 4.8.7 / 2014-08-29
973 ==================
975   * deps: qs@2.2.2
976     - Remove unnecessary cloning
978 4.8.6 / 2014-08-27
979 ==================
981   * deps: qs@2.2.0
982     - Array parsing fix
983     - Performance improvements
985 4.8.5 / 2014-08-18
986 ==================
988   * deps: send@0.8.3
989     - deps: destroy@1.0.3
990     - deps: on-finished@2.1.0
991   * deps: serve-static@~1.5.3
992     - deps: send@0.8.3
994 4.8.4 / 2014-08-14
995 ==================
997   * deps: qs@1.2.2
998   * deps: send@0.8.2
999     - Work around `fd` leak in Node.js 0.10 for `fs.ReadStream`
1000   * deps: serve-static@~1.5.2
1001     - deps: send@0.8.2
1003 4.8.3 / 2014-08-10
1004 ==================
1006   * deps: parseurl@~1.3.0
1007   * deps: qs@1.2.1
1008   * deps: serve-static@~1.5.1
1009     - Fix parsing of weird `req.originalUrl` values
1010     - deps: parseurl@~1.3.0
1011     - deps: utils-merge@1.0.0
1013 4.8.2 / 2014-08-07
1014 ==================
1016   * deps: qs@1.2.0
1017     - Fix parsing array of objects
1019 4.8.1 / 2014-08-06
1020 ==================
1022   * fix incorrect deprecation warnings on `res.download`
1023   * deps: qs@1.1.0
1024     - Accept urlencoded square brackets
1025     - Accept empty values in implicit array notation
1027 4.8.0 / 2014-08-05
1028 ==================
1030   * add `res.sendFile`
1031     - accepts a file system path instead of a URL
1032     - requires an absolute path or `root` option specified
1033   * deprecate `res.sendfile` -- use `res.sendFile` instead
1034   * support mounted app as any argument to `app.use()`
1035   * deps: qs@1.0.2
1036     - Complete rewrite
1037     - Limits array length to 20
1038     - Limits object depth to 5
1039     - Limits parameters to 1,000
1040   * deps: send@0.8.1
1041     - Add `extensions` option
1042   * deps: serve-static@~1.5.0
1043     - Add `extensions` option
1044     - deps: send@0.8.1
1046 4.7.4 / 2014-08-04
1047 ==================
1049   * fix `res.sendfile` regression for serving directory index files
1050   * deps: send@0.7.4
1051     - Fix incorrect 403 on Windows and Node.js 0.11
1052     - Fix serving index files without root dir
1053   * deps: serve-static@~1.4.4
1054     - deps: send@0.7.4
1056 4.7.3 / 2014-08-04
1057 ==================
1059   * deps: send@0.7.3
1060     - Fix incorrect 403 on Windows and Node.js 0.11
1061   * deps: serve-static@~1.4.3
1062     - Fix incorrect 403 on Windows and Node.js 0.11
1063     - deps: send@0.7.3
1065 4.7.2 / 2014-07-27
1066 ==================
1068   * deps: depd@0.4.4
1069     - Work-around v8 generating empty stack traces
1070   * deps: send@0.7.2
1071     - deps: depd@0.4.4
1072   * deps: serve-static@~1.4.2
1074 4.7.1 / 2014-07-26
1075 ==================
1077   * deps: depd@0.4.3
1078     - Fix exception when global `Error.stackTraceLimit` is too low
1079   * deps: send@0.7.1
1080     - deps: depd@0.4.3
1081   * deps: serve-static@~1.4.1
1083 4.7.0 / 2014-07-25
1084 ==================
1086   * fix `req.protocol` for proxy-direct connections
1087   * configurable query parser with `app.set('query parser', parser)`
1088     - `app.set('query parser', 'extended')` parse with "qs" module
1089     - `app.set('query parser', 'simple')` parse with "querystring" core module
1090     - `app.set('query parser', false)` disable query string parsing
1091     - `app.set('query parser', true)` enable simple parsing
1092   * deprecate `res.json(status, obj)` -- use `res.status(status).json(obj)` instead
1093   * deprecate `res.jsonp(status, obj)` -- use `res.status(status).jsonp(obj)` instead
1094   * deprecate `res.send(status, body)` -- use `res.status(status).send(body)` instead
1095   * deps: debug@1.0.4
1096   * deps: depd@0.4.2
1097     - Add `TRACE_DEPRECATION` environment variable
1098     - Remove non-standard grey color from color output
1099     - Support `--no-deprecation` argument
1100     - Support `--trace-deprecation` argument
1101   * deps: finalhandler@0.1.0
1102     - Respond after request fully read
1103     - deps: debug@1.0.4
1104   * deps: parseurl@~1.2.0
1105     - Cache URLs based on original value
1106     - Remove no-longer-needed URL mis-parse work-around
1107     - Simplify the "fast-path" `RegExp`
1108   * deps: send@0.7.0
1109     - Add `dotfiles` option
1110     - Cap `maxAge` value to 1 year
1111     - deps: debug@1.0.4
1112     - deps: depd@0.4.2
1113   * deps: serve-static@~1.4.0
1114     - deps: parseurl@~1.2.0
1115     - deps: send@0.7.0
1116   * perf: prevent multiple `Buffer` creation in `res.send`
1118 4.6.1 / 2014-07-12
1119 ==================
1121   * fix `subapp.mountpath` regression for `app.use(subapp)`
1123 4.6.0 / 2014-07-11
1124 ==================
1126   * accept multiple callbacks to `app.use()`
1127   * add explicit "Rosetta Flash JSONP abuse" protection
1128     - previous versions are not vulnerable; this is just explicit protection
1129   * catch errors in multiple `req.param(name, fn)` handlers
1130   * deprecate `res.redirect(url, status)` -- use `res.redirect(status, url)` instead
1131   * fix `res.send(status, num)` to send `num` as json (not error)
1132   * remove unnecessary escaping when `res.jsonp` returns JSON response
1133   * support non-string `path` in `app.use(path, fn)`
1134     - supports array of paths
1135     - supports `RegExp`
1136   * router: fix optimization on router exit
1137   * router: refactor location of `try` blocks
1138   * router: speed up standard `app.use(fn)`
1139   * deps: debug@1.0.3
1140     - Add support for multiple wildcards in namespaces
1141   * deps: finalhandler@0.0.3
1142     - deps: debug@1.0.3
1143   * deps: methods@1.1.0
1144     - add `CONNECT`
1145   * deps: parseurl@~1.1.3
1146     - faster parsing of href-only URLs
1147   * deps: path-to-regexp@0.1.3
1148   * deps: send@0.6.0
1149     - deps: debug@1.0.3
1150   * deps: serve-static@~1.3.2
1151     - deps: parseurl@~1.1.3
1152     - deps: send@0.6.0
1153   * perf: fix arguments reassign deopt in some `res` methods
1155 4.5.1 / 2014-07-06
1156 ==================
1158  * fix routing regression when altering `req.method`
1160 4.5.0 / 2014-07-04
1161 ==================
1163  * add deprecation message to non-plural `req.accepts*`
1164  * add deprecation message to `res.send(body, status)`
1165  * add deprecation message to `res.vary()`
1166  * add `headers` option to `res.sendfile`
1167    - use to set headers on successful file transfer
1168  * add `mergeParams` option to `Router`
1169    - merges `req.params` from parent routes
1170  * add `req.hostname` -- correct name for what `req.host` returns
1171  * deprecate things with `depd` module
1172  * deprecate `req.host` -- use `req.hostname` instead
1173  * fix behavior when handling request without routes
1174  * fix handling when `route.all` is only route
1175  * invoke `router.param()` only when route matches
1176  * restore `req.params` after invoking router
1177  * use `finalhandler` for final response handling
1178  * use `media-typer` to alter content-type charset
1179  * deps: accepts@~1.0.7
1180  * deps: send@0.5.0
1181    - Accept string for `maxage` (converted by `ms`)
1182    - Include link in default redirect response
1183  * deps: serve-static@~1.3.0
1184    - Accept string for `maxAge` (converted by `ms`)
1185    - Add `setHeaders` option
1186    - Include HTML link in redirect response
1187    - deps: send@0.5.0
1188  * deps: type-is@~1.3.2
1190 4.4.5 / 2014-06-26
1191 ==================
1193  * deps: cookie-signature@1.0.4
1194    - fix for timing attacks
1196 4.4.4 / 2014-06-20
1197 ==================
1199  * fix `res.attachment` Unicode filenames in Safari
1200  * fix "trim prefix" debug message in `express:router`
1201  * deps: accepts@~1.0.5
1202  * deps: buffer-crc32@0.2.3
1204 4.4.3 / 2014-06-11
1205 ==================
1207  * fix persistence of modified `req.params[name]` from `app.param()`
1208  * deps: accepts@1.0.3
1209    - deps: negotiator@0.4.6
1210  * deps: debug@1.0.2
1211  * deps: send@0.4.3
1212    - Do not throw uncatchable error on file open race condition
1213    - Use `escape-html` for HTML escaping
1214    - deps: debug@1.0.2
1215    - deps: finished@1.2.2
1216    - deps: fresh@0.2.2
1217  * deps: serve-static@1.2.3
1218    - Do not throw uncatchable error on file open race condition
1219    - deps: send@0.4.3
1221 4.4.2 / 2014-06-09
1222 ==================
1224  * fix catching errors from top-level handlers
1225  * use `vary` module for `res.vary`
1226  * deps: debug@1.0.1
1227  * deps: proxy-addr@1.0.1
1228  * deps: send@0.4.2
1229    - fix "event emitter leak" warnings
1230    - deps: debug@1.0.1
1231    - deps: finished@1.2.1
1232  * deps: serve-static@1.2.2
1233    - fix "event emitter leak" warnings
1234    - deps: send@0.4.2
1235  * deps: type-is@1.2.1
1237 4.4.1 / 2014-06-02
1238 ==================
1240  * deps: methods@1.0.1
1241  * deps: send@0.4.1
1242    - Send `max-age` in `Cache-Control` in correct format
1243  * deps: serve-static@1.2.1
1244    - use `escape-html` for escaping
1245    - deps: send@0.4.1
1247 4.4.0 / 2014-05-30
1248 ==================
1250  * custom etag control with `app.set('etag', val)`
1251    - `app.set('etag', function(body, encoding){ return '"etag"' })` custom etag generation
1252    - `app.set('etag', 'weak')` weak tag
1253    - `app.set('etag', 'strong')` strong etag
1254    - `app.set('etag', false)` turn off
1255    - `app.set('etag', true)` standard etag
1256  * mark `res.send` ETag as weak and reduce collisions
1257  * update accepts to 1.0.2
1258    - Fix interpretation when header not in request
1259  * update send to 0.4.0
1260    - Calculate ETag with md5 for reduced collisions
1261    - Ignore stream errors after request ends
1262    - deps: debug@0.8.1
1263  * update serve-static to 1.2.0
1264    - Calculate ETag with md5 for reduced collisions
1265    - Ignore stream errors after request ends
1266    - deps: send@0.4.0
1268 4.3.2 / 2014-05-28
1269 ==================
1271  * fix handling of errors from `router.param()` callbacks
1273 4.3.1 / 2014-05-23
1274 ==================
1276  * revert "fix behavior of multiple `app.VERB` for the same path"
1277    - this caused a regression in the order of route execution
1279 4.3.0 / 2014-05-21
1280 ==================
1282  * add `req.baseUrl` to access the path stripped from `req.url` in routes
1283  * fix behavior of multiple `app.VERB` for the same path
1284  * fix issue routing requests among sub routers
1285  * invoke `router.param()` only when necessary instead of every match
1286  * proper proxy trust with `app.set('trust proxy', trust)`
1287    - `app.set('trust proxy', 1)` trust first hop
1288    - `app.set('trust proxy', 'loopback')` trust loopback addresses
1289    - `app.set('trust proxy', '10.0.0.1')` trust single IP
1290    - `app.set('trust proxy', '10.0.0.1/16')` trust subnet
1291    - `app.set('trust proxy', '10.0.0.1, 10.0.0.2')` trust list
1292    - `app.set('trust proxy', false)` turn off
1293    - `app.set('trust proxy', true)` trust everything
1294  * set proper `charset` in `Content-Type` for `res.send`
1295  * update type-is to 1.2.0
1296    - support suffix matching
1298 4.2.0 / 2014-05-11
1299 ==================
1301  * deprecate `app.del()` -- use `app.delete()` instead
1302  * deprecate `res.json(obj, status)` -- use `res.json(status, obj)` instead
1303    - the edge-case `res.json(status, num)` requires `res.status(status).json(num)`
1304  * deprecate `res.jsonp(obj, status)` -- use `res.jsonp(status, obj)` instead
1305    - the edge-case `res.jsonp(status, num)` requires `res.status(status).jsonp(num)`
1306  * fix `req.next` when inside router instance
1307  * include `ETag` header in `HEAD` requests
1308  * keep previous `Content-Type` for `res.jsonp`
1309  * support PURGE method
1310    - add `app.purge`
1311    - add `router.purge`
1312    - include PURGE in `app.all`
1313  * update debug to 0.8.0
1314    - add `enable()` method
1315    - change from stderr to stdout
1316  * update methods to 1.0.0
1317    - add PURGE
1319 4.1.2 / 2014-05-08
1320 ==================
1322  * fix `req.host` for IPv6 literals
1323  * fix `res.jsonp` error if callback param is object
1325 4.1.1 / 2014-04-27
1326 ==================
1328  * fix package.json to reflect supported node version
1330 4.1.0 / 2014-04-24
1331 ==================
1333  * pass options from `res.sendfile` to `send`
1334  * preserve casing of headers in `res.header` and `res.set`
1335  * support unicode file names in `res.attachment` and `res.download`
1336  * update accepts to 1.0.1
1337    - deps: negotiator@0.4.0
1338  * update cookie to 0.1.2
1339    - Fix for maxAge == 0
1340    - made compat with expires field
1341  * update send to 0.3.0
1342    - Accept API options in options object
1343    - Coerce option types
1344    - Control whether to generate etags
1345    - Default directory access to 403 when index disabled
1346    - Fix sending files with dots without root set
1347    - Include file path in etag
1348    - Make "Can't set headers after they are sent." catchable
1349    - Send full entity-body for multi range requests
1350    - Set etags to "weak"
1351    - Support "If-Range" header
1352    - Support multiple index paths
1353    - deps: mime@1.2.11
1354  * update serve-static to 1.1.0
1355    - Accept options directly to `send` module
1356    - Resolve relative paths at middleware setup
1357    - Use parseurl to parse the URL from request
1358    - deps: send@0.3.0
1359  * update type-is to 1.1.0
1360    - add non-array values support
1361    - add `multipart` as a shorthand
1363 4.0.0 / 2014-04-09
1364 ==================
1366  * remove:
1367    - node 0.8 support
1368    - connect and connect's patches except for charset handling
1369    - express(1) - moved to [express-generator](https://github.com/expressjs/generator)
1370    - `express.createServer()` - it has been deprecated for a long time. Use `express()`
1371    - `app.configure` - use logic in your own app code
1372    - `app.router` - is removed
1373    - `req.auth` - use `basic-auth` instead
1374    - `req.accepted*` - use `req.accepts*()` instead
1375    - `res.location` - relative URL resolution is removed
1376    - `res.charset` - include the charset in the content type when using `res.set()`
1377    - all bundled middleware except `static`
1378  * change:
1379    - `app.route` -> `app.mountpath` when mounting an express app in another express app
1380    - `json spaces` no longer enabled by default in development
1381    - `req.accepts*` -> `req.accepts*s` - i.e. `req.acceptsEncoding` -> `req.acceptsEncodings`
1382    - `req.params` is now an object instead of an array
1383    - `res.locals` is no longer a function. It is a plain js object. Treat it as such.
1384    - `res.headerSent` -> `res.headersSent` to match node.js ServerResponse object
1385  * refactor:
1386    - `req.accepts*` with [accepts](https://github.com/expressjs/accepts)
1387    - `req.is` with [type-is](https://github.com/expressjs/type-is)
1388    - [path-to-regexp](https://github.com/component/path-to-regexp)
1389  * add:
1390    - `app.router()` - returns the app Router instance
1391    - `app.route()` - Proxy to the app's `Router#route()` method to create a new route
1392    - Router & Route - public API
1394 3.21.2 / 2015-07-31
1395 ===================
1397   * deps: connect@2.30.2
1398     - deps: body-parser@~1.13.3
1399     - deps: compression@~1.5.2
1400     - deps: errorhandler@~1.4.2
1401     - deps: method-override@~2.3.5
1402     - deps: serve-index@~1.7.2
1403     - deps: type-is@~1.6.6
1404     - deps: vhost@~3.0.1
1405   * deps: vary@~1.0.1
1406     - Fix setting empty header from empty `field`
1407     - perf: enable strict mode
1408     - perf: remove argument reassignments
1410 3.21.1 / 2015-07-05
1411 ===================
1413   * deps: basic-auth@~1.0.3
1414   * deps: connect@2.30.1
1415     - deps: body-parser@~1.13.2
1416     - deps: compression@~1.5.1
1417     - deps: errorhandler@~1.4.1
1418     - deps: morgan@~1.6.1
1419     - deps: pause@0.1.0
1420     - deps: qs@4.0.0
1421     - deps: serve-index@~1.7.1
1422     - deps: type-is@~1.6.4
1424 3.21.0 / 2015-06-18
1425 ===================
1427   * deps: basic-auth@1.0.2
1428     - perf: enable strict mode
1429     - perf: hoist regular expression
1430     - perf: parse with regular expressions
1431     - perf: remove argument reassignment
1432   * deps: connect@2.30.0
1433     - deps: body-parser@~1.13.1
1434     - deps: bytes@2.1.0
1435     - deps: compression@~1.5.0
1436     - deps: cookie@0.1.3
1437     - deps: cookie-parser@~1.3.5
1438     - deps: csurf@~1.8.3
1439     - deps: errorhandler@~1.4.0
1440     - deps: express-session@~1.11.3
1441     - deps: finalhandler@0.4.0
1442     - deps: fresh@0.3.0
1443     - deps: morgan@~1.6.0
1444     - deps: serve-favicon@~2.3.0
1445     - deps: serve-index@~1.7.0
1446     - deps: serve-static@~1.10.0
1447     - deps: type-is@~1.6.3
1448   * deps: cookie@0.1.3
1449     - perf: deduce the scope of try-catch deopt
1450     - perf: remove argument reassignments
1451   * deps: escape-html@1.0.2
1452   * deps: etag@~1.7.0
1453     - Always include entity length in ETags for hash length extensions
1454     - Generate non-Stats ETags using MD5 only (no longer CRC32)
1455     - Improve stat performance by removing hashing
1456     - Improve support for JXcore
1457     - Remove base64 padding in ETags to shorten
1458     - Support "fake" stats objects in environments without fs
1459     - Use MD5 instead of MD4 in weak ETags over 1KB
1460   * deps: fresh@0.3.0
1461     - Add weak `ETag` matching support
1462   * deps: mkdirp@0.5.1
1463     - Work in global strict mode
1464   * deps: send@0.13.0
1465     - Allow Node.js HTTP server to set `Date` response header
1466     - Fix incorrectly removing `Content-Location` on 304 response
1467     - Improve the default redirect response headers
1468     - Send appropriate headers on default error response
1469     - Use `http-errors` for standard emitted errors
1470     - Use `statuses` instead of `http` module for status messages
1471     - deps: escape-html@1.0.2
1472     - deps: etag@~1.7.0
1473     - deps: fresh@0.3.0
1474     - deps: on-finished@~2.3.0
1475     - perf: enable strict mode
1476     - perf: remove unnecessary array allocations
1478 3.20.3 / 2015-05-17
1479 ===================
1481   * deps: connect@2.29.2
1482     - deps: body-parser@~1.12.4
1483     - deps: compression@~1.4.4
1484     - deps: connect-timeout@~1.6.2
1485     - deps: debug@~2.2.0
1486     - deps: depd@~1.0.1
1487     - deps: errorhandler@~1.3.6
1488     - deps: finalhandler@0.3.6
1489     - deps: method-override@~2.3.3
1490     - deps: morgan@~1.5.3
1491     - deps: qs@2.4.2
1492     - deps: response-time@~2.3.1
1493     - deps: serve-favicon@~2.2.1
1494     - deps: serve-index@~1.6.4
1495     - deps: serve-static@~1.9.3
1496     - deps: type-is@~1.6.2
1497   * deps: debug@~2.2.0
1498     - deps: ms@0.7.1
1499   * deps: depd@~1.0.1
1500   * deps: proxy-addr@~1.0.8
1501     - deps: ipaddr.js@1.0.1
1502   * deps: send@0.12.3
1503     - deps: debug@~2.2.0
1504     - deps: depd@~1.0.1
1505     - deps: etag@~1.6.0
1506     - deps: ms@0.7.1
1507     - deps: on-finished@~2.2.1
1509 3.20.2 / 2015-03-16
1510 ===================
1512   * deps: connect@2.29.1
1513     - deps: body-parser@~1.12.2
1514     - deps: compression@~1.4.3
1515     - deps: connect-timeout@~1.6.1
1516     - deps: debug@~2.1.3
1517     - deps: errorhandler@~1.3.5
1518     - deps: express-session@~1.10.4
1519     - deps: finalhandler@0.3.4
1520     - deps: method-override@~2.3.2
1521     - deps: morgan@~1.5.2
1522     - deps: qs@2.4.1
1523     - deps: serve-index@~1.6.3
1524     - deps: serve-static@~1.9.2
1525     - deps: type-is@~1.6.1
1526   * deps: debug@~2.1.3
1527     - Fix high intensity foreground color for bold
1528     - deps: ms@0.7.0
1529   * deps: merge-descriptors@1.0.0
1530   * deps: proxy-addr@~1.0.7
1531     - deps: ipaddr.js@0.1.9
1532   * deps: send@0.12.2
1533     - Throw errors early for invalid `extensions` or `index` options
1534     - deps: debug@~2.1.3
1536 3.20.1 / 2015-02-28
1537 ===================
1539   * Fix `req.host` when using "trust proxy" hops count
1540   * Fix `req.protocol`/`req.secure` when using "trust proxy" hops count
1542 3.20.0 / 2015-02-18
1543 ===================
1545   * Fix `"trust proxy"` setting to inherit when app is mounted
1546   * Generate `ETag`s for all request responses
1547     - No longer restricted to only responses for `GET` and `HEAD` requests
1548   * Use `content-type` to parse `Content-Type` headers
1549   * deps: connect@2.29.0
1550     - Use `content-type` to parse `Content-Type` headers
1551     - deps: body-parser@~1.12.0
1552     - deps: compression@~1.4.1
1553     - deps: connect-timeout@~1.6.0
1554     - deps: cookie-parser@~1.3.4
1555     - deps: cookie-signature@1.0.6
1556     - deps: csurf@~1.7.0
1557     - deps: errorhandler@~1.3.4
1558     - deps: express-session@~1.10.3
1559     - deps: http-errors@~1.3.1
1560     - deps: response-time@~2.3.0
1561     - deps: serve-index@~1.6.2
1562     - deps: serve-static@~1.9.1
1563     - deps: type-is@~1.6.0
1564   * deps: cookie-signature@1.0.6
1565   * deps: send@0.12.1
1566     - Always read the stat size from the file
1567     - Fix mutating passed-in `options`
1568     - deps: mime@1.3.4
1570 3.19.2 / 2015-02-01
1571 ===================
1573   * deps: connect@2.28.3
1574     - deps: compression@~1.3.1
1575     - deps: csurf@~1.6.6
1576     - deps: errorhandler@~1.3.3
1577     - deps: express-session@~1.10.2
1578     - deps: serve-index@~1.6.1
1579     - deps: type-is@~1.5.6
1580   * deps: proxy-addr@~1.0.6
1581     - deps: ipaddr.js@0.1.8
1583 3.19.1 / 2015-01-20
1584 ===================
1586   * deps: connect@2.28.2
1587     - deps: body-parser@~1.10.2
1588     - deps: serve-static@~1.8.1
1589   * deps: send@0.11.1
1590     - Fix root path disclosure
1592 3.19.0 / 2015-01-09
1593 ===================
1595   * Fix `OPTIONS` responses to include the `HEAD` method property
1596   * Use `readline` for prompt in `express(1)`
1597   * deps: commander@2.6.0
1598   * deps: connect@2.28.1
1599     - deps: body-parser@~1.10.1
1600     - deps: compression@~1.3.0
1601     - deps: connect-timeout@~1.5.0
1602     - deps: csurf@~1.6.4
1603     - deps: debug@~2.1.1
1604     - deps: errorhandler@~1.3.2
1605     - deps: express-session@~1.10.1
1606     - deps: finalhandler@0.3.3
1607     - deps: method-override@~2.3.1
1608     - deps: morgan@~1.5.1
1609     - deps: serve-favicon@~2.2.0
1610     - deps: serve-index@~1.6.0
1611     - deps: serve-static@~1.8.0
1612     - deps: type-is@~1.5.5
1613   * deps: debug@~2.1.1
1614   * deps: methods@~1.1.1
1615   * deps: proxy-addr@~1.0.5
1616     - deps: ipaddr.js@0.1.6
1617   * deps: send@0.11.0
1618     - deps: debug@~2.1.1
1619     - deps: etag@~1.5.1
1620     - deps: ms@0.7.0
1621     - deps: on-finished@~2.2.0
1623 3.18.6 / 2014-12-12
1624 ===================
1626   * Fix exception in `req.fresh`/`req.stale` without response headers
1628 3.18.5 / 2014-12-11
1629 ===================
1631   * deps: connect@2.27.6
1632     - deps: compression@~1.2.2
1633     - deps: express-session@~1.9.3
1634     - deps: http-errors@~1.2.8
1635     - deps: serve-index@~1.5.3
1636     - deps: type-is@~1.5.4
1638 3.18.4 / 2014-11-23
1639 ===================
1641   * deps: connect@2.27.4
1642     - deps: body-parser@~1.9.3
1643     - deps: compression@~1.2.1
1644     - deps: errorhandler@~1.2.3
1645     - deps: express-session@~1.9.2
1646     - deps: qs@2.3.3
1647     - deps: serve-favicon@~2.1.7
1648     - deps: serve-static@~1.5.1
1649     - deps: type-is@~1.5.3
1650   * deps: etag@~1.5.1
1651   * deps: proxy-addr@~1.0.4
1652     - deps: ipaddr.js@0.1.5
1654 3.18.3 / 2014-11-09
1655 ===================
1657   * deps: connect@2.27.3
1658     - Correctly invoke async callback asynchronously
1659     - deps: csurf@~1.6.3
1661 3.18.2 / 2014-10-28
1662 ===================
1664   * deps: connect@2.27.2
1665     - Fix handling of URLs containing `://` in the path
1666     - deps: body-parser@~1.9.2
1667     - deps: qs@2.3.2
1669 3.18.1 / 2014-10-22
1670 ===================
1672   * Fix internal `utils.merge` deprecation warnings
1673   * deps: connect@2.27.1
1674     - deps: body-parser@~1.9.1
1675     - deps: express-session@~1.9.1
1676     - deps: finalhandler@0.3.2
1677     - deps: morgan@~1.4.1
1678     - deps: qs@2.3.0
1679     - deps: serve-static@~1.7.1
1680   * deps: send@0.10.1
1681     - deps: on-finished@~2.1.1
1683 3.18.0 / 2014-10-17
1684 ===================
1686   * Use `content-disposition` module for `res.attachment`/`res.download`
1687     - Sends standards-compliant `Content-Disposition` header
1688     - Full Unicode support
1689   * Use `etag` module to generate `ETag` headers
1690   * deps: connect@2.27.0
1691     - Use `http-errors` module for creating errors
1692     - Use `utils-merge` module for merging objects
1693     - deps: body-parser@~1.9.0
1694     - deps: compression@~1.2.0
1695     - deps: connect-timeout@~1.4.0
1696     - deps: debug@~2.1.0
1697     - deps: depd@~1.0.0
1698     - deps: express-session@~1.9.0
1699     - deps: finalhandler@0.3.1
1700     - deps: method-override@~2.3.0
1701     - deps: morgan@~1.4.0
1702     - deps: response-time@~2.2.0
1703     - deps: serve-favicon@~2.1.6
1704     - deps: serve-index@~1.5.0
1705     - deps: serve-static@~1.7.0
1706   * deps: debug@~2.1.0
1707     - Implement `DEBUG_FD` env variable support
1708   * deps: depd@~1.0.0
1709   * deps: send@0.10.0
1710     - deps: debug@~2.1.0
1711     - deps: depd@~1.0.0
1712     - deps: etag@~1.5.0
1714 3.17.8 / 2014-10-15
1715 ===================
1717   * deps: connect@2.26.6
1718     - deps: compression@~1.1.2
1719     - deps: csurf@~1.6.2
1720     - deps: errorhandler@~1.2.2
1722 3.17.7 / 2014-10-08
1723 ===================
1725   * deps: connect@2.26.5
1726     - Fix accepting non-object arguments to `logger`
1727     - deps: serve-static@~1.6.4
1729 3.17.6 / 2014-10-02
1730 ===================
1732   * deps: connect@2.26.4
1733     - deps: morgan@~1.3.2
1734     - deps: type-is@~1.5.2
1736 3.17.5 / 2014-09-24
1737 ===================
1739   * deps: connect@2.26.3
1740     - deps: body-parser@~1.8.4
1741     - deps: serve-favicon@~2.1.5
1742     - deps: serve-static@~1.6.3
1743   * deps: proxy-addr@~1.0.3
1744     - Use `forwarded` npm module
1745   * deps: send@0.9.3
1746     - deps: etag@~1.4.0
1748 3.17.4 / 2014-09-19
1749 ===================
1751   * deps: connect@2.26.2
1752     - deps: body-parser@~1.8.3
1753     - deps: qs@2.2.4
1755 3.17.3 / 2014-09-18
1756 ===================
1758   * deps: proxy-addr@~1.0.2
1759     - Fix a global leak when multiple subnets are trusted
1760     - deps: ipaddr.js@0.1.3
1762 3.17.2 / 2014-09-15
1763 ===================
1765   * Use `crc` instead of `buffer-crc32` for speed
1766   * deps: connect@2.26.1
1767     - deps: body-parser@~1.8.2
1768     - deps: depd@0.4.5
1769     - deps: express-session@~1.8.2
1770     - deps: morgan@~1.3.1
1771     - deps: serve-favicon@~2.1.3
1772     - deps: serve-static@~1.6.2
1773   * deps: depd@0.4.5
1774   * deps: send@0.9.2
1775     - deps: depd@0.4.5
1776     - deps: etag@~1.3.1
1777     - deps: range-parser@~1.0.2
1779 3.17.1 / 2014-09-08
1780 ===================
1782   * Fix error in `req.subdomains` on empty host
1784 3.17.0 / 2014-09-08
1785 ===================
1787   * Support `X-Forwarded-Host` in `req.subdomains`
1788   * Support IP address host in `req.subdomains`
1789   * deps: connect@2.26.0
1790     - deps: body-parser@~1.8.1
1791     - deps: compression@~1.1.0
1792     - deps: connect-timeout@~1.3.0
1793     - deps: cookie-parser@~1.3.3
1794     - deps: cookie-signature@1.0.5
1795     - deps: csurf@~1.6.1
1796     - deps: debug@~2.0.0
1797     - deps: errorhandler@~1.2.0
1798     - deps: express-session@~1.8.1
1799     - deps: finalhandler@0.2.0
1800     - deps: fresh@0.2.4
1801     - deps: media-typer@0.3.0
1802     - deps: method-override@~2.2.0
1803     - deps: morgan@~1.3.0
1804     - deps: qs@2.2.3
1805     - deps: serve-favicon@~2.1.3
1806     - deps: serve-index@~1.2.1
1807     - deps: serve-static@~1.6.1
1808     - deps: type-is@~1.5.1
1809     - deps: vhost@~3.0.0
1810   * deps: cookie-signature@1.0.5
1811   * deps: debug@~2.0.0
1812   * deps: fresh@0.2.4
1813   * deps: media-typer@0.3.0
1814     - Throw error when parameter format invalid on parse
1815   * deps: range-parser@~1.0.2
1816   * deps: send@0.9.1
1817     - Add `lastModified` option
1818     - Use `etag` to generate `ETag` header
1819     - deps: debug@~2.0.0
1820     - deps: fresh@0.2.4
1821   * deps: vary@~1.0.0
1822     - Accept valid `Vary` header string as `field`
1824 3.16.10 / 2014-09-04
1825 ====================
1827   * deps: connect@2.25.10
1828     - deps: serve-static@~1.5.4
1829   * deps: send@0.8.5
1830     - Fix a path traversal issue when using `root`
1831     - Fix malicious path detection for empty string path
1833 3.16.9 / 2014-08-29
1834 ===================
1836   * deps: connect@2.25.9
1837     - deps: body-parser@~1.6.7
1838     - deps: qs@2.2.2
1840 3.16.8 / 2014-08-27
1841 ===================
1843   * deps: connect@2.25.8
1844     - deps: body-parser@~1.6.6
1845     - deps: csurf@~1.4.1
1846     - deps: qs@2.2.0
1848 3.16.7 / 2014-08-18
1849 ===================
1851   * deps: connect@2.25.7
1852     - deps: body-parser@~1.6.5
1853     - deps: express-session@~1.7.6
1854     - deps: morgan@~1.2.3
1855     - deps: serve-static@~1.5.3
1856   * deps: send@0.8.3
1857     - deps: destroy@1.0.3
1858     - deps: on-finished@2.1.0
1860 3.16.6 / 2014-08-14
1861 ===================
1863   * deps: connect@2.25.6
1864     - deps: body-parser@~1.6.4
1865     - deps: qs@1.2.2
1866     - deps: serve-static@~1.5.2
1867   * deps: send@0.8.2
1868     - Work around `fd` leak in Node.js 0.10 for `fs.ReadStream`
1870 3.16.5 / 2014-08-11
1871 ===================
1873   * deps: connect@2.25.5
1874     - Fix backwards compatibility in `logger`
1876 3.16.4 / 2014-08-10
1877 ===================
1879   * Fix original URL parsing in `res.location`
1880   * deps: connect@2.25.4
1881     - Fix `query` middleware breaking with argument
1882     - deps: body-parser@~1.6.3
1883     - deps: compression@~1.0.11
1884     - deps: connect-timeout@~1.2.2
1885     - deps: express-session@~1.7.5
1886     - deps: method-override@~2.1.3
1887     - deps: on-headers@~1.0.0
1888     - deps: parseurl@~1.3.0
1889     - deps: qs@1.2.1
1890     - deps: response-time@~2.0.1
1891     - deps: serve-index@~1.1.6
1892     - deps: serve-static@~1.5.1
1893   * deps: parseurl@~1.3.0
1895 3.16.3 / 2014-08-07
1896 ===================
1898   * deps: connect@2.25.3
1899     - deps: multiparty@3.3.2
1901 3.16.2 / 2014-08-07
1902 ===================
1904   * deps: connect@2.25.2
1905     - deps: body-parser@~1.6.2
1906     - deps: qs@1.2.0
1908 3.16.1 / 2014-08-06
1909 ===================
1911   * deps: connect@2.25.1
1912     - deps: body-parser@~1.6.1
1913     - deps: qs@1.1.0
1915 3.16.0 / 2014-08-05
1916 ===================
1918   * deps: connect@2.25.0
1919     - deps: body-parser@~1.6.0
1920     - deps: compression@~1.0.10
1921     - deps: csurf@~1.4.0
1922     - deps: express-session@~1.7.4
1923     - deps: qs@1.0.2
1924     - deps: serve-static@~1.5.0
1925   * deps: send@0.8.1
1926     - Add `extensions` option
1928 3.15.3 / 2014-08-04
1929 ===================
1931   * fix `res.sendfile` regression for serving directory index files
1932   * deps: connect@2.24.3
1933     - deps: serve-index@~1.1.5
1934     - deps: serve-static@~1.4.4
1935   * deps: send@0.7.4
1936     - Fix incorrect 403 on Windows and Node.js 0.11
1937     - Fix serving index files without root dir
1939 3.15.2 / 2014-07-27
1940 ===================
1942   * deps: connect@2.24.2
1943     - deps: body-parser@~1.5.2
1944     - deps: depd@0.4.4
1945     - deps: express-session@~1.7.2
1946     - deps: morgan@~1.2.2
1947     - deps: serve-static@~1.4.2
1948   * deps: depd@0.4.4
1949     - Work-around v8 generating empty stack traces
1950   * deps: send@0.7.2
1951     - deps: depd@0.4.4
1953 3.15.1 / 2014-07-26
1954 ===================
1956   * deps: connect@2.24.1
1957     - deps: body-parser@~1.5.1
1958     - deps: depd@0.4.3
1959     - deps: express-session@~1.7.1
1960     - deps: morgan@~1.2.1
1961     - deps: serve-index@~1.1.4
1962     - deps: serve-static@~1.4.1
1963   * deps: depd@0.4.3
1964     - Fix exception when global `Error.stackTraceLimit` is too low
1965   * deps: send@0.7.1
1966     - deps: depd@0.4.3
1968 3.15.0 / 2014-07-22
1969 ===================
1971   * Fix `req.protocol` for proxy-direct connections
1972   * Pass options from `res.sendfile` to `send`
1973   * deps: connect@2.24.0
1974     - deps: body-parser@~1.5.0
1975     - deps: compression@~1.0.9
1976     - deps: connect-timeout@~1.2.1
1977     - deps: debug@1.0.4
1978     - deps: depd@0.4.2
1979     - deps: express-session@~1.7.0
1980     - deps: finalhandler@0.1.0
1981     - deps: method-override@~2.1.2
1982     - deps: morgan@~1.2.0
1983     - deps: multiparty@3.3.1
1984     - deps: parseurl@~1.2.0
1985     - deps: serve-static@~1.4.0
1986   * deps: debug@1.0.4
1987   * deps: depd@0.4.2
1988     - Add `TRACE_DEPRECATION` environment variable
1989     - Remove non-standard grey color from color output
1990     - Support `--no-deprecation` argument
1991     - Support `--trace-deprecation` argument
1992   * deps: parseurl@~1.2.0
1993     - Cache URLs based on original value
1994     - Remove no-longer-needed URL mis-parse work-around
1995     - Simplify the "fast-path" `RegExp`
1996   * deps: send@0.7.0
1997     - Add `dotfiles` option
1998     - Cap `maxAge` value to 1 year
1999     - deps: debug@1.0.4
2000     - deps: depd@0.4.2
2002 3.14.0 / 2014-07-11
2003 ===================
2005  * add explicit "Rosetta Flash JSONP abuse" protection
2006    - previous versions are not vulnerable; this is just explicit protection
2007  * deprecate `res.redirect(url, status)` -- use `res.redirect(status, url)` instead
2008  * fix `res.send(status, num)` to send `num` as json (not error)
2009  * remove unnecessary escaping when `res.jsonp` returns JSON response
2010  * deps: basic-auth@1.0.0
2011    - support empty password
2012    - support empty username
2013  * deps: connect@2.23.0
2014    - deps: debug@1.0.3
2015    - deps: express-session@~1.6.4
2016    - deps: method-override@~2.1.0
2017    - deps: parseurl@~1.1.3
2018    - deps: serve-static@~1.3.1
2019   * deps: debug@1.0.3
2020     - Add support for multiple wildcards in namespaces
2021   * deps: methods@1.1.0
2022     - add `CONNECT`
2023   * deps: parseurl@~1.1.3
2024     - faster parsing of href-only URLs
2026 3.13.0 / 2014-07-03
2027 ===================
2029  * add deprecation message to `app.configure`
2030  * add deprecation message to `req.auth`
2031  * use `basic-auth` to parse `Authorization` header
2032  * deps: connect@2.22.0
2033    - deps: csurf@~1.3.0
2034    - deps: express-session@~1.6.1
2035    - deps: multiparty@3.3.0
2036    - deps: serve-static@~1.3.0
2037  * deps: send@0.5.0
2038    - Accept string for `maxage` (converted by `ms`)
2039    - Include link in default redirect response
2041 3.12.1 / 2014-06-26
2042 ===================
2044  * deps: connect@2.21.1
2045    - deps: cookie-parser@1.3.2
2046    - deps: cookie-signature@1.0.4
2047    - deps: express-session@~1.5.2
2048    - deps: type-is@~1.3.2
2049  * deps: cookie-signature@1.0.4
2050    - fix for timing attacks
2052 3.12.0 / 2014-06-21
2053 ===================
2055  * use `media-typer` to alter content-type charset
2056  * deps: connect@2.21.0
2057    - deprecate `connect(middleware)` -- use `app.use(middleware)` instead
2058    - deprecate `connect.createServer()` -- use `connect()` instead
2059    - fix `res.setHeader()` patch to work with with get -> append -> set pattern
2060    - deps: compression@~1.0.8
2061    - deps: errorhandler@~1.1.1
2062    - deps: express-session@~1.5.0
2063    - deps: serve-index@~1.1.3
2065 3.11.0 / 2014-06-19
2066 ===================
2068  * deprecate things with `depd` module
2069  * deps: buffer-crc32@0.2.3
2070  * deps: connect@2.20.2
2071    - deprecate `verify` option to `json` -- use `body-parser` npm module instead
2072    - deprecate `verify` option to `urlencoded` -- use `body-parser` npm module instead
2073    - deprecate things with `depd` module
2074    - use `finalhandler` for final response handling
2075    - use `media-typer` to parse `content-type` for charset
2076    - deps: body-parser@1.4.3
2077    - deps: connect-timeout@1.1.1
2078    - deps: cookie-parser@1.3.1
2079    - deps: csurf@1.2.2
2080    - deps: errorhandler@1.1.0
2081    - deps: express-session@1.4.0
2082    - deps: multiparty@3.2.9
2083    - deps: serve-index@1.1.2
2084    - deps: type-is@1.3.1
2085    - deps: vhost@2.0.0
2087 3.10.5 / 2014-06-11
2088 ===================
2090  * deps: connect@2.19.6
2091    - deps: body-parser@1.3.1
2092    - deps: compression@1.0.7
2093    - deps: debug@1.0.2
2094    - deps: serve-index@1.1.1
2095    - deps: serve-static@1.2.3
2096  * deps: debug@1.0.2
2097  * deps: send@0.4.3
2098    - Do not throw uncatchable error on file open race condition
2099    - Use `escape-html` for HTML escaping
2100    - deps: debug@1.0.2
2101    - deps: finished@1.2.2
2102    - deps: fresh@0.2.2
2104 3.10.4 / 2014-06-09
2105 ===================
2107  * deps: connect@2.19.5
2108    - fix "event emitter leak" warnings
2109    - deps: csurf@1.2.1
2110    - deps: debug@1.0.1
2111    - deps: serve-static@1.2.2
2112    - deps: type-is@1.2.1
2113  * deps: debug@1.0.1
2114  * deps: send@0.4.2
2115    - fix "event emitter leak" warnings
2116    - deps: finished@1.2.1
2117    - deps: debug@1.0.1
2119 3.10.3 / 2014-06-05
2120 ===================
2122  * use `vary` module for `res.vary`
2123  * deps: connect@2.19.4
2124    - deps: errorhandler@1.0.2
2125    - deps: method-override@2.0.2
2126    - deps: serve-favicon@2.0.1
2127  * deps: debug@1.0.0
2129 3.10.2 / 2014-06-03
2130 ===================
2132  * deps: connect@2.19.3
2133    - deps: compression@1.0.6
2135 3.10.1 / 2014-06-03
2136 ===================
2138  * deps: connect@2.19.2
2139    - deps: compression@1.0.4
2140  * deps: proxy-addr@1.0.1
2142 3.10.0 / 2014-06-02
2143 ===================
2145  * deps: connect@2.19.1
2146    - deprecate `methodOverride()` -- use `method-override` npm module instead
2147    - deps: body-parser@1.3.0
2148    - deps: method-override@2.0.1
2149    - deps: multiparty@3.2.8
2150    - deps: response-time@2.0.0
2151    - deps: serve-static@1.2.1
2152  * deps: methods@1.0.1
2153  * deps: send@0.4.1
2154    - Send `max-age` in `Cache-Control` in correct format
2156 3.9.0 / 2014-05-30
2157 ==================
2159  * custom etag control with `app.set('etag', val)`
2160    - `app.set('etag', function(body, encoding){ return '"etag"' })` custom etag generation
2161    - `app.set('etag', 'weak')` weak tag
2162    - `app.set('etag', 'strong')` strong etag
2163    - `app.set('etag', false)` turn off
2164    - `app.set('etag', true)` standard etag
2165  * Include ETag in HEAD requests
2166  * mark `res.send` ETag as weak and reduce collisions
2167  * update connect to 2.18.0
2168    - deps: compression@1.0.3
2169    - deps: serve-index@1.1.0
2170    - deps: serve-static@1.2.0
2171  * update send to 0.4.0
2172    - Calculate ETag with md5 for reduced collisions
2173    - Ignore stream errors after request ends
2174    - deps: debug@0.8.1
2176 3.8.1 / 2014-05-27
2177 ==================
2179  * update connect to 2.17.3
2180    - deps: body-parser@1.2.2
2181    - deps: express-session@1.2.1
2182    - deps: method-override@1.0.2
2184 3.8.0 / 2014-05-21
2185 ==================
2187  * keep previous `Content-Type` for `res.jsonp`
2188  * set proper `charset` in `Content-Type` for `res.send`
2189  * update connect to 2.17.1
2190    - fix `res.charset` appending charset when `content-type` has one
2191    - deps: express-session@1.2.0
2192    - deps: morgan@1.1.1
2193    - deps: serve-index@1.0.3
2195 3.7.0 / 2014-05-18
2196 ==================
2198  * proper proxy trust with `app.set('trust proxy', trust)`
2199    - `app.set('trust proxy', 1)` trust first hop
2200    - `app.set('trust proxy', 'loopback')` trust loopback addresses
2201    - `app.set('trust proxy', '10.0.0.1')` trust single IP
2202    - `app.set('trust proxy', '10.0.0.1/16')` trust subnet
2203    - `app.set('trust proxy', '10.0.0.1, 10.0.0.2')` trust list
2204    - `app.set('trust proxy', false)` turn off
2205    - `app.set('trust proxy', true)` trust everything
2206  * update connect to 2.16.2
2207    - deprecate `res.headerSent` -- use `res.headersSent`
2208    - deprecate `res.on("header")` -- use on-headers module instead
2209    - fix edge-case in `res.appendHeader` that would append in wrong order
2210    - json: use body-parser
2211    - urlencoded: use body-parser
2212    - dep: bytes@1.0.0
2213    - dep: cookie-parser@1.1.0
2214    - dep: csurf@1.2.0
2215    - dep: express-session@1.1.0
2216    - dep: method-override@1.0.1
2218 3.6.0 / 2014-05-09
2219 ==================
2221  * deprecate `app.del()` -- use `app.delete()` instead
2222  * deprecate `res.json(obj, status)` -- use `res.json(status, obj)` instead
2223    - the edge-case `res.json(status, num)` requires `res.status(status).json(num)`
2224  * deprecate `res.jsonp(obj, status)` -- use `res.jsonp(status, obj)` instead
2225    - the edge-case `res.jsonp(status, num)` requires `res.status(status).jsonp(num)`
2226  * support PURGE method
2227    - add `app.purge`
2228    - add `router.purge`
2229    - include PURGE in `app.all`
2230  * update connect to 2.15.0
2231    * Add `res.appendHeader`
2232    * Call error stack even when response has been sent
2233    * Patch `res.headerSent` to return Boolean
2234    * Patch `res.headersSent` for node.js 0.8
2235    * Prevent default 404 handler after response sent
2236    * dep: compression@1.0.2
2237    * dep: connect-timeout@1.1.0
2238    * dep: debug@^0.8.0
2239    * dep: errorhandler@1.0.1
2240    * dep: express-session@1.0.4
2241    * dep: morgan@1.0.1
2242    * dep: serve-favicon@2.0.0
2243    * dep: serve-index@1.0.2
2244  * update debug to 0.8.0
2245    * add `enable()` method
2246    * change from stderr to stdout
2247  * update methods to 1.0.0
2248    - add PURGE
2249  * update mkdirp to 0.5.0
2251 3.5.3 / 2014-05-08
2252 ==================
2254  * fix `req.host` for IPv6 literals
2255  * fix `res.jsonp` error if callback param is object
2257 3.5.2 / 2014-04-24
2258 ==================
2260  * update connect to 2.14.5
2261  * update cookie to 0.1.2
2262  * update mkdirp to 0.4.0
2263  * update send to 0.3.0
2265 3.5.1 / 2014-03-25
2266 ==================
2268  * pin less-middleware in generated app
2270 3.5.0 / 2014-03-06
2271 ==================
2273  * bump deps
2275 3.4.8 / 2014-01-13
2276 ==================
2278  * prevent incorrect automatic OPTIONS responses #1868 @dpatti
2279  * update binary and examples for jade 1.0 #1876 @yossi, #1877 @reqshark, #1892 @matheusazzi
2280  * throw 400 in case of malformed paths @rlidwka
2282 3.4.7 / 2013-12-10
2283 ==================
2285  * update connect
2287 3.4.6 / 2013-12-01
2288 ==================
2290  * update connect (raw-body)
2292 3.4.5 / 2013-11-27
2293 ==================
2295  * update connect
2296  * res.location: remove leading ./ #1802 @kapouer
2297  * res.redirect: fix `res.redirect('toString') #1829 @michaelficarra
2298  * res.send: always send ETag when content-length > 0
2299  * router: add Router.all() method
2301 3.4.4 / 2013-10-29
2302 ==================
2304  * update connect
2305  * update supertest
2306  * update methods
2307  * express(1): replace bodyParser() with urlencoded() and json() #1795 @chirag04
2309 3.4.3 / 2013-10-23
2310 ==================
2312  * update connect
2314 3.4.2 / 2013-10-18
2315 ==================
2317  * update connect
2318  * downgrade commander
2320 3.4.1 / 2013-10-15
2321 ==================
2323  * update connect
2324  * update commander
2325  * jsonp: check if callback is a function
2326  * router: wrap encodeURIComponent in a try/catch #1735 (@lxe)
2327  * res.format: now includes charset @1747 (@sorribas)
2328  * res.links: allow multiple calls @1746 (@sorribas)
2330 3.4.0 / 2013-09-07
2331 ==================
2333  * add res.vary(). Closes #1682
2334  * update connect
2336 3.3.8 / 2013-09-02
2337 ==================
2339  * update connect
2341 3.3.7 / 2013-08-28
2342 ==================
2344  * update connect
2346 3.3.6 / 2013-08-27
2347 ==================
2349  * Revert "remove charset from json responses. Closes #1631" (causes issues in some clients)
2350  * add: req.accepts take an argument list
2352 3.3.4 / 2013-07-08
2353 ==================
2355  * update send and connect
2357 3.3.3 / 2013-07-04
2358 ==================
2360  * update connect
2362 3.3.2 / 2013-07-03
2363 ==================
2365  * update connect
2366  * update send
2367  * remove .version export
2369 3.3.1 / 2013-06-27
2370 ==================
2372  * update connect
2374 3.3.0 / 2013-06-26
2375 ==================
2377  * update connect
2378  * add support for multiple X-Forwarded-Proto values. Closes #1646
2379  * change: remove charset from json responses. Closes #1631
2380  * change: return actual booleans from req.accept* functions
2381  * fix jsonp callback array throw
2383 3.2.6 / 2013-06-02
2384 ==================
2386  * update connect
2388 3.2.5 / 2013-05-21
2389 ==================
2391  * update connect
2392  * update node-cookie
2393  * add: throw a meaningful error when there is no default engine
2394  * change generation of ETags with res.send() to GET requests only. Closes #1619
2396 3.2.4 / 2013-05-09
2397 ==================
2399   * fix `req.subdomains` when no Host is present
2400   * fix `req.host` when no Host is present, return undefined
2402 3.2.3 / 2013-05-07
2403 ==================
2405   * update connect / qs
2407 3.2.2 / 2013-05-03
2408 ==================
2410   * update qs
2412 3.2.1 / 2013-04-29
2413 ==================
2415   * add app.VERB() paths array deprecation warning
2416   * update connect
2417   * update qs and remove all ~ semver crap
2418   * fix: accept number as value of Signed Cookie
2420 3.2.0 / 2013-04-15
2421 ==================
2423   * add "view" constructor setting to override view behaviour
2424   * add req.acceptsEncoding(name)
2425   * add req.acceptedEncodings
2426   * revert cookie signature change causing session race conditions
2427   * fix sorting of Accept values of the same quality
2429 3.1.2 / 2013-04-12
2430 ==================
2432   * add support for custom Accept parameters
2433   * update cookie-signature
2435 3.1.1 / 2013-04-01
2436 ==================
2438   * add X-Forwarded-Host support to `req.host`
2439   * fix relative redirects
2440   * update mkdirp
2441   * update buffer-crc32
2442   * remove legacy app.configure() method from app template.
2444 3.1.0 / 2013-01-25
2445 ==================
2447   * add support for leading "." in "view engine" setting
2448   * add array support to `res.set()`
2449   * add node 0.8.x to travis.yml
2450   * add "subdomain offset" setting for tweaking `req.subdomains`
2451   * add `res.location(url)` implementing `res.redirect()`-like setting of Location
2452   * use app.get() for x-powered-by setting for inheritance
2453   * fix colons in passwords for `req.auth`
2455 3.0.6 / 2013-01-04
2456 ==================
2458   * add http verb methods to Router
2459   * update connect
2460   * fix mangling of the `res.cookie()` options object
2461   * fix jsonp whitespace escape. Closes #1132
2463 3.0.5 / 2012-12-19
2464 ==================
2466   * add throwing when a non-function is passed to a route
2467   * fix: explicitly remove Transfer-Encoding header from 204 and 304 responses
2468   * revert "add 'etag' option"
2470 3.0.4 / 2012-12-05
2471 ==================
2473   * add 'etag' option to disable `res.send()` Etags
2474   * add escaping of urls in text/plain in `res.redirect()`
2475     for old browsers interpreting as html
2476   * change crc32 module for a more liberal license
2477   * update connect
2479 3.0.3 / 2012-11-13
2480 ==================
2482   * update connect
2483   * update cookie module
2484   * fix cookie max-age
2486 3.0.2 / 2012-11-08
2487 ==================
2489   * add OPTIONS to cors example. Closes #1398
2490   * fix route chaining regression. Closes #1397
2492 3.0.1 / 2012-11-01
2493 ==================
2495   * update connect
2497 3.0.0 / 2012-10-23
2498 ==================
2500   * add `make clean`
2501   * add "Basic" check to req.auth
2502   * add `req.auth` test coverage
2503   * add cb && cb(payload) to `res.jsonp()`. Closes #1374
2504   * add backwards compat for `res.redirect()` status. Closes #1336
2505   * add support for `res.json()` to retain previously defined Content-Types. Closes #1349
2506   * update connect
2507   * change `res.redirect()` to utilize a pathname-relative Location again. Closes #1382
2508   * remove non-primitive string support for `res.send()`
2509   * fix view-locals example. Closes #1370
2510   * fix route-separation example
2512 3.0.0rc5 / 2012-09-18
2513 ==================
2515   * update connect
2516   * add redis search example
2517   * add static-files example
2518   * add "x-powered-by" setting (`app.disable('x-powered-by')`)
2519   * add "application/octet-stream" redirect Accept test case. Closes #1317
2521 3.0.0rc4 / 2012-08-30
2522 ==================
2524   * add `res.jsonp()`. Closes #1307
2525   * add "verbose errors" option to error-pages example
2526   * add another route example to express(1) so people are not so confused
2527   * add redis online user activity tracking example
2528   * update connect dep
2529   * fix etag quoting. Closes #1310
2530   * fix error-pages 404 status
2531   * fix jsonp callback char restrictions
2532   * remove old OPTIONS default response
2534 3.0.0rc3 / 2012-08-13
2535 ==================
2537   * update connect dep
2538   * fix signed cookies to work with `connect.cookieParser()` ("s:" prefix was missing) [tnydwrds]
2539   * fix `res.render()` clobbering of "locals"
2541 3.0.0rc2 / 2012-08-03
2542 ==================
2544   * add CORS example
2545   * update connect dep
2546   * deprecate `.createServer()` & remove old stale examples
2547   * fix: escape `res.redirect()` link
2548   * fix vhost example
2550 3.0.0rc1 / 2012-07-24
2551 ==================
2553   * add more examples to view-locals
2554   * add scheme-relative redirects (`res.redirect("//foo.com")`) support
2555   * update cookie dep
2556   * update connect dep
2557   * update send dep
2558   * fix `express(1)` -h flag, use -H for hogan. Closes #1245
2559   * fix `res.sendfile()` socket error handling regression
2561 3.0.0beta7 / 2012-07-16
2562 ==================
2564   * update connect dep for `send()` root normalization regression
2566 3.0.0beta6 / 2012-07-13
2567 ==================
2569   * add `err.view` property for view errors. Closes #1226
2570   * add "jsonp callback name" setting
2571   * add support for "/foo/:bar*" non-greedy matches
2572   * change `res.sendfile()` to use `send()` module
2573   * change `res.send` to use "response-send" module
2574   * remove `app.locals.use` and `res.locals.use`, use regular middleware
2576 3.0.0beta5 / 2012-07-03
2577 ==================
2579   * add "make check" support
2580   * add route-map example
2581   * add `res.json(obj, status)` support back for BC
2582   * add "methods" dep, remove internal methods module
2583   * update connect dep
2584   * update auth example to utilize cores pbkdf2
2585   * updated tests to use "supertest"
2587 3.0.0beta4 / 2012-06-25
2588 ==================
2590   * Added `req.auth`
2591   * Added `req.range(size)`
2592   * Added `res.links(obj)`
2593   * Added `res.send(body, status)` support back for backwards compat
2594   * Added `.default()` support to `res.format()`
2595   * Added 2xx / 304 check to `req.fresh`
2596   * Revert "Added + support to the router"
2597   * Fixed `res.send()` freshness check, respect res.statusCode
2599 3.0.0beta3 / 2012-06-15
2600 ==================
2602   * Added hogan `--hjs` to express(1) [nullfirm]
2603   * Added another example to content-negotiation
2604   * Added `fresh` dep
2605   * Changed: `res.send()` always checks freshness
2606   * Fixed: expose connects mime module. Closes #1165
2608 3.0.0beta2 / 2012-06-06
2609 ==================
2611   * Added `+` support to the router
2612   * Added `req.host`
2613   * Changed `req.param()` to check route first
2614   * Update connect dep
2616 3.0.0beta1 / 2012-06-01
2617 ==================
2619   * Added `res.format()` callback to override default 406 behaviour
2620   * Fixed `res.redirect()` 406. Closes #1154
2622 3.0.0alpha5 / 2012-05-30
2623 ==================
2625   * Added `req.ip`
2626   * Added `{ signed: true }` option to `res.cookie()`
2627   * Removed `res.signedCookie()`
2628   * Changed: dont reverse `req.ips`
2629   * Fixed "trust proxy" setting check for `req.ips`
2631 3.0.0alpha4 / 2012-05-09
2632 ==================
2634   * Added: allow `[]` in jsonp callback. Closes #1128
2635   * Added `PORT` env var support in generated template. Closes #1118 [benatkin]
2636   * Updated: connect 2.2.2
2638 3.0.0alpha3 / 2012-05-04
2639 ==================
2641   * Added public `app.routes`. Closes #887
2642   * Added _view-locals_ example
2643   * Added _mvc_ example
2644   * Added `res.locals.use()`. Closes #1120
2645   * Added conditional-GET support to `res.send()`
2646   * Added: coerce `res.set()` values to strings
2647   * Changed: moved `static()` in generated apps below router
2648   * Changed: `res.send()` only set ETag when not previously set
2649   * Changed connect 2.2.1 dep
2650   * Changed: `make test` now runs unit / acceptance tests
2651   * Fixed req/res proto inheritance
2653 3.0.0alpha2 / 2012-04-26
2654 ==================
2656   * Added `make benchmark` back
2657   * Added `res.send()` support for `String` objects
2658   * Added client-side data exposing example
2659   * Added `res.header()` and `req.header()` aliases for BC
2660   * Added `express.createServer()` for BC
2661   * Perf: memoize parsed urls
2662   * Perf: connect 2.2.0 dep
2663   * Changed: make `expressInit()` middleware self-aware
2664   * Fixed: use app.get() for all core settings
2665   * Fixed redis session example
2666   * Fixed session example. Closes #1105
2667   * Fixed generated express dep. Closes #1078
2669 3.0.0alpha1 / 2012-04-15
2670 ==================
2672   * Added `app.locals.use(callback)`
2673   * Added `app.locals` object
2674   * Added `app.locals(obj)`
2675   * Added `res.locals` object
2676   * Added `res.locals(obj)`
2677   * Added `res.format()` for content-negotiation
2678   * Added `app.engine()`
2679   * Added `res.cookie()` JSON cookie support
2680   * Added "trust proxy" setting
2681   * Added `req.subdomains`
2682   * Added `req.protocol`
2683   * Added `req.secure`
2684   * Added `req.path`
2685   * Added `req.ips`
2686   * Added `req.fresh`
2687   * Added `req.stale`
2688   * Added comma-delimited / array support for `req.accepts()`
2689   * Added debug instrumentation
2690   * Added `res.set(obj)`
2691   * Added `res.set(field, value)`
2692   * Added `res.get(field)`
2693   * Added `app.get(setting)`. Closes #842
2694   * Added `req.acceptsLanguage()`
2695   * Added `req.acceptsCharset()`
2696   * Added `req.accepted`
2697   * Added `req.acceptedLanguages`
2698   * Added `req.acceptedCharsets`
2699   * Added "json replacer" setting
2700   * Added "json spaces" setting
2701   * Added X-Forwarded-Proto support to `res.redirect()`. Closes #92
2702   * Added `--less` support to express(1)
2703   * Added `express.response` prototype
2704   * Added `express.request` prototype
2705   * Added `express.application` prototype
2706   * Added `app.path()`
2707   * Added `app.render()`
2708   * Added `res.type()` to replace `res.contentType()`
2709   * Changed: `res.redirect()` to add relative support
2710   * Changed: enable "jsonp callback" by default
2711   * Changed: renamed "case sensitive routes" to "case sensitive routing"
2712   * Rewrite of all tests with mocha
2713   * Removed "root" setting
2714   * Removed `res.redirect('home')` support
2715   * Removed `req.notify()`
2716   * Removed `app.register()`
2717   * Removed `app.redirect()`
2718   * Removed `app.is()`
2719   * Removed `app.helpers()`
2720   * Removed `app.dynamicHelpers()`
2721   * Fixed `res.sendfile()` with non-GET. Closes #723
2722   * Fixed express(1) public dir for windows. Closes #866
2724 2.5.9/ 2012-04-02
2725 ==================
2727   * Added support for PURGE request method [pbuyle]
2728   * Fixed `express(1)` generated app `app.address()` before `listening` [mmalecki]
2730 2.5.8 / 2012-02-08
2731 ==================
2733   * Update mkdirp dep. Closes #991
2735 2.5.7 / 2012-02-06
2736 ==================
2738   * Fixed `app.all` duplicate DELETE requests [mscdex]
2740 2.5.6 / 2012-01-13
2741 ==================
2743   * Updated hamljs dev dep. Closes #953
2745 2.5.5 / 2012-01-08
2746 ==================
2748   * Fixed: set `filename` on cached templates [matthewleon]
2750 2.5.4 / 2012-01-02
2751 ==================
2753   * Fixed `express(1)` eol on 0.4.x. Closes #947
2755 2.5.3 / 2011-12-30
2756 ==================
2758   * Fixed `req.is()` when a charset is present
2760 2.5.2 / 2011-12-10
2761 ==================
2763   * Fixed: express(1) LF -> CRLF for windows
2765 2.5.1 / 2011-11-17
2766 ==================
2768   * Changed: updated connect to 1.8.x
2769   * Removed sass.js support from express(1)
2771 2.5.0 / 2011-10-24
2772 ==================
2774   * Added ./routes dir for generated app by default
2775   * Added npm install reminder to express(1) app gen
2776   * Added 0.5.x support
2777   * Removed `make test-cov` since it wont work with node 0.5.x
2778   * Fixed express(1) public dir for windows. Closes #866
2780 2.4.7 / 2011-10-05
2781 ==================
2783   * Added mkdirp to express(1). Closes #795
2784   * Added simple _json-config_ example
2785   * Added  shorthand for the parsed request's pathname via `req.path`
2786   * Changed connect dep to 1.7.x to fix npm issue...
2787   * Fixed `res.redirect()` __HEAD__ support. [reported by xerox]
2788   * Fixed `req.flash()`, only escape args
2789   * Fixed absolute path checking on windows. Closes #829 [reported by andrewpmckenzie]
2791 2.4.6 / 2011-08-22
2792 ==================
2794   * Fixed multiple param callback regression. Closes #824 [reported by TroyGoode]
2796 2.4.5 / 2011-08-19
2797 ==================
2799   * Added support for routes to handle errors. Closes #809
2800   * Added `app.routes.all()`. Closes #803
2801   * Added "basepath" setting to work in conjunction with reverse proxies etc.
2802   * Refactored `Route` to use a single array of callbacks
2803   * Added support for multiple callbacks for `app.param()`. Closes #801
2804 Closes #805
2805   * Changed: removed .call(self) for route callbacks
2806   * Dependency: `qs >= 0.3.1`
2807   * Fixed `res.redirect()` on windows due to `join()` usage. Closes #808
2809 2.4.4 / 2011-08-05
2810 ==================
2812   * Fixed `res.header()` intention of a set, even when `undefined`
2813   * Fixed `*`, value no longer required
2814   * Fixed `res.send(204)` support. Closes #771
2816 2.4.3 / 2011-07-14
2817 ==================
2819   * Added docs for `status` option special-case. Closes #739
2820   * Fixed `options.filename`, exposing the view path to template engines
2822 2.4.2. / 2011-07-06
2823 ==================
2825   * Revert "removed jsonp stripping" for XSS
2827 2.4.1 / 2011-07-06
2828 ==================
2830   * Added `res.json()` JSONP support. Closes #737
2831   * Added _extending-templates_ example. Closes #730
2832   * Added "strict routing" setting for trailing slashes
2833   * Added support for multiple envs in `app.configure()` calls. Closes #735
2834   * Changed: `res.send()` using `res.json()`
2835   * Changed: when cookie `path === null` don't default it
2836   * Changed; default cookie path to "home" setting. Closes #731
2837   * Removed _pids/logs_ creation from express(1)
2839 2.4.0 / 2011-06-28
2840 ==================
2842   * Added chainable `res.status(code)`
2843   * Added `res.json()`, an explicit version of `res.send(obj)`
2844   * Added simple web-service example
2846 2.3.12 / 2011-06-22
2847 ==================
2849   * \#express is now on freenode! come join!
2850   * Added `req.get(field, param)`
2851   * Added links to Japanese documentation, thanks @hideyukisaito!
2852   * Added; the `express(1)` generated app outputs the env
2853   * Added `content-negotiation` example
2854   * Dependency: connect >= 1.5.1 < 2.0.0
2855   * Fixed view layout bug. Closes #720
2856   * Fixed; ignore body on 304. Closes #701
2858 2.3.11 / 2011-06-04
2859 ==================
2861   * Added `npm test`
2862   * Removed generation of dummy test file from `express(1)`
2863   * Fixed; `express(1)` adds express as a dep
2864   * Fixed; prune on `prepublish`
2866 2.3.10 / 2011-05-27
2867 ==================
2869   * Added `req.route`, exposing the current route
2870   * Added _package.json_ generation support to `express(1)`
2871   * Fixed call to `app.param()` function for optional params. Closes #682
2873 2.3.9 / 2011-05-25
2874 ==================
2876   * Fixed bug-ish with `../' in `res.partial()` calls
2878 2.3.8 / 2011-05-24
2879 ==================
2881   * Fixed `app.options()`
2883 2.3.7 / 2011-05-23
2884 ==================
2886   * Added route `Collection`, ex: `app.get('/user/:id').remove();`
2887   * Added support for `app.param(fn)` to define param logic
2888   * Removed `app.param()` support for callback with return value
2889   * Removed module.parent check from express(1) generated app. Closes #670
2890   * Refactored router. Closes #639
2892 2.3.6 / 2011-05-20
2893 ==================
2895   * Changed; using devDependencies instead of git submodules
2896   * Fixed redis session example
2897   * Fixed markdown example
2898   * Fixed view caching, should not be enabled in development
2900 2.3.5 / 2011-05-20
2901 ==================
2903   * Added export `.view` as alias for `.View`
2905 2.3.4 / 2011-05-08
2906 ==================
2908   * Added `./examples/say`
2909   * Fixed `res.sendfile()` bug preventing the transfer of files with spaces
2911 2.3.3 / 2011-05-03
2912 ==================
2914   * Added "case sensitive routes" option.
2915   * Changed; split methods supported per rfc [slaskis]
2916   * Fixed route-specific middleware when using the same callback function several times
2918 2.3.2 / 2011-04-27
2919 ==================
2921   * Fixed view hints
2923 2.3.1 / 2011-04-26
2924 ==================
2926   * Added `app.match()` as `app.match.all()`
2927   * Added `app.lookup()` as `app.lookup.all()`
2928   * Added `app.remove()` for `app.remove.all()`
2929   * Added `app.remove.VERB()`
2930   * Fixed template caching collision issue. Closes #644
2931   * Moved router over from connect and started refactor
2933 2.3.0 / 2011-04-25
2934 ==================
2936   * Added options support to `res.clearCookie()`
2937   * Added `res.helpers()` as alias of `res.locals()`
2938   * Added; json defaults to UTF-8 with `res.send()`. Closes #632. [Daniel   * Dependency `connect >= 1.4.0`
2939   * Changed; auto set Content-Type in res.attachement [Aaron Heckmann]
2940   * Renamed "cache views" to "view cache". Closes #628
2941   * Fixed caching of views when using several apps. Closes #637
2942   * Fixed gotcha invoking `app.param()` callbacks once per route middleware.
2943 Closes #638
2944   * Fixed partial lookup precedence. Closes #631
2945 Shaw]
2947 2.2.2 / 2011-04-12
2948 ==================
2950   * Added second callback support for `res.download()` connection errors
2951   * Fixed `filename` option passing to template engine
2953 2.2.1 / 2011-04-04
2954 ==================
2956   * Added `layout(path)` helper to change the layout within a view. Closes #610
2957   * Fixed `partial()` collection object support.
2958     Previously only anything with `.length` would work.
2959     When `.length` is present one must still be aware of holes,
2960     however now `{ collection: {foo: 'bar'}}` is valid, exposes
2961     `keyInCollection` and `keysInCollection`.
2963   * Performance improved with better view caching
2964   * Removed `request` and `response` locals
2965   * Changed; errorHandler page title is now `Express` instead of `Connect`
2967 2.2.0 / 2011-03-30
2968 ==================
2970   * Added `app.lookup.VERB()`, ex `app.lookup.put('/user/:id')`. Closes #606
2971   * Added `app.match.VERB()`, ex `app.match.put('/user/12')`. Closes #606
2972   * Added `app.VERB(path)` as alias of `app.lookup.VERB()`.
2973   * Dependency `connect >= 1.2.0`
2975 2.1.1 / 2011-03-29
2976 ==================
2978   * Added; expose `err.view` object when failing to locate a view
2979   * Fixed `res.partial()` call `next(err)` when no callback is given [reported by aheckmann]
2980   * Fixed; `res.send(undefined)` responds with 204 [aheckmann]
2982 2.1.0 / 2011-03-24
2983 ==================
2985   * Added `<root>/_?<name>` partial lookup support. Closes #447
2986   * Added `request`, `response`, and `app` local variables
2987   * Added `settings` local variable, containing the app's settings
2988   * Added `req.flash()` exception if `req.session` is not available
2989   * Added `res.send(bool)` support (json response)
2990   * Fixed stylus example for latest version
2991   * Fixed; wrap try/catch around `res.render()`
2993 2.0.0 / 2011-03-17
2994 ==================
2996   * Fixed up index view path alternative.
2997   * Changed; `res.locals()` without object returns the locals
2999 2.0.0rc3 / 2011-03-17
3000 ==================
3002   * Added `res.locals(obj)` to compliment `res.local(key, val)`
3003   * Added `res.partial()` callback support
3004   * Fixed recursive error reporting issue in `res.render()`
3006 2.0.0rc2 / 2011-03-17
3007 ==================
3009   * Changed; `partial()` "locals" are now optional
3010   * Fixed `SlowBuffer` support. Closes #584 [reported by tyrda01]
3011   * Fixed .filename view engine option [reported by drudge]
3012   * Fixed blog example
3013   * Fixed `{req,res}.app` reference when mounting [Ben Weaver]
3015 2.0.0rc / 2011-03-14
3016 ==================
3018   * Fixed; expose `HTTPSServer` constructor
3019   * Fixed express(1) default test charset. Closes #579 [reported by secoif]
3020   * Fixed; default charset to utf-8 instead of utf8 for lame IE [reported by NickP]
3022 2.0.0beta3 / 2011-03-09
3023 ==================
3025   * Added support for `res.contentType()` literal
3026     The original `res.contentType('.json')`,
3027     `res.contentType('application/json')`, and `res.contentType('json')`
3028     will work now.
3029   * Added `res.render()` status option support back
3030   * Added charset option for `res.render()`
3031   * Added `.charset` support (via connect 1.0.4)
3032   * Added view resolution hints when in development and a lookup fails
3033   * Added layout lookup support relative to the page view.
3034     For example while rendering `./views/user/index.jade` if you create
3035     `./views/user/layout.jade` it will be used in favour of the root layout.
3036   * Fixed `res.redirect()`. RFC states absolute url [reported by unlink]
3037   * Fixed; default `res.send()` string charset to utf8
3038   * Removed `Partial` constructor (not currently used)
3040 2.0.0beta2 / 2011-03-07
3041 ==================
3043   * Added res.render() `.locals` support back to aid in migration process
3044   * Fixed flash example
3046 2.0.0beta / 2011-03-03
3047 ==================
3049   * Added HTTPS support
3050   * Added `res.cookie()` maxAge support
3051   * Added `req.header()` _Referrer_ / _Referer_ special-case, either works
3052   * Added mount support for `res.redirect()`, now respects the mount-point
3053   * Added `union()` util, taking place of `merge(clone())` combo
3054   * Added stylus support to express(1) generated app
3055   * Added secret to session middleware used in examples and generated app
3056   * Added `res.local(name, val)` for progressive view locals
3057   * Added default param support to `req.param(name, default)`
3058   * Added `app.disabled()` and `app.enabled()`
3059   * Added `app.register()` support for omitting leading ".", either works
3060   * Added `res.partial()`, using the same interface as `partial()` within a view. Closes #539
3061   * Added `app.param()` to map route params to async/sync logic
3062   * Added; aliased `app.helpers()` as `app.locals()`. Closes #481
3063   * Added extname with no leading "." support to `res.contentType()`
3064   * Added `cache views` setting, defaulting to enabled in "production" env
3065   * Added index file partial resolution, eg: partial('user') may try _views/user/index.jade_.
3066   * Added `req.accepts()` support for extensions
3067   * Changed; `res.download()` and `res.sendfile()` now utilize Connect's
3068     static file server `connect.static.send()`.
3069   * Changed; replaced `connect.utils.mime()` with npm _mime_ module
3070   * Changed; allow `req.query` to be pre-defined (via middleware or other parent
3071   * Changed view partial resolution, now relative to parent view
3072   * Changed view engine signature. no longer `engine.render(str, options, callback)`, now `engine.compile(str, options) -> Function`, the returned function accepts `fn(locals)`.
3073   * Fixed `req.param()` bug returning Array.prototype methods. Closes #552
3074   * Fixed; using `Stream#pipe()` instead of `sys.pump()` in `res.sendfile()`
3075   * Fixed; using _qs_ module instead of _querystring_
3076   * Fixed; strip unsafe chars from jsonp callbacks
3077   * Removed "stream threshold" setting
3079 1.0.8 / 2011-03-01
3080 ==================
3082   * Allow `req.query` to be pre-defined (via middleware or other parent app)
3083   * "connect": ">= 0.5.0 < 1.0.0". Closes #547
3084   * Removed the long deprecated __EXPRESS_ENV__ support
3086 1.0.7 / 2011-02-07
3087 ==================
3089   * Fixed `render()` setting inheritance.
3090     Mounted apps would not inherit "view engine"
3092 1.0.6 / 2011-02-07
3093 ==================
3095   * Fixed `view engine` setting bug when period is in dirname
3097 1.0.5 / 2011-02-05
3098 ==================
3100   * Added secret to generated app `session()` call
3102 1.0.4 / 2011-02-05
3103 ==================
3105   * Added `qs` dependency to _package.json_
3106   * Fixed namespaced `require()`s for latest connect support
3108 1.0.3 / 2011-01-13
3109 ==================
3111   * Remove unsafe characters from JSONP callback names [Ryan Grove]
3113 1.0.2 / 2011-01-10
3114 ==================
3116   * Removed nested require, using `connect.router`
3118 1.0.1 / 2010-12-29
3119 ==================
3121   * Fixed for middleware stacked via `createServer()`
3122     previously the `foo` middleware passed to `createServer(foo)`
3123     would not have access to Express methods such as `res.send()`
3124     or props like `req.query` etc.
3126 1.0.0 / 2010-11-16
3127 ==================
3129   * Added; deduce partial object names from the last segment.
3130     For example by default `partial('forum/post', postObject)` will
3131     give you the _post_ object, providing a meaningful default.
3132   * Added http status code string representation to `res.redirect()` body
3133   * Added; `res.redirect()` supporting _text/plain_ and _text/html_ via __Accept__.
3134   * Added `req.is()` to aid in content negotiation
3135   * Added partial local inheritance [suggested by masylum]. Closes #102
3136     providing access to parent template locals.
3137   * Added _-s, --session[s]_ flag to express(1) to add session related middleware
3138   * Added _--template_ flag to express(1) to specify the
3139     template engine to use.
3140   * Added _--css_ flag to express(1) to specify the
3141     stylesheet engine to use (or just plain css by default).
3142   * Added `app.all()` support [thanks aheckmann]
3143   * Added partial direct object support.
3144     You may now `partial('user', user)` providing the "user" local,
3145     vs previously `partial('user', { object: user })`.
3146   * Added _route-separation_ example since many people question ways
3147     to do this with CommonJS modules. Also view the _blog_ example for
3148     an alternative.
3149   * Performance; caching view path derived partial object names
3150   * Fixed partial local inheritance precedence. [reported by Nick Poulden] Closes #454
3151   * Fixed jsonp support; _text/javascript_ as per mailinglist discussion
3153 1.0.0rc4 / 2010-10-14
3154 ==================
3156   * Added _NODE_ENV_ support, _EXPRESS_ENV_ is deprecated and will be removed in 1.0.0
3157   * Added route-middleware support (very helpful, see the [docs](http://expressjs.com/guide.html#Route-Middleware))
3158   * Added _jsonp callback_ setting to enable/disable jsonp autowrapping [Dav Glass]
3159   * Added callback query check on response.send to autowrap JSON objects for simple webservice implementations [Dav Glass]
3160   * Added `partial()` support for array-like collections. Closes #434
3161   * Added support for swappable querystring parsers
3162   * Added session usage docs. Closes #443
3163   * Added dynamic helper caching. Closes #439 [suggested by maritz]
3164   * Added authentication example
3165   * Added basic Range support to `res.sendfile()` (and `res.download()` etc)
3166   * Changed; `express(1)` generated app using 2 spaces instead of 4
3167   * Default env to "development" again [aheckmann]
3168   * Removed _context_ option is no more, use "scope"
3169   * Fixed; exposing _./support_ libs to examples so they can run without installs
3170   * Fixed mvc example
3172 1.0.0rc3 / 2010-09-20
3173 ==================
3175   * Added confirmation for `express(1)` app generation. Closes #391
3176   * Added extending of flash formatters via `app.flashFormatters`
3177   * Added flash formatter support. Closes #411
3178   * Added streaming support to `res.sendfile()` using `sys.pump()` when >= "stream threshold"
3179   * Added _stream threshold_ setting for `res.sendfile()`
3180   * Added `res.send()` __HEAD__ support
3181   * Added `res.clearCookie()`
3182   * Added `res.cookie()`
3183   * Added `res.render()` headers option
3184   * Added `res.redirect()` response bodies
3185   * Added `res.render()` status option support. Closes #425 [thanks aheckmann]
3186   * Fixed `res.sendfile()` responding with 403 on malicious path
3187   * Fixed `res.download()` bug; when an error occurs remove _Content-Disposition_
3188   * Fixed; mounted apps settings now inherit from parent app [aheckmann]
3189   * Fixed; stripping Content-Length / Content-Type when 204
3190   * Fixed `res.send()` 204. Closes #419
3191   * Fixed multiple _Set-Cookie_ headers via `res.header()`. Closes #402
3192   * Fixed bug messing with error handlers when `listenFD()` is called instead of `listen()`. [thanks guillermo]
3195 1.0.0rc2 / 2010-08-17
3196 ==================
3198   * Added `app.register()` for template engine mapping. Closes #390
3199   * Added `res.render()` callback support as second argument (no options)
3200   * Added callback support to `res.download()`
3201   * Added callback support for `res.sendfile()`
3202   * Added support for middleware access via `express.middlewareName()` vs `connect.middlewareName()`
3203   * Added "partials" setting to docs
3204   * Added default expresso tests to `express(1)` generated app. Closes #384
3205   * Fixed `res.sendfile()` error handling, defer via `next()`
3206   * Fixed `res.render()` callback when a layout is used [thanks guillermo]
3207   * Fixed; `make install` creating ~/.node_libraries when not present
3208   * Fixed issue preventing error handlers from being defined anywhere. Closes #387
3210 1.0.0rc / 2010-07-28
3211 ==================
3213   * Added mounted hook. Closes #369
3214   * Added connect dependency to _package.json_
3216   * Removed "reload views" setting and support code
3217     development env never caches, production always caches.
3219   * Removed _param_ in route callbacks, signature is now
3220     simply (req, res, next), previously (req, res, params, next).
3221     Use _req.params_ for path captures, _req.query_ for GET params.
3223   * Fixed "home" setting
3224   * Fixed middleware/router precedence issue. Closes #366
3225   * Fixed; _configure()_ callbacks called immediately. Closes #368
3227 1.0.0beta2 / 2010-07-23
3228 ==================
3230   * Added more examples
3231   * Added; exporting `Server` constructor
3232   * Added `Server#helpers()` for view locals
3233   * Added `Server#dynamicHelpers()` for dynamic view locals. Closes #349
3234   * Added support for absolute view paths
3235   * Added; _home_ setting defaults to `Server#route` for mounted apps. Closes #363
3236   * Added Guillermo Rauch to the contributor list
3237   * Added support for "as" for non-collection partials. Closes #341
3238   * Fixed _install.sh_, ensuring _~/.node_libraries_ exists. Closes #362 [thanks jf]
3239   * Fixed `res.render()` exceptions, now passed to `next()` when no callback is given [thanks guillermo]
3240   * Fixed instanceof `Array` checks, now `Array.isArray()`
3241   * Fixed express(1) expansion of public dirs. Closes #348
3242   * Fixed middleware precedence. Closes #345
3243   * Fixed view watcher, now async [thanks aheckmann]
3245 1.0.0beta / 2010-07-15
3246 ==================
3248   * Re-write
3249     - much faster
3250     - much lighter
3251     - Check [ExpressJS.com](http://expressjs.com) for migration guide and updated docs
3253 0.14.0 / 2010-06-15
3254 ==================
3256   * Utilize relative requires
3257   * Added Static bufferSize option [aheckmann]
3258   * Fixed caching of view and partial subdirectories [aheckmann]
3259   * Fixed mime.type() comments now that ".ext" is not supported
3260   * Updated haml submodule
3261   * Updated class submodule
3262   * Removed bin/express
3264 0.13.0 / 2010-06-01
3265 ==================
3267   * Added node v0.1.97 compatibility
3268   * Added support for deleting cookies via Request#cookie('key', null)
3269   * Updated haml submodule
3270   * Fixed not-found page, now using using charset utf-8
3271   * Fixed show-exceptions page, now using using charset utf-8
3272   * Fixed view support due to fs.readFile Buffers
3273   * Changed; mime.type() no longer accepts ".type" due to node extname() changes
3275 0.12.0 / 2010-05-22
3276 ==================
3278   * Added node v0.1.96 compatibility
3279   * Added view `helpers` export which act as additional local variables
3280   * Updated haml submodule
3281   * Changed ETag; removed inode, modified time only
3282   * Fixed LF to CRLF for setting multiple cookies
3283   * Fixed cookie compilation; values are now urlencoded
3284   * Fixed cookies parsing; accepts quoted values and url escaped cookies
3286 0.11.0 / 2010-05-06
3287 ==================
3289   * Added support for layouts using different engines
3290     - this.render('page.html.haml', { layout: 'super-cool-layout.html.ejs' })
3291     - this.render('page.html.haml', { layout: 'foo' }) // assumes 'foo.html.haml'
3292     - this.render('page.html.haml', { layout: false }) // no layout
3293   * Updated ext submodule
3294   * Updated haml submodule
3295   * Fixed EJS partial support by passing along the context. Issue #307
3297 0.10.1 / 2010-05-03
3298 ==================
3300   * Fixed binary uploads.
3302 0.10.0 / 2010-04-30
3303 ==================
3305   * Added charset support via Request#charset (automatically assigned to 'UTF-8' when respond()'s
3306     encoding is set to 'utf8' or 'utf-8'.
3307   * Added "encoding" option to Request#render(). Closes #299
3308   * Added "dump exceptions" setting, which is enabled by default.
3309   * Added simple ejs template engine support
3310   * Added error response support for text/plain, application/json. Closes #297
3311   * Added callback function param to Request#error()
3312   * Added Request#sendHead()
3313   * Added Request#stream()
3314   * Added support for Request#respond(304, null) for empty response bodies
3315   * Added ETag support to Request#sendfile()
3316   * Added options to Request#sendfile(), passed to fs.createReadStream()
3317   * Added filename arg to Request#download()
3318   * Performance enhanced due to pre-reversing plugins so that plugins.reverse() is not called on each request
3319   * Performance enhanced by preventing several calls to toLowerCase() in Router#match()
3320   * Changed; Request#sendfile() now streams
3321   * Changed; Renamed Request#halt() to Request#respond(). Closes #289
3322   * Changed; Using sys.inspect() instead of JSON.encode() for error output
3323   * Changed; run() returns the http.Server instance. Closes #298
3324   * Changed; Defaulting Server#host to null (INADDR_ANY)
3325   * Changed; Logger "common" format scale of 0.4f
3326   * Removed Logger "request" format
3327   * Fixed; Catching ENOENT in view caching, preventing error when "views/partials" is not found
3328   * Fixed several issues with http client
3329   * Fixed Logger Content-Length output
3330   * Fixed bug preventing Opera from retaining the generated session id. Closes #292
3332 0.9.0 / 2010-04-14
3333 ==================
3335   * Added DSL level error() route support
3336   * Added DSL level notFound() route support
3337   * Added Request#error()
3338   * Added Request#notFound()
3339   * Added Request#render() callback function. Closes #258
3340   * Added "max upload size" setting
3341   * Added "magic" variables to collection partials (\_\_index\_\_, \_\_length\_\_, \_\_isFirst\_\_, \_\_isLast\_\_). Closes #254
3342   * Added [haml.js](http://github.com/visionmedia/haml.js) submodule; removed haml-js
3343   * Added callback function support to Request#halt() as 3rd/4th arg
3344   * Added preprocessing of route param wildcards using param(). Closes #251
3345   * Added view partial support (with collections etc)
3346   * Fixed bug preventing falsey params (such as ?page=0). Closes #286
3347   * Fixed setting of multiple cookies. Closes #199
3348   * Changed; view naming convention is now NAME.TYPE.ENGINE (for example page.html.haml)
3349   * Changed; session cookie is now httpOnly
3350   * Changed; Request is no longer global
3351   * Changed; Event is no longer global
3352   * Changed; "sys" module is no longer global
3353   * Changed; moved Request#download to Static plugin where it belongs
3354   * Changed; Request instance created before body parsing. Closes #262
3355   * Changed; Pre-caching views in memory when "cache view contents" is enabled. Closes #253
3356   * Changed; Pre-caching view partials in memory when "cache view partials" is enabled
3357   * Updated support to node --version 0.1.90
3358   * Updated dependencies
3359   * Removed set("session cookie") in favour of use(Session, { cookie: { ... }})
3360   * Removed utils.mixin(); use Object#mergeDeep()
3362 0.8.0 / 2010-03-19
3363 ==================
3365   * Added coffeescript example app. Closes #242
3366   * Changed; cache api now async friendly. Closes #240
3367   * Removed deprecated 'express/static' support. Use 'express/plugins/static'
3369 0.7.6 / 2010-03-19
3370 ==================
3372   * Added Request#isXHR. Closes #229
3373   * Added `make install` (for the executable)
3374   * Added `express` executable for setting up simple app templates
3375   * Added "GET /public/*" to Static plugin, defaulting to <root>/public
3376   * Added Static plugin
3377   * Fixed; Request#render() only calls cache.get() once
3378   * Fixed; Namespacing View caches with "view:"
3379   * Fixed; Namespacing Static caches with "static:"
3380   * Fixed; Both example apps now use the Static plugin
3381   * Fixed set("views"). Closes #239
3382   * Fixed missing space for combined log format
3383   * Deprecated Request#sendfile() and 'express/static'
3384   * Removed Server#running
3386 0.7.5 / 2010-03-16
3387 ==================
3389   * Added Request#flash() support without args, now returns all flashes
3390   * Updated ext submodule
3392 0.7.4 / 2010-03-16
3393 ==================
3395   * Fixed session reaper
3396   * Changed; class.js replacing js-oo Class implementation (quite a bit faster, no browser cruft)
3398 0.7.3 / 2010-03-16
3399 ==================
3401   * Added package.json
3402   * Fixed requiring of haml / sass due to kiwi removal
3404 0.7.2 / 2010-03-16
3405 ==================
3407   * Fixed GIT submodules (HAH!)
3409 0.7.1 / 2010-03-16
3410 ==================
3412   * Changed; Express now using submodules again until a PM is adopted
3413   * Changed; chat example using millisecond conversions from ext
3415 0.7.0 / 2010-03-15
3416 ==================
3418   * Added Request#pass() support (finds the next matching route, or the given path)
3419   * Added Logger plugin (default "common" format replaces CommonLogger)
3420   * Removed Profiler plugin
3421   * Removed CommonLogger plugin
3423 0.6.0 / 2010-03-11
3424 ==================
3426   * Added seed.yml for kiwi package management support
3427   * Added HTTP client query string support when method is GET. Closes #205
3429   * Added support for arbitrary view engines.
3430     For example "foo.engine.html" will now require('engine'),
3431     the exports from this module are cached after the first require().
3433   * Added async plugin support
3435   * Removed usage of RESTful route funcs as http client
3436     get() etc, use http.get() and friends
3438   * Removed custom exceptions
3440 0.5.0 / 2010-03-10
3441 ==================
3443   * Added ext dependency (library of js extensions)
3444   * Removed extname() / basename() utils. Use path module
3445   * Removed toArray() util. Use arguments.values
3446   * Removed escapeRegexp() util. Use RegExp.escape()
3447   * Removed process.mixin() dependency. Use utils.mixin()
3448   * Removed Collection
3449   * Removed ElementCollection
3450   * Shameless self promotion of ebook "Advanced JavaScript" (http://dev-mag.com)  ;)
3452 0.4.0 / 2010-02-11
3453 ==================
3455   * Added flash() example to sample upload app
3456   * Added high level restful http client module (express/http)
3457   * Changed; RESTful route functions double as HTTP clients. Closes #69
3458   * Changed; throwing error when routes are added at runtime
3459   * Changed; defaulting render() context to the current Request. Closes #197
3460   * Updated haml submodule
3462 0.3.0 / 2010-02-11
3463 ==================
3465   * Updated haml / sass submodules. Closes #200
3466   * Added flash message support. Closes #64
3467   * Added accepts() now allows multiple args. fixes #117
3468   * Added support for plugins to halt. Closes #189
3469   * Added alternate layout support. Closes #119
3470   * Removed Route#run(). Closes #188
3471   * Fixed broken specs due to use(Cookie) missing
3473 0.2.1 / 2010-02-05
3474 ==================
3476   * Added "plot" format option for Profiler (for gnuplot processing)
3477   * Added request number to Profiler plugin
3478   * Fixed binary encoding for multipart file uploads, was previously defaulting to UTF8
3479   * Fixed issue with routes not firing when not files are present. Closes #184
3480   * Fixed process.Promise -> events.Promise
3482 0.2.0 / 2010-02-03
3483 ==================
3485   * Added parseParam() support for name[] etc. (allows for file inputs with "multiple" attr) Closes #180
3486   * Added Both Cache and Session option "reapInterval" may be "reapEvery". Closes #174
3487   * Added expiration support to cache api with reaper. Closes #133
3488   * Added cache Store.Memory#reap()
3489   * Added Cache; cache api now uses first class Cache instances
3490   * Added abstract session Store. Closes #172
3491   * Changed; cache Memory.Store#get() utilizing Collection
3492   * Renamed MemoryStore -> Store.Memory
3493   * Fixed use() of the same plugin several time will always use latest options. Closes #176
3495 0.1.0 / 2010-02-03
3496 ==================
3498   * Changed; Hooks (before / after) pass request as arg as well as evaluated in their context
3499   * Updated node support to 0.1.27 Closes #169
3500   * Updated dirname(__filename) -> __dirname
3501   * Updated libxmljs support to v0.2.0
3502   * Added session support with memory store / reaping
3503   * Added quick uid() helper
3504   * Added multi-part upload support
3505   * Added Sass.js support / submodule
3506   * Added production env caching view contents and static files
3507   * Added static file caching. Closes #136
3508   * Added cache plugin with memory stores
3509   * Added support to StaticFile so that it works with non-textual files.
3510   * Removed dirname() helper
3511   * Removed several globals (now their modules must be required)
3513 0.0.2 / 2010-01-10
3514 ==================
3516   * Added view benchmarks; currently haml vs ejs
3517   * Added Request#attachment() specs. Closes #116
3518   * Added use of node's parseQuery() util. Closes #123
3519   * Added `make init` for submodules
3520   * Updated Haml
3521   * Updated sample chat app to show messages on load
3522   * Updated libxmljs parseString -> parseHtmlString
3523   * Fixed `make init` to work with older versions of git
3524   * Fixed specs can now run independent specs for those who can't build deps. Closes #127
3525   * Fixed issues introduced by the node url module changes. Closes 126.
3526   * Fixed two assertions failing due to Collection#keys() returning strings
3527   * Fixed faulty Collection#toArray() spec due to keys() returning strings
3528   * Fixed `make test` now builds libxmljs.node before testing
3530 0.0.1 / 2010-01-03
3531 ==================
3533   * Initial release