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

CKTIS / JavaScript

URLSearchParams.set(): nastavenie parametra dopytu

URLSearchParams.set() priradí parametru jednu hodnotu a odstráni jeho duplicity alebo pridá chýbajúci názov.

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

params.set(name, value)

params.set(name, value) mení objekt a vracia undefined, takže volania nemožno reťaziť. Oba argumenty sú povinné a konvertujú sa na reťazce.

Metóda nahradí hodnotu prvej zodpovedajúcej položky a zachová jej pozíciu; ostatné položky s rovnakým názvom odstráni. Ak názov chýba, pridá ho na koniec. Naopak, append() duplicity zachováva.

Odovzdávajte neenkódovaný text. Pri serializácii sa medzery zmenia na + a doslovné znaky + na %2B. Volanie url.searchParams.set() aktualizuje súvisiaci objekt URL.

Toto Web API patrí do WHATWG URL Standard, nie do konkrétnej edície ECMAScriptu. Dostupnosť overte v cieľovom prostredí; Node 24 nedokazuje podporu v prehliadačoch.

Príklady

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Výsledok

q=a%2Bb+c&page=1&lang=pl
true

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

Zdroje