Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

URLSearchParams.set() : définir un paramètre de requête

URLSearchParams.set() attribue une valeur à un paramètre, en supprimant ses doublons ou en ajoutant son nom s’il n’existe pas encore.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

params.set(name, value)

params.set(name, value) modifie l’objet et renvoie undefined ; il n’est donc pas possible d’enchaîner les appels. Les deux arguments sont obligatoires et convertis en chaînes de caractères.

La méthode remplace la valeur de la première entrée correspondante, en conservant sa position, et supprime les autres entrées portant le même nom. Si le nom n’existe pas, elle l’ajoute à la fin. En revanche, append() conserve les doublons.

Transmettez du texte non encodé. Lors de la sérialisation, les espaces deviennent des + et les caractères + littéraux deviennent %2B. Un appel à url.searchParams.set() met à jour l’objet URL associé.

Cette API Web fait partie du WHATWG URL Standard, et non d’une édition particulière d’ECMAScript. Vérifiez sa disponibilité dans l’environnement cible ; Node 24 ne prouve pas qu’elle est prise en charge par les navigateurs.

Exemples

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Résultat

q=a%2Bb+c&page=1&lang=pl
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources