Formations — 1 037 leçons en français

Accueil › React › Paramètres d'URL

Paramètres d'URL

Le routeurintermediaire

Lire un paramètre de chemin

// route : { path: "/clients/:id", element: <FicheClient /> }

function FicheClient() {
  const { id } = useParams();        // toujours une chaîne
  const numero = Number(id);
  if (!Number.isInteger(numero)) return <PageIntrouvable />;
  // ...
}

useParams rend un objet de chaînes. Une URL est du texte, et le routeur ne connaît pas le type attendu. Number(id) sur un identifiant malformé rend NaN, qui traverse silencieusement jusqu'à l'appel réseau.

Lire et écrire les paramètres de requête

const [params, setParams] = useSearchParams();

const tri = params.get("tri") ?? "nom";
const page = Number(params.get("page") ?? 1);

function trierPar(cle) {
  setParams({ tri: cle, page: "1" });   // remplace tout
}

setParams remplace l'ensemble des paramètres. Pour n'en changer qu'un :

setParams((p) => {
  const copie = new URLSearchParams(p);
  copie.set("tri", cle);
  copie.delete("page");
  return copie;
});

Chemin ou requête ?

Le chemin identifie la ressource, la requête décrit la vue qu'on en a. /clients/42 est une fiche ; /clients?tri=nom&page=2 est une façon de regarder la liste. Mettre un filtre dans le chemin interdit de le retirer sans changer de route.

Les termes à connaître

Paramètre de chemin

Un segment variable du motif, écrit :id. Il identifie une ressource et fait partie du chemin : /clients/42.

Paramètre de requête

Ce qui suit le ?. Il décrit une vue de la ressource — tri, page, filtre — et non la ressource elle-même.

Segment attrape-tout

Le motif *, qui absorbe plusieurs segments d'un coup. On le lit dans useParams()["*"].

URL canonique

Une seule écriture possible pour une même demande : clés triées, valeurs vides retirées. Sans elle, un cache garde deux entrées pour une question unique.

Source de vérité

L'endroit qui détient l'information. Quand un filtre est dans l'URL, l'URL est la source de vérité, et l'état local n'en est qu'une copie à éviter.

Encodage d'URL

La transformation des caractères réservés — espace, &, / — en séquences %xx. encodeURIComponent à l'écriture, decodeURIComponent à la lecture.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.