Kurs vibe coding z Claude Code · Moduł 5: Klon Reddita
Wywiad w porcie: wyszukiwarka z frazą w adresie
W tej lekcji9
Wczoraj skończyłeś na czerwonym teście przekreśleń. Otwierasz terminal w folderze crew-council i wpisujesz claude -c: Claude Code otwiera ostatnią rozmowę z tego folderu, razem z poleceniem i wynikiem testu. Wystarczy napisać "Dokończ: dodaj remark-gfm, aż test przejdzie. Testów nie zmieniaj", przeczytać diff i zrobić commit. Dzisiejsze zadanie to już nowa funkcja, więc zaczynasz je od /clear. Dlaczego tak, a nie inaczej, zobaczysz w ostatniej lekcji tej lokacji.
Na Crew Council przybywa postów. Jack pamięta, że ktoś pisał o wraku ze złotem, ale nie pamięta ani tytułu, ani gildii. Przewijanie kilkuset postów to nie wywiad, to tortura. Potrzebna jest wyszukiwarka, która zadziała razem z gildiami i sortowaniem.
Problem: najpierw zapytaj, ile tego jest
Zanim padnie słowo o kodzie, odpowiedz na jedno pytanie: ile postów będzie przeszukiwać wyszukiwarka? Przy kilkuset wystarczy przejrzeć listę, którą Feed i tak trzyma w przeglądarce. Przy setkach tysięcy szukałaby baza danych na serwerze. Agent bez tej informacji zgaduje i często wybiera rozmach: nowy endpoint, bibliotekę do wyszukiwania pełnotekstowego albo bazę, o którą nie prosiłeś. Liczba w poleceniu oszczędza Ci tej przeprawy.
Druga decyzja: kiedy szukać. Fraza trafi do adresu jako ?q=, obok ?community= z lekcji 4_3, żeby link do wyników dało się wysłać kompanowi. Każda zmiana adresu to jednak prośba do serwera o stronę, co widziałeś w terminalu w lekcji 3_5. Tam pomagał debounce, czyli czekanie z wysłaniem, aż piszący zrobi przerwę. Tu prościej: szukasz po naciśnięciu Enter, więc na jedno wyszukiwanie przypada jedna prośba i debounce nie jest potrzebny. Next.js ma do tego komponent Form z next/form: formularz, który po wysłaniu dopisuje swoje pola do adresu i przechodzi pod niego bez przeładowania strony.
Polecenie dla Claude Code
Polecenie zbiera obie decyzje i od razu zamawia sprawdzian:
Polecenie dla Claude Code:
Dodaj wyszukiwarkę postów do Crew Council. Postów będzie kilkaset, więc
szukaj w przeglądarce, na liście, którą trzyma @components/Feed.tsx:
bez bazy danych, bez nowego endpointu i bez nowych paczek. Fraza trafia
do adresu jako ?q= obok ?community=, a pole wysyła ją Enterem przez Form
z next/form w components/SearchBar.tsx. Szukaj w tytule i treści, bez
względu na wielkość liter; przy kilku słowach post musi zawierać każde.
Najpierw testy funkcji searchPosts(posts, query) w lib/search.test.ts,
w tym fraza z nawiasem "(dwa". Uruchom je przed kodem i po nim.
Na koniec testy, lint i build, pokaż wynik.Polecenie mówi, ile jest danych, gdzie leżą i czego nie dodawać. Nawias w teście nie jest przypadkowy, za chwilę zobaczysz dlaczego.
Co napisał Claude: test
Otwórz lib/search.test.ts. Na górze stoją trzy posty zbudowane pomocnikiem makePost: mapa na Wyspie Czaszki, rejs na Tortugę z wrakiem w treści i łatanie kadłuba z treścią "Dziura nad linią wody (dwa łokcie)". Dwa przypadki z sześciu:
it("kilka słów: post musi zawierać każde z nich", () => {
expect(ids(searchPosts(list, "mapa czaszki"))).toEqual(["p1"]);
expect(ids(searchPosts(list, "czaszki mapa"))).toEqual(["p1"]);
expect(ids(searchPosts(list, "mapa kraken"))).toEqual([]);
});
it("znaki specjalne nie psują wyszukiwania", () => {
expect(ids(searchPosts(list, "(dwa"))).toEqual(["p3"]);
});ids zamienia wynik na listę samych id, więc porównanie mieści się w jednej linii. Pierwszy test mówi, że kolejność słów nie ma znaczenia, a słowo, którego nie ma w poście, odrzuca go. Pozostałe sprawdzają pustą frazę, wielkie litery, szukanie w treści i to, że lista wejściowa się nie zmienia. Na pustym szkielecie cztery z sześciu testów padają, i dobrze.
Najprostsza wersja nie wystarcza
Agenci często sięgają po wyrażenie regularne, czyli wzorzec do wyszukiwania w tekście, w którym niektóre znaki mają specjalne znaczenie. Sprawdziliśmy taką wersję:
const pattern = new RegExp(query.trim().split(/\s+/).join(".*"), "i");
return posts.filter((post) => pattern.test(`${post.title} ${post.content}`));Słowa sklejone przez .* znaczą "to słowo, coś, potem tamto", a flaga i wyłącza wielkość liter. Wynik testów:
× kilka słów: post musi zawierać każde z nich
× znaki specjalne nie psują wyszukiwania
SyntaxError: Invalid regular expression: /(dwa/i: Unterminated group
Tests 2 failed | 29 passed (31)Nawias we wzorcu otwiera grupę, której nikt nie zamknął, więc funkcja rzuca błąd. Na stronie oznaczałoby to biały ekran po wpisaniu nawiasu, a frazy "czaszki mapa" wzorzec nie znajdzie, bo pilnuje kolejności. Na ekranie z przykładowymi danymi wszystko wyglądało dobrze, test pokazał oba błędy.
Co napisał Claude: searchPosts
Wersja, która przechodzi, w ogóle nie używa wzorców:
export function searchPosts(posts: Post[], query: string): Post[] {
const words = query.toLocaleLowerCase("pl").split(/\s+/).filter(Boolean);
if (words.length === 0) {
return posts;
}
return posts.filter((post) => {
const text = `${post.title} ${post.content}`.toLocaleLowerCase("pl");
return words.every((word) => text.includes(word));
});
}toLocaleLowerCase("pl") zamienia wielkie litery na małe według zasad polskiego, więc "Skarb" i "skarb" trafiają tak samo. split(/\s+/) tnie frazę na słowa w miejscach spacji, a filter(Boolean) wyrzuca puste kawałki, więc fraza z samych spacji działa jak pusta. every zwraca true, gdy warunek spełnia każde słowo, a includes szuka zwykłego tekstu, w którym nawias to po prostu nawias. Pusta fraza zwraca tę samą listę, a filter zawsze buduje nową, więc stan nie zmienia się po cichu. Wynik: Tests 31 passed (31).
Co napisał Claude: fraza w adresie
app/page.tsx czyta frazę tak jak gildię w lekcji 4_3 i przekazuje ją dalej:
const { community, q } = await searchParams;
const query = typeof q === "string" ? q : "";Pod nagłówkiem stoi <SearchBar query={query} community={selected?.id ?? null} />, a Feed dostaje nowy prop query. Otwórz components/SearchBar.tsx; poniżej jego środek bez klas Tailwinda i tekstu podpowiedzi:
<Form action="/" role="search">
{community && <input type="hidden" name="community" value={community} />}
<input key={query} name="q" type="search" defaultValue={query} aria-label="Szukaj postów" />
<button type="submit">Szukaj</button>
</Form>Po Enterze Form składa adres z atrybutów name pól, na przykład /?community=pirate-life&q=wrak, i przechodzi pod niego bez przeładowania. Ukryte pole community sprawia, że szukasz w otwartej gildii. role="search" mówi czytnikowi ekranu, że to wyszukiwarka. Nie ma tu stanu ani "use client", więc pasek zostaje Server Componentem. Po co key, zobaczysz w przeglądzie.
W components/Feed.tsx przybyła jedna linia przed sortowaniem:
const found = searchPosts(filtered, query);
const visiblePosts = sortPosts(found, sortMode);Najpierw filtr gildii z lekcji 4_3, potem fraza, na końcu sortowanie tego, co zostało. Oba filtry tylko zawężają listę, a stan posts się nie zmienia, więc głosy i nowe posty przetrwają każde wyszukiwanie. Gdy nic nie pasuje, Feed pisze "Żaden post nie pasuje do frazy" zamiast zostawiać pustą stronę.
useMemo na zapas
Claude lubi owinąć taki filtr w useMemo, hook, który zapamiętuje wynik obliczenia między renderami i liczy go od nowa tylko po zmianie wartości z listy zależności. Dokumentacja Reacta mówi, że obliczenie zwykle nie jest kosztowne, dopóki nie tworzysz albo nie przeglądasz tysięcy obiektów, i radzi zmierzyć je przez console.time. Zasada z lekcji 3_5 obowiązuje dalej: najpierw pomiar, potem useMemo. Gdy spotkasz useMemo w cudzym kodzie, wiesz już, co robi.
Przegląd kapitana
- Filtr na serwerze. To typowy błąd agenta:
searchPostswapp/page.tsxi przefiltrowana lista podana doFeedjakoinitialPosts. Sprawdziliśmy go. Po Enterze adres się zmienia, a na liście dalej są wszystkie posty; dopiero odświeżenie strony pokazuje wynik.useState(initialPosts)bierze wartość startową tylko przy pierwszym renderze, jakGalleryw lekcji 3_5. Do tego nowe posty z formularza nigdy nie trafiłyby do wyników. W diffiesearchPostsma stać wFeed. - Pole po zmianie gildii. Wyszukaj "mapa" i kliknij Wszystkie. Lista pokazuje wszystkie posty, a pole ma być puste. Bez
key={query}zostaje w nim "mapa": pole, w którym ktoś pisał, trzyma wpisany tekst, nawet gdy zmieni się jegodefaultValue. Sprawdziliśmy to. Nowy klucz każe Reactowi narysować pole od nowa, z frazą z adresu. - Litery i nawiasy. Wpisz "MAPA", a potem "kraken (". Pierwsza fraza znajduje mapę, druga pokazuje komunikat o braku wyników, bez białego ekranu.
- Gildia, fraza i stan. Zagłosuj na post o Tortudze i dodaj w r/PirateLife post "Kto płynie po wrak?". Potem wejdź do r/PirateLife i wyszukaj "wrak". Adres to
/?community=pirate-life&q=wrak, głos i nowy post są na miejscu, a przycisk Wstecz wraca do poprzedniego wyniku.
Następny krok
Gdy wszystko przejdzie, poproś o commit, na przykład "Wyszukiwarka: searchPosts z testami, fraza w adresie". Potem kolejny mały krok:
Wyszukiwanie ma działać bez polskich znaków: "kadlub smola" znajduje
"Jak załatać kadłub smołą?". Najpierw test w @lib/search.test.ts,
uruchom go przed kodem i po nim. Testów nie zmieniaj.Pierwszy pomysł Claude to rozbicie liter z ogonkami na literę i znak przez normalize("NFD") i usunięcie znaków. Test i tak padnie: expected [] to deeply equal [ 'p3' ]. Litera ł nie rozkłada się na l i kreskę, więc "smoła" nie staje się "smola". Poprawka to jeszcze jedna zamiana, .replace(/ł/g, "l"), a test wyłapał ją, zanim zauważył to pierwszy pirat. Gdy zechcesz podświetlać znalezione słowa, każ Claude dzielić tekst na kawałki i owijać trafienia w element <mark> w JSX, a nie składać HTML dla dangerouslySetInnerHTML. W edytorze poniżej czeka wyszukiwarka z gildiami, sortowaniem i małym sprawdzianem searchPosts: wpisz frazę z nawiasem i obserwuj adres nad listą.
Pamiętaj: wywiad w porcie zaczynasz od pytania, ilu ludzi przesłuchać, a fraza zapisana w adresie to notatka, którą każdy kompan odczyta z tego samego miejsca.
Kod do tej lekcji: App.jsx
// Wywiad w porcie: wyszukiwarka z gildią i sortowaniem, fraza wysyłana Enterem
import { useState } from 'react';
const posts = [
{ id: 'p1', community: 'pirate-life', title: 'Płyniemy na Tortugę czy na północ?', content: 'Na północy leży wrak z ładownią złota.', score: 90 },
{ id: 'p2', community: 'treasure-hunting', title: 'Mapa z krzyżykiem na Wyspie Czaszki', content: 'Znalazłem ją w butelce.', score: 90 },
{ id: 'p3', community: 'ship-building', title: 'Jak załatać kadłub smołą?', content: 'Dziura nad linią wody (dwa łokcie).', score: 38 },
{ id: 'p4', community: 'sea-battles', title: 'Kraken zatopił nam szalupę', content: 'Omijajcie Zatokę Mgieł.', score: 45 },
{ id: 'p5', community: 'treasure-hunting', title: 'Druga mapa do tego samego wraku?', content: 'Ktoś sprzedaje ją w porcie.', score: 12 },
];
const communities = ['treasure-hunting', 'sea-battles', 'pirate-life', 'ship-building'];
// Ta sama funkcja co lib/search.ts: zwykły tekst zamiast wzorca, każde słowo musi wystąpić
function searchPosts(list, query) {
const words = query.toLocaleLowerCase('pl').split(/\s+/).filter(Boolean);
if (words.length === 0) return list;
return list.filter((post) => {
const text = `${post.title} ${post.content}`.toLocaleLowerCase('pl');
return words.every((word) => text.includes(word));
});
}
const ids = (list) => list.map((post) => post.id).join(',');
const checks = [
{ name: 'pusta fraza zwraca wszystko', ok: ids(searchPosts(posts, ' ')) === ids(posts) },
{ name: 'wielkie litery: MAPA', ok: ids(searchPosts(posts, 'MAPA')) === 'p2,p5' },
{ name: 'szukanie w treści: butelce', ok: ids(searchPosts(posts, 'butelce')) === 'p2' },
{ name: 'kolejność słów: wraku druga', ok: ids(searchPosts(posts, 'wraku druga')) === 'p5' },
{ name: 'nawias: (dwa', ok: ids(searchPosts(posts, '(dwa')) === 'p3' },
];
export default function App() {
const [community, setCommunity] = useState('');
const [query, setQuery] = useState('');
const [sortMode, setSortMode] = useState('top');
// W projekcie fraza i gildia żyją w adresie; tu pokazujemy, jak by wyglądał
const params = new URLSearchParams();
if (community) params.set('community', community);
if (query) params.set('q', query);
const address = '/' + (params.toString() ? '?' + params.toString() : '');
// Najpierw gildia, potem fraza, na końcu sortowanie kopii
const inCommunity = community ? posts.filter((post) => post.community === community) : posts;
const found = searchPosts(inCommunity, query);
const visible = [...found].sort((a, b) => (sortMode === 'top' ? b.score - a.score : a.title.localeCompare(b.title, 'pl')));
const handleSubmit = (event) => {
event.preventDefault();
setQuery(new FormData(event.currentTarget).get('q'));
};
return (
<div className="min-h-screen bg-gray-100 p-4 text-gray-900">
<div className="mx-auto max-w-2xl space-y-3">
<h1 className="text-2xl font-bold">Crew Council: wyszukiwarka</h1>
<form onSubmit={handleSubmit} role="search" className="flex gap-2">
<input key={query} name="q" type="search" defaultValue={query} aria-label="Szukaj postów" placeholder="Szukaj w tytułach i treści, Enter wysyła" className="flex-1 rounded border border-gray-300 bg-white p-2" />
<button type="submit" className="rounded bg-gray-900 px-4 text-white">Szukaj</button>
</form>
<div className="flex flex-wrap gap-2">
<select value={community} onChange={(event) => setCommunity(event.target.value)} aria-label="Gildia" className="rounded border border-gray-300 bg-white p-1">
<option value="">Wszystkie gildie</option>
{communities.map((id) => <option key={id} value={id}>{id}</option>)}
</select>
{['top', 'a-z'].map((mode) => (
<button key={mode} type="button" onClick={() => setSortMode(mode)} aria-pressed={sortMode === mode} className={sortMode === mode ? 'rounded bg-orange-600 px-3 py-1 text-white' : 'rounded px-3 py-1 hover:bg-gray-200'}>
{mode}
</button>
))}
</div>
<p className="font-mono text-sm text-gray-600">Adres: {address}</p>
{visible.length === 0 && <p className="text-gray-500">Żaden post nie pasuje do frazy: {query}</p>}
{visible.map((post) => (
<article key={post.id} className="rounded-lg border border-gray-200 bg-white p-3">
<p className="text-xs text-gray-500">r/{post.community} · score {post.score}</p>
<h2 className="font-semibold">{post.title}</h2>
<p className="text-sm text-gray-700">{post.content}</p>
</article>
))}
<section className="rounded-lg bg-white p-3 text-sm">
<h2 className="mb-2 font-bold">Sprawdzian searchPosts</h2>
<ul className="space-y-1">
{checks.map((check) => (
<li key={check.name} className={check.ok ? 'text-green-700' : 'font-semibold text-red-700'}>
{check.ok ? 'ZALICZONY' : 'NIEZALICZONY'}: {check.name}
</li>
))}
</ul>
<p className="mt-2 text-gray-600">Zamień includes na wyrażenie regularne i wpisz nawias: zobacz, co się stanie.</p>
</section>
</div>
</div>
);
}Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Co zwróci searchPosts z lekcji dla frazy "czaszki mapa", gdy jeden z postów ma tytuł "Mapa z krzyżykiem na Wyspie Czaszki"?
2. Kiedy według lekcji warto owinąć filtrowanie postów w useMemo?
To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Search and filter posts
- Układanie w pionie
Uporządkuj, co dzieje się po wpisaniu "wrak" w r/PirateLife i naciśnięciu Enter:
- Układanie w pionie
Dodajesz przekreślenia przez remark-gfm. Uporządkuj kroki pętli z testem, od prośby do commita:
Zadania po tej lekcji
- PytanieQuiz: Kilka słów w searchPosts
- Zadanie z kodemPraktyka: Search & filter
- PytanieQuiz: Kiedy useMemo przy filtrowaniu
- Ułóż w kolejnościSortowanie: Droga frazy wyszukiwania
- PytanieQuiz: Gdzie filtrować wyszukiwanie
- PytanieQuiz: key na polu wyszukiwania
- Ułóż w kolejnościSortowanie: Najpierw test, potem commit
- PytanieQuiz: Co jest dowodem
- PytanieQuiz: Zmieniona wartość w teście