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

CKTIS / JavaScript

URLSearchParams.delete() : supprimer des paramètres de requête

URLSearchParams.delete() supprime toutes les paires portant un nom donné, ou uniquement celles qui correspondent à la fois au nom et à la valeur indiqué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.delete(name)
params.delete(name, value)

params.delete(name) supprime toutes les paires nommées name, y compris les doublons. params.delete(name, value) supprime toutes les paires correspondant à la fois au nom et à la valeur, et pas seulement la première.

La méthode modifie l’objet et renvoie undefined, et non le nombre de paires supprimées. L’absence de correspondance ne provoque pas d’erreur. Pour un objet obtenu via url.searchParams, elle met également à jour la requête de cette URL.

Cette API relève de la norme WHATWG URL, et non d’une édition particulière d’ECMAScript. Vérifiez la prise en charge de la forme avec value dans l’environnement cible ; la seule présence de Node 24 dans un dépôt ne permet pas d’établir la prise en charge par les navigateurs.

Exemples

const params = new URLSearchParams('tag=js&tag=web&tag=js&page=2');
params.delete('tag', 'js');
console.log(params.toString());
params.delete('tag');
console.log(params.toString());

Résultat

tag=web&page=2
page=2

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