/*! * statuses * Copyright(c) 2014 Jonathan Ong * Copyright(c) 2016 Douglas Christopher Wilson * MIT Licensed */ 'use strict' /** * Module dependencies. * @private */ var codes = require('./codes.json') /** * Module exports. * @public */ module.exports = status // status code to message map status.message = codes // status message (lower-case) to code map status.code = createMessageToStatusCodeMap(codes) // array of status codes status.codes = createStatusCodeList(codes) // status codes for redirects status.redirect = { 300: true, 301: true, 302: true, 303: true, 305: true, 307: true, 308: true } // status codes for empty bodies status.empty = { 204: true, 205: true, 304: true } // status codes for when you should retry the request status.retry = { 502: true, 503: true, 504: true } /** * Create a map of message to status code. * @private */ function createMessageToStatusCodeMap (codes) { var map = {} Object.keys(codes).forEach(function forEachCode (code) { var message = codes[code] var status = Number(code) // populate map map[message.toLowerCase()] = status }) return map } /** * Create a list of all status codes. * @private */ function createStatusCodeList (codes) { return Object.keys(codes).map(function mapCode (code) { return Number(code) }) } /** * Get the status code for given message. * @private */ function getStatusCode (message) { var msg = message.toLowerCase() if (!Object.prototype.hasOwnProperty.call(status.code, msg)) { throw new Error('invalid status message: "' + message + '"') } return status.code[msg] } /** * Get the status message for given code. * @private */ function getStatusMessage (code) { if (!Object.prototype.hasOwnProperty.call(status.message, code)) { throw new Error('invalid status code: ' + code) } return status.message[code] } /** * Get the status code. * * Given a number, this will throw if it is not a known status * code, otherwise the code will be returned. Given a string, * the string will be parsed for a number and return the code * if valid, otherwise will lookup the code assuming this is * the status message. * * @param {string|number} code * @returns {number} * @public */ function status (code) { if (typeof code === 'number') { return getStatusMessage(code) } if (typeof code !== 'string') { throw new TypeError('code must be a number or string') } // '403' var n = parseInt(code, 10) if (!isNaN(n)) { return getStatusMessage(n) } return getStatusCode(code) }