Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes