Cours Vibe coding avec Claude Code · Module 5: Clone de Reddit

Interrogatoire au port : une recherche dont la phrase vit dans l'adresse

10 min de lecture ·
Dans cette leçon9

Hier tu t'es arrêté sur le test rouge du texte barré. Tu ouvres un terminal dans le dossier crew-council et tu tapes claude -c : Claude Code rouvre la dernière conversation de ce dossier, avec la demande et le résultat du test. Il suffit d'écrire "Termine : ajoute remark-gfm jusqu'à ce que le test passe. Ne modifie pas les tests", de lire le diff et de faire un commit. La tâche d'aujourd'hui est déjà une nouvelle fonctionnalité, tu la commences donc par /clear. Pourquoi ainsi et pas autrement, tu le verras dans la dernière leçon de ce lieu.

Crew Council reçoit de plus en plus de posts. Jack se souvient que quelqu'un a écrit sur une épave pleine d'or, mais il ne se rappelle ni le titre ni la guilde. Faire défiler des centaines de posts n'est pas un interrogatoire, c'est une torture. Il faut une recherche qui marche avec les guildes et le tri.

Problème : d'abord, demande combien il y en a

Avant de parler de code, réponds à une question : combien de posts la recherche devra-t-elle parcourir ? Pour quelques centaines, il suffit de parcourir la liste que Feed garde de toute façon dans le navigateur. Pour des centaines de milliers, ce serait la base de données du serveur qui chercherait. Un agent qui n'a pas cette information devine, et choisit souvent la grandeur : un nouvel endpoint, une bibliothèque de recherche plein texte ou une base dont tu n'avais pas parlé. Un nombre dans la demande t'épargne cette traversée.

Seconde décision : quand chercher. La phrase ira dans l'adresse sous la forme ?q=, à côté de ?community= de la leçon 4_3, afin que le lien vers les résultats puisse être envoyé à un compagnon. Mais chaque changement d'adresse est une demande de page au serveur, ce que tu as vu dans le terminal à la leçon 3_5. Là, le debounce aidait, c'est-à-dire attendre pour envoyer que celui qui écrit fasse une pause. Ici c'est plus simple : tu cherches en appuyant sur Entrée, donc une recherche égale une demande et le debounce n'est pas nécessaire. Next.js a pour cela le composant Form de next/form : un formulaire qui, à l'envoi, ajoute ses champs à l'adresse et passe à cette adresse sans recharger la page.

Demande pour Claude Code

La demande rassemble les deux décisions et commande tout de suite une épreuve :

Demande pour Claude Code :

Ajoute une recherche de posts à Crew Council. Il y aura quelques
centaines de posts, donc cherche dans le navigateur, dans la liste que
garde @components/Feed.tsx : sans base de données, sans nouvel endpoint
et sans nouveau paquet. La phrase va dans l'adresse sous la forme ?q=
à côté de ?community=, et le champ l'envoie par Entrée avec Form de
next/form dans components/SearchBar.tsx. Cherche dans le titre et le
contenu, sans tenir compte des majuscules ; avec plusieurs mots, le
post doit contenir chacun d'eux. D'abord les tests de la fonction
searchPosts(posts, query) dans lib/search.test.ts, y compris la phrase
avec une parenthèse "(deux". Lance-les avant le code et après.
À la fin, tests, lint et build, montre le résultat.

La demande dit combien il y a de données, où elles se trouvent et ce qu'il ne faut pas ajouter. La parenthèse dans le test n'est pas un hasard, tu vas voir pourquoi dans un instant.

Ce que Claude a écrit : le test

Ouvre lib/search.test.ts. En haut se tiennent trois posts construits avec l'assistant makePost : une carte de l'île du Crâne, un voyage vers Tortuga avec une épave dans le contenu, et le colmatage de la coque avec le contenu "Brèche au-dessus de la ligne de flottaison (deux coudées)". Deux cas sur six :

it("plusieurs mots : le post doit contenir chacun d'eux", () => {
  expect(ids(searchPosts(list, "carte crâne"))).toEqual(["p1"]);
  expect(ids(searchPosts(list, "crâne carte"))).toEqual(["p1"]);
  expect(ids(searchPosts(list, "carte kraken"))).toEqual([]);
});

it("les caractères spéciaux ne cassent pas la recherche", () => {
  expect(ids(searchPosts(list, "(deux"))).toEqual(["p3"]);
});

