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