Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

URLSearchParams — parametre dotazu

URLSearchParams číta a upravuje parametre dotazu, zachováva opakované názvy a pracuje s kódovaním v štýle formulárov.

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

Syntax

new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()

URLSearchParams je API štandardu WHATWG URL, nie ECMAScriptu. Konštruktor prijíma dotaz (voliteľne začínajúci znakom ?), záznam alebo dvojice názov–hodnota; celú URL neparsuje.

get() vracia prvú hodnotu alebo null; getAll() vracia všetky hodnoty. append() pridá dvojicu. Ak zadaný názov už existuje, set() zmení hodnotu prvej dvojice s týmto názvom a odstráni ostatné dvojice s rovnakým názvom. Inak set() pridá na koniec novú dvojicu.

toString() vynechá ? a používa application/x-www-form-urlencoded: medzery sa zmenia na + a doslovné znamienka plus na %2B. Metódam odovzdávajte nekódované hodnoty.

Zmeny url.searchParams aktualizujú súvisiacu URL a môžu zmeniť jej kódovanie. Štandard nie je tabuľkou kompatibility prehliadačov; Node 24 nedokazuje podporu v prehliadačoch.

Príklady

const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());

Výsledok

js,web
tag=api&q=a%2Bb+c

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje