Arquetipo
Patrones de comportamientoUso: AltaComplejidad: Media

Chain of Responsibility

Cadena de responsabilidad

Pasa una petición a lo largo de una cadena de manejadores; cada uno decide si la procesa, la rechaza o la pasa al siguiente.

“Una petición pasa por varios filtros y cualquiera puede cortarla.”

workEl caso real

Antes de aprobar un pago con tarjeta, tu fintech aplica controles antifraude en orden: lista de tarjetas bloqueadas, límite diario del cliente, país de la conexión frente al país de la tarjeta y un puntaje de riesgo calculado por un modelo externo. Cualquier control puede rechazar el pago y cortar el resto. El equipo de riesgo cambia el orden y añade controles cada pocas semanas.

warningEl problema sin el patrón

Un método validarPago() de 200 líneas tiene todos los controles en if encadenados. Cambiar el orden, o desactivar un control para un país, obliga a modificar y volver a probar el método entero.

check_circleCómo lo resuelve el patrón

Cada control es un manejador con la misma interfaz y una referencia al siguiente. Si detecta un problema, rechaza el pago; si no, lo pasa al siguiente eslabón. La cadena se arma al configurar la aplicación y puede ser distinta en cada país.

schemaDiagrama de clases

Diagrama interactivo: puedes acercar, mover el lienzo y pasar el cursor sobre cada clase para ver su detalle.

codeEl código, antes y después

cancelSin el patrónANTES
async function validarPago(pago: Pago) {
  if (await listaBloqueo.contiene(pago.tarjeta)) return rechazar('Tarjeta bloqueada');
  if ((await totalDelDia(pago.cliente)) + pago.monto > LIMITE) return rechazar('Límite diario');
  if (paisConexion(pago) !== pago.tarjeta.pais) return rechazar('País no coincide');
  if ((await modeloRiesgo.puntuar(pago)) > 0.8) return rechazar('Riesgo alto');
  return aprobar();
}
check_circleCon el patrónDESPUÉS
abstract class ControlFraude {
  private siguiente?: ControlFraude;

  enlazar(control: ControlFraude) { this.siguiente = control; return control; }

  async revisar(pago: Pago): Promise<Resultado> {
    const motivo = await this.detectar(pago);
    if (motivo) return { aprobado: false, motivo };          // corta la cadena
    return this.siguiente ? this.siguiente.revisar(pago) : { aprobado: true };
  }

  protected abstract detectar(pago: Pago): Promise<string | null>;
}

class ControlListaBloqueo extends ControlFraude {
  protected async detectar(pago: Pago) {
    return (await listaBloqueo.contiene(pago.tarjeta)) ? 'Tarjeta bloqueada' : null;
  }
}

const cadena = new ControlListaBloqueo();
cadena.enlazar(new ControlLimiteDiario()).enlazar(new ControlPais()).enlazar(new ControlRiesgo());
await cadena.revisar(pago);

Ejemplos en TypeScript, simplificados para mostrar la idea: los tipos auxiliares (Pedido, Cliente…) se omiten.

lightbulb

Matiz importante

Define siempre qué ocurre si la petición llega al final sin que nadie la atienda: en este ejemplo se aprueba, en otros casos conviene un manejador por defecto. Los middlewares de Express, ASP.NET Core o Laravel son una variante de este patrón.

thumb_upCuándo usarlo

  • ✓Una petición debe pasar por varios pasos de validación o procesamiento y cualquiera puede detenerla.
  • ✓El orden o el conjunto de pasos cambia según la configuración o el contexto.

do_not_disturb_onCuándo no usarlo

  • ✕Los pasos son pocos y fijos: una secuencia de llamadas es más fácil de leer.
  • ✕La cadena es larga y no registras qué eslabón decidió: depurar un rechazo se vuelve difícil.

memoryPrincipios en juego

  • •Responsabilidad única: cada control vive en su propia clase.
  • •Abierto/Cerrado: añades, quitas o reordenas controles sin modificar los existentes.

hubPatrones relacionados

  • •Decorator: estructura parecida, pero el decorador siempre delega; en la cadena cualquier eslabón puede cortar.
  • •Command: las peticiones que recorren la cadena pueden representarse como comandos.
  • •Composite: un evento puede subir de un componente a su contenedor como si fuera una cadena.

quizPon a prueba lo que leíste

Dos preguntas al azar sobre este patrón. Cada vez que las cambias salen otras.

Más ejercicios →

code_blocksChain of Responsibility en tu lenguaje

El mismo caso, implementado completo y de forma idiomática. Se puede copiar y ejecutar.

LO IDIOMÁTICO EN TYPESCRIPT: Cada eslabón implementa detectar de forma asíncrona y devuelve string | null. El resultado es una unión discriminada: si aprobado es false, el compilador sabe que existe motivo. La cadena se arma encadenando enlazar, que devuelve el eslabón añadido.

chain-of-responsibility.ts · 58 líneas
export interface Pago {
  tarjeta: string;
  cliente: string;
  monto: number;
  paisTarjeta: string;
  paisConexion: string;
}

export type Resultado = { aprobado: true } | { aprobado: false; motivo: string };

export abstract class ControlFraude {
  #siguiente?: ControlFraude;

  enlazar(siguiente: ControlFraude): ControlFraude {
    this.#siguiente = siguiente;
    return siguiente;
  }

  async revisar(pago: Pago): Promise<Resultado> {
    const motivo = await this.detectar(pago);
    if (motivo) return { aprobado: false, motivo };                       // corta la cadena
    return this.#siguiente ? this.#siguiente.revisar(pago) : { aprobado: true };
  }

  protected abstract detectar(pago: Pago): Promise<string | null>;
}

const tarjetasBloqueadas = new Set(['4000000000000002']);
const gastadoHoy = new Map([['cli-1', 900]]);

class ControlListaBloqueo extends ControlFraude {
  protected async detectar(pago: Pago) {
    return tarjetasBloqueadas.has(pago.tarjeta) ? 'Tarjeta bloqueada' : null;
  }
}

class ControlLimiteDiario extends ControlFraude {
  constructor(private readonly limite: number) { super(); }
  protected async detectar(pago: Pago) {
    const total = (gastadoHoy.get(pago.cliente) ?? 0) + pago.monto;
    return total > this.limite ? 'Supera el límite diario' : null;
  }
}

class ControlPais extends ControlFraude {
  protected async detectar(pago: Pago) {
    return pago.paisTarjeta !== pago.paisConexion ? 'El país de conexión no coincide' : null;
  }
}

// ── Uso ──
const cadena = new ControlListaBloqueo();
cadena.enlazar(new ControlLimiteDiario(1000)).enlazar(new ControlPais());

const pago: Pago = { tarjeta: '4111111111111111', cliente: 'cli-2', monto: 120, paisTarjeta: 'PE', paisConexion: 'PE' };
console.log(await cadena.revisar(pago));                            // { aprobado: true }
console.log(await cadena.revisar({ ...pago, cliente: 'cli-1' }));   // límite diario
console.log(await cadena.revisar({ ...pago, paisConexion: 'RU' })); // país
Ver los 23 patrones en TypeScript →