Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.append(): aggiungere parametri di query

append(name, value) aggiunge una coppia alla fine dei parametri di query, conservando i valori precedenti con lo stesso nome.

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

Sintassi

params.append(name, value)

params.append(name, value) modifica l’oggetto e restituisce undefined, quindi le chiamate non possono essere concatenate. Entrambi gli argomenti sono obbligatori.

append() conserva i duplicati e l’ordine. get() legge il primo valore, mentre getAll() li legge tutti. Al contrario, set() sostituisce il primo valore e rimuove gli altri con lo stesso nome.

Passa testo non codificato. toString() usa la codifica application/x-www-form-urlencoded: uno spazio diventa + e un + letterale diventa %2B; il risultato non include ?. Una chiamata tramite url.searchParams aggiorna l’oggetto URL associato. Questa Web API è definita dal URL Standard, non da ECMAScript stesso.

Esempi

const params = new URLSearchParams("tag=web");
const result = params.append("tag", "JavaScript basics");
console.log(params.toString());
console.log(JSON.stringify(params.getAll("tag")));
console.log(result);

Risultato

tag=web&tag=JavaScript+basics
["web","JavaScript basics"]
undefined

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti