Kurs Svelte i SvelteKit · Moduł 14: Hooki, API i wdrożenie

Straż Heimdalla - Hooks

2 min czytania ·
W tej lekcji4

Witaj na posterunku Heimdalla! On strzeże Bifröstu i widzi wszystko. Hooks w SvelteKit to strażnicy Twojej aplikacji - widzą każde żądanie!

hooks.server.js

// src/hooks.server.js

export async function handle({ event, resolve }) {
  // Przed przetworzeniem żądania
  console.log('Żądanie:', event.url.pathname);

  // Dodaj dane do locals
  const session = await getSession(event.cookies.get('session'));
  event.locals.user = session?.user;

  // Przetwórz żądanie
  const response = await resolve(event);

  // Po przetworzeniu
  console.log('Odpowiedź status:', response.status);

  return response;
}

Authentication middleware

// hooks.server.js
import { redirect } from '@sveltejs/kit';

export async function handle({ event, resolve }) {
  const session = event.cookies.get('session');

  if (session) {
    const user = await getUserFromSession(session);
    event.locals.user = user;
  }

  // Chroń ścieżki
  if (event.url.pathname.startsWith('/dashboard') && !event.locals.user) {
    redirect(303, '/login');
  }

  return resolve(event);
}

Tak jak w funkcjach load, redirect() w hooku handle sam rzuca wyjątek, a SvelteKit zamienia go na odpowiedź z przekierowaniem.

Kilku strażników: sequence

Gdy hook robi wiele rzeczy, podziel go na mniejsze funkcje i połącz je pomocnikiem sequence. Wykonają się po kolei, jak kolejne posterunki na moście Bifröst:

// hooks.server.js
import { sequence } from '@sveltejs/kit/hooks';

async function auth({ event, resolve }) {
  event.locals.user = await getUserFromSession(event.cookies.get('session'));
  return resolve(event);
}

async function logger({ event, resolve }) {
  console.log('Żądanie:', event.url.pathname);
  return resolve(event);
}

export const handle = sequence(auth, logger);

handleError

// hooks.server.js
export function handleError({ kind, error, event }) {
  // kind: 'app', 'framework', 'validation' lub 'unknown'
  if (kind !== 'unknown') {
    return error; // błędy z error() przekazujemy bez zmian
  }

  console.error('Error:', error);

  // Wyślij do Sentry, LogRocket itp.
  Sentry.captureException(error);

  return {
    message: 'Wystąpił błąd'
  };
}

W SvelteKit 3 handleError dostaje wszystkie błędy, a pole kind mówi, skąd pochodzą. Nieoczekiwane błędy (unknown) logujesz i zamieniasz na bezpieczny komunikat, żeby nie pokazać użytkownikowi szczegółów serwera.

Heimdall widzi wszystko - Twoje hooks też!

Kod do tej lekcji: App.svelte
<script>
  // Straż Heimdalla - Hooks
  // hooks.server.js - strażnik każdego żądania

  let requests = $state([]);
  let isAuthenticated = $state(false);
  let user = $state(null);
  let nextId = 1;

  // Symulacja hooka handle
  function simulateRequest(path) {
    const timestamp = new Date().toLocaleTimeString();
    const log = {
      id: nextId++,
      time: timestamp,
      path,
      user: isAuthenticated ? user?.name : 'anonymous'
    };

    requests = [log, ...requests].slice(0, 5);

    // Symulacja protected route
    if (path.startsWith('/dashboard') && !isAuthenticated) {
      return { redirect: '/login', status: 303 };
    }

    return { ok: true };
  }

  function login() {
    isAuthenticated = true;
    user = { name: 'Ragnar', role: 'jarl' };
  }

  function logout() {
    isAuthenticated = false;
    user = null;
  }
</script>

<main class="heimdall">
  <h1>Straż Heimdalla - Hooks</h1>
  <p class="subtitle">hooks.server.js - widzi każde żądanie</p>

  <section class="code">
    <h2>hooks.server.js</h2>
    <pre>
