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

Question

IT Interview Practice · 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.

Las tres fases

Ejemplo

Por qué AAA ayuda

Por qué es importante

Preguntas relacionadas