pax_global_header00006660000000000000000000000064124101752070014511gustar00rootroot0000000000000052 comment=ef9569319703e5fac47ce116641e12c617b8f7a5 response-time-2.2.0/000077500000000000000000000000001241017520700143045ustar00rootroot00000000000000response-time-2.2.0/.gitignore000066400000000000000000000000461241017520700162740ustar00rootroot00000000000000coverage/ node_modules/ npm-debug.log response-time-2.2.0/.travis.yml000066400000000000000000000004371241017520700164210ustar00rootroot00000000000000language: node_js node_js: - "0.8" - "0.10" - "0.11" matrix: allow_failures: - node_js: "0.11" fast_finish: true script: "npm run-script test-travis" after_script: "test $TRAVIS_NODE_VERSION = '0.10' && npm install coveralls@2.11.1 && cat ./coverage/lcov.info | coveralls" response-time-2.2.0/HISTORY.md000066400000000000000000000011131241017520700157630ustar00rootroot000000000000002.2.0 / 2014-09-22 ================== * Add `suffix` option * deps: depd@~1.0.0 2.1.0 / 2014-09-16 ================== * Add `header` option for custom header name * Change `digits` argument to an `options` argument 2.0.1 / 2014-08-10 ================== * deps: on-headers@~1.0.0 2.0.0 / 2014-05-31 ================== * add `digits` argument * do not override existing `X-Response-Time` header * timer not subject to clock drift * timer resolution down to nanoseconds * use `on-headers` module 1.0.0 / 2014-02-08 ================== * Genesis from `connect` response-time-2.2.0/LICENSE000066400000000000000000000022171241017520700153130ustar00rootroot00000000000000(The MIT License) Copyright (c) 2014 Jonathan Ong Copyright (c) 2014 Douglas Christopher Wilson Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. response-time-2.2.0/README.md000066400000000000000000000044731241017520700155730ustar00rootroot00000000000000# response-time [![NPM Version][npm-image]][npm-url] [![NPM Downloads][downloads-image]][downloads-url] [![Build Status][travis-image]][travis-url] [![Test Coverage][coveralls-image]][coveralls-url] [![Gratipay][gratipay-image]][gratipay-url] Response time header for node.js ## Installation ```sh $ npm install response-time ``` ## API ```js var responseTime = require('response-time') ``` ### responseTime(options) Returns middleware that adds a `X-Response-Time` header to responses. #### Options `responseTime` accepts these properties in the options object. ##### digits The fixed number of digits to include in the output, which is always in milliseconds, defaults to `3` (ex: `2.300ms`). ##### header The name of the header to set, defaults to `X-Response-Time`. ##### suffix Boolean to indicate if units of measurement suffix should be added to the output, defaults to `true` (ex: `2.300ms` vs `2.300`). ## Examples ### express/connect ```js var express = require('express') var responseTime = require('response-time') var app = express() app.use(responseTime()) app.get('/', function (req, res) { res.send('hello, world!') }) ``` ### vanilla http server ```js var finalhandler = require('finalhandler') var http = require('http') var responseTime = require('response-time') // create "middleware" var _responseTime = responseTime() http.createServer(function (req, res) { var done = finalhandler(req, res) _responseTime(req, res, function (err) { if (err) return done(err) // respond to request res.setHeader('content-type', 'text/plain') res.end('hello, world!') }) }) ``` ## License [MIT](LICENSE) [npm-image]: https://img.shields.io/npm/v/response-time.svg?style=flat [npm-url]: https://npmjs.org/package/response-time [travis-image]: https://img.shields.io/travis/expressjs/response-time.svg?style=flat [travis-url]: https://travis-ci.org/expressjs/response-time [coveralls-image]: https://img.shields.io/coveralls/expressjs/response-time.svg?style=flat [coveralls-url]: https://coveralls.io/r/expressjs/response-time?branch=master [downloads-image]: https://img.shields.io/npm/dm/response-time.svg?style=flat [downloads-url]: https://npmjs.org/package/response-time [gratipay-image]: https://img.shields.io/gratipay/dougwilson.svg?style=flat [gratipay-url]: https://www.gratipay.com/dougwilson/ response-time-2.2.0/index.js000066400000000000000000000027011241017520700157510ustar00rootroot00000000000000/*! * response-time * Copyright(c) 2011 TJ Holowaychuk * Copyright(c) 2014 Jonathan Ong * Copyright(c) 2014 Douglas Christopher Wilson * MIT Licensed */ /** * Module dependencies */ var deprecate = require('depd')('response-time') var onHeaders = require('on-headers') /** * Reponse time: * * Adds the `X-Response-Time` header displaying the response * duration in milliseconds. * * @param {object} [options] * @param {number} [options.digits=3] * @return {function} * @api public */ module.exports = function responseTime(options) { if (typeof options === 'number') { // back-compat single number argument deprecate('number argument: use {digits: ' + JSON.stringify(options) + '} instead') options = { digits: options } } options = options || {} // response time digits var digits = options.digits !== undefined ? options.digits : 3 // header name var header = options.header || 'X-Response-Time' // display suffix var suffix = options.suffix !== undefined ? Boolean(options.suffix) : true return function responseTime(req, res, next) { var startAt = process.hrtime() onHeaders(res, function () { if (this.getHeader(header)) { return } var diff = process.hrtime(startAt) var ms = diff[0] * 1e3 + diff[1] * 1e-6 var val = ms.toFixed(digits) if (suffix) { val += 'ms' } this.setHeader(header, val) }) next() } } response-time-2.2.0/package.json000066400000000000000000000017601241017520700165760ustar00rootroot00000000000000{ "name": "response-time", "description": "Response time header for node.js", "version": "2.2.0", "author": "Jonathan Ong (http://jongleberry.com)", "contributors": [ "Douglas Christopher Wilson " ], "license": "MIT", "keywords": [ "http", "res", "response time", "x-response-time" ], "repository": "expressjs/response-time", "dependencies": { "depd": "~1.0.0", "on-headers": "~1.0.0" }, "devDependencies": { "istanbul": "0.3.2", "mocha": "~1.21.4", "supertest": "~0.13.0" }, "files": [ "LICENSE", "HISTORY.md", "index.js" ], "engines": { "node": ">= 0.8.0" }, "scripts": { "test": "mocha --reporter spec --bail --check-leaks test/", "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --reporter dot --check-leaks test/", "test-travis": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --reporter spec --check-leaks test/" } } response-time-2.2.0/test/000077500000000000000000000000001241017520700152635ustar00rootroot00000000000000response-time-2.2.0/test/test.js000066400000000000000000000062541241017520700166070ustar00rootroot00000000000000 process.env.NO_DEPRECATION = 'response-time' var http = require('http'); var request = require('supertest'); var responseTime = require('..') describe('responseTime()', function () { it('should send X-Response-Time header', function (done) { var server = createServer() request(server) .get('/') .expect('X-Response-Time', /^[0-9\.]+ms$/, done) }) it('should not override X-Response-Time header', function (done) { var server = createServer(undefined, function(req, res) { res.setHeader('X-Response-Time', 'bogus') }) request(server) .get('/') .expect('X-Response-Time', 'bogus', done) }) describe('with "digits"', function () { it('should default to 3', function (done) { var server = createServer() request(server) .get('/') .expect('X-Response-Time', /^[0-9]+\.[0-9]{3}ms$/, done) }) it('should allow custom digits', function (done) { var server = createServer(5) request(server) .get('/') .expect('X-Response-Time', /^[0-9]+\.[0-9]{5}ms$/, done) }) it('should allow no digits', function (done) { var server = createServer(0) request(server) .get('/') .expect('X-Response-Time', /^[0-9]+ms$/, done) }) }) }) describe('responseTime(options)', function () { describe('with "digits" option', function () { it('should default to 3', function (done) { var server = createServer() request(server) .get('/') .expect('X-Response-Time', /^[0-9]+\.[0-9]{3}ms$/, done) }) it('should allow custom digits', function (done) { var server = createServer({ digits: 5 }) request(server) .get('/') .expect('X-Response-Time', /^[0-9]+\.[0-9]{5}ms$/, done) }) it('should allow no digits', function (done) { var server = createServer({ digits: 0 }) request(server) .get('/') .expect('X-Response-Time', /^[0-9]+ms$/, done) }) }) describe('with "header" option', function () { it('should default to X-Response-Time', function (done) { var server = createServer() request(server) .get('/') .expect('X-Response-Time', /^[0-9\.]+ms$/, done) }) it('should allow custom header name', function (done) { var server = createServer({ header: 'X-Time-Taken' }) request(server) .get('/') .expect('X-Time-Taken', /^[0-9\.]+ms$/, done) }) }) describe('with "suffix" option', function () { it('should default to true', function (done) { var server = createServer() request(server) .get('/') .expect('X-Response-Time', /^[0-9\.]+ms$/, done) }) it('should allow disabling suffix', function (done) { var server = createServer({ suffix: false }) request(server) .get('/') .expect('X-Response-Time', /^[0-9\.]+$/, done) }) }) }) function createServer(opts, fn) { var _responseTime = responseTime(opts) return http.createServer(function (req, res) { _responseTime(req, res, function (err) { setTimeout(function () { fn && fn(req, res) res.statusCode = err ? (err.status || 500) : 200 res.end(err ? err.message : 'OK') }, 10) }) }) }