import {"{"} redirect {"}"} from '@sveltejs/kit';

export async function handle({"{"} event, resolve {"}"}) {"{"}
  // 1. Przed przetworzeniem
  console.log('Request:', event.url.pathname);

  // 2. Dodaj dane do locals
  const session = event.cookies.get('session');
  event.locals.user = await getUser(session);

  // 3. Chroń ścieżki
  if (event.url.pathname.startsWith('/dashboard')) {"{"}
    if (!event.locals.user) {"{"}
      redirect(303, '/login');
    {"}"}
  {"}"}

  // 4. Przetwórz żądanie
  const response = await resolve(event);

  // 5. Po przetworzeniu
  console.log('Status:', response.status);

  return response;
{"}"}
    </pre>
  </section>

  <section class="auth">
    <h2>Status użytkownika</h2>
    {#if isAuthenticated}
      <p>Zalogowany jako: <strong>{user.name}</strong></p>
      <button onclick={logout}>Wyloguj</button>
    {:else}
      <p>Niezalogowany</p>
      <button onclick={login}>Zaloguj jako Ragnar</button>
    {/if}
  </section>

  <section class="test">
    <h2>Testuj ścieżki</h2>
    <div class="paths">
      <button onclick={() => simulateRequest('/')}>/ (Home)</button>
      <button onclick={() => simulateRequest('/warriors')}>/warriors</button>
      <button onclick={() => simulateRequest('/dashboard')}>/dashboard</button>
    </div>
  </section>

  <section class="logs">
    <h2>Request logs</h2>
    {#each requests as req (req.id)}
      <div class="log">
        <span class="time">{req.time}</span>
        <span class="path">{req.path}</span>
        <span class="user">{req.user}</span>
      </div>
    {:else}
      <p class="empty">Brak żądań</p>
    {/each}
  </section>
</main>

<style>
  .heimdall {
    font-family: 'Georgia', serif;
    max-width: 600px;
    margin: 0 auto;
    padding: 2rem;
    background: linear-gradient(135deg, #0a1628 0%, #1a2d4e 100%);
    color: #b8d4f7;
    min-height: 100vh;
  }

  h1 {
    color: #ffd700;
    text-align: center;
  }

  .subtitle {
    text-align: center;
    color: #6a8ab9;
  }

  section {
    background: rgba(74, 144, 217, 0.1);
    border: 1px solid #4a90d9;
    border-radius: 8px;
    padding: 1rem;
    margin: 1rem 0;
  }

  h2 {
    color: #4a90d9;
    font-size: 1rem;
    margin-top: 0;
  }

  pre {
    background: rgba(0,0,0,0.5);
    padding: 1rem;
    border-radius: 4px;
    font-size: 0.75rem;
    overflow-x: auto;
  }

  strong {
    color: #ffd700;
  }

  button {
    padding: 0.5rem 1rem;
    background: #1e3a5f;
    color: #b8d4f7;
    border: 1px solid #4a90d9;
    border-radius: 4px;
    cursor: pointer;
    margin-right: 0.5rem;
  }

  .paths {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
  }

  .log {
    display: flex;
    gap: 1rem;
    padding: 0.5rem;
    background: rgba(0,0,0,0.3);
    border-radius: 4px;
    margin-bottom: 0.25rem;
    font-size: 0.9rem;
  }

  .time {
    color: #6a8ab9;
    font-family: monospace;
  }

  .path {
    color: #ffd700;
    flex: 1;
  }

  .user {
    color: #90ee90;
  }

  .empty {
    color: #6a8ab9;
    font-style: italic;
  }
</style>

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. W jakim pliku definiujemy server hooks?

  2. 2. Co robi funkcja handle() w hooks.server.js?

  1. PytaniePlik z server hooks
  2. PytanieFunkcja handle()

Przydatne artykuły