1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-23 15:16:54 -05:00
denoland-deno/std/http
William Perron 8a6a2a50f7
docs(std): add missing jsdoc comments to exported functions (#8442)
includes:
- http/file_server.ts
- testing/_diff.ts
- testing/asserts.ts

Relates to #7487
2020-11-19 21:59:45 -05:00
..
testdata test(std/http): make tests runnable from any directory (#7441) 2020-09-14 12:58:43 +02:00
_io.ts fix(std/http): fix error handling in the request iterator (#8365) 2020-11-18 17:47:47 +01:00
_io_test.ts feat(fmt): Sort named import and export specifiers (#7711) 2020-09-27 12:22:32 +02:00
_mock_conn.ts chore: add copyright (#7593) 2020-09-21 08:26:41 -04:00
bench.ts chore(std/http): rename http_bench.ts -> bench.ts (#7509) 2020-10-04 13:34:52 +02:00
cookie.ts feat(std/http): Check if cookie property is valid (#7189) 2020-11-17 21:06:06 +01:00
cookie_test.ts feat(std/http): Check if cookie property is valid (#7189) 2020-11-17 21:06:06 +01:00
file_server.ts docs(std): add missing jsdoc comments to exported functions (#8442) 2020-11-19 21:59:45 -05:00
file_server_test.ts fix: path traversal in std/http/file_server.ts (#8134) 2020-10-27 11:48:45 +01:00
http_status.ts feat(std/http) support code 103 Early Hints (#6021) 2020-06-01 11:10:17 -04:00
mod.ts chore: add copyright (#7593) 2020-09-21 08:26:41 -04:00
racing_server.ts Use dprint for internal formatting (#6682) 2020-07-14 15:24:17 -04:00
racing_server_test.ts chore: add copyright (#7593) 2020-09-21 08:26:41 -04:00
README.md docs: fix command examples use outdated default file_server port (#8062) 2020-10-22 17:17:38 +02:00
server.ts fix(std/http): fix error handling in the request iterator (#8365) 2020-11-18 17:47:47 +01:00
server_test.ts fix(std/http): fix error handling in the request iterator (#8365) 2020-11-18 17:47:47 +01:00
test.ts chore: add copyright (#7593) 2020-09-21 08:26:41 -04:00

http

import { serve } from "https://deno.land/std@$STD_VERSION/http/server.ts";
const server = serve({ port: 8000 });
console.log("http://localhost:8000/");
for await (const req of server) {
  req.respond({ body: "Hello World\n" });
}

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://0.0.0.0:4507/

Helper to manipulate Cookie through ServerRequest and Response.

import { ServerRequest } from "https://deno.land/std@$STD_VERSION/http/server.ts";
import { getCookies } from "https://deno.land/std@$STD_VERSION/http/cookie.ts";

let request = new ServerRequest();
request.headers = new Headers();
request.headers.set("Cookie", "full=of; tasty=chocolate");

const cookies = getCookies(request);
console.log("cookies:", cookies);
// cookies: { full: "of", tasty: "chocolate" }

To set a Cookie you can add CookieOptions to properly set your Cookie:

import { Response } from "https://deno.land/std@$STD_VERSION/http/server.ts";
import {
  Cookie,
  setCookie,
} from "https://deno.land/std@$STD_VERSION/http/cookie.ts";

let response: Response = {};
const cookie: Cookie = { name: "Space", value: "Cat" };
setCookie(response, cookie);

const cookieHeader = response.headers.get("set-cookie");
console.log("Set-Cookie:", cookieHeader);
// Set-Cookie: Space=Cat

Deleting a Cookie will set its expiration date before now. Forcing the browser to delete it.

import { Response } from "https://deno.land/std@$STD_VERSION/http/server.ts";
import { deleteCookie } from "https://deno.land/std@$STD_VERSION/http/cookie.ts";

let response: Response = {};
deleteCookie(response, "deno");

const cookieHeader = response.headers.get("set-cookie");
console.log("Set-Cookie:", cookieHeader);
// Set-Cookie: deno=; Expires=Thus, 01 Jan 1970 00:00:00 GMT

Note: At the moment multiple Set-Cookie in a Response is not handled.