Skip to main content
Module

x/oak/mod.ts>Response

A middleware framework for handling HTTP with Deno 🐿️ 🦕
Extremely Popular
Go to Latest
class Response
import { Response } from "https://deno.land/x/oak@v10.6.0/mod.ts";

An interface to control what response will be sent when the middleware finishes processing the request.

The response is usually accessed via the context's .response property.

Example

import { Application, Status } from "https://deno.land/x/oak/mod.ts";

const app = new Application();

app.use((ctx) => {
  ctx.response.body = { hello: "oak" };
  ctx.response.type = "json";
  ctx.response.status = Status.OK;
});

Constructors

new
Response(request: Request)

Properties

body: ResponseBody | ResponseBodyFunction

The body of the response. The body will be automatically processed when the response is being sent and converted to a Uint8Array or a Deno.Reader.

Automatic conversion to a Deno.Reader occurs for async iterables.

headers: Headers

Headers that will be returned in the response.

status: Status

The HTTP status of the response. If this has not been explicitly set, reading the value will return what would be the value of status if the response were sent at this point in processing the middleware. If the body has been set, the status will be 200 OK. If a value for the body has not been set yet, the status will be 404 Not Found.

type: string | undefined

The media type, or extension of the response. Setting this value will ensure an appropriate Content-Type header is added to the response.

readonly
writable: boolean

A read-only property which determines if the response is writable or not. Once the response has been processed, this value is set to false.

Methods

addResource(rid: number): void

Add a resource to the list of resources that will be closed when the request is destroyed.

destroy(closeResources?): void

Release any resources that are being tracked by the response.

redirect(url: string | URL): void

Sets the response to redirect to the supplied url.

If the .status is not currently a redirect status, the status will be set to 302 Found.

The body will be set to a message indicating the redirection is occurring.

redirect(url: REDIRECT_BACK, alt?: string | URL): void

Sets the response to redirect back to the referrer if available, with an optional alt URL if there is no referrer header on the request. If there is no referrer header, nor an alt parameter, the redirect is set to /.

If the .status is not currently a redirect status, the status will be set to 302 Found.

The body will be set to a message indicating the redirection is occurring.

toDomResponse(): Promise<globalThis.Response>
[Symbol.for("Deno.customInspect")](inspect: (value: unknown) => string)
[Symbol.for("nodejs.util.inspect.custom")](
depth: number,
options: any,
inspect: (value: unknown, options?: unknown) => string,
)