import * as mod from "https://deno.land/std@0.177.0/http/mod.ts";
A collection of HTTP errors and utilities.
The export errors
contains an individual class that extends
HttpError
which makes handling HTTP errors in a structured way.
The function createHttpError
provides a way to create instances
of errors in a factory pattern.
The function isHttpError
is a type guard that will narrow a value
to an HttpError
instance.
Examples
Example 1
Example 1
import { errors, isHttpError } from "https://deno.land/std@0.177.0/http/http_errors.ts";
try {
throw new errors.NotFound();
} catch (e) {
if (isHttpError(e)) {
const response = new Response(e.message, { status: e.status });
} else {
throw e;
}
}
Example 2
Example 2
import { createHttpError } from "https://deno.land/std@0.177.0/http/http_errors.ts";
import { Status } from "https://deno.land/std@0.177.0/http/http_status.ts";
try {
throw createHttpError(
Status.BadRequest,
"The request was bad.",
{ expose: false }
);
} catch (e) {
// handle errors
}
Classes
Provides a way to manage cookies in a request and response on the server as a single iterable collection. | |
The base class that all derivative HTTP extend, providing a | |
Provides an way to manage cookies in a request and response on the server as a single iterable collection, as well as the ability to sign and verify cookies to prevent tampering. | |
Used to construct an HTTP server. |
Variables
Symbol which is used in mergeHeaders to extract a
| |
A namespace that contains each error constructor. Each error extends
| |
A record of all the status codes text. |
Functions
Returns an array of media types accepted by the request, in order of preference. If there are no media types supplied in the request, then any media type selector will be returned. | |
Returns an array of content encodings accepted by the request, in order of
preference. If there are no encoding supplied in the request, then | |
Returns an array of languages accepted by the request, in order of
preference. If there are no languages supplied in the request, then | |
A factory function which provides a way to create errors. It takes up to 3
arguments, the error | |
Set the cookie header with empty value in the headers to delete it | |
Parse cookies of a header | |
Parse set-cookies of a header | |
A type guard that determines if the status code is a client error. | |
A type guard that determines if the status code is an error. | |
A type guard that determines if the value is an HttpError or not. | |
A type guard that determines if the status code is informational. | |
A type guard that determines if the status code is a redirection. | |
A type guard that determines if the status code is a server error. | |
A type guard that determines if the status code is successful. | |
Allows merging of various sources of headers into a final set of headers
which can be used in a | |
Serves HTTP requests with the given handler. | |
Constructs a server, accepts incoming connections on the given listener, and handles requests on these connections with the given handler. | |
Serves HTTPS requests with the given handler. | |
Set the cookie header properly in the headers |
Interfaces
Information about the connection a request arrived on. | |
Provides a iterable map interfaces for managing cookies server side. | |
An interface which describes the methods that | |
Additional serve options. | |
Options for running an HTTP server. | |
Type Aliases
An HTTP status that is a client error (4XX). | |
T Data | Types of data that can be signed cryptographically. |
An HTTP status that is an error (4XX and 5XX). | |
A handler for HTTP requests. Consumes a request and connection information and returns a response. | |
An HTTP status that is a informational (1XX). | |
An HTTP status that is a redirect (3XX). | |
An HTTP status that is a server error (5XX). | |
An HTTP status that is a success (2XX). |