From ce7b7985b489e63ba032562690b49e090ef477bd Mon Sep 17 00:00:00 2001 From: seeker8 Date: Fri, 23 Aug 2024 21:53:11 -0400 Subject: [PATCH 1/2] [es] translate map forEach --- .../global_objects/map/foreach/index.md | 84 +++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 files/es/web/javascript/reference/global_objects/map/foreach/index.md diff --git a/files/es/web/javascript/reference/global_objects/map/foreach/index.md b/files/es/web/javascript/reference/global_objects/map/foreach/index.md new file mode 100644 index 00000000000000..3c627bd0c36db8 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/map/foreach/index.md @@ -0,0 +1,84 @@ +--- +title: Map.prototype.forEach() +slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +l10n: + sourceCommit: 27180875516cc311342e74b596bfb589b7211e0c +--- + +{{JSRef}} + +El método **`forEach()`** de las instancias de {{jsxref("Map")}} ejecuta la función provista, una vez por cada tupla llave/valor en este _map_, en orden de inserción. + +{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}} + +## Sintaxis + +```js-nolint +forEach(callbackFn) +forEach(callbackFn, thisArg) +``` + +### Parámetro + +- `callbackFn` + - : Una función que se ejecuta por cada entrada en el _map_. La función es llamada con los siguientes argumentos: + - `value` + - : El valor de cada iteración. + - `key` + - : La llave de cada iteración. + - `map` + - : El _map_ que esta siendo iterado. +- `thisArg` {{optional_inline}} + - : Un valor que se usa como `this` cuando se ejecuta la función `callbackFn`. + +### Valor devuelto + +Ningúno ({{jsxref("undefined")}}). + +## Descripción + +El método `forEach` ejecuta la función `callback` provista, una vez por cada llave que actualmente existe en el _map_. No se invoca para llaves que fueron borradas. Sin embargo, la función es ejecutada para valores que se encuentran en el objeto, pero que su valor es `undefined`. + +La función `callback` es invocada con **tres argumentos**: + +- el `value` del elemento +- el `key` del elemento +- el **objeto `Map`** que se esta iterando + +Si el parámetro `thisArg` se provee a la función `forEach`, este se pasará a la función `callback` cuando sea invocada, para usarse como el valor `this`. De lo contrario, el valor `undefined` será pasado para usarse como el valor `this`. El valor `this` que finalmente es visible para lafunción `callback`, es determinado de acuerdo a [las reglas para determinar el valor `this` visible para una función](/es/docs/Web/JavaScript/Reference/Operators/this). + +Cada valor es visitado una vez, excepto en el caso en que el valor es borrado y agregado antes de que `forEach` haya terminado. La función `callback` no es invocada para valores que se borraron antes de ser visitados. Los valores agregados antes de que `forEach` termine, serán visitados. + +## Ejemplos + +### Imprimiendo el contenido de un objeto Map + +El siguiente código, registra en la consola un mensaje por cada elemento en un objeto `Map`: + +```js +function logMapElements(value, key, map) { + console.log(`map.get('${key}') = ${value}`); +} +new Map([ + ["foo", 3], + ["bar", {}], + ["baz", undefined], +]).forEach(logMapElements); +// Logs: +// "map.get('foo') = 3" +// "map.get('bar') = [object Object]" +// "map.get('baz') = undefined" +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Array.prototype.forEach()")}} +- {{jsxref("Set.prototype.forEach()")}} From 6e723e68a80e0100b63ae1fa0f3768f1316c51c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20V=C3=A1squez?= Date: Tue, 27 Aug 2024 12:58:59 -0600 Subject: [PATCH 2/2] Update files/es/web/javascript/reference/global_objects/map/foreach/index.md --- .../javascript/reference/global_objects/map/foreach/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/es/web/javascript/reference/global_objects/map/foreach/index.md b/files/es/web/javascript/reference/global_objects/map/foreach/index.md index 3c627bd0c36db8..1f1ea26a9db7ea 100644 --- a/files/es/web/javascript/reference/global_objects/map/foreach/index.md +++ b/files/es/web/javascript/reference/global_objects/map/foreach/index.md @@ -45,7 +45,7 @@ La función `callback` es invocada con **tres argumentos**: - el `key` del elemento - el **objeto `Map`** que se esta iterando -Si el parámetro `thisArg` se provee a la función `forEach`, este se pasará a la función `callback` cuando sea invocada, para usarse como el valor `this`. De lo contrario, el valor `undefined` será pasado para usarse como el valor `this`. El valor `this` que finalmente es visible para lafunción `callback`, es determinado de acuerdo a [las reglas para determinar el valor `this` visible para una función](/es/docs/Web/JavaScript/Reference/Operators/this). +Si el parámetro `thisArg` se provee a la función `forEach`, este se pasará a la función `callback` cuando sea invocada, para usarse como el valor `this`. De lo contrario, el valor `undefined` será pasado para usarse como el valor `this`. El valor `this` que finalmente es visible para la función `callback`, es determinado de acuerdo a [las reglas para determinar el valor `this` visible para una función](/es/docs/Web/JavaScript/Reference/Operators/this). Cada valor es visitado una vez, excepto en el caso en que el valor es borrado y agregado antes de que `forEach` haya terminado. La función `callback` no es invocada para valores que se borraron antes de ser visitados. Los valores agregados antes de que `forEach` termine, serán visitados.