Nivel inicial8 min de lectura · Publicado el

Newsletter especializado en BDD y guía rápida de BDD

BDD con dos escenarios Dado, Cuando, Entonces: con un carrito de 30 € el envío cuesta 5 € y con 50 €, gratis; cada uno se ejecuta como test. BDD: el ejemplo es el testrubentejera.com DadoCuandoEntonces30 €5 €50 €gratisse ejecuta como test
Dado un carrito de 30 €, cuando calculo el envío, entonces cuesta 5 €; con 50 €, gratis. Alguien conecta cada frase con código en los pasos, y Cucumber ejecuta cada ejemplo como test.

El newsletter: BDD Addict

Este artículo nació en 2018 como un enlace a un newsletter dedicado solo a BDD:

https://www.specsolutions.eu/news/bddaddict/

Es BDD Addict, una selección de artículos, charlas y eventos sobre BDD. Lo edita Gáspár Nagy, creador de SpecFlow y coautor, con Seb Rose, de la serie de libros «The BDD Books». Trata BDD, Cucumber, Reqnroll (el sucesor de SpecFlow para .NET), automatización de pruebas y documentación viva.

Estado en noviembre de 2026
¿Sigue existiendo? Sí: la página y el formulario de suscripción funcionan
Último número El 61, de abril de 2024
Frecuencia Nació como mensual; desde 2022 sale de forma irregular
Archivo Los números anteriores se pueden leer desde la misma página

Si nunca has trabajado con BDD, lo que sigue te sirve para sacarle partido al archivo.

Qué es BDD, en palabras sencillas

Una petición vaga cada uno la entiende a su manera; un ejemplo concreto se puede comprobar. Cualquiera puede leerlo y ver si el resultado es el esperado.

BDD aplica esa idea al software. En vez de pedir «que el envío sea gratis en pedidos grandes», el equipo acuerda ejemplos concretos:

  • Con un carrito de 30 euros, el envío cuesta 5 euros.
  • Con un carrito de 50 euros, el envío es gratis.

Esos ejemplos sirven a la vez de especificación (lo que hay que construir), de prueba (lo que se comprueba) y de documentación (lo que hace hoy el sistema).

Y no se quedan en un documento: alguien conecta cada frase con un poco de código (los pasos o step definitions), y desde ahí cada ejemplo se ejecuta como test y avisa cuando el código deja de cumplirlo.

Primero el ejemplo, después el código.

De dónde viene

BDD lo propuso Dan North en «Introducing BDD» (publicado en la revista Better Software en 2006). Lo creó porque a los programadores que empezaban con TDD les costaba saber qué probar, cómo llamar a cada test o por dónde empezar. Su idea fue cambiar la palabra «test» por «comportamiento»: en vez de pensar qué probar, piensas qué debe hacer el sistema.

De ese artículo vienen dos plantillas que hoy se usan en todas partes:

Para Plantilla
Historias de usuario Como [rol], quiero [algo], para [beneficio]
Criterios de aceptación Dado [un contexto], cuando [ocurre algo], entonces [resultado esperado]

North también propuso nombrar los tests como frases que empiezan por should («debería»). Si el nombre no encaja en esa frase, quizá ese comportamiento pertenece a otra clase.

Las tres prácticas de BDD

La documentación de Cucumber divide BDD en tres prácticas que se repiten en pequeñas iteraciones:

  1. Descubrir: negocio, desarrollo y pruebas conversan con ejemplos reales para entender qué hace falta y encontrar huecos.
  2. Formular: los ejemplos acordados se escriben en Gherkin, un formato que leen tanto las personas como las máquinas.
  3. Automatizar: cada ejemplo se conecta al código como una prueba que falla hasta que el comportamiento existe.

La parte más valiosa es la primera. Si te saltas la conversación y solo escribes Gherkin, tienes pruebas con otra sintaxis, no BDD.

Un ejemplo que puedes ejecutar

Gherkin está traducido a más de 70 idiomas, también al español. Basta con indicar el idioma en la primera línea. Este es el fichero features/envio.feature:

# language: es
Característica: Envío gratis
  Como cliente de la tienda
  quiero saber cuándo no pago el envío
  para animarme a completar el pedido

  Escenario: Pedido por debajo del mínimo
    Dado un carrito con productos por valor de 30 euros
    Cuando calculo el envío
    Entonces el envío cuesta 5 euros

  Escenario: Pedido que llega al mínimo
    Dado un carrito con productos por valor de 50 euros
    Cuando calculo el envío
    Entonces el envío es gratis

Cada frase se conecta con código en los «pasos» (features/step_definitions/envio.steps.mjs). Los {int} recogen el número de la frase:

import { Given, When, Then } from '@cucumber/cucumber';
import assert from 'node:assert/strict';
import { costeEnvio } from '../../src/envio.mjs';

Given('un carrito con productos por valor de {int} euros', function (total) {
  this.total = total;
});

When('calculo el envío', function () {
  this.envio = costeEnvio(this.total);
});

Then('el envío cuesta {int} euros', function (esperado) {
  assert.equal(this.envio, esperado);
});

Then('el envío es gratis', function () {
  assert.equal(this.envio, 0);
});

Y el código que cumple los ejemplos (src/envio.mjs):

const MINIMO_ENVIO_GRATIS = 50;
const TARIFA_ENVIO = 5;

export function costeEnvio(totalCarrito) {
  return totalCarrito >= MINIMO_ENVIO_GRATIS ? 0 : TARIFA_ENVIO;
}

Para ejecutarlo:

npm install --save-dev @cucumber/cucumber
npx cucumber-js
2 scenarios (2 passed)
6 steps (6 passed)

Si alguien cambia >= por >, el segundo escenario falla y te dice qué frase dejó de cumplirse: «Entonces el envío es gratis», con 5 !== 0. El ejemplo ha detectado un error en el límite que un lector con prisa habría pasado por alto.

Las palabras clave en español que más vas a usar:

Inglés Español
Feature Característica
Scenario Escenario o Ejemplo
Given Dado, Dada, Dados, Dadas
When Cuando
Then Entonces
And / But Y / Pero
Background Antecedentes
Scenario Outline / Examples Esquema del escenario / Ejemplos

Puedes ver la lista completa con npx cucumber-js --i18n-keywords es.

BDD, TDD y ATDD: cómo encajan

  • TDD trabaja por dentro: pequeños tests que guían el diseño del código. Lo tienes en TDD, desarrollo dirigido por test.
  • ATDD escribe primero las pruebas de aceptación de cada funcionalidad. Lo tienes en desarrollo dirigido por tests de aceptación.
  • BDD pone el foco en la conversación y en un lenguaje común entre negocio y desarrollo. Los escenarios de BDD suelen hacer el papel de las pruebas de aceptación, y por dentro se sigue programando con TDD.

Los escenarios nacen muchas veces de los criterios de aceptación de una historia de usuario: más sobre ellas en historias de usuario en Scrum.

BDD cuando programas con IA

Esto es criterio propio del enfoque IA Limpia, no algo que digan North ni Cucumber.

Un escenario en Gherkin es un buen encargo para un agente de IA: dice qué debe pasar con ejemplos concretos y se puede comprobar solo. Tres reglas sencillas:

  1. Los escenarios los acuerdan y revisan personas antes de pedir el código.
  2. El agente puede escribir los pasos y la implementación, pero no cambiar los escenarios para que pasen.
  3. Si un escenario está mal, se corrige en la conversación del equipo, no en silencio.

Alternativas al newsletter

  • Documentación de BDD de Cucumber: gratuita, mantenida y en inglés. Explica las tres prácticas con ejemplos y es un buen sitio para empezar.
  • Effective Behavior-Driven Development, de Gáspár Nagy y Seb Rose (Manning): recoge el contenido de «The BDD Books». Está en acceso anticipado desde octubre de 2025 y Manning prevé publicarlo en enero de 2027. En inglés y de pago.

Fuentes

Comprobado el 7 de noviembre de 2026:

Ejecutado con Node 24.21.0, @cucumber/cucumber 13.3.0 y @cucumber/gherkin 42.0.1, en Linux. Las palabras clave en español salen de npx cucumber-js --i18n-keywords es en esa misma versión.