redirect

This is a shortcut for sending 30x responses.

  1. import { redirect } from "@remix-run/node"; // or cloudflare/deno
  3. export const action = async () => {
  4.   const userSession = await getUserSessionOrWhatever();
  6.   if (!userSession) {
  7.     return redirect("/login");
  8.   }
  10.   return json({ ok: true });
  11. };

By default, it sends 302, but you can change it to whichever redirect status code you’d like:

  1. redirect(path, 301);
  2. redirect(path, 303);

You can also send a ResponseInit to set headers, like committing a session.

  1. redirect(path, {
  2.   headers: {
  3.     "Set-Cookie": await commitSession(session),
  4.   },
  5. });
  7. redirect(path, {
  8.   status: 302,
  9.   headers: {
  10.     "Set-Cookie": await commitSession(session),
  11.   },
  12. });

Of course, you can do redirects without this helper if you’d rather build it up yourself:

  1. // this is a shortcut...
  2. return redirect("/else/where", 303);
  4. // ...for this
  5. return new Response(null, {
  6.   status: 303,
  7.   headers: {
  8.     Location: "/else/where",
  9.   },
  10. });

And you can throw redirects to break through the call stack and redirect right away:

  1. if (!session) {
  2.   throw redirect("/login", 302);
  3. }