UNPKG

@alwatr/http-primer

Version:

Essential HTTP utilities for TypeScript, including types for HTTP methods, status codes, and headers.

458 lines 17.5 kB
/** * Object representing standard HTTP methods. */ export declare const HttpMethods: { /** * GET: Requests a representation of the specified resource. */ readonly GET: 'GET'; /** * HEAD: Asks for a response identical to that of a GET request, but without the response body. */ readonly HEAD: 'HEAD'; /** * POST: Submits data to be processed (e.g., from an HTML form) to the identified resource. */ readonly POST: 'POST'; /** * PUT: Uploads a representation of the specified URI. */ readonly PUT: 'PUT'; /** * DELETE: Deletes the specified resource. */ readonly DELETE: 'DELETE'; /** * CONNECT: Establishes a tunnel to the server identified by the target resource. */ readonly CONNECT: 'CONNECT'; /** * OPTIONS: Describes the communication options for the target resource. */ readonly OPTIONS: 'OPTIONS'; /** * TRACE: Performs a message loop-back test along the path to the target resource. */ readonly TRACE: 'TRACE'; /** * PATCH: Applies partial modifications to a resource. */ readonly PATCH: 'PATCH'; }; /** * Object representing standard HTTP status codes. */ export declare const HttpStatusCodes: { /** * 100 Continue: The server has received the request headers and the client should proceed to send the request body. */ readonly Info_100_Continue: 100; /** * 101 Switching Protocols: The server understands and is willing to comply with the clients request to switch protocols. */ readonly Info_101_Switching_Protocols: 101; /** * 102 Processing: The server has received and is processing the request, but no response is available yet. */ readonly Info_102_Processing: 102; /** * 103 Early Hints: The server is sending some response headers before the final HTTP message. */ readonly Info_103_Early_Hints: 103; /** * 200 OK: The request has succeeded. */ readonly Success_200_OK: 200; /** * 201 Created: The request has been fulfilled and resulted in a new resource being created. */ readonly Success_201_Created: 201; /** * 202 Accepted: The request has been accepted for processing, but the processing has not been completed. */ readonly Success_202_Accepted: 202; /** * 203 Non-Authoritative Information: The server is a transforming proxy that received a 200 OK * from the origin server but is returning a modified version of the origins response. */ readonly Success_203_Non_Authoritative_Information: 203; /** * 204 No Content: The server successfully processed the request and is not returning any content. */ readonly Success_204_No_Content: 204; /** * 205 Reset Content: The server successfully processed the request, * asks that the client reset its document view, and is not returning any content. */ readonly Success_205_Reset_Content: 205; /** * 206 Partial Content: The server is delivering only part of the resource due to a range header sent by the client. */ readonly Success_206_Partial_Content: 206; /** * 207 Multi-Status: The message body that follows is an XML message * and can contain a number of separate response codes, depending on how many sub-requests were made. */ readonly Success_207_Multi_Status: 207; /** * 208 Already Reported: The members of a DAV binding have already been enumerated * in a preceding part of the (multi-status) response, and are not being included again. */ readonly Success_208_Already_Reported: 208; /** * 226 IM Used: The server has fulfilled a request for the resource, and the response is a representation * of the result of one or more instance-manipulations applied to the current instance. */ readonly Success_226_IM_Used: 226; /** * 300 Multiple Choices: The request has more than one possible response. */ readonly Redirect_300_Multiple_Choices: 300; /** * 301 Moved Permanently: The URL of the requested resource has been changed permanently. */ readonly Redirect_301_Moved_Permanently: 301; /** * 302 Found: The URL of the requested resource has been changed temporarily. */ readonly Redirect_302_Found: 302; /** * 303 See Other: The response to the request can be found under another URI using a GET method. */ readonly Redirect_303_See_Other: 303; /** * 304 Not Modified: The resource has not been modified since the version specified * by the request headers If-Modified-Since or If-None-Match. */ readonly Redirect_304_Not_Modified: 304; /** * 305 Use Proxy: The requested resource is only available through a proxy, the address for which is provided in the response. */ readonly Redirect_305_Use_Proxy: 305; /** * 306 Switch Proxy: No longer used. Originally meant "Subsequent requests should use the specified proxy." */ readonly Redirect_306_Switch_Proxy: 306; /** * 307 Temporary Redirect: The server sends this response to direct the client * to get the requested resource at another URI with the same method that was used in the prior request. */ readonly Redirect_307_Temporary_Redirect: 307; /** * 308 Permanent Redirect: This means that the resource is now permanently located at another URI, * specified by the Location: HTTP Response header. */ readonly Redirect_308_Permanent_Redirect: 308; /** * 400 Bad Request: The server cannot or will not process the request due to something that is perceived to be a client error. */ readonly Error_Client_400_Bad_Request: 400; /** * 401 Unauthorized: The request has not been applied because it lacks valid authentication credentials for the target resource. */ readonly Error_Client_401_Unauthorized: 401; /** * 402 Payment Required: Reserved for future use. */ readonly Error_Client_402_Payment_Required: 402; /** * 403 Forbidden: The client does not have access rights to the content, so the server is refusing to give the requested resource. */ readonly Error_Client_403_Forbidden: 403; /** * 404 Not Found: The server can not find the requested resource. */ readonly Error_Client_404_Not_Found: 404; /** * 405 Method Not Allowed: The request method is known by the server but is not supported by the target resource. */ readonly Error_Client_405_Method_Not_Allowed: 405; /** * 406 Not Acceptable: The target resource does not have a current representation that would be acceptable * to the user agent, according to the proactive negotiation header fields received in the request, * and the server is unwilling to supply a default representation. */ readonly Error_Client_406_Not_Acceptable: 406; /** * 407 Proxy Authentication Required: Similar to 401 Unauthorized, * but it indicates that the client needs to authenticate itself in order to use a proxy. */ readonly Error_Client_407_Proxy_Authentication_Required: 407; /** * 408 Request Timeout: The server timed out waiting for the request. */ readonly Error_Client_408_Request_Timeout: 408; /** * 409 Conflict: The request could not be processed because of conflict in the request, such as an edit conflict. */ readonly Error_Client_409_Conflict: 409; /** * 410 Gone: The requested resource is no longer available and will not be available again. */ readonly Error_Client_410_Gone: 410; /** * 411 Length Required: The server refuses to accept the request without a defined Content-Length header. */ readonly Error_Client_411_Length_Required: 411; /** * 412 Precondition Failed: One or more conditions given in the request header fields evaluated to false when tested on the server. */ readonly Error_Client_412_Precondition_Failed: 412; /** * 413 Payload Too Large: The server is refusing to process a request because the request payload is larger * than the server is willing or able to process. */ readonly Error_Client_413_Payload_Too_Large: 413; /** * 414 URI Too Long: The server is refusing to service the request because the URI is longer than the server is willing to interpret. */ readonly Error_Client_414_URI_Too_Long: 414; /** * 415 Unsupported Media Type: The server is refusing to service the request * because the entity of the request is in a format not supported by the requested resource for the requested method. */ readonly Error_Client_415_Unsupported_Media_Type: 415; /** * 416 Range Not Satisfiable: The client has asked for a portion of the file, but the server cannot supply that portion. */ readonly Error_Client_416_Range_Not_Satisfiable: 416; /** * 417 Expectation Failed: The server cannot meet the requirements of the Expect request-header field. */ readonly Error_Client_417_Expectation_Failed: 417; /** * 421 Misdirected Request: The request was directed at a server that is not able to produce a response. */ readonly Error_Client_421_Misdirected_Request: 421; /** * 422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors. */ readonly Error_Client_422_Unprocessable_Entity: 422; /** * 423 Locked: The resource that is being accessed is locked. */ readonly Error_Client_423_Locked: 423; /** * 424 Failed Dependency: The request failed due to a failure of a previous request. */ readonly Error_Client_424_Failed_Dependency: 424; /** * 425 Too Early: The server is unwilling to risk processing a request that might be replayed. */ readonly Error_Client_425_Too_Early: 425; /** * 426 Upgrade Required: The server refuses to perform the request using the current protocol * but might be willing to do so after the client upgrades to a different protocol. */ readonly Error_Client_426_Upgrade_Required: 426; /** * 428 Precondition Required: The origin server requires the request to be conditional. */ readonly Error_Client_428_Precondition_Required: 428; /** * 429 Too Many Requests: The user has sent too many requests in a given amount of time ("rate limiting"). */ readonly Error_Client_429_Too_Many_Requests: 429; /** * 431 Request Header Fields Too Large: The server is unwilling to process the request because its header fields are too large. */ readonly Error_Client_431_Request_Header_Fields_Too_Large: 431; /** * 451 Unavailable For Legal Reasons: The user requests an illegal resource, such as a web page censored by a government. */ readonly Error_Client_451_Unavailable_For_Legal_Reasons: 451; /** * 500 Internal Server Error: A generic error message, given when no more specific message is suitable. */ readonly Error_Server_500_Internal_Server_Error: 500; /** * 501 Not Implemented: The server either does not recognize the request method, or it lacks the ability to fulfill the request. */ readonly Error_Server_501_Not_Implemented: 501; /** * 502 Bad Gateway: The server was acting as a gateway or proxy and received an invalid response from the upstream server. */ readonly Error_Server_502_Bad_Gateway: 502; /** * 503 Service Unavailable: The server is currently unavailable (because it is overloaded or down for maintenance). */ readonly Error_Server_503_Service_Unavailable: 503; /** * 504 Gateway Timeout: The server was acting as a gateway or proxy and did not receive a timely response from the upstream server. */ readonly Error_Server_504_Gateway_Timeout: 504; /** * 505 HTTP Version Not Supported: The server does not support the HTTP protocol version used in the request. */ readonly Error_Server_505_HTTP_Version_Not_Supported: 505; /** * 506 Variant Also Negotiates: Transparent content negotiation for the request results in a circular reference. */ readonly Error_Server_506_Variant_Also_Negotiates: 506; /** * 507 Insufficient Storage: The server is unable to store the representation needed to complete the request. */ readonly Error_Server_507_Insufficient_Storage: 507; /** * 508 Loop Detected: The server detected an infinite loop while processing the request. */ readonly Error_Server_508_Loop_Detected: 508; /** * 510 Not Extended: Further extensions to the request are required for the server to fulfill it. */ readonly Error_Server_510_Not_Extended: 510; /** * 511 Network Authentication Required: The client needs to authenticate to gain network access. */ readonly Error_Server_511_Network_Authentication_Required: 511; }; /** * Object representing standard HTTP status messages. */ export declare const HttpStatusMessages: { 100: string; 101: string; 102: string; 103: string; 200: string; 201: string; 202: string; 203: string; 204: string; 205: string; 206: string; 207: string; 208: string; 226: string; 300: string; 301: string; 302: string; 303: string; 304: string; 305: string; 307: string; 308: string; 400: string; 401: string; 402: string; 403: string; 404: string; 405: string; 406: string; 407: string; 408: string; 409: string; 410: string; 411: string; 412: string; 413: string; 414: string; 415: string; 416: string; 417: string; 418: string; 421: string; 422: string; 423: string; 424: string; 425: string; 426: string; 428: string; 429: string; 431: string; 451: string; 500: string; 501: string; 502: string; 503: string; 504: string; 505: string; 506: string; 507: string; 508: string; 509: string; 510: string; 511: string; }; /** * Type representing standard HTTP status codes. */ export type HttpStatusCode = keyof typeof HttpStatusMessages; /** * Object representing standard MIME types. */ export declare const MimeTypes: { readonly AAC: 'audio/aac'; readonly ABW: 'application/x-abiword'; readonly ARC: 'application/x-freearc'; readonly AVI: 'video/x-msvideo'; readonly AZW: 'application/vnd.amazon.ebook'; readonly BIN: 'application/octet-stream'; readonly BMP: 'image/bmp'; readonly BZ: 'application/x-bzip'; readonly BZ2: 'application/x-bzip2'; readonly CSH: 'application/x-csh'; readonly CSS: 'text/css'; readonly CSV: 'text/csv'; readonly DOC: 'application/msword'; readonly DOCX: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'; readonly EOT: 'application/vnd.ms-fontobject'; readonly EPUB: 'application/epub+zip'; readonly GZ: 'application/gzip'; readonly GIF: 'image/gif'; readonly HTML: 'text/html'; readonly ICO: 'image/vnd.microsoft.icon'; readonly ICS: 'text/calendar'; readonly JAR: 'application/java-archive'; readonly JPEG: 'image/jpeg'; readonly JS: 'text/javascript'; readonly JSON: 'application/json'; readonly JSONLD: 'application/ld+json'; readonly MID: 'audio/midi'; readonly MIDI: 'audio/midi'; readonly MJS: 'text/javascript'; readonly MP3: 'audio/mpeg'; readonly MP4: 'video/mp4'; readonly MPEG: 'video/mpeg'; readonly MPKG: 'application/vnd.apple.installer+xml'; readonly ODP: 'application/vnd.oasis.opendocument.presentation'; readonly ODS: 'application/vnd.oasis.opendocument.spreadsheet'; readonly ODT: 'application/vnd.oasis.opendocument.text'; readonly OGA: 'audio/ogg'; readonly OGV: 'video/ogg'; readonly OGX: 'application/ogg'; readonly OPUS: 'audio/opus'; readonly OTF: 'font/otf'; readonly PNG: 'image/png'; readonly PDF: 'application/pdf'; readonly PHP: 'application/x-httpd-php'; readonly PPT: 'application/vnd.ms-powerpoint'; readonly PPTX: 'application/vnd.openxmlformats-officedocument.presentationml.presentation'; readonly RAR: 'application/vnd.rar'; readonly RTF: 'application/rtf'; readonly SH: 'application/x-sh'; readonly SVG: 'image/svg+xml'; readonly SWF: 'application/x-shockwave-flash'; readonly TAR: 'application/x-tar'; readonly TIFF: 'image/tiff'; readonly TS: 'video/mp2t'; readonly TTF: 'font/ttf'; readonly TXT: 'text/plain'; readonly VS: 'application/x-sh'; readonly WAV: 'audio/wav'; readonly WEBA: 'audio/webm'; readonly WEBM: 'video/webm'; readonly WEBP: 'image/webp'; readonly WOFF: 'font/woff'; readonly WOFF2: 'font/woff2'; readonly XHTML: 'application/xhtml+xml'; readonly XLS: 'application/vnd.ms-excel'; readonly XLSX: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'; readonly XML: 'application/xml'; readonly XUL: 'application/vnd.mozilla.xul+xml'; readonly ZIP: 'application/zip'; readonly '3GP': 'video/3gpp'; readonly '3G2': 'video/3gpp2'; readonly '7Z': 'application/x-7z-compressed'; }; //# sourceMappingURL=constant.d.ts.map