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

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializar parámetros de consulta

La llamada `params.toString()` devuelve los parámetros de consulta como texto, sin un `?` inicial. Utiliza codificación de formularios y conserva el orden y los nombres repetidos.

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.toString()

URLSearchParams.prototype.toString es el método de instancia que serializa los parámetros de consulta. Llámalo sin argumentos con params.toString(). En cambio, la propiedad URLSearchParams.toString del constructor hace referencia al método heredado Function.prototype.toString, que no serializa los parámetros.

El método de instancia devuelve el texto de los parámetros sin un ? inicial, no una URL completa. Una lista vacía produce "".

La serialización utiliza application/x-www-form-urlencoded y UTF-8: un espacio se convierte en + y un + literal, en %2B. Proporciona valores sin codificar para evitar que % se codifique de nuevo.

Los pares se unen con &, y los nombres y valores, con =. Se conservan el orden y los nombres repetidos; un valor vacío produce name=. El método no ordena ni modifica los parámetros. Es una API web del URL Standard, no una función definida por ECMAScript.

Ejemplos

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Resultado

q=a+b%2Bc&tag=js&tag=web&empty=
""

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