Started to implement server
This commit is contained in:
didier amyot committed
1 parent
1f2ea8b7e5
commit
17a1b4bed3
177 files changed
+29894
-74
No files matched your search
+343
@@ -0,0 +1,343 @@
|
||||
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
|
||||
// This module is browser compatible.
|
||||
|
||||
/**
|
||||
* Contains the enum {@linkcode Status} which enumerates standard HTTP status
|
||||
* codes and provides several type guards for handling status codes with type
|
||||
* safety.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import {
|
||||
* Status,
|
||||
* STATUS_TEXT,
|
||||
* } from "https://deno.land/std@$STD_VERSION/http/http_status.ts";
|
||||
*
|
||||
* console.log(Status.NotFound); //=> 404
|
||||
* console.log(STATUS_TEXT[Status.NotFound]); //=> "Not Found"
|
||||
* ```
|
||||
*
|
||||
* ```ts
|
||||
* import { isErrorStatus } from "https://deno.land/std@$STD_VERSION/http/http_status.ts";
|
||||
*
|
||||
* const res = await fetch("https://example.com/");
|
||||
*
|
||||
* if (isErrorStatus(res.status)) {
|
||||
* // error handling here...
|
||||
* }
|
||||
* ```
|
||||
*
|
||||
* @module
|
||||
*/
|
||||
|
||||
/** Standard HTTP status codes. */
|
||||
export enum Status {
|
||||
/** RFC 7231, 6.2.1 */
|
||||
Continue = 100,
|
||||
/** RFC 7231, 6.2.2 */
|
||||
SwitchingProtocols = 101,
|
||||
/** RFC 2518, 10.1 */
|
||||
Processing = 102,
|
||||
/** RFC 8297 **/
|
||||
EarlyHints = 103,
|
||||
|
||||
/** RFC 7231, 6.3.1 */
|
||||
OK = 200,
|
||||
/** RFC 7231, 6.3.2 */
|
||||
Created = 201,
|
||||
/** RFC 7231, 6.3.3 */
|
||||
Accepted = 202,
|
||||
/** RFC 7231, 6.3.4 */
|
||||
NonAuthoritativeInfo = 203,
|
||||
/** RFC 7231, 6.3.5 */
|
||||
NoContent = 204,
|
||||
/** RFC 7231, 6.3.6 */
|
||||
ResetContent = 205,
|
||||
/** RFC 7233, 4.1 */
|
||||
PartialContent = 206,
|
||||
/** RFC 4918, 11.1 */
|
||||
MultiStatus = 207,
|
||||
/** RFC 5842, 7.1 */
|
||||
AlreadyReported = 208,
|
||||
/** RFC 3229, 10.4.1 */
|
||||
IMUsed = 226,
|
||||
|
||||
/** RFC 7231, 6.4.1 */
|
||||
MultipleChoices = 300,
|
||||
/** RFC 7231, 6.4.2 */
|
||||
MovedPermanently = 301,
|
||||
/** RFC 7231, 6.4.3 */
|
||||
Found = 302,
|
||||
/** RFC 7231, 6.4.4 */
|
||||
SeeOther = 303,
|
||||
/** RFC 7232, 4.1 */
|
||||
NotModified = 304,
|
||||
/** RFC 7231, 6.4.5 */
|
||||
UseProxy = 305,
|
||||
/** RFC 7231, 6.4.7 */
|
||||
TemporaryRedirect = 307,
|
||||
/** RFC 7538, 3 */
|
||||
PermanentRedirect = 308,
|
||||
|
||||
/** RFC 7231, 6.5.1 */
|
||||
BadRequest = 400,
|
||||
/** RFC 7235, 3.1 */
|
||||
Unauthorized = 401,
|
||||
/** RFC 7231, 6.5.2 */
|
||||
PaymentRequired = 402,
|
||||
/** RFC 7231, 6.5.3 */
|
||||
Forbidden = 403,
|
||||
/** RFC 7231, 6.5.4 */
|
||||
NotFound = 404,
|
||||
/** RFC 7231, 6.5.5 */
|
||||
MethodNotAllowed = 405,
|
||||
/** RFC 7231, 6.5.6 */
|
||||
NotAcceptable = 406,
|
||||
/** RFC 7235, 3.2 */
|
||||
ProxyAuthRequired = 407,
|
||||
/** RFC 7231, 6.5.7 */
|
||||
RequestTimeout = 408,
|
||||
/** RFC 7231, 6.5.8 */
|
||||
Conflict = 409,
|
||||
/** RFC 7231, 6.5.9 */
|
||||
Gone = 410,
|
||||
/** RFC 7231, 6.5.10 */
|
||||
LengthRequired = 411,
|
||||
/** RFC 7232, 4.2 */
|
||||
PreconditionFailed = 412,
|
||||
/** RFC 7231, 6.5.11 */
|
||||
RequestEntityTooLarge = 413,
|
||||
/** RFC 7231, 6.5.12 */
|
||||
RequestURITooLong = 414,
|
||||
/** RFC 7231, 6.5.13 */
|
||||
UnsupportedMediaType = 415,
|
||||
/** RFC 7233, 4.4 */
|
||||
RequestedRangeNotSatisfiable = 416,
|
||||
/** RFC 7231, 6.5.14 */
|
||||
ExpectationFailed = 417,
|
||||
/** RFC 7168, 2.3.3 */
|
||||
Teapot = 418,
|
||||
/** RFC 7540, 9.1.2 */
|
||||
MisdirectedRequest = 421,
|
||||
/** RFC 4918, 11.2 */
|
||||
UnprocessableEntity = 422,
|
||||
/** RFC 4918, 11.3 */
|
||||
Locked = 423,
|
||||
/** RFC 4918, 11.4 */
|
||||
FailedDependency = 424,
|
||||
/** RFC 8470, 5.2 */
|
||||
TooEarly = 425,
|
||||
/** RFC 7231, 6.5.15 */
|
||||
UpgradeRequired = 426,
|
||||
/** RFC 6585, 3 */
|
||||
PreconditionRequired = 428,
|
||||
/** RFC 6585, 4 */
|
||||
TooManyRequests = 429,
|
||||
/** RFC 6585, 5 */
|
||||
RequestHeaderFieldsTooLarge = 431,
|
||||
/** RFC 7725, 3 */
|
||||
UnavailableForLegalReasons = 451,
|
||||
|
||||
/** RFC 7231, 6.6.1 */
|
||||
InternalServerError = 500,
|
||||
/** RFC 7231, 6.6.2 */
|
||||
NotImplemented = 501,
|
||||
/** RFC 7231, 6.6.3 */
|
||||
BadGateway = 502,
|
||||
/** RFC 7231, 6.6.4 */
|
||||
ServiceUnavailable = 503,
|
||||
/** RFC 7231, 6.6.5 */
|
||||
GatewayTimeout = 504,
|
||||
/** RFC 7231, 6.6.6 */
|
||||
HTTPVersionNotSupported = 505,
|
||||
/** RFC 2295, 8.1 */
|
||||
VariantAlsoNegotiates = 506,
|
||||
/** RFC 4918, 11.5 */
|
||||
InsufficientStorage = 507,
|
||||
/** RFC 5842, 7.2 */
|
||||
LoopDetected = 508,
|
||||
/** RFC 2774, 7 */
|
||||
NotExtended = 510,
|
||||
/** RFC 6585, 6 */
|
||||
NetworkAuthenticationRequired = 511,
|
||||
}
|
||||
|
||||
/** A record of all the status codes text. */
|
||||
export const STATUS_TEXT: Readonly<Record<Status, string>> = {
|
||||
[Status.Accepted]: "Accepted",
|
||||
[Status.AlreadyReported]: "Already Reported",
|
||||
[Status.BadGateway]: "Bad Gateway",
|
||||
[Status.BadRequest]: "Bad Request",
|
||||
[Status.Conflict]: "Conflict",
|
||||
[Status.Continue]: "Continue",
|
||||
[Status.Created]: "Created",
|
||||
[Status.EarlyHints]: "Early Hints",
|
||||
[Status.ExpectationFailed]: "Expectation Failed",
|
||||
[Status.FailedDependency]: "Failed Dependency",
|
||||
[Status.Forbidden]: "Forbidden",
|
||||
[Status.Found]: "Found",
|
||||
[Status.GatewayTimeout]: "Gateway Timeout",
|
||||
[Status.Gone]: "Gone",
|
||||
[Status.HTTPVersionNotSupported]: "HTTP Version Not Supported",
|
||||
[Status.IMUsed]: "IM Used",
|
||||
[Status.InsufficientStorage]: "Insufficient Storage",
|
||||
[Status.InternalServerError]: "Internal Server Error",
|
||||
[Status.LengthRequired]: "Length Required",
|
||||
[Status.Locked]: "Locked",
|
||||
[Status.LoopDetected]: "Loop Detected",
|
||||
[Status.MethodNotAllowed]: "Method Not Allowed",
|
||||
[Status.MisdirectedRequest]: "Misdirected Request",
|
||||
[Status.MovedPermanently]: "Moved Permanently",
|
||||
[Status.MultiStatus]: "Multi Status",
|
||||
[Status.MultipleChoices]: "Multiple Choices",
|
||||
[Status.NetworkAuthenticationRequired]: "Network Authentication Required",
|
||||
[Status.NoContent]: "No Content",
|
||||
[Status.NonAuthoritativeInfo]: "Non Authoritative Info",
|
||||
[Status.NotAcceptable]: "Not Acceptable",
|
||||
[Status.NotExtended]: "Not Extended",
|
||||
[Status.NotFound]: "Not Found",
|
||||
[Status.NotImplemented]: "Not Implemented",
|
||||
[Status.NotModified]: "Not Modified",
|
||||
[Status.OK]: "OK",
|
||||
[Status.PartialContent]: "Partial Content",
|
||||
[Status.PaymentRequired]: "Payment Required",
|
||||
[Status.PermanentRedirect]: "Permanent Redirect",
|
||||
[Status.PreconditionFailed]: "Precondition Failed",
|
||||
[Status.PreconditionRequired]: "Precondition Required",
|
||||
[Status.Processing]: "Processing",
|
||||
[Status.ProxyAuthRequired]: "Proxy Auth Required",
|
||||
[Status.RequestEntityTooLarge]: "Request Entity Too Large",
|
||||
[Status.RequestHeaderFieldsTooLarge]: "Request Header Fields Too Large",
|
||||
[Status.RequestTimeout]: "Request Timeout",
|
||||
[Status.RequestURITooLong]: "Request URI Too Long",
|
||||
[Status.RequestedRangeNotSatisfiable]: "Requested Range Not Satisfiable",
|
||||
[Status.ResetContent]: "Reset Content",
|
||||
[Status.SeeOther]: "See Other",
|
||||
[Status.ServiceUnavailable]: "Service Unavailable",
|
||||
[Status.SwitchingProtocols]: "Switching Protocols",
|
||||
[Status.Teapot]: "I'm a teapot",
|
||||
[Status.TemporaryRedirect]: "Temporary Redirect",
|
||||
[Status.TooEarly]: "Too Early",
|
||||
[Status.TooManyRequests]: "Too Many Requests",
|
||||
[Status.Unauthorized]: "Unauthorized",
|
||||
[Status.UnavailableForLegalReasons]: "Unavailable For Legal Reasons",
|
||||
[Status.UnprocessableEntity]: "Unprocessable Entity",
|
||||
[Status.UnsupportedMediaType]: "Unsupported Media Type",
|
||||
[Status.UpgradeRequired]: "Upgrade Required",
|
||||
[Status.UseProxy]: "Use Proxy",
|
||||
[Status.VariantAlsoNegotiates]: "Variant Also Negotiates",
|
||||
};
|
||||
|
||||
/** An HTTP status that is a informational (1XX). */
|
||||
export type InformationalStatus =
|
||||
| Status.Continue
|
||||
| Status.SwitchingProtocols
|
||||
| Status.Processing
|
||||
| Status.EarlyHints;
|
||||
|
||||
/** An HTTP status that is a success (2XX). */
|
||||
export type SuccessfulStatus =
|
||||
| Status.OK
|
||||
| Status.Created
|
||||
| Status.Accepted
|
||||
| Status.NonAuthoritativeInfo
|
||||
| Status.NoContent
|
||||
| Status.ResetContent
|
||||
| Status.PartialContent
|
||||
| Status.MultiStatus
|
||||
| Status.AlreadyReported
|
||||
| Status.IMUsed;
|
||||
|
||||
/** An HTTP status that is a redirect (3XX). */
|
||||
export type RedirectStatus =
|
||||
| Status.MultipleChoices // 300
|
||||
| Status.MovedPermanently // 301
|
||||
| Status.Found // 302
|
||||
| Status.SeeOther // 303
|
||||
| Status.UseProxy // 305 - DEPRECATED
|
||||
| Status.TemporaryRedirect // 307
|
||||
| Status.PermanentRedirect; // 308
|
||||
|
||||
/** An HTTP status that is a client error (4XX). */
|
||||
export type ClientErrorStatus =
|
||||
| Status.BadRequest
|
||||
| Status.Unauthorized
|
||||
| Status.PaymentRequired
|
||||
| Status.Forbidden
|
||||
| Status.NotFound
|
||||
| Status.MethodNotAllowed
|
||||
| Status.NotAcceptable
|
||||
| Status.ProxyAuthRequired
|
||||
| Status.RequestTimeout
|
||||
| Status.Conflict
|
||||
| Status.Gone
|
||||
| Status.LengthRequired
|
||||
| Status.PreconditionFailed
|
||||
| Status.RequestEntityTooLarge
|
||||
| Status.RequestURITooLong
|
||||
| Status.UnsupportedMediaType
|
||||
| Status.RequestedRangeNotSatisfiable
|
||||
| Status.ExpectationFailed
|
||||
| Status.Teapot
|
||||
| Status.MisdirectedRequest
|
||||
| Status.UnprocessableEntity
|
||||
| Status.Locked
|
||||
| Status.FailedDependency
|
||||
| Status.UpgradeRequired
|
||||
| Status.PreconditionRequired
|
||||
| Status.TooManyRequests
|
||||
| Status.RequestHeaderFieldsTooLarge
|
||||
| Status.UnavailableForLegalReasons;
|
||||
|
||||
/** An HTTP status that is a server error (5XX). */
|
||||
export type ServerErrorStatus =
|
||||
| Status.InternalServerError
|
||||
| Status.NotImplemented
|
||||
| Status.BadGateway
|
||||
| Status.ServiceUnavailable
|
||||
| Status.GatewayTimeout
|
||||
| Status.HTTPVersionNotSupported
|
||||
| Status.VariantAlsoNegotiates
|
||||
| Status.InsufficientStorage
|
||||
| Status.LoopDetected
|
||||
| Status.NotExtended
|
||||
| Status.NetworkAuthenticationRequired;
|
||||
|
||||
/** An HTTP status that is an error (4XX and 5XX). */
|
||||
export type ErrorStatus = ClientErrorStatus | ServerErrorStatus;
|
||||
|
||||
/** A type guard that determines if the status code is informational. */
|
||||
export function isInformationalStatus(
|
||||
status: Status,
|
||||
): status is InformationalStatus {
|
||||
return status >= 100 && status < 200;
|
||||
}
|
||||
|
||||
/** A type guard that determines if the status code is successful. */
|
||||
export function isSuccessfulStatus(status: Status): status is SuccessfulStatus {
|
||||
return status >= 200 && status < 300;
|
||||
}
|
||||
|
||||
/** A type guard that determines if the status code is a redirection. */
|
||||
export function isRedirectStatus(status: Status): status is RedirectStatus {
|
||||
return status >= 300 && status < 400;
|
||||
}
|
||||
|
||||
/** A type guard that determines if the status code is a client error. */
|
||||
export function isClientErrorStatus(
|
||||
status: Status,
|
||||
): status is ClientErrorStatus {
|
||||
return status >= 400 && status < 500;
|
||||
}
|
||||
|
||||
/** A type guard that determines if the status code is a server error. */
|
||||
export function isServerErrorStatus(
|
||||
status: Status,
|
||||
): status is ServerErrorStatus {
|
||||
return status >= 500 && status < 600;
|
||||
}
|
||||
|
||||
/** A type guard that determines if the status code is an error. */
|
||||
export function isErrorStatus(status: Status): status is ErrorStatus {
|
||||
return status >= 400 && status < 600;
|
||||
}
|
||||
Reference in new issue
Block a user