Why Deno.serve for HTTP handling? - Purpose & Use Cases

The Big Idea

Discover how a few lines of code can replace hours of complex server setup!

The Scenario

Imagine you want to create a simple web server that listens for requests and sends back responses. You try to write all the code yourself, handling sockets, parsing HTTP requests, and managing connections manually.

The Problem

Writing raw HTTP servers by hand is complicated, slow, and easy to get wrong. You have to manage low-level details like headers, methods, and streams, which can lead to bugs and security issues.

The Solution

Deno.serve provides a simple, built-in way to handle HTTP requests and responses with minimal code. It abstracts the complex parts so you can focus on your app logic.

Before vs After

✗ Before

const server = Deno.listen({ port: 8000 });
for await (const conn of server) {
  // manual HTTP parsing and response handling here
}

✓ After

Deno.serve(req => new Response("Hello World"), { port: 8000 });

What It Enables

You can quickly build reliable web servers that handle HTTP requests without worrying about low-level details.

Real Life Example

Creating a small API to serve data or a website backend becomes easy and fast, letting you focus on features instead of server plumbing.

Key Takeaways

Manual HTTP handling is complex and error-prone.

Deno.serve simplifies server creation with minimal code.

It lets you build web servers quickly and reliably.

Practice

1. What does Deno.serve primarily do in a Deno application?

easy

A. It creates a simple HTTP server that listens for requests.

B. It compiles TypeScript code into JavaScript.

C. It manages database connections automatically.

D. It formats JSON data for API responses.

Solution

1. Step 1: Understand the purpose of Deno.serve

   Deno.serve is designed to start an HTTP server that listens for incoming requests.

2. Step 2: Compare options with this purpose

   Only It creates a simple HTTP server that listens for requests. describes creating an HTTP server. Other options describe unrelated tasks.

3. Final Answer:

   It creates a simple HTTP server that listens for requests. -> Option A

4. Quick Check:

   Deno.serve creates HTTP server [OK]

Hint: Deno.serve starts a server to handle HTTP requests [OK]

Common Mistakes:

• Confusing Deno.serve with code compilation
• Thinking it manages databases
• Assuming it formats data automatically

2. Which of the following is the correct way to use Deno.serve to respond with "Hello World" to every request?

easy

A. Deno.serve(() => new Response.text("Hello World"));

B. Deno.serve(request => Response("Hello World"));

C. Deno.serve(() => Response.text("Hello World"));

D. Deno.serve(() => new Response("Hello World"));

Solution

1. Step 1: Check the correct Response object creation

   In Deno, to send a response, you create a new Response object with the body text.

2. Step 2: Validate syntax of each option

   Deno.serve(() => new Response("Hello World")); correctly uses new Response("Hello World"). Options A, B, and C misuse Response creation or methods.

3. Final Answer:

   Deno.serve(() => new Response("Hello World")); -> Option D

4. Quick Check:

   Use new Response() to send reply [OK]

Hint: Always use new Response() to send HTTP replies [OK]

Common Mistakes:

• Omitting 'new' keyword before Response
• Using Response as a function instead of a constructor
• Calling non-existent Response.text method

3. What will the following code output when accessed via a browser?

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

Deno.serve(req => {
  if (req.url.endsWith("/json")) {
    return new Response(JSON.stringify({ message: "Hi" }), {
      headers: { "Content-Type": "application/json" },
    });
  }
  return new Response("Not JSON");
});

medium

A. The browser shows: Not JSON

B. The browser shows: {"message":"Hi"} with JSON content type

C. The browser shows a 404 error

D. The server crashes with an error

Solution

1. Step 1: Analyze the request URL condition

   The code checks if the URL ends with '/json'. If yes, it returns JSON; otherwise, it returns "Not JSON".

2. Step 2: Determine the output for a normal browser request

   A browser accessing the root URL (e.g., http://localhost:8000/) does not end with '/json', so it returns "Not JSON" as plain text.

3. Final Answer:

   The browser shows: Not JSON -> Option A

4. Quick Check:

   URL ends with '/json'? No = "Not JSON" [OK]

Hint: Check URL endings carefully to predict response [OK]

Common Mistakes:

• Assuming all requests return JSON
• Ignoring URL path in condition
• Expecting server errors without syntax issues

4. Identify the error in this Deno.serve usage:

Deno.serve(async (req) => {
  const data = await req.json();
  return new Response(data);
});

medium

A. Cannot call req.json() on a Request object

B. Response constructor expects a string or Uint8Array, not an object

C. Missing await before new Response()

D. Deno.serve does not support async functions

Solution

1. Step 1: Understand req.json() usage

   Calling await req.json() correctly parses JSON body from the request.

2. Step 2: Check Response constructor argument

   The Response constructor expects a string or binary data, but data is an object, causing a type error.

3. Final Answer:

   Response constructor expects a string or Uint8Array, not an object -> Option B

4. Quick Check:

   Response body must be string or bytes, not object [OK]

Hint: Always stringify objects before passing to Response [OK]

Common Mistakes:

• Passing raw object to Response instead of string
• Thinking req.json() is invalid on Request
• Assuming async functions are unsupported

5. You want to create a Deno server that responds with "Hello, {name}!" where {name} is a query parameter from the URL (e.g., /?name=Alice). Which code snippet correctly implements this?

hard

A. Deno.serve(req => {
const url = req.url;
const name = url.params.name || 'Guest';
return new Response(`Hello, ${name}!`);
});

B. Deno.serve(req => {
const name = req.query.name || 'Guest';
return new Response(`Hello, ${name}!`);
});

C. Deno.serve(req => {
const url = new URL(req.url);
const name = url.searchParams.get('name') || 'Guest';
return new Response(`Hello, ${name}!`);
});

D. Deno.serve(req => {
const name = req.get('name') || 'Guest';
return new Response(`Hello, ${name}!`);
});

Solution

1. Step 1: Extract query parameters from request URL

   Use new URL(req.url) to parse the URL and access searchParams for query parameters.

2. Step 2: Get 'name' parameter safely and respond

   Use url.searchParams.get('name') with fallback to 'Guest', then return a Response with the greeting string.

3. Final Answer:

   Deno.serve(req => { const url = new URL(req.url); const name = url.searchParams.get('name') || 'Guest'; return new Response(`Hello, ${name}!`); }); -> Option C

4. Quick Check:

   Use URL and searchParams to read query [OK]

Hint: Parse req.url with URL to access query parameters [OK]

Common Mistakes:

• Assuming req has query or params properties
• Trying to get query params directly from req
• Using non-existent req.get() method