ids transforme le résultat en liste des seuls id, donc la comparaison tient sur une ligne. Le premier test dit que l'ordre des mots n'a pas d'importance, et qu'un mot absent du post l'écarte. Les autres vérifient la phrase vide, les majuscules, la recherche dans le contenu et le fait que la liste d'entrée ne change pas. Sur un squelette vide, quatre tests sur six tombent, et c'est très bien.

La version la plus simple ne suffit pas

Les agents prennent souvent une expression régulière, c'est-à-dire un motif de recherche dans un texte où certains caractères ont un sens spécial. Nous avons essayé une telle version :

const pattern = new RegExp(query.trim().split(/\s+/).join(".*"), "i");
return posts.filter((post) => pattern.test(`${post.title} ${post.content}`));

Les mots collés par .* signifient "ce mot, quelque chose, puis cet autre", et le drapeau i désactive la casse. Le résultat des tests :

     × plusieurs mots : le post doit contenir chacun d'eux
     × les caractères spéciaux ne cassent pas la recherche

SyntaxError: Invalid regular expression: /(deux/i: Unterminated group

      Tests  2 failed | 29 passed (31)

La parenthèse dans le motif ouvre un groupe que personne n'a fermé, et la fonction lance donc une erreur. Sur la page, cela donnerait un écran blanc après la saisie d'une parenthèse, et la phrase "crâne carte" ne serait pas trouvée, puisque le motif surveille l'ordre. Avec les données d'exemple, tout avait l'air bien à l'écran, le test a montré les deux erreurs.

Ce que Claude a écrit : searchPosts

La version qui passe n'utilise aucun motif :

export function searchPosts(posts: Post[], query: string): Post[] {
  const words = query.toLocaleLowerCase("fr").split(/\s+/).filter(Boolean);
  if (words.length === 0) {
    return posts;
  }
  return posts.filter((post) => {
    const text = `${post.title} ${post.content}`.toLocaleLowerCase("fr");
    return words.every((word) => text.includes(word));
  });
}

toLocaleLowerCase("fr") passe les majuscules en minuscules selon les règles du français, donc « Trésor » et « trésor » se trouvent de la même façon. split(/\s+/) coupe la phrase en mots aux espaces, et filter(Boolean) jette les morceaux vides, donc une phrase de seuls espaces agit comme une phrase vide. every renvoie true quand chaque mot remplit la condition, et includes cherche du texte ordinaire, où la parenthèse n'est qu'une parenthèse. La phrase vide renvoie la même liste, et filter en construit toujours une nouvelle, donc l'état ne change pas en silence. Résultat : Tests 31 passed (31).

Ce que Claude a écrit : la phrase dans l'adresse

app/page.tsx lit la phrase comme la guilde de la leçon 4_3 et la transmet :

const { community, q } = await searchParams;
const query = typeof q === "string" ? q : "";

Sous le titre se tient <SearchBar query={query} community={selected?.id ?? null} />, et Feed reçoit une nouvelle prop query. Ouvre components/SearchBar.tsx ; voici son milieu, sans les classes Tailwind ni le texte d'indice :

<Form action="/" role="search">
  {community && <input type="hidden" name="community" value={community} />}
  <input key={query} name="q" type="search" defaultValue={query} aria-label="Chercher des posts" />
  <button type="submit">Chercher</button>
</Form>

Après Entrée, Form assemble l'adresse à partir des attributs name des champs, par exemple /?community=pirate-life&q=épave, et y passe sans recharger. Le champ caché community fait que tu cherches dans la guilde ouverte. role="search" dit au lecteur d'écran qu'il s'agit d'une recherche. Il n'y a ici ni état ni "use client", la barre reste donc un Server Component. Pourquoi key, tu le verras dans la revue.

Dans components/Feed.tsx, une ligne s'est ajoutée avant le tri :

const found = searchPosts(filtered, query);
const visiblePosts = sortPosts(found, sortMode);

D'abord le filtre de guilde de la leçon 4_3, puis la phrase, et à la fin le tri de ce qui reste. Les deux filtres ne font que resserrer la liste, et l'état posts ne change pas, donc les votes et les nouveaux posts survivent à chaque recherche. Quand rien ne correspond, Feed écrit "Aucun post ne correspond à la phrase" au lieu de laisser une page vide.

useMemo par précaution

Claude aime envelopper un tel filtre dans useMemo, un hook qui mémorise le résultat d'un calcul entre les rendus et ne le refait qu'après un changement d'une valeur de la liste de dépendances. La documentation de React dit que ce calcul n'est en général pas coûteux tant que tu ne crées ni ne parcours des milliers d'objets, et conseille de le mesurer avec console.time. La règle de la leçon 3_5 reste valable : d'abord la mesure, ensuite useMemo. Quand tu rencontreras useMemo dans le code d'un autre, tu sauras déjà ce qu'il fait.

La revue du capitaine

  1. Le filtre sur le serveur. C'est l'erreur typique d'un agent : searchPosts dans app/page.tsx, et la liste filtrée donnée à Feed comme initialPosts. Nous l'avons essayé. Après Entrée l'adresse change, mais la liste contient toujours tous les posts ; seul le rechargement de la page montre le résultat. useState(initialPosts) ne prend la valeur de départ qu'au premier rendu, comme Gallery dans la leçon 3_5. De plus, les nouveaux posts du formulaire n'arriveraient jamais dans les résultats. Dans le diff, searchPosts doit se trouver dans Feed.
  2. Le champ après un changement de guilde. Cherche "carte" et clique sur Toutes. La liste montre tous les posts, et le champ doit être vide. Sans key={query}, "carte" y reste : un champ où quelqu'un a écrit garde le texte saisi, même quand son defaultValue change. Nous l'avons vérifié. Une nouvelle clé dit à React de redessiner le champ à neuf, avec la phrase de l'adresse.
  3. Lettres et parenthèses. Tape "CARTE", puis "kraken (". La première phrase trouve la carte, la seconde affiche le message d'absence de résultats, sans écran blanc.
  4. Guilde, phrase et état. Vote pour le post sur Tortuga et ajoute dans r/PirateLife le post "Qui part chercher l'épave ?". Puis entre dans r/PirateLife et cherche "épave". L'adresse est /?community=pirate-life&q=épave, le vote et le nouveau post sont en place, et le bouton Retour revient au résultat précédent.

Étape suivante

Quand tout passe, demande un commit, par exemple "Recherche : searchPosts avec tests, phrase dans l'adresse". Puis une autre petite étape :

La recherche doit marcher sans accents : "crane" trouve "Carte de
l'île du Crâne", et "lukasz goudron" trouve "Comment Łukasz colmate la
coque au goudron ?". D'abord un test dans @lib/search.test.ts, lance-le
avant le code et après. Ne modifie pas les tests.

La première idée de Claude est de décomposer les lettres accentuées en une lettre et un signe avec normalize("NFD") et de supprimer les signes. Le test tombera quand même : expected [] to deeply equal [ 'p3' ]. La lettre Ł ne se décompose pas en L et en trait, donc "Łukasz" ne devient pas "lukasz". Pour "crane", en revanche, tout va bien, car "â" se décompose proprement. La correction est un remplacement de plus, .replace(/ł/g, "l") après le passage en minuscules, et le test l'a attrapée avant que le premier pirate ne la remarque. Quand tu voudras surligner les mots trouvés, demande à Claude de couper le texte en morceaux et d'envelopper les résultats dans un élément <mark> en JSX, et non d'assembler du HTML pour dangerouslySetInnerHTML. Dans l'éditeur ci-dessous t'attend une recherche avec les guildes, le tri et une petite épreuve de searchPosts : tape une phrase avec une parenthèse et observe l'adresse au-dessus de la liste.

À retenir : l'interrogatoire au port commence par la question de savoir combien de gens interroger, et la phrase écrite dans l'adresse est une note que chaque compagnon lit au même endroit.

Code de cette leçon : App.jsx
// Interrogatoire au port : une recherche avec guilde et tri, la phrase envoyée par Entrée
import { useState } from 'react';

const posts = [
  { id: 'p1', community: 'pirate-life', title: 'Cap sur Tortuga ou vers le nord ?', content: "Au nord gît une épave avec une cale pleine d'or.", score: 90 },
  { id: 'p2', community: 'treasure-hunting', title: "Carte avec une croix sur l'île du Crâne", content: "Je l'ai trouvée dans une bouteille.", score: 90 },
  { id: 'p3', community: 'ship-building', title: 'Comment Łukasz colmate la coque au goudron ?', content: 'Brèche au-dessus de la ligne de flottaison (deux coudées).', score: 38 },
  { id: 'p4', community: 'sea-battles', title: "Le Kraken a coulé notre chaloupe", content: 'Évitez la baie des Brumes.', score: 45 },
  { id: 'p5', community: 'treasure-hunting', title: 'Une deuxième carte vers la même épave ?', content: "Quelqu'un la vend au port.", score: 12 },
];

const communities = ['treasure-hunting', 'sea-battles', 'pirate-life', 'ship-building'];

// La même fonction que lib/search.ts : du texte ordinaire au lieu d'un motif, chaque mot doit apparaître
function searchPosts(list, query) {
  const words = query.toLocaleLowerCase('fr').split(/\s+/).filter(Boolean);
  if (words.length === 0) return list;
  return list.filter((post) => {
    const text = `${post.title} ${post.content}`.toLocaleLowerCase('fr');
    return words.every((word) => text.includes(word));
  });
}

const ids = (list) => list.map((post) => post.id).join(',');
const checks = [
  { name: 'une phrase vide renvoie tout', ok: ids(searchPosts(posts, '   ')) === ids(posts) },
  { name: 'majuscules : CARTE', ok: ids(searchPosts(posts, 'CARTE')) === 'p2,p5' },
  { name: 'recherche dans le contenu : bouteille', ok: ids(searchPosts(posts, 'bouteille')) === 'p2' },
  { name: 'ordre des mots : épave deuxième', ok: ids(searchPosts(posts, 'épave deuxième')) === 'p5' },
  { name: 'parenthèse : (deux', ok: ids(searchPosts(posts, '(deux')) === 'p3' },
];

export default function App() {
  const [community, setCommunity] = useState('');
  const [query, setQuery] = useState('');
  const [sortMode, setSortMode] = useState('top');

  // Dans le projet, la phrase et la guilde vivent dans l'adresse ; ici on montre à quoi elle ressemblerait
  const params = new URLSearchParams();
  if (community) params.set('community', community);
  if (query) params.set('q', query);
  const address = '/' + (params.toString() ? '?' + params.toString() : '');

  // D'abord la guilde, puis la phrase, à la fin le tri d'une copie
  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, 'fr')));

  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 : la recherche</h1>
        <form onSubmit={handleSubmit} role="search" className="flex gap-2">
          <input key={query} name="q" type="search" defaultValue={query} aria-label="Chercher des posts" placeholder="Cherche dans les titres et le contenu, Entrée envoie" className="flex-1 rounded border border-gray-300 bg-white p-2" />
          <button type="submit" className="rounded bg-gray-900 px-4 text-white">Chercher</button>
        </form>
        <div className="flex flex-wrap gap-2">
          <select value={community} onChange={(event) => setCommunity(event.target.value)} aria-label="Guilde" className="rounded border border-gray-300 bg-white p-1">
            <option value="">Toutes les guildes</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">Adresse : {address}</p>
        {visible.length === 0 && <p className="text-gray-500">Aucun post ne correspond à la phrase : {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">Épreuve de 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 ? 'RÉUSSI' : 'ÉCHOUÉ'} : {check.name}
              </li>
            ))}
          </ul>
          <p className="mt-2 text-gray-600">Remplace includes par une expression régulière et tape une parenthèse : vois ce qui se passe.</p>
        </section>
      </div>
    </div>
  );
}

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Que renvoie searchPosts de la leçon pour la phrase "crâne carte", quand l'un des posts a pour titre "Carte avec une croix sur l'île du Crâne" ?

  2. 2. Quand, d'après la leçon, vaut-il la peine d'envelopper le filtrage des posts dans useMemo ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Éditeur de code

    Rechercher et filtrer des posts

  • Tri vertical

    Ordonne ce qui se passe quand tu tapes "épave" dans r/PirateLife et que tu appuies sur Entrée :

  • Tri vertical

    Tu ajoutes le texte barré avec remark-gfm. Ordonne les étapes de la boucle avec test, de la demande au commit :

  1. QuestionQuiz : Plusieurs mots dans searchPosts
  2. Exercice de codePratique : Recherche et filtre
  3. QuestionQuiz : Quand utiliser useMemo pour le filtrage
  4. Remets dans l'ordreTri : Le trajet de la phrase de recherche
  5. QuestionQuiz : Où filtrer la recherche
  6. QuestionQuiz : key sur le champ de recherche
  7. Remets dans l'ordreTri : D'abord le test, puis le commit
  8. QuestionQuiz : Qu'est-ce qui prouve
  9. QuestionQuiz : Une valeur modifiée dans un test

Articles utiles