CKTIS / JavaScript
URLSearchParams.append(): añadir parámetros de consulta
append(name, value) añade un par al final de los parámetros de consulta y conserva los valores anteriores que tengan el mismo nombre.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
params.append(name, value)params.append(name, value) modifica el objeto y devuelve undefined, por lo que no se pueden encadenar llamadas. Ambos argumentos son obligatorios.
append() conserva los duplicados y el orden. get() lee el primer valor y getAll() lee todos. En cambio, set() reemplaza el primer valor y elimina los demás que tengan ese nombre.
Pasa texto sin codificar. toString() utiliza la codificación application/x-www-form-urlencoded: un espacio se convierte en + y un + literal, en %2B; el resultado no incluye ?. Una llamada mediante url.searchParams actualiza el objeto URL asociado. Esta API web está definida por el URL Standard, no por ECMAScript en sí.
Ejemplos
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);Resultado
tag=web&tag=JavaScript+basics ["web","JavaScript basics"] undefined
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.