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

CKTIS / JavaScript

URLSearchParams.prototype.toString — sérialiser les paramètres de requête

L’appel `params.toString()` renvoie les paramètres de requête sous forme de texte, sans `?` initial. La méthode utilise l’encodage de formulaire tout en conservant l’ordre et les noms répétés.

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.toString()

URLSearchParams.prototype.toString est la méthode d’instance qui sérialise les paramètres de requête. Appelez-la sans argument avec params.toString(). La propriété URLSearchParams.toString du constructeur désigne en revanche la méthode héritée Function.prototype.toString, qui ne sérialise pas les paramètres.

La méthode d’instance renvoie le texte des paramètres sans ? initial, et non une URL complète. Une liste vide produit "".

La sérialisation utilise application/x-www-form-urlencoded et UTF-8 : un espace devient +, et un + littéral devient %2B. Fournissez des valeurs non encodées pour éviter d’encoder % une seconde fois.

Les paires sont séparées par &, et dans chaque paire, le nom est séparé de la valeur par =. L’ordre et les noms répétés sont conservés ; une valeur vide produit name=. La méthode ne trie pas et ne modifie pas les paramètres. Il s’agit d’une API Web de la norme URL Standard, et non d’une fonctionnalité définie par ECMAScript.

Exemples

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Résultat

q=a+b%2Bc&tag=js&tag=web&empty=
""

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