Skip to content

Commit c82f0f1

Browse files
alexseikalexseik
committed
Update 05-testing-mocha article.md and task.md
1 parent b91261d commit c82f0f1

20 files changed

Lines changed: 263 additions & 275 deletions

File tree

‎1-js/03-code-quality/05-testing-mocha/3-pow-test-wrong/solution.md‎

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,47 @@
1-
The test demonstrates one of the temptations a developer meets when writing tests.
1+
El test demuestra una tentación habitual del/a desarrollador/a al escribir tests.
22

3-
What we have here is actually 3 tests, but layed out as a single function with 3 asserts.
3+
Lo que tenemos aquí son en realidad 3 pruebas, pero presentadas como una sola función con 3 afirmaciones.
44

5-
Sometimes it's easier to write this way, but if an error occurs, it's much less obvious what went wrong.
5+
A veces es más fácil escribir de esta manera, pero si ocurre un error, es mucho menos obvio saber qué salió mal.
66

7-
If an error happens inside a complex execution flow, then we'll have to figure out the data at that point. We'll actually have to *debug the test*.
7+
Sería mucho mejor dividir la prueba en múltiples bloques 'it' con entradas y salidas claramente escritas.
88

9-
It would be much better to break the test into multiple `it` blocks with clearly written inputs and outputs.
10-
11-
Like this:
9+
Como ésto:
1210
```js
13-
describe("Raises x to power n", function() {
14-
it("5 in the power of 1 equals 5", function() {
11+
describe("Eleva x a la potencia n", function() {
12+
it("5 elevado a 1 es igual a 5", function() {
1513
assert.equal(pow(5, 1), 5);
1614
});
1715

18-
it("5 in the power of 2 equals 25", function() {
16+
it("5 elevado a 2 es igual a 25", function() {
1917
assert.equal(pow(5, 2), 25);
2018
});
2119

22-
it("5 in the power of 3 equals 125", function() {
20+
it("5 elevado a 3 es igual a 125", function() {
2321
assert.equal(pow(5, 3), 125);
2422
});
2523
});
2624
```
2725

28-
We replaced the single `it` with `describe` and a group of `it` blocks. Now if something fails we would see clearly what the data was.
26+
Reemplazamos el único `it` por un `describe` y agrupamos los bloques `it` dentro. Ahora si algo sale mal, podemos ver claramente que dato fue.
2927

30-
Also we can isolate a single test and run it in standalone mode by writing `it.only` instead of `it`:
28+
Además podemos aislar un único test y ejecutarlo individualmente escribiendo `it.only` en lugar de `it`:
3129

3230

