Cours Vibe coding avec Claude Code · Module 11: Clone de Spotify
Recherche et recommandations : d'abord une reconnaissance, ensuite les changements
Dans cette leçon10
Le catalogue de Sea Shanty Sounds grandit et personne ne fera défiler des centaines de shanties pour trouver celle du kraken. L'équipage a besoin d'une recherche avec des onglets et d'une petite fenêtre "Similaires" qui propose quelque chose dans la même ambiance. Le projet a déjà deux leçons de code derrière lui : avant que Claude ne change quoi que ce soit, il doit donc savoir ce qui existe. Un agent qui ne le vérifie pas crée volontiers une seconde copie des données dans un nouveau fichier ou appelle des fonctions que personne n'a écrites.
Ce que tu vas apprendre
- envoyer le sous-agent Explore en reconnaissance avant que Claude ne change le code ;
- lire une recherche avec un délai de 300 ms qui nettoie derrière elle ;
- vérifier qu'une ancienne réponse du serveur n'écrase pas une plus récente ;
- veiller à ce que chaque onglet ait sa section ou un état vide.
La reconnaissance avec Explore
Tu connais le sous-agent intégré Explore depuis la leçon 5_4. La documentation de Claude Code le décrit comme un assistant qui cherche des fichiers et lit du code, qui n'a que des outils de lecture (Write et Edit lui sont bloqués) et démarre sans ton CLAUDE.md, pour que la reconnaissance reste rapide et peu coûteuse. C'est un autre outil que /btw de la leçon 10_1. La documentation le résume ainsi : avec /btw, tu interroges ce que Claude sait déjà de la conversation, et tu envoies un sous-agent pour qu'il apprenne quelque chose de nouveau.
Demande pour Claude Code (reconnaissance) :
Utilise le sous-agent Explore. Ne modifie aucun fichier. Avant que nous
ajoutions la recherche, établis : où se trouvent les données du
catalogue (morceaux, albums, artistes, playlists) et quels fichiers les
importent, s'il existe déjà dans le projet une fonction qui formate le
temps ou compare du texte, et quels types décrivent un morceau, un
album, un artiste et une playlist. Réponds en 5 points, avec le chemin
du fichier pour chacun.Tu vérifies le rapport dans Cursor avant de commander quoi que ce soit. Après les leçons 10_1 et 10_2, les données se trouvent dans un seul fichier, lib/catalog.ts, et trois pages l'importent : app/page.tsx, app/playlists/page.tsx et app/playlists/[id]/page.tsx, ainsi que les tests. Cherche dans le projet (Cmd+Shift+F sur Mac, Ctrl+Shift+F sous Windows) lib/catalog et compare les occurrences avec le rapport. Un rapport qui oublie un fichier ou cite un fichier qui n'existe pas, tu le renvoies avec une demande de correction. Un bon rapport mentionne aussi formatTime dans lib/format.ts, et dit qu'il n'existe pas de fonction pour comparer du texte.
La demande : la recherche
Demande pour Claude Code (construction) :
À partir de la reconnaissance, ajoute la recherche. lib/search.ts :
searchCatalog sur les données de @lib/catalog.ts, sans seconde copie
des données, sans accents ("ecume" trouve "Écume"). Un Route Handler
app/api/search, components/SearchPage.tsx et la page /recherche : un
champ avec un délai de 300 ms et les onglets Tout, Titres, Albums,
Artistes, Playlists.
Ce sera fini quand :
1. en tapant vite "shant", le serveur reçoit une seule requête ;
2. une ancienne réponse n'écrase pas une plus récente (test avec un
faux fetch) ;
3. chaque onglet montre sa section ou un texte d'absence de résultats ;
4. lint, types, tests et build passent. Montre les commandes et les
résultats.La condition 2 décrit une course classique. Tu tapes "hymne", le serveur commence à chercher, tu changes d'avis pour "kraken". Si la première réponse arrive après la seconde, l'écran garde les résultats de "hymne" alors que le champ contient "kraken".
Ce que Claude a écrit : chercher sans accents
Ouvre lib/search.ts dans Cursor. Le texte du champ et le texte du catalogue passent par la même fonction :
export function normalize(text: string): string {
return text
.toLowerCase()
.replace(/ł/g, "l")
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "");
}normalize("NFD") décompose une lettre accentuée en la lettre et un caractère d'accent séparé, et la dernière ligne supprime ces caractères. La lettre "ł" du polonais ne se décompose pas ainsi, c'est pourquoi elle a sa propre ligne au début : le jour où un artiste polonais entrera au catalogue, sa recherche fonctionnera aussi. Chez nous, le test a renvoyé "ecume de l'ile" pour "Écume de l'Île". searchCatalog renvoie toujours les quatre listes, même vides : pour "shant", un morceau, une playlist et deux listes vides d'albums et d'artistes.
Ce que Claude a écrit : 300 ms et le nettoyage
Ouvre components/SearchPage.tsx. Le délai, en anglais debounce, est un minuteur qui attend que tu aies arrêté de taper pendant 300 ms, et seulement alors interroge le serveur :
useEffect(() => {
if (!q) return;
const controller = new AbortController();
const timer = setTimeout(async () => {
try {
const res = await fetch(`/api/search?q=${encodeURIComponent(q)}`, { signal: controller.signal });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
setResult({ query: q, data: await res.json() });
} catch {
if (!controller.signal.aborted) setResult({ query: q, data: null });
}
}, 300);
return () => {
clearTimeout(timer);
controller.abort();
};
}, [q]);q est le texte du champ sans les espaces aux extrémités, donc une espace ajoutée à la fin n'envoie pas de nouvelle requête. Chaque lettre change q, et React appelle le nettoyage de l'exécution précédente avant de relancer l'effet. Le nettoyage fait deux choses pour deux moments différents. clearTimeout annule le minuteur qui attend encore, donc les lettres tapées plus vite que toutes les 300 ms n'atteignent pas le serveur. abort() interrompt la requête déjà partie : selon MDN, fetch se termine alors par une erreur AbortError, et la condition du catch ne la traite pas comme une panne. setResult se trouve dans la fonction du minuteur, et non directement dans le corps de l'effet, donc la règle de lint react-hooks/set-state-in-effect des locations précédentes n'a rien à redire.
Ce que Claude a écrit : le résultat correspond à la question
Le résultat se souvient de ce qu'il a demandé, et le texte "Recherche en cours..." découle d'une comparaison, sans état de chargement séparé :
const current = q && result?.query === q ? result : null;Si le champ contient "kraken" et que le dernier résultat concerne "hymne", current est vide et la page affiche "Recherche en cours...". data: null dans le résultat signifie que la requête a échoué, et un message demandant de réessayer apparaît alors.
Ce que Claude a écrit : des onglets impossibles à perdre
Chaque section a sa fonction de rendu dans un seul objet :
const RENDER: Record<Section, (r: SearchResults) => React.ReactNode> = {
tracks: (r) => r.tracks.map((t) => <li key={t.id}>{t.title}, {t.artist.name}</li>),
albums: (r) => r.albums.map((a) => <li key={a.id}>{a.title} ({a.year})</li>),
artists: (r) => r.artists.map((a) => <li key={a.id}>{a.name}</li>),
playlists: (r) => r.playlists.map((p) => <li key={p.id}>{p.name}</li>),
};Section est une union de quatre noms de sections, et Record exige une fonction pour chacun, comme les noms de mises en page du duo dans la leçon 9_3. Chez nous, supprimer la ligne albums s'est terminé par une erreur TS2741 avec le texte Property 'albums' is missing in type. L'onglet Tout dessine les quatre sections, chacune par une fonction différente. Une section à la liste vide affiche "Aucun résultat dans cette catégorie.", donc un clic sur Albums avec "shant" donne un texte, pas une page vide.
Ce que Claude a écrit : des shanties similaires
Sous le lecteur se trouve la fenêtre "Similaires". Notre clone ne fait pas semblant d'avoir les algorithmes des grands services : les recommandations sont une règle explicite de lib/recommend.ts, qu'on peut tester :
export function similarTracks(track: Track, catalog: Track[], limit = 3): Track[] {
return catalog
.filter((t) => t.genre === track.genre && t.id !== track.id)
.slice(0, limit);
}La règle : les morceaux du même genre, sans celui qui joue, trois au plus. L'ordre compte : d'abord filter, ensuite slice, sinon on prendrait dans le catalogue les trois premiers morceaux de n'importe quel genre. Chez nous, "Chant du kraken" est la seule ballade, donc le test a reçu une liste vide et la fenêtre a affiché "Aucun autre morceau du genre ballade.".
La revue du capitaine
- Un onglet sans section. L'erreur typique de l'agent est deux conditions
tab === "tracks"ettab === "artists"au lieu de cinq, parce qu'il a recopié deux cas sur cinq. Chez nous, cette version a passé le lint ettsc. Le test de la condition 3 a échoué :Unable to find an accessible element with the role "region" and name "Albums". Tape "shant" et clique sur chaque onglet. - La course des réponses. La version sans
controller.abort()a passé le lint ettsc, et le test de la condition 2 a signaléUnable to find an element with the text: Chant du kraken, Mary la Noire: la réponse tardive pour "hymne" a écrasé le résultat de "kraken", et la page est restée bloquée sur "Recherche en cours...". Cherche dans le fichierclearTimeout(etabort(: les deux doivent se trouver dans lereturnde l'effet. - Une seule copie des données. Cherche dans le projet
mocket[...]. Un agent sans reconnaissance peut appelermockTracksetmockAlbums, que personne n'a définis, ou laissertracks: [...]à la place des données. Après la reconnaissance, les données ont une seule source,lib/catalog.ts. - La preuve dans le navigateur. Ouvre
/recherche, l'onglet Network des outils de développement, et tape vite "shant". Chez nous, une seule requête est partie,q=shant.
Étape suivante
Avant le commit, lance /code-review de la leçon 2_9 : le relecteur, dans un sous-agent tout neuf, n'a pas vu naître l'effet, donc il le regarde sans votre raisonnement. Tu vérifies chaque constat comme une hypothèse avant de demander une correction par une demande étroite. La recherche et la fenêtre "Similaires" ne partagent aucun fichier, donc sur un plus grand navire elles pourraient naître en parallèle dans deux worktrees, comme dans la leçon 9_2. Quand la revue et les tests sont d'accord, demande un commit, par exemple "Recherche et shanties similaires".
Dans l'éditeur ci-dessous t'attend la recherche avec un faux serveur qui répond plus lentement aux requêtes plus courtes. Tape "ch", attends une demi-seconde, ajoute "ant" et regarde le journal des requêtes. Puis active l'erreur de l'agent sans abort() et refais la même chose, et enfin l'erreur avec deux sections au lieu de quatre, et clique sur l'onglet Albums.
À retenir : le capitaine envoie d'abord l'éclaireur à terre, et seulement ensuite le débarquement, et un catalogue sans onglet "Albums" est une carte sans l'île vers laquelle tu navigues.
Code de cette leçon : App.jsx
// Recherche en miniature : le faux serveur répond plus lentement aux requêtes plus courtes
import { useEffect, useState } from 'react';
const catalog = {
tracks: [
{ id: 't1', title: 'Hymne des pirates', artist: 'Capitaine Redbeard' },
{ id: 't2', title: 'Tambours de bataille', artist: 'Mary la Noire' },
{ id: 't3', title: "Shanty de l'île", artist: 'Capitaine Redbeard' },
{ id: 't4', title: 'Chant du kraken', artist: 'Mary la Noire' },
],
albums: [
{ id: 'al1', title: 'Chants du pont', year: 1718 },
{ id: 'al2', title: 'Tempête sur la Tortue', year: 1721 },
],
artists: [
{ id: 'a1', name: 'Capitaine Redbeard' },
{ id: 'a2', name: 'Mary la Noire' },
],
playlists: [{ id: 'p1', name: 'Shanties de quart' }],
};
const normalize = (text) => text.toLowerCase().replace(/ł/g, 'l').normalize('NFD').replace(/[\u0300-\u036f]/g, '');
function searchCatalog(query) {
const q = normalize(query);
const has = (text) => normalize(text).includes(q);
return {
tracks: catalog.tracks.filter((t) => has(t.title) || has(t.artist)),
albums: catalog.albums.filter((a) => has(a.title)),
artists: catalog.artists.filter((a) => has(a.name)),
playlists: catalog.playlists.filter((p) => has(p.name)),
};
}
// Faux fetch : plus la requête est courte, plus il attend (1 lettre : 1,5 s), et il écoute le signal abort
function fakeFetch(q, signal) {
const delay = Math.max(200, 1750 - 250 * q.length);
return new Promise((resolve, reject) => {
const id = setTimeout(() => resolve(searchCatalog(q)), delay);
signal.addEventListener('abort', () => {
clearTimeout(id);
reject(new DOMException('aborted', 'AbortError'));
});
});
}
const TABS = ['all', 'tracks', 'albums', 'artists', 'playlists'];
const SECTIONS = ['tracks', 'albums', 'artists', 'playlists'];
const LABELS = { all: 'Tout', tracks: 'Titres', albums: 'Albums', artists: 'Artistes', playlists: 'Playlists' };
const RENDER = {
tracks: (r) => r.tracks.map((t) => <li key={t.id}>{t.title}, {t.artist}</li>),
albums: (r) => r.albums.map((a) => <li key={a.id}>{a.title} ({a.year})</li>),
artists: (r) => r.artists.map((a) => <li key={a.id}>{a.name}</li>),
playlists: (r) => r.playlists.map((p) => <li key={p.id}>{p.name}</li>),
};
export default function App() {
const [query, setQuery] = useState('');
const [tab, setTab] = useState('all');
const [result, setResult] = useState(null);
const [log, setLog] = useState([]);
const [noAbort, setNoAbort] = useState(false);
const [twoSections, setTwoSections] = useState(false);
const q = query.trim();
const note = (line) => setLog((l) => [line, ...l].slice(0, 10));
useEffect(() => {
if (!q) return;
const controller = new AbortController();
const timer = setTimeout(async () => {
note(`envoyée : ${q}`);
try {
const data = await fakeFetch(q, controller.signal);
note(`réponse : ${q}`);
setResult({ query: q, data });
} catch {
if (controller.signal.aborted) note(`interrompue : ${q}`);
}
}, 300);
return () => {
clearTimeout(timer);
if (!noAbort) controller.abort(); // erreur de l'agent : sans abort(), l'ancienne requête continue
};
}, [q, noAbort]);
// Sans l'erreur de l'agent, le résultat doit correspondre à la question ; avec l'erreur, on affiche le dernier arrivé
const current = noAbort ? result : q && result?.query === q ? result : null;
const data = current?.data;
const visible = twoSections
? SECTIONS.filter((s) => (s === 'tracks' || s === 'artists') && (tab === 'all' || tab === s))
: tab === 'all' ? SECTIONS : [tab];
return (
<div className="min-h-screen bg-gray-950 p-4 text-white">
<div className="mx-auto max-w-xl space-y-3">
<input value={query} onChange={(e) => setQuery(e.target.value)} placeholder="Tape ch, attends, ajoute ant" className="w-full rounded-full bg-gray-800 px-4 py-2" />
<div className="flex flex-wrap gap-2">
{TABS.map((t) => (
<button key={t} type="button" onClick={() => setTab(t)} className={`rounded-full px-3 py-1 text-sm ${tab === t ? 'bg-white text-black' : 'bg-gray-800'}`}>
{LABELS[t]}
</button>
))}
</div>
{q && !current && <p className="text-gray-400">Recherche en cours...</p>}
{current && <p className="text-xs text-gray-400">Résultats pour : « {current.query} », dans le champ : « {q} »</p>}
{data && visible.map((s) => (
<section key={s}>
<h2 className="font-semibold">{LABELS[s]}</h2>
{data[s].length === 0 ? <p className="text-sm text-gray-400">Aucun résultat dans cette catégorie.</p> : <ul className="text-sm">{RENDER[s](data)}</ul>}
</section>
))}
{data && visible.length === 0 && <p className="text-sm text-red-400">Page vide : cet onglet n'a pas de section.</p>}
<div className="space-y-1 text-sm">
<label className="flex items-center gap-2"><input type="checkbox" checked={noAbort} onChange={(e) => setNoAbort(e.target.checked)} /> Erreur de l'agent : sans abort()</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={twoSections} onChange={(e) => setTwoSections(e.target.checked)} /> Erreur de l'agent : seulement Titres et Artistes</label>
</div>
<div className="rounded-xl bg-black p-3 font-mono text-xs text-green-400">
<p className="text-gray-400">Journal des requêtes (les plus récentes en haut) :</p>
{log.map((line, i) => <p key={i}>{line}</p>)}
</div>
</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. Pourquoi la recherche attend-elle 300 ms avant d'interroger le serveur ?
2. Que renvoie searchCatalog("shant") pour une catégorie où rien ne correspond ?
Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Clique dans l'ordre
Clique sur les éléments pour construire une requête de recherche que l'on peut interrompre :
- Clique dans l'ordre
Clique sur les éléments pour construire la recherche différée :
- Tri horizontal
Range sur une seule ligne le choix du résultat qui correspond au texte du champ :
- Éditeur de code
Interface de recherche
- Tri vertical
Range ce qui se passe quand tu ajoutes une lettre dans le champ de recherche :
- Tri vertical
Range les lignes de la fonction similarTracks :
- Clique dans l'ordre
Clique sur les éléments pour construire le nettoyage qui annule le minuteur en attente :
- Tri horizontal
Range sur une seule ligne la gestion d'erreur qui ignore les requêtes interrompues :
- Tri vertical
Range les étapes de travail sur la recherche de la leçon :
- Éditeur de code
Interface de découverte musicale
Exercices après cette leçon
- QuestionLe délai de la recherche
- QuestionLes catégories vides dans les résultats
- Clique dans l'ordreUne requête avec un signal d'interruption
- Clique dans l'ordreConstruis le minuteur du délai
- Remets dans l'ordreLe résultat correspond à la question
- Exercice de codePratique : page de recherche
- QuestionLa reconnaissance avec Explore
- QuestionLa règle des shanties similaires
- Remets dans l'ordreLe déroulement de la recherche avec délai
- Remets dans l'ordreLa fonction similarTracks
- Clique dans l'ordreConstruis le nettoyage du minuteur
- QuestionÀ quoi sert abort() dans le nettoyage
- Remets dans l'ordreUne interruption n'est pas une panne
- Remets dans l'ordreL'ordre de travail sur la recherche
- Exercice de codePratique : parcourir les catégories
- QuestionDes onglets impossibles à perdre