http | /deps.ts | fsrouter@3.1.0

namespace http

import { http } from "https://deno.land/x/fsrouter@3.1.0/deps.ts";

Provides user-friendly serve on top of Deno's native HTTP server and other utilities for creating HTTP servers and clients.

Server

Server APIs utilizing Deno's HTTP server APIs.

import { serve } from "https://deno.land/std@0.224.0/http/server.ts";

serve(() => new Response("Hello World\n"));

console.log("http://localhost:8000/");

File Server

A small program for serving local files over HTTP.

deno run --allow-net --allow-read https://deno.land/std/http/file_server.ts
> HTTP server listening on http://localhost:4507/

HTTP Status Code and Status Text

Helper for processing status code and status text.

HTTP errors

Provides error classes for each HTTP error status code as well as utility functions for handling HTTP errors in a structured way.

Negotiation

A set of functions which can be used to negotiate content types, encodings and languages when responding to requests.

Note: some libraries include accept charset functionality by analyzing the Accept-Charset header. This is a legacy header that clients omit and servers should ignore therefore is not provided.

Cookie maps

An alternative to cookie.ts is cookie_map.ts which provides CookieMap, SecureCookieMap, and mergeHeaders to manage request and response cookies with the familiar Map interface.

Classes

c http.CookieMap	Provides a way to manage cookies in a request and response on the server as a single iterable collection.
c http.HttpError	The base class that all derivative HTTP extend, providing a `status` and an `expose` property.
c http.SecureCookieMap	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.
c http.Server	Used to construct an HTTP server.

Enums

http.Status

Standard HTTP status codes.

Variables

v http.cookieMapHeadersInitSymbol	Symbol which is used in mergeHeaders to extract a `[string \| string][]` from an instance to generate the final set of headers.
v http.errors	A namespace that contains each error constructor. Each error extends `HTTPError` and provides `.status` and `.expose` properties, where the `.status` will be an error `Status` value and `.expose` indicates if information, like a stack trace, should be shared in the response.
v http.STATUS_TEXT	A record of all the status codes text.

Functions

f http.accepts	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.
f http.acceptsEncodings	Returns an array of content encodings accepted by the request, in order of preference. If there are no encoding supplied in the request, then `["*"]` is returned, implying any encoding is accepted.
f http.acceptsLanguages	Returns an array of languages accepted by the request, in order of preference. If there are no languages supplied in the request, then `["*"]` is returned, imply any language is accepted.
f http.createHttpError	A factory function which provides a way to create errors. It takes up to 3 arguments, the error `Status`, an message, which defaults to the status text and error options, which incudes the `expose` property to set the `.expose` value on the error.
f http.deleteCookie	Set the cookie header with empty value in the headers to delete it
f http.getCookies	Parse cookies of a header
f http.getSetCookies	Parse set-cookies of a header
f http.isClientErrorStatus	A type guard that determines if the status code is a client error.
f http.isErrorStatus	A type guard that determines if the status code is an error.
f http.isHttpError	A type guard that determines if the value is an HttpError or not.
f http.isInformationalStatus	A type guard that determines if the status code is informational.
f http.isRedirectStatus	A type guard that determines if the status code is a redirection.
f http.isServerErrorStatus	A type guard that determines if the status code is a server error.
f http.isSuccessfulStatus	A type guard that determines if the status code is successful.
f http.mergeHeaders	Allows merging of various sources of headers into a final set of headers which can be used in a `Response`.
f http.serve	Serves HTTP requests with the given handler.
f http.serveListener	Constructs a server, accepts incoming connections on the given listener, and handles requests on these connections with the given handler.
f http.serveTls	Serves HTTPS requests with the given handler.
f http.setCookie	Set the cookie header properly in the headers

Interfaces

I http.ConnInfo	Information about the connection a request arrived on.
I http.Cookie
I http.CookieMapOptions	Provides a iterable map interfaces for managing cookies server side.
I http.CookieMapSetDeleteOptions
I http.Headered	An object which contains a `headers` property which has a value of an instance of `Headers`, like `Request` and `Response`.
I http.HttpErrorOptions
I http.KeyRing	An interface which describes the methods that `SecureCookieMap` uses to sign and verify cookies.
I http.Mergeable
I http.SecureCookieMapGetOptions
I http.SecureCookieMapOptions
I http.SecureCookieMapSetDeleteOptions
I http.ServeInit	Additional serve options.
I http.ServerInit	Options for running an HTTP server.
I http.ServeTlsInit

Type Aliases

T http.ClientErrorStatus	An HTTP status that is a client error (4XX).
T http.Data	Types of data that can be signed cryptographically.
T http.ErrorStatus	An HTTP status that is an error (4XX and 5XX).
T http.ErrorStatusKeys
T http.Handler	A handler for HTTP requests. Consumes a request and connection information and returns a response.
T http.InformationalStatus	An HTTP status that is a informational (1XX).
T http.RedirectStatus	An HTTP status that is a redirect (3XX).
T http.Request
T http.ServerErrorStatus	An HTTP status that is a server error (5XX).
T http.SuccessfulStatus	An HTTP status that is a success (2XX).