3331
```js
3432
describe("Raises x to power n", function() {
35-
it("5 in the power of 1 equals 5", function() {
33+
it("5 elevado a 1 es igual a 5", function() {
3634
assert.equal(pow(5, 1), 5);
3735
});
3836

3937
*!*
40-
// Mocha will run only this block
41-
it.only("5 in the power of 2 equals 25", function() {
38+
// Mocha sólo ejecutará este bloque
39+
it.only("5 elevado a 2 es igual a 25", function() {
4240
assert.equal(pow(5, 2), 25);
4341
});
4442
*/!*
4543

46-
it("5 in the power of 3 equals 125", function() {
44+
it("5 elevado a 3 es igual a 125", function() {
4745
assert.equal(pow(5, 3), 125);
4846
});
4947
});

‎1-js/03-code-quality/05-testing-mocha/3-pow-test-wrong/task.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@ importance: 5
22

33
---
44

5-
# What's wrong in the test?
5+
# ¿Qué esta mal en el test?
66

7-
What's wrong in the test of `pow` below?
7+
¿Qué es incorrecto en el test de `pow` de abajo?
88

99
```js
10-
it("Raises x to the power n", function() {
10+
it("Eleva x a la potencia n", function() {
1111
let x = 5;
1212

1313
let result = x;
@@ -21,4 +21,4 @@ it("Raises x to the power n", function() {
2121
});
2222
```
2323

24-
P.S. Syntactically the test is correct and passes.
24+
P.S. El test es sintácticamente correcto y pasa.

‎1-js/03-code-quality/05-testing-mocha/article.md‎

Lines changed: 149 additions & 150 deletions
Large diffs are not rendered by default.

‎1-js/03-code-quality/05-testing-mocha/beforeafter.view/index.html‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,30 @@
11
<!DOCTYPE html>
22
<html>
33
<head>
4-
<!-- add mocha css, to show results -->
4+
<!-- incluir css para mocha, para mostrar los resultados -->
55
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css">
6-
<!-- add mocha framework code -->
6+
<!-- incluir el código del framework mocha -->
77
<script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
88
<script>
9-
// enable bdd-style testing
10-
mocha.setup('bdd');
9+
mocha.setup('bdd'); // configuración mínima
1110
</script>
12-
<!-- add chai -->
11+
<!-- incluir chai -->
1312
<script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
1413
<script>
15-
// chai has a lot of stuff, let's make assert global
14+
// chai tiene un montón de cosas, hacemos assert global
1615
let assert = chai.assert;
1716
</script>
1817
</head>
1918

2019
<body>
2120

22-
<!-- the script with tests (describe, it...) -->
21+
<!-- el fichero con los tests (describe, it...) -->
2322
<script src="test.js"></script>
2423

25-
<!-- the element with id="mocha" will contain test results -->
24+
<!-- el elemento con id="mocha" que contendrá los resultados de los tests -->
2625
<div id="mocha"></div>
2726

28-
<!-- run tests! -->
27+
<!-- ¡ejecutamos los tests! -->
2928
<script>
3029
mocha.run();
3130
</script>

‎1-js/03-code-quality/05-testing-mocha/beforeafter.view/test.js‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
describe("test", function() {
22

3-
before(() => alert("Testing started – before all tests"));
4-
after(() => alert("Testing finished – after all tests"));
3+
before(() => alert("Inicio testing – antes de todos los tests"));
4+
after(() => alert("Final testing – después de todos los tests"));
55

6-
beforeEach(() => alert("Before a test – enter a test"));
7-
afterEach(() => alert("After a test – exit a test"));
6+
beforeEach(() => alert("Antes de un test – entramos al test"));
7+
afterEach(() => alert("Después de un test – salimos del test"));
88

99
it('test 1', () => alert(1));
1010
it('test 2', () => alert(2));

‎1-js/03-code-quality/05-testing-mocha/index.html‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
<!DOCTYPE html>
22
<html>
33
<head>
4-
<!-- add mocha css, to show results -->
4+
<!-- incluir css para mocha, para mostrar los resultados -->
55
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css">
6-
<!-- add mocha framework code -->
6+
<!-- incluir el código del framework mocha -->
77
<script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
88
<script>
9-
mocha.setup('bdd'); // minimal setup
9+
mocha.setup('bdd'); // configuración mínima
1010
</script>
11-
<!-- add chai -->
11+
<!-- incluir chai -->
1212
<script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
1313
<script>
14-
// chai has a lot of stuff, let's make assert global
14+
// chai tiene un montón de cosas, hacemos assert global
1515
let assert = chai.assert;
1616
</script>
1717
</head>
@@ -20,17 +20,17 @@
2020

2121
<script>
2222
function pow(x, n) {
23-
/* function code is to be written, empty now */
23+
/* código a escribir de la función, de momento vacío */
2424
}
2525
</script>
2626

27-
<!-- the script with tests (describe, it...) -->
27+
<!-- el script con los tests (describe, it...) -->
2828
<script src="test.js"></script>
2929

30-
<!-- the element with id="mocha" will contain test results -->
30+
<!-- el elemento con id="mocha" que contiene los resultados de los tests -->
3131
<div id="mocha"></div>
3232

33-
<!-- run tests! -->
33+
<!-- ¡ejectuar los tests! -->
3434
<script>
3535
mocha.run();
3636
</script>

‎1-js/03-code-quality/05-testing-mocha/pow-1.view/index.html‎

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
<!DOCTYPE html>
22
<html>
33
<head>
4-
<!-- add mocha css, to show results -->
4+
<!-- incluir css para mocha, para mostrar los resultados -->
55
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css">
6-
<!-- add mocha framework code -->
6+
<!-- incluir el código del framework mocha -->
77
<script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
88
<script>
9-
// enable bdd-style testing
10-
mocha.setup('bdd');
9+
mocha.setup('bdd'); // configuración mínima
1110
</script>
12-
<!-- add chai -->
11+
<!-- incluir chai -->
1312
<script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
1413
<script>
15-
// chai has a lot of stuff, let's make assert global
14+
// chai tiene un montón de cosas, hacemos assert global
1615
let assert = chai.assert;
1716
</script>
1817
</head>
@@ -21,17 +20,17 @@
2120

2221
<script>
2322
function pow(x, n) {
24-
/* function code is to be written, empty now */
23+
/* código a escribir de la función, de momento vacío */
2524
}
2625
</script>
2726

28-
<!-- the script with tests (describe, it...) -->
27+
<!-- el script con los tests (describe, it...) -->
2928
<script src="test.js"></script>
3029

31-
<!-- the element with id="mocha" will contain test results -->
30+
<!-- el elemento con id="mocha" que contiene los resultados de los tests -->
3231
<div id="mocha"></div>
3332

34-
<!-- run tests! -->
33+
<!-- ¡ejectuar los tests! -->
3534
<script>
3635
mocha.run();
3736
</script>

‎1-js/03-code-quality/05-testing-mocha/pow-1.view/test.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
describe("pow", function() {
22

3-
it("raises to n-th power", function() {
3+
it("eleva a la n-esima potencia", function() {
44
assert.equal(pow(2, 3), 8);
55
});
66

‎1-js/03-code-quality/05-testing-mocha/pow-2.view/index.html‎

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,35 @@
11
<!DOCTYPE html>
22
<html>
33
<head>
4-
<!-- add mocha css, to show results -->
4+
<!-- incluir css para mocha, para mostrar los resultados -->
55
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css">
6-
<!-- add mocha framework code -->
6+
<!-- incluir el código del framework mocha -->
77
<script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
88
<script>
9-
// enable bdd-style testing
10-
mocha.setup('bdd');
9+
mocha.setup('bdd'); // configuración mínima
1110
</script>
12-
<!-- add chai -->
11+
<!-- incluir chai -->
1312
<script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
1413
<script>
15-
// chai has a lot of stuff, let's make assert global
14+
// chai tiene un montón de cosas, hacemos assert global
1615
let assert = chai.assert;
1716
</script>
1817
</head>
19-
2018
<body>
2119

2220
<script>
2321
function pow(x, n) {
24-
return 8; // :) we cheat!
22+
return 8; // :) ¡hacemos trampas!
2523
}
2624
</script>
2725

28-
<!-- the script with tests (describe, it...) -->
26+
<!-- el fichero con los tests (describe, it...) -->
2927
<script src="test.js"></script>
3028

31-
<!-- the element with id="mocha" will contain test results -->
29+
<!-- el elemento con id="mocha" que contendrá los resultados de los tests -->
3230
<div id="mocha"></div>
3331

34-
<!-- run tests! -->
32+
<!-- ¡ejecutamos los tests! -->
3533
<script>
3634
mocha.run();
3735
</script>

‎1-js/03-code-quality/05-testing-mocha/pow-2.view/test.js‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
describe("pow", function() {
22

3-
it("2 raised to power 3 is 8", function() {
3+
it("2 elevado a la potencia de 3 es 8", function() {
44
assert.equal(pow(2, 3), 8);
55
});
66

7-
it("3 raised to power 3 is 27", function() {
7+
it("3 elevado a la potencia de 3 es 27", function() {
88
assert.equal(pow(3, 3), 27);
99
});
1010

0 commit comments

Comments
 (0)