From 1109132f09d75da9a28b649c7677bb6ce07c40c0 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:41:45 -0500 Subject: initial commit --- files/es/web/api/urlsearchparams/index.html | 204 +++++++++++++++++++++ .../api/urlsearchparams/urlsearchparams/index.html | 78 ++++++++ 2 files changed, 282 insertions(+) create mode 100644 files/es/web/api/urlsearchparams/index.html create mode 100644 files/es/web/api/urlsearchparams/urlsearchparams/index.html (limited to 'files/es/web/api/urlsearchparams') diff --git a/files/es/web/api/urlsearchparams/index.html b/files/es/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..ec3433af72 --- /dev/null +++ b/files/es/web/api/urlsearchparams/index.html @@ -0,0 +1,204 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +translation_of: Web/API/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

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 {{jsxref("Statements/for...of", "for...of")}} estructura, en lugar de {{domxref('URLSearchParams.entries()', 'entries()')}}: for (var p of mySearchParams) la cual es equivalente a for (var p of mySearchParams.entries()).

+ +

Constructor

+ +
+
{{domxref("URLSearchParams.URLSearchParams", '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.

+ +
+
{{domxref("URLSearchParams.append()")}}
+
Agrega el par de llave/valor especificado como un nuevo parámetro de búsqueda.
+
{{domxref("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.
+
{{domxref("URLSearchParams.entries()")}}
+
Returna un {{jsxref("Iteration_protocols","iterator")}} que permite iterar a traves de todos los pares de llave/valor que contiene el objeto.
+
{{domxref("URLSearchParams.get()")}}
+
Returna el primer valor asociado al parámetro de búsqueda especificado.
+
{{domxref("URLSearchParams.getAll()")}}
+
Returna todas los valores asociados con el parámetro de búsqueda especificado.
+
{{domxref("URLSearchParams.has()")}}
+
Returna un {{jsxref("Boolean")}} que indica si el parametro de búsqueda especificado existe.
+
{{domxref("URLSearchParams.keys()")}}
+
Returna un {{jsxref("Iteration_protocols", "iterator")}} que permite iterar a través de todas las llaves de los pares de llave/valor que contiene un objeto.
+
{{domxref("URLSearchParams.set()")}}
+
Establece el valor al parámetro de búsqueda asociado con el valor dado. Si hay varios valores, elimina los demás.
+
{{domxref("URLSearchParams.sort()")}}
+
Organiza todos los pares de llave/valor, si existen, por sus llaves.
+
{{domxref("URLSearchParams.toString()")}}
+
Returna una cadena de texto que contiene un parámetro de consulta adecuado para utilizar en una URL.
+
{{domxref("URLSearchParams.values()")}}
+
Returna un {{jsxref("Iteration_protocols", "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

+ + + + + + + + + + + + + + + + +
EspecificacionesEstadoComentario
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}{{Spec2('URL')}}Definición Inicial.
+ +

Compatibilidad con navegadores

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico{{CompatChrome(49)}}{{CompatGeckoDesktop("29.0")}}{{CompatNo}}3610.1
entries(), keys(), values(), and support of for...of{{CompatChrome(49)}}{{CompatGeckoDesktop("44.0")}}{{CompatNo}}36{{CompatUnknown}}
USVString for constructor init object{{CompatVersionUnknown}}{{CompatGeckoDesktop("53.0")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatUnknown}}
Record for constructor init object{{CompatNo}}{{CompatGeckoDesktop("54.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroid WebviewChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatChrome(49)}}{{CompatChrome(49)}}{{CompatGeckoMobile("29.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
entries(), keys(), values(), and support of for...of{{CompatChrome(49)}}{{CompatChrome(49)}}{{CompatGeckoMobile("44.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
USVString for constructor init object{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("53.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
Record for constructor init object{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("54.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Vea también

+ + + +
+
diff --git a/files/es/web/api/urlsearchparams/urlsearchparams/index.html b/files/es/web/api/urlsearchparams/urlsearchparams/index.html new file mode 100644 index 0000000000..0cfe5f28df --- /dev/null +++ b/files/es/web/api/urlsearchparams/urlsearchparams/index.html @@ -0,0 +1,78 @@ +--- +title: URLSearchParams() +slug: Web/API/URLSearchParams/URLSearchParams +tags: + - API + - API URL + - Constructor + - Referencia + - URLSearchParams +translation_of: Web/API/URLSearchParams/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

El constructor URLSearchParams() crea y retorna un nuevo objeto {{domxref("URLSearchParams")}}. Si se incluye el caracter '?' al comienzo, éste es ignorado.

+ +

{{availableinworkers}}

+ +

Sintaxis

+ +
var URLSearchParams = new URLSearchParams(init);
+ +

Parámetros

+ +
+
init {{optional_inline}}
+
Una instancia de {{domxref("USVString")}}, una secuencia de {{domxref("USVString")}}s, o un registro conteniendo dos {{domxref("USVString")}}s.
+
+ +

Valor retornado

+ +

Un objeto instancia de {{domxref("URLSearchParams")}}.

+ +

Ejemplos

+ +

El siguiente ejemplo muestra cómo crear un objeto {{domxref("URLSearchParams")}} desde un string que representa una URL.

+ +
// Pasar un literal string
+var url = new URL('https://example.com?foo=1&bar=2');
+// Obtener la URL actual desde window.location
+var url2 = new URL(window.location);
+
+// Obtener parámetros de url.search y pasarlos al constructor
+var params = new URLSearchParams(url.search);
+var params2 = new URLSearchParams(url2.search);
+
+// Pasar una secuencia
+var params3 = new URLSearchParams([["foo", 1],["bar", 2]]);
+
+// Pasar un registro
+var params4 = new URLSearchParams({"foo" : 1 , "bar" : 2});
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName('URL', '#dom-urlsearchparams-urlsearchparams', "URLSearchParams()")}}{{Spec2('URL')}}Definición inicial.
+ +

Compatibilidad de browsers

+ +
+ + +

{{Compat("api.URLSearchParams.URLSearchParams")}}

+
-- cgit v1.2.3-54-g00ecf