SOLID sin dogma
En resumen: SOLID son cinco principios para un código que sobrevive a los cambios: una sola razón para cambiar, ampliar sin modificar, subtipos sustituibles, interfaces pequeñas y dependencia de abstracciones.
Problema
El cambio del correo que rompió la contabilidad
La tienda online envía al cliente una factura por correo. Cada noche también entrega a contabilidad un archivo con una línea por pedido. Una sola clase hace las dos cosas:
class Order { constructor(number, customer, net) { this.number = number; this.customer = customer; this.net = net; }}class InvoiceService { vat(order) { return order.net * 0.2; }
// Contabilidad: una línea para el archivo que importa en su programa. exportLine(order) { const total = order.net + this.vat(order); return [order.number, this.#money(order.net), this.#money(this.vat(order)), this.#money(total)].join(";"); }
// El cliente: el texto del correo con la factura. emailText(order) { const total = order.net + this.vat(order); return `Hola, ${order.customer}! Pedido ${order.number}: ${this.#money(total)} €`; }
#money(amount) { return amount.toFixed(2); }}const invoices = new InvoiceService();const order = new Order("2026-0142", "María", 80);console.log(invoices.exportLine(order));console.log(invoices.emailText(order));2026-0142;80.00;16.00;96.00Hola, María! Pedido 2026-0142: 96.00 €Marketing dice: «En el correo, pon 96 €, no 96,00 €. Se ve más limpio.» Alguien cambia el método auxiliar método #money:
#money(amount) { if (Number.isInteger(amount)) { return String(amount); } return amount.toFixed(2);}2026-0142;80;16;96Hola, María! Pedido 2026-0142: 96 €El correo queda como querían. A la mañana siguiente el programa de contabilidad rechaza el archivo: espera 80.00 y recibe 80. Nadie tocó la línea de contabilidad. Lo que cambió es el método auxiliar que comparten las dos líneas. La prueba del correo pasa, y no hay prueba del archivo, porque «nadie lo cambió».
La idea
Una sola razón para cambiar
La clase atiende a dos partes que no se conocen. La contable necesita un formato exacto que lee su programa. Marketing quiere un texto agradable para el cliente. Piden cambios en momentos distintos y por razones distintas. Mientras su código viva en una sola clase, un cambio para uno puede romper al otro.
Este es el primero de los cinco principios SOLID (reunidos por Robert Martin; el nombre sale de sus iniciales). El Single Responsibility Principle (SRP): una clase tiene una sola razón para cambiar.
«Razón» significa quién pide el cambio: una persona, un departamento, una ley. No significa «un método», y no significa «una clase pequeña». La pregunta que debes hacerte: «¿Quién vendrá a pedir un cambio aquí?» Si la respuesta es «contabilidad o marketing», son dos clases.
Míralo
Cada uno tiene su propia clase
El IVA y el total son una regla de la ley fiscal, y las dos partes los necesitan. Van al pedido, en un solo lugar:
class Order { constructor(number, customer, net) { this.number = number; this.customer = customer; this.net = net; }
vat() { return this.net * 0.2; }
total() { return this.net + this.vat(); }}La línea de contabilidad y el texto del correo se convierten en clases separadas. Cada una da formato a los importes a su manera:
class AccountingExport { line(order) { return [order.number, order.net.toFixed(2), order.vat().toFixed(2), order.total().toFixed(2)].join(";"); }}
class InvoiceEmail { text(order) { return `Hola, ${order.customer}! Pedido ${order.number}: ${this.#money(order.total())} €`; }
#money(amount) { if (Number.isInteger(amount)) { return String(amount); } return amount.toFixed(2); }}const order = new Order("2026-0142", "María", 80);console.log(new AccountingExport().line(order));console.log(new InvoiceEmail().text(order));2026-0142;80.00;16.00;96.00Hola, María! Pedido 2026-0142: 96 €El correo tiene importes enteros, y el archivo sigue con dos decimales. Mañana contabilidad cambiará el formato, y tocarás solo AccountingExport. El código del correo ni siquiera está delante de ti.
Las dos formas de escribir un importe ya no se comparten. Eso no es duplicación: hoy se parecen, pero son dos reglas que cambian por razones distintas.
Cuándo duele. El otro extremo es una clase para cada acción: VatCalculator, TotalCalculator, NumberFormatter, GreetingBuilder, tres líneas cada una. Siempre cambian juntas, porque las pide la misma persona, y abres cuatro archivos para leer una regla. Una clase de 200 líneas que atiende a una persona es mejor que cinco clases que siempre abres juntas. Lo que cambia junto se queda junto.
Más precisamente, para curiosos
- El propio Robert Martin escribe que «una responsabilidad» suele leerse como «hace una sola cosa». Su aclaración posterior es que un módulo responde ante un actor: un grupo de personas que piden cambios. «Hace una sola cosa» es una regla para funciones, no para clases.
- «Don't repeat yourself» (DRY) trata del conocimiento, no del texto. Dos trozos de código que se parecen pero cambian por razones distintas no son duplicación. Si los fundes en un método auxiliar, atas a dos personas con un mismo nudo. Eso es justo lo que pasó en el problema.
Pruébalo
Quién pide el cambio
Míralo
Un envío nuevo sin tocar el total
El segundo principio es abierto/cerrado (Open/Closed Principle, OCP): el código está abierto a la ampliación y cerrado a la modificación. Una variante nueva llega como código nuevo, y el código que ya funciona y está probado no se toca.
Lo viste en la lección Strategy: la cadena de if para el método de pago se convirtió en una tabla nombre → estrategia. Con los envíos pasa igual. Cada envío conoce su precio:
function toAddress(amount) { return amount >= 100 ? 0 : 5.9;}
function toOffice(amount) { return 3.9;}El total no sabe qué envíos existen:
function orderTotal(amount, delivery) { return amount + delivery(amount);}La tienda añade el envío a un casillero de paquetes. Es una función nueva:
function toLocker(amount) { return 2.9;}orderTotal, el envío a un domicilio y a una oficina no se tocan. Falta poner el envío nuevo en la tabla de la que elige el cliente. Esa es la siguiente tarjeta.
Cuándo duele. No puedes cerrar el código contra todo, y no deberías. Cada punto de extensión es una función y una fila en una tabla que alguien tiene que leer. Cierras donde los cambios llegan de verdad: cada temporada llegan envíos nuevos. La regla práctica: la primera vez, escribe un if. Cuando llegue la tercera variante, haz la tabla (Replace Conditional with Polymorphism, de la lección sobre refactorización).
Pruébalo
Una fila nueva en la tabla
La tabla de la lección Strategy enumera los envíos entre los que elige el cliente. Añade el casillero.
¿Qué va en el hueco?
const deliveries = new Map([
["domicilio", toAddress],
["oficina", toOffice],
["casillero", ],
]);
for (const [choice, delivery] of deliveries) {
console.log(`${choice}: ${orderTotal(80, delivery).toFixed(2)} €`);
}toLocker, sin paréntesis. La tabla guarda la función misma. Con paréntesis guardaría su resultado (2.9), y el total no tendría nada a lo que llamar.domicilio: 85.90 €oficina: 83.90 €casillero: 82.90 €Solo cambió la tabla, y lo único que hace es enumerar. OCP no significa «ni una sola línea cambiada». Significa que las reglas que ya funcionan y están probadas no se tocan por cada variante nueva.
Problema
La cancelación que se detuvo a medias
Una clienta paga un pedido de tres formas: 60 € con tarjeta, un cupón de 20 € y 16 € en puntos. Después lo cancela. Cada tipo de pago sabe cómo devolver su dinero:
// Todo pago tiene refund(): devuelve el dinero al cliente por el mismo medio con el que pagó.class Payment { constructor(amount) { this.amount = amount; }}
class CardPayment extends Payment { refund() { console.log(`Tarjeta: devueltos ${this.amount.toFixed(2)} €`); }}
class VoucherPayment extends Payment { refund() { throw new Error("un cupón no se puede devolver"); }}
class PointsPayment extends Payment { refund() { console.log(`Puntos: devueltos ${this.amount.toFixed(2)} €`); }}El pedido recorre sus pagos y llama a refund() en cada uno:
class Order { constructor(payments) { this.payments = payments; this.status = "pagado"; }
cancel() { for (const payment of this.payments) { payment.refund(); } this.status = "cancelado"; }}const order = new Order([ new CardPayment(60), new VoucherPayment(20), new PointsPayment(16),]);try { order.cancel();} catch (e) { console.log(`Error: ${e.message}`);}console.log(`Estado: ${order.status}`);Tarjeta: devueltos 60.00 €Error: un cupón no se puede devolverEstado: pagadoLa tarjeta está devuelta, los puntos no, y el pedido sigue «pagado». El almacén ve «pagado» y envía el paquete. El código de cancel() es correcto. El fallo está en el cupón: es un Payment, pero no hace lo que Payment promete.
Míralo
El subtipo que rompe la promesa
cancel() { for (const payment of this.payments) { payment.refund(); } this.status = "cancelado";}
const order = new Order([ new CardPayment(60), new VoucherPayment(20), new PointsPayment(16),]);try { order.cancel();} catch (e) { console.log(`Error: ${e.message}`);}console.log(`Estado: ${order.status}`);Paso a paso, en palabras
- El pedido se pagó de tres formas: 60.00 € con tarjeta, un cupón de 20.00 € y 16.00 € en puntos. Los tres son Payment.
- La clienta cancela. cancel() recorre los pagos y llama a refund() en cada uno.
- La tarjeta devuelve 60.00 €. Hace exactamente lo que promete Payment.
- El cupón también es un Payment, pero su refund() lanza Error. La promesa está rota.
- La excepción sale del bucle y de cancel(). Los puntos (16.00 €) no se devuelven, y la línea que pone status en «cancelado» nunca se ejecuta.
- El catch en el programa la atrapa y imprime el error. El programa sigue.
- El estado sigue siendo «pagado». El almacén envía el pedido, y 60.00 € ya están de vuelta en la tarjeta.
Este es el tercer principio, el principio de sustitución de Barbara Liskov (Liskov Substitution Principle, LSP): donde el código trabaja con un tipo, cualquier subtipo puede ocupar su lugar, y el código no lo nota. El subtipo puede hacer el trabajo a su manera, pero cumple la promesa del tipo.
Payment promete «devuelvo el dinero al cliente». ¿Qué significa eso para un cupón en una tienda de verdad? Un cupón nuevo por el mismo importe:
class VoucherPayment extends Payment { refund() { console.log(`Cupón: nuevo cupón por ${this.amount.toFixed(2)} €`); }}const order = new Order([ new CardPayment(60), new VoucherPayment(20), new PointsPayment(16),]);try { order.cancel();} catch (e) { console.log(`Error: ${e.message}`);}console.log(`Estado: ${order.status}`);Tarjeta: devueltos 60.00 €Cupón: nuevo cupón por 20.00 €Puntos: devueltos 16.00 €Estado: canceladocancel() no cambió. Ahora el subtipo encaja donde se espera el tipo.
Reconoces una violación por tres señales:
- el subtipo lanza «no soportado» (un error) en un método que el tipo promete;
- el subtipo devuelve algo que el tipo no promete (
-1,null, una cadena vacía), o le exige más a quien llama; - el código comprueba con instanceof antes de llamar al método. Es un rodeo alrededor de un subtipo que no encaja.
Cuándo duele. Aquí el dogma va en la otra dirección: meter algo a la fuerza en la jerarquía porque «también es un pago». Si algo de verdad no puede devolver dinero (un regalo de la tienda, por ejemplo), no es un Payment con refund. Dale su propio tipo en lugar de escribir un método que lanza.
Más precisamente, para curiosos
Array (Array.isArray dice true), pero no admite push:const items = Object.freeze(["café", "taza"]);try { items.push("té");} catch (e) { console.log(`${e.name}: ${e.message}`);}TypeError: Cannot add property 2, object is not extensible"use strict") el error es un TypeError. Fuera del modo estricto, push sigue lanzando, pero asignar un elemento no hace nada en silencio.Formalmente, según Liskov: un subtipo no pide más que el tipo (no endurece las condiciones de entrada), no da menos (no debilita la promesa sobre el resultado) y conserva lo que siempre es cierto para el tipo.
Pruébalo
La violación silenciosa
El envío a un casillero devuelve -1 cuando el casillero está lleno. El total lo suma, como siempre. ¿Qué imprime el programa?
function toLocker(full) { return (amount) => { if (full) { return -1; // -1 significa «no hay sitio» } return 2.9; };}
console.log(`${orderTotal(80, toLocker(true)).toFixed(2)} €`);79.00 €. El total está escrito para la promesa «el precio del envío, 0 o más». Suma 80 y -1, y el cliente paga 1 € menos por un envío que no puede ocurrir. Nada lanza, y eso hace esta violación más peligrosa que la excepción. La solución: un casillero lleno no es un precio. El casillero lleno no entra en la tabla de envíos que el cliente puede elegir.
Problema
El SMS que nunca salió
La tienda envía avisos a los clientes. Alguien describió en un solo lugar todo lo que se puede enviar:
// Avisos: todo el que envía avisos tiene email(to, text) y sms(phone, text).notifier.sms(...), y sin el método el programa se detiene con un TypeError. Así que alguien lo escribió.Pruébalo
Encuentra el error
El cliente recibe un correo de que el paquete salió. El SMS del mensajero nunca llega:
const notifier = new MailProvider();notifier.email("maria@example.com", "El pedido 2026-0142 ha sido enviado.");notifier.sms("0888 123 456", "El mensajero llega hoy entre las 14 y las 16 h.");Correo a maria@example.com: El pedido 2026-0142 ha sido enviado.¿En qué línea está el error?
Elige la línea con el error.
El método de SMS está vacío. Es una mentira que nadie oye: el código lo llama, no sale nada, y no hay error. El proveedor lo escribió porque el código llama a sms en todo el que envía avisos. El método vacío también rompe LSP: la promesa «envío un SMS» no se cumple. La solución de verdad no está en esta línea sino en el contrato: la siguiente tarjeta.
Míralo
Interfaces pequeñas
El cuarto principio: segregación de interfaces (Interface Segregation Principle, ISP). Nadie debe depender de métodos que no usa. El contrato se escribe desde el lado de quien lo usa, y es tan grande como lo necesita.
JavaScript no tiene interfaces. El contrato pequeño es lo que llama el código: el aviso del mensajero llama solo asms, así que encaja cualquier objeto con sms. Aquí el principio significa: no pidas más de lo que llamas, y no hagas que nadie escriba métodos vacíos.Cada proveedor hace solo lo que sabe, y el aviso del mensajero pide solo SMS:
class MailProvider { email(to, text) { console.log(`Correo a ${to}: ${text}`); }}
class SmsGateway { sms(phone, text) { console.log(`SMS a ${phone}: ${text}`); }}
class ShippingNotice { constructor(sender) { this.sender = sender; }
courierToday(phone) { this.sender.sms(phone, "El mensajero llega hoy entre las 14 y las 16 h."); }}const email = new MailProvider();email.email("maria@example.com", "El pedido 2026-0142 ha sido enviado.");new ShippingNotice(new SmsGateway()).courierToday("0888 123 456");Correo a maria@example.com: El pedido 2026-0142 ha sido enviado.SMS a 0888 123 456: El mensajero llega hoy entre las 14 y las 16 h.Si alguien pasa el proveedor de correo donde hace falta un SMS, el programa se detiene en la primera llamada en lugar de quedarse callado:
try { new ShippingNotice(new MailProvider()).courierToday("0888 123 456");} catch (e) { console.log(`${e.name}: ${e.message}`);}TypeError: this.sender.sms is not a functionLas interfaces pequeñas también ayudan a las pruebas: el doble del aviso implementa un método, no todo lo que la tienda puede enviar.
Cuándo duele. Una interfaz por cada método «por ISP» es el otro extremo: Readable, Writable, Deletable, Countable delante de un repositorio que se usa en un solo sitio y siempre entero. Si todos los que usan el contrato lo usan todo, es un solo contrato.
Problema
La prueba que envía un correo de verdad
La factura sale por correo. El servicio crea su propio mailer:
class SmtpMailer { send(to, text) { console.log(`SMTP a ${to}: ${text}`); }}
class InvoiceService { constructor() { this.mailer = new SmtpMailer(); }
issue(order, email) { const total = order.total().toFixed(2); const text = `Factura ${order.number}: ${total} €`; this.mailer.send(email, text); }}const order = new Order("2026-0142", "María", 80);new InvoiceService().issue(order, "maria@example.com");SMTP a maria@example.com: Factura 2026-0142: 96.00 €Funciona, pero:
- la prueba de la factura envía un correo de verdad, y en una máquina sin servidor SMTP falla;
- la tienda pasa de SMTP a un servicio con API, y editas la clase con las reglas de la factura para cambiar el mailer.
La regla (qué va en la factura) depende del detalle (cómo sale el correo).
Míralo
La abstracción pertenece a la regla
El quinto principio: inversión de dependencias (Dependency Inversion Principle, DIP). El código con las reglas no depende de los detalles. Ambos dependen de una abstracción, y ella pertenece a las reglas: dice qué necesitan («envía este texto a esta dirección»), no cómo lo hace SMTP.
class InvoiceService { // sender es cualquier objeto con un método send(to, text). constructor(sender) { this.sender = sender; }
issue(order, email) { const total = order.total().toFixed(2); const text = `Factura ${order.number}: ${total} €`; this.sender.send(email, text); }}Los detalles van aparte. El mailer y el doble de prueba tienen el método al que llama el servicio:
class SmtpSender { send(to, text) { console.log(`SMTP a ${to}: ${text}`); }}
class FakeSender { constructor() { this.sent = []; }
send(to, text) { this.sent.push(`${to} | ${text}`); }}const order = new Order("2026-0142", "María", 80);new InvoiceService(new SmtpSender()) .issue(order, "maria@example.com");
const fake = new FakeSender();const service = new InvoiceService(fake);service.issue(order, "maria@example.com");console.log(`La prueba vio: ${fake.sent[0]}`);SMTP a maria@example.com: Factura 2026-0142: 96.00 €La prueba vio: maria@example.com | Factura 2026-0142: 96.00 €class InvoiceService { // sender es cualquier objeto con un método send(to, text). constructor(sender) { this.sender = sender; }
issue(order, email) { const total = order.total().toFixed(2); const text = `Factura ${order.number}: ${total} €`; this.sender.send(email, text); }}
class SmtpSender { send(to, text) { console.log(`SMTP a ${to}: ${text}`); }}
const order = new Order("2026-0142", "María", 80);new InvoiceService(new SmtpSender()) .issue(order, "maria@example.com");
const fake = new FakeSender();const service = new InvoiceService(fake);service.issue(order, "maria@example.com");console.log(`La prueba vio: ${fake.sent[0]}`);Paso a paso, en palabras
- Antes las facturas apuntaban hacia abajo, a SmtpMailer. Ahora el servicio anota lo que necesita: un objeto con send(to, text).
- InvoiceService recibe el envío en el constructor y solo conoce send(to, text). De SMTP no sabe nada.
- SmtpSender tiene send(to, text), el contrato que describió el servicio. La flecha apunta hacia arriba: el detalle depende de la regla. Esa es la inversión.
- En ejecución la llamada sigue yendo hacia abajo: del servicio a SMTP. Lo que se invierte es la dependencia en el código, no la dirección de la llamada.
- En la prueba el mismo servicio recibe FakeSender: un segundo detalle que apunta a la misma abstracción. No sale ningún correo: el doble anota en sent lo que recibió.
- La prueba ve exactamente el texto de la factura, sin servidor de correo.
La «inversión» es la de la flecha en el código. Antes, las facturas conocían SMTP. Ahora SMTP conoce el contrato send(to, text), que está junto a las facturas. En ejecución, la llamada sigue yendo de las facturas a SMTP.
DIP y DI. En la lección Singleton e inyección de dependencias viste pasar desde fuera: el objeto recibe su dependencia en el constructor. Ese es el mecanismo. DIP dice de qué depender: de una abstracción que es tuya. Puedes tener una sin la otra:
-
pasar sin DIP: el servicio recibe el mailer desde fuera, pero su archivo sigue importando
import { SmtpMailer } from "./mail.js"y llama a algo que solo tiene SMTP; - DIP sin una biblioteca de DI: en el programa,
InvoiceServicerecibeSmtpSender, y ese es todo el cableado. Hay un solo lugar donde el programa junta los objetos.
Cuándo duele. Una interfaz delante de cada clase «por DIP» es el dogma más común. Una abstracción vale la pena delante de un detalle lento, externo o que va a cambiar: correo, pago, base de datos, reloj, red. Delante de Order o delante del formato de un importe es código que leer sin beneficio.
Más precisamente, para curiosos
invoices.js no importa smtp.js. main.js importa los dos y pasa new SmtpSender() al servicio. No hay abstracción como tipo: es el método send(to, text), escrito en el comentario y comprobado por la prueba con el doble.Pruébalo
Pon la prueba en orden
La prueba comprueba la factura sin un mailer real. El order ya existe. Pon las líneas en orden:
const fake = new FakeSender();console.log(`La prueba vio: ${fake.sent[0]}`);service.issue(order, "maria@example.com");const service = new InvoiceService(fake);
El doble va primero, porque el servicio lo quiere en su constructor. Luego se emite la factura, y solo entonces hay algo que comprobar. La salida: La prueba vio: maria@example.com | Factura 2026-0142: 96.00 €
En resumen
Cuando SOLID duele
Aquí está el IVA, escrito «según todas las reglas»:
class StandardVat { vat(net) { return net * 0.2; }}
class TaxPolicyFactory { static create() { return new StandardVat(); }}console.log(`IVA: ${TaxPolicyFactory.create().vat(80).toFixed(2)} €`);IVA: 16.00 €Y lo mismo sin dogma:
const VAT_RATE = 0.2;console.log(`IVA: ${(80 * VAT_RATE).toFixed(2)} €`);IVA: 16.00 €La salida es la misma. Lo primero es una clase y una fábrica para un número que cambia una vez cada diez años, y de todos modos en un solo lugar. Ese es el smell llamado generalidad especulativa (speculative generality): código para cambios que nadie ha pedido. Cuando llegue un segundo tipo (9 % para alimentos), ese es el momento de una tabla.
Los principios son preguntas, no reglas. Hazlas cuando el código duela:
| La pregunta | El dogma que debes evitar | |
|---|---|---|
| SRP | ¿Quién pedirá un cambio aquí? ¿Una parte o dos? | Una clase por cada método |
| OCP | ¿Qué llega de verdad nuevo cada mes? | Puntos de extensión por todas partes |
| LSP | ¿Puede cada subtipo estar aquí sin un if? |
Una jerarquía por la palabra «es» |
| ISP | ¿Este cliente usa todo lo que pide? | Una interfaz por cada método |
| DIP | ¿El detalle es lento, externo o reemplazable? | Una interfaz delante de cada clase |
Ejercicio
Una tarjeta regalo sin tocar la cancelación
Resuelve la tarea en tu editor.
Tarjeta regalo. La tienda también acepta tarjetas regalo. Al cancelar, el dinero vuelve a la tarjeta. Añade un GiftCardPayment que cumpla la promesa de Payment, y cancela un pedido pagado con 40 € con tarjeta y 25 € con tarjeta regalo. cancel() y los otros pagos no se tocan.
Tarjeta: devueltos 40.00 €Tarjeta regalo: 25.00 € de vuelta en la tarjetaEstado: canceladoMás tareas
- El informe mensual. Una clase calcula los ingresos del mes, escribe un CSV para contabilidad y un texto para la gerente, y envía el correo ella misma. Divídela según quién pide los cambios. ¿Qué queda compartido?
- Notificación push. Añade en la aplicación móvil un aviso cuando el paquete ha salido. ¿Qué contrato pequeño necesitas, y qué clases no tocas?
- Quitar una abstracción. Busca en tu propio proyecto una clase o función envuelta «por si acaso» sin ningún detalle lento o externo detrás. Quita la envoltura y ejecuta las pruebas.
Test
Ponte a prueba
Lecciones relacionadas
Sección «Lecciones relacionadas»- Se basa en: Singleton e inyección de dependencias · Funciones: una tarea, pocos parámetros, sin efectos secundarios ocultos · Code smells: método largo, clase grande, duplicación, primitivos en vez de tipos, cadenas largas de if · Refactorización en pasos pequeños
- Continúa en: Ejercicio: una clase desordenada, limpiada paso a paso · Capas · Arquitectura hexagonal y clean architecture · Monolito, monolito modular, servicios
- Ejercicios sobre el tema: Código limpio y refactorización