CKTIS / JavaScript
URLSearchParams.has() — controleren of een parameter bestaat
URLSearchParams.has() controleert of een parameternaam of een naam-waardepaar bestaat. De methode retourneert true of false zonder de parameters te wijzigen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
params.has(name)
params.has(name, value)params.has(name) retourneert true als er een parameter met die naam bestaat. In een uitvoeringsomgeving die vergelijking op waarde ondersteunt, moeten bij params.has(name, value) de naam en de waarde in hetzelfde paar overeenkomen, mits value niet undefined is. Expliciet undefined als tweede argument meegeven is hetzelfde als dat argument weglaten: params.has(name, undefined) controleert alleen de naam. Bij herhaalde namen is één overeenkomend paar voldoende; de methode wijzigt de gegevens niet.
De vergelijking is hoofdlettergevoelig en gebeurt met gedecodeerde tekenreeksen, niet met delen van de query. Bij het parsen wordt + als een spatie behandeld. Ook een lege waarde betekent dat de parameter bestaat: voor empty= retourneert has("empty") true.
Dit is een Web API uit de WHATWG URL Standard, geen functie uit een bepaalde ECMAScript-editie. De specificatie alleen bewijst niet dat de API in de doelbrowser wordt ondersteund; Node 24 in de repository bewijst dat evenmin. Controleer de variant met value afzonderlijk.
Voorbeelden
const params = new URLSearchParams("tag=js&tag=web&empty=&q=a+b");
console.log(params.has("tag"));
console.log(params.has("tag", "web"));
console.log(params.has("tag", "css"));
console.log(params.has("empty"));
console.log(params.has("missing"));
console.log(params.has("q", "a b"));Resultaat
true true false true false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.