Merge pull request #441 from joaquinelio/susy201113

Susy201113

Author: joaquinelio

1-js/06-advanced-functions/01-recursion/article.md

@@ -132,7 +132,7 @@ Podemos esbozarlo como:
   </li>
 </ul>
 
-Ahí es cuando la función comienza a ejecutarse. La condición `n == 1` es falsa, por lo que el flujo continúa en la segunda rama de` if`:
+Ahí es cuando la función comienza a ejecutarse. La condición `n == 1` es falsa, por lo que el flujo continúa en la segunda rama de `if`:
 
 ```js run
 function pow(x, n) {

1-js/08-prototypes/01-prototype-inheritance/article.md

@@ -27,7 +27,7 @@ let rabbit = {
 };
 
 *!*
-rabbit.__proto__ = animal;
+rabbit.__proto__ = animal; // establece rabbit.[[Prototype]] = animal
 */!*
 ```
 

1-js/11-async/01-callbacks/article.md

@@ -144,7 +144,7 @@ loadScript('/my/script.js', function(script) {
     });
 */!*
 
-  })
+  });
 
 });
 ```
@@ -221,7 +221,7 @@ loadScript('1.js', function(error, script) {
         });
 
       }
-    })
+    });
   }
 });
 ```
@@ -279,7 +279,7 @@ loadScript('1.js', function(error, script) {
           }
         });
       }
-    })
+    });
   }
 });
 -->
@@ -319,7 +319,7 @@ function step3(error, script) {
   } else {
     // ...continua despues que se han cargado todos los scripts (*)
   }
-};
+}
 ```
 
 ¿Lo Ves? Hace lo mismo, y ahora no hay anidamiento profundo porque convertimos cada acción en una función de nivel superior separada.

1-js/11-async/05-promise-api/article.md

@@ -176,15 +176,14 @@ Entonces para cada promesa obtendremos su estado y `value/error`.
 Si el browser no soporta `Promise.allSettled`, es fácil implementarlo:
 
 ```js
-if(!Promise.allSettled) {
-  Promise.allSettled = function(promises) {
-    return Promise.all(promises.map(p => Promise.resolve(p).then(value => ({
-      status: 'fulfilled',
-      value
-    }), reason => ({
-      status: 'rejected',
-      reason
-    }))));
+if (!Promise.allSettled) {
+  const rejectHandler = reason => ({ status: 'rejected', reason });
+
+  const resolveHandler = value => ({ status: 'fulfilled', value });
+
+  Promise.allSettled = function (promises) {
+    const convertedPromises = promises.map(p => Promise.resolve(p).then(resolveHandler, rejectHandler));
+    return Promise.all(convertedPromises);
   };
 }
 ```

1-js/11-async/06-promisify/article.md

@@ -25,15 +25,16 @@ function loadScript(src, callback) {
 
 Vamos a promisificarla. La función nueva `loadScriptPromise(src)` va a hacer lo mismo, pero solo acepta `src` (sin callback) y retorna una promesa.
 
+Aquí:
 ```js
 let loadScriptPromise = function(src) {
   return new Promise((resolve, reject) => {
     loadScript(src, (err, script) => {
-      if (err) reject(err)
+      if (err) reject(err);
       else resolve(script);
     });
-  })
-}
+  });
+};
 
 // uso:
 // loadScriptPromise('path/script.js').then(...)
@@ -66,7 +67,7 @@ function promisify(f) {
       f.call(this, ...args); // llama a la función original
     });
   };
-};
+}
 
 // uso:
 let loadScriptPromise = promisify(loadScript);
@@ -98,11 +99,11 @@ function promisify(f, manyArgs = false) {
       f.call(this, ...args);
     });
   };
-};
+}
 
 // Uso:
 f = promisify(f, true);
-f(...).then(arrayOfResults => ..., err => ...)
+f(...).then(arrayOfResults => ..., err => ...);
 ```
 En algunos casos, puede que `err` esté ausente: `callback(result)`, o que haya algo que no es habitual en el formato del callback, por lo que tendremos que promisificar tales funciones manualmente.
 

1-js/11-async/08-async-await/01-rewrite-async/task.md

@@ -12,7 +12,7 @@ function loadJson(url) {
       } else {
         throw new Error(response.status);
       }
-    })
+    });
 }
 
 loadJson('no-such-user.json')

1-js/11-async/08-async-await/02-rewrite-async-2/task.md

@@ -1,7 +1,7 @@
 
 # Reescribir "rethrow" con async/await
 
-Debajo puedes encontrar el ejemplo "rethrow" del capítulo <info:promise-chaining>. Rescríbelo usando `async/await` en vez de `.then/catch`.
+Debajo puedes encontrar el ejemplo "rethrow". Rescríbelo usando `async/await` en vez de `.then/catch`.
 
 Y deshazte de la recursión en favor de un bucle en `demoGithubUser`: con `async/await`, que se vuelve fácil de hacer.
 
@@ -22,7 +22,7 @@ function loadJson(url) {
       } else {
         throw new HttpError(response);
       }
-    })
+    });
 }
 
 // Pide nombres hasta que github devuelve un usuario válido

1-js/11-async/08-async-await/article.md

@@ -156,7 +156,7 @@ class Thenable {
     // resuelve con this.num*2 después de 1000ms
     setTimeout(() => resolve(this.num * 2), 1000); // (*)
   }
-};
+}
 
 async function f() {
   // espera durante 1 segundo, entonces el resultado se vuelve 2

1-js/12-generators-iterators/2-async-iterators-generators/article.md

@@ -363,9 +363,9 @@ Explayando más sobre cómo funciona:
     - La URL inicial es `https://api.github.com/repos/<repo>/commits`, y la siguiente página estará en la cabecera de `Link` de la respuesta.
     - El método `fetch` nos permite suministrar autorización y otras cabeceras si lo necesitamos, aquí GitHub requiere `User-Agent`.
 2. Los commits son devueltos en formato JSON.
-3. Deberíamos obtener la siguiente URL de la página del `enlace` en el encabezado de la respuesta. Esto tiene un formato especial, por lo que usamos una expresión regular para eso. 
+3. Deberíamos obtener la siguiente URL de la página del `enlace` en el encabezado de la respuesta. Esto tiene un formato especial, por lo que usamos una expresión regular para eso (aprenderemos esta característica en [Regular expressions](info:regular-expressions)). 
     - La URL de la página siguiente puede verse así `https://api.github.com/repositories/93253246/commits?page=2`. Eso es generado por el propio Github.
-4. Luego entregamos todas las confirmaciones recibidas, y cuando finalizan, se activará la siguiente iteración `while(url)` haciendo una solicitud más.
+4. Luego entregamos uno por uno todos los "commit" recibidos y, cuando finalizan, se activará la siguiente iteración `while(url)` haciendo una solicitud más.
 
 Un ejemplo de uso (muestra autores de commit en la consola):
 

1-js/13-modules/01-modules-intro/article.md

@@ -260,7 +260,7 @@ Abajo compare con un script normal:
 
 <script>
 *!*
-  alert(typeof button); // Error: button es indefinido, el script no puede ver los elementos de abjo
+  alert(typeof button); // button es indefinido, el script no puede ver los elementos de abajo
 */!*
   // los scripts normales corren inmediatamente, antes que el resto de la página sea procesada
 </script>