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

CKTIS / JavaScript

URLSearchParams.append() : ajouter des paramètres de requête

append(name, value) ajoute une paire à la fin des paramètres de requête, tout en conservant les valeurs précédentes portant le même nom.

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.append(name, value)

params.append(name, value) modifie l’objet et renvoie undefined ; les appels ne peuvent donc pas être chaînés. Les deux arguments sont obligatoires.

append() conserve les doublons et l’ordre. get() lit la première valeur et getAll() lit toutes les valeurs. En revanche, set() remplace la première valeur et supprime les autres portant ce nom.

Transmettez du texte non encodé. toString() utilise l’encodage application/x-www-form-urlencoded : une espace devient + et un + littéral devient %2B ; le résultat ne contient pas ?. Un appel via url.searchParams met à jour l’objet URL associé. Cette API Web est définie par le URL Standard, et non par ECMAScript lui-même.

Exemples

const params = new URLSearchParams("tag=web");
const result = params.append("tag", "JavaScript basics");
console.log(params.toString());
console.log(JSON.stringify(params.getAll("tag")));
console.log(result);

Résultat

tag=web&tag=JavaScript+basics
["web","JavaScript basics"]
undefined

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