Server Utilities (react-just/server)

Server Only

These APIs can only be used in Server Components, Server Functions, or their transitive dependencies. They cannot be used in Client Components or in code that runs in the browser.

request

Access information about the incoming HTTP request.

import { request } from "react-just/server";

async function RequestDetails() {
  const { url, method, headers } = request();

  const parsed = new URL(url);
  const device = await getDevice(headers.get("user-agent"));

  return (
    <div>
      <p>Method: {method}</p>
      <p>Pathname: {parsed.pathname}</p>
      <p>Device: {device}</p>
    </div>
  );
}

"use server";

export async function addComment() {
  const { headers } = request();

  const device = await getDevice(headers.get("user-agent"));

  // ...
}

Parameters

const req = request();

request takes no parameters.

Returns

function request(): JustRequest;

interface JustRequest {
  readonly headers: Headers;
  readonly method: string;
  readonly url: string;
}

request returns an object with the following properties:

• headers: A standard Headers representing the request headers.
• method: The HTTP method of the request (e.g., GET, POST).
• url: The absolute URL of the request. You can create a URL instance from it.

response

Access and modify the outgoing HTTP response of a Server Function.

Server Functions Only

Changes to the response made during rendering will not take effect.

"use server";

import { response } from "react-just/server";

export async function logout() {
  const res = response();

  res.headers.append("Set-Cookie", "sessionId=; Max-Age=0; Path=/; HttpOnly");
}

Parameters

const res = response();

response takes no parameters.

Returns

declare function response(): JustResponse;

interface JustResponse {
  readonly headers: Headers;
}

response returns an object containing the following properties:

• headers: A standard Headers object representing the response headers. Use it to set headers like Set-Cookie.