MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

La interfaz URLSearchParams define métodos útiles para trabajar con los parámetros de búsqueda de una URL.

Un objeto implementando URLSearchParams puede directamente ser usado en una for...of estructura, en lugar de entries(): for (var p of mySearchParams) la cual es equivalente a for (var p of mySearchParams.entries()).

Constructor

URLSearchParams()
El Constructor returna un objeto de tipo URLSearchParams.

Propiedades

Esta interfaz no hereda ninguna propiedad.

Métodos

Esta interfaz no hereda ningún método.

URLSearchParams.append()
Agrega el par de llave/valor especificado como un nuevo parámetro de búsqueda.
URLSearchParams.delete()
Elimina el parámetro de búsqueda especificado, y su valor asociado, de la lista de todos los parámetros de búsqueda.
URLSearchParams.entries()
Returna un iterator que permite iterar a traves de todos los pares de llave/valor que contiene el objeto.
URLSearchParams.get()
Returna el primer valor asociado al parámetro de búsqueda especificado.
URLSearchParams.getAll()
Returna todas los valores asociados con el parámetro de búsqueda especificado.
URLSearchParams.has()
Returna un Boolean que indica si el parametro de búsqueda especificado existe.
URLSearchParams.keys()
Returna un iterator que permite iterar a través de todas las llaves de los pares de llave/valor que contiene un objeto.
URLSearchParams.set()
Establece el valor al parámetro de búsqueda asociado con el valor dado. Si hay varios valores, elimina los demás.
URLSearchParams.sort()
Organiza todos los pares de llave/valor, si existen, por sus llaves.
URLSearchParams.toString()
Returna una cadena de texto que contiene un parámetro de consulta adecuado para utilizar en una URL.
URLSearchParams.values()
Returna un iterator que permite iterar a través de todos los valores de los pares de llave/valor que contiene un objeto.

Ejemplo

var paramsString = "q=URLUtils.searchParams&topic=api"
var searchParams = new URLSearchParams(paramsString);

//Itera los parámetros de búsqueda.
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

Especificaciones

Especificaciones Estado Comentario
URL
The definition of 'URLSearchParams' in that specification.
Living Standard Definición Inicial.

Compatibilidad con navegadores

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte básico 49 29.0 (29.0) No support 36 10.1
entries(), keys(), values(), and support of for...of 49 44.0 (44.0) No support 36 ?
USVString for constructor init object (Yes) 53.0 (53.0) No support (Yes) ?
Record for constructor init object No support 54.0 (54.0) No support ? ?
Característica Android Webview Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico 49 49 29.0 (29.0) No support ? No support
entries(), keys(), values(), and support of for...of 49 49 44.0 (44.0) No support ? No support
USVString for constructor init object (Yes) (Yes) 53.0 (53.0) No support ? ?
Record for constructor init object ? ? 54.0 (54.0) No support ? ?

Vea también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: aliveghost04
 Última actualización por: aliveghost04,