¿Qué es el patrón Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** es un patrón para estructurar las pruebas claramente en tres fases: **Arrange** (preparar), **Act** (realizar la acción), **Assert** (verificar el resultado). Hace que las pruebas sean legibles, organizadas y fáciles de entender.

## Las tres fases

```text
ARRANGE → set up the test: create objects, prepare inputs, configure mocks, set state
ACT     → perform the ACTION being tested (call the function/method under test)
ASSERT  → verify the OUTCOME: check the result/behavior matches what's expected
→ A clear three-part structure for every test.
```

## Ejemplo

```js
test('Cart calculates total with discount', () => {
  // ARRANGE — set up
  const cart = new Cart();
  cart.add({ price: 100 });
  cart.applyDiscount(0.1);          // 10% off

// ACT — perform the action under test
  const total = cart.getTotal();

// ASSERT — verify the result
  expect(total).toBe(90);
});
```

Las tres fases son visualmente claras (a menudo separadas por líneas en blanco o comentarios), lo que hace evidente la intención de la prueba: qué se prepara, qué se hace, qué se verifica.

## Por qué AAA ayuda

```text
✓ READABILITY — clear structure; easy to see setup vs action vs verification
✓ FOCUS — encourages testing ONE action per test (one clear Act)
✓ MAINTAINABILITY — consistent structure across tests; easy to understand/modify
✓ Spot problems — too much in Arrange (complex setup) or multiple Acts (testing too much)
→ (Given-When-Then is the same idea, in BDD terms: Given setup, When action, Then outcome.)
```

## Por qué es importante

Entender el patrón Arrange-Act-Assert es valioso porque proporciona una **estructura simple y efectiva para escribir pruebas claras y mantenibles**, por lo que es conocimiento práctico útil.

El patrón — estructurar cada prueba en **Arrange** (preparar el contexto de la prueba, entradas y estado), **Act** (realizar la única acción siendo probada), y **Assert** (verificar que el resultado coincida con las expectativas) — hace que las pruebas sean legibles y bien organizadas, con la intención inmediatamente clara (qué se prepara, qué se hace, qué se verifica).

Entender **por qué AAA ayuda** es el valor clave: mejora la **legibilidad** (la estructura clara de tres partes hace que las pruebas sean fáciles de seguir), fomenta el **enfoque** (una acción por prueba, ya que hay una fase Act clara — promoviendo pruebas enfocadas que verifiquen un comportamiento), mejora la **mantenibilidad** (estructura consistente en toda la suite de pruebas), y ayuda a **detectar problemas** (configuración excesiva en Arrange señala dependencias complejas, múltiples Acts señalan una prueba haciendo demasiado).

Seguir AAA produce pruebas que son fáciles de escribir, entender y mantener — valioso ya que las pruebas se leen y modifican con el tiempo, y las pruebas poco claras son una carga real de mantenimiento.

Saber que **Given-When-Then** (la formulación BDD: Given configuración, When acción, Then resultado) es la misma idea conecta AAA con enfoques basados en comportamiento.

Ya que escribir pruebas claras, bien estructuradas y mantenibles es importante (las pruebas son código que debe ser entendido y mantenido) y AAA proporciona una estructura simple y efectiva para esto, y ya que entender el patrón y sus beneficios ayuda a escribir mejores pruebas, entender el patrón Arrange-Act-Assert es conocimiento valioso y prácticamente relevante — una práctica simple pero efectiva para escribir pruebas claras, enfocadas y mantenibles, ampliamente utilizada y que vale la pena aplicar para mejor calidad de pruebas, un hábito útil para cualquiera que escriba pruebas.