Kurs Svelte i SvelteKit · Moduł 14: Hooki, API i wdrożenie
Straż Heimdalla - Hooks
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. W jakim pliku definiujemy server hooks?
2. Co robi funkcja handle() w hooks.server.js?