Context

console.log(ctx.url); // "https://example.com/listings?page=2"
// Purpose: Access the full request URL including query string

console.log(ctx.pathname); // "/listings"
// Purpose: Get the pathname part of the URL without query parameters

if (ctx.method === "POST") { /* handle post */ }
// Purpose: Check the HTTP method of the incoming request

const body = await ctx.req.json();
// Purpose: Access and parse the request body as JSON

ctx.headers.set("X-Custom", "value");
console.log(ctx.headers.get("content-type"));
// Purpose: Get or set headers for the request/response

ctx.status(404).text("Not Found"); 
// Purpose: Set the HTTP status code and chain response methods

ctx.setHeader("X-Powered-By", "tezx");
ctx.setHeader("Set-Cookie", "id=1; Path=/; HttpOnly", { append: true });
ctx.setHeader("Set-Cookie", "token=abcd; Path=/; HttpOnly", { append: true });
return ctx.text("headers set");
// Purpose: Add or append a single header to the response

// Plain text
app.get("/", (ctx) => ctx.text("Welcome to TezX 🚀"));
// Purpose: Send a simple text response

// JSON API
app.get("/status", (ctx) => ctx.json({ ok: true, uptime: process.uptime() }));
// Purpose: Send a JSON response, useful for APIs

// HTML page
app.get("/hello", (ctx) => ctx.html`<h1>Hello, ${ctx.username ?? "Guest"}!</h1>`);
// Purpose: Send HTML content with template literals

// Route parameter
app.get("/user/:id", (ctx) => {
  return ctx.json({ userId: ctx.req.params.id });
});
// Purpose: Extract dynamic route parameters

// Query string
app.get("/search", (ctx) => {
  return ctx.json({ q: ctx.req.query.q || "nothing" });
});
// Purpose: Access query parameters from the URL

// Handle multipart form upload
app.post("/upload", async (ctx) => {
  const form = await ctx.req.formData();
  const file = form.get("file"); // File | null
  const username = form.get("username");
  
  return ctx.json({ uploadedBy: username, hasFile: !!file });
});
// Purpose: Parse form data including file uploads

<form action="/upload" method="post" enctype="multipart/form-data">
  <input type="text" name="username" placeholder="Your Name" />
  <input type="file" name="file" />
  <button type="submit">Upload</button>
</form>

app.get("/secure", (ctx) => {
  ctx.status(401)
     .setHeader("WWW-Authenticate", "Bearer")
     .json({ error: "Unauthorized" });
});
// Purpose: Send a response with custom status and header

// Multiple cookies
app.get("/cookies", (ctx) => {
  ctx.setHeader("Set-Cookie", "id=1; Path=/; HttpOnly", { append: true });
  ctx.setHeader("Set-Cookie", "token=abc; Path=/; HttpOnly", { append: true });
  return ctx.text("Cookies set");
});
// Purpose: Set multiple cookies in a response

app.get("/old", (ctx) => ctx.redirect("/new"));          
// Purpose: Temporary redirect (HTTP 302)

app.get("/permanent", (ctx) => ctx.redirect("/new", 301)); 
// Purpose: Permanent redirect (HTTP 301)

// Serve file inline (streaming)
app.get("/video", (ctx) => ctx.sendFile("./media/video.mp4"));
// Purpose: Stream a file for inline viewing

// Serve with custom download filename
app.get("/image", (ctx) => ctx.sendFile("./media/pic.png", { filename: "photo.png" }));
// Purpose: Serve a file while specifying a download filename

app.post("/create", async (ctx) => {
  const body = await ctx.req.json();
  return ctx
    .status(201)
    .setHeader("x-resource-id", "42")
    .json({ message: "Created", data: body });
});
// Purpose: Demonstrate chaining of status, headers, and JSON response