Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

URLSearchParams — parametri poizvedbe

URLSearchParams bere in spreminja parametre poizvedbe, ohranja ponovljena imena in podpira kodiranje v slogu obrazcev.

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

Sintaksa

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

URLSearchParams je API standarda WHATWG URL, ne ECMAScript. Konstruktor sprejme poizvedbo (po želji z začetnim ?), zapis ali pare ime–vrednost; celotnega URL-ja ne razčleni.

get() vrne prvo vrednost ali null; getAll() vrne vse vrednosti. append() doda par. Če navedeno ime že obstaja, set() spremeni vrednost prvega para s tem imenom in odstrani vse preostale pare z istim imenom. Sicer set() na konec doda nov par.

toString() izpusti ? in uporablja application/x-www-form-urlencoded: presledki postanejo +, dobesedni znaki plus pa %2B. Metodam podajte nekodirane vrednosti.

Spreminjanje url.searchParams posodobi povezani URL in lahko spremeni njegovo kodiranje. Standard ni tabela združljivosti brskalnikov; Node 24 ne dokazuje podpore v brskalnikih.

Primeri

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());

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri