Arquetipo
Patrones creacionalesUso: MediaComplejidad: Baja

Singleton

Instancia única

Garantiza que una clase tenga una única instancia y ofrece un punto de acceso a ella.

“Debe existir una sola instancia compartida (configuración, caché del proceso).”

workEl caso real

Tu API carga al arrancar la configuración y las feature flags (qué funcionalidades están activas en cada país) desde un archivo y un servicio remoto. La carga tarda medio segundo y debe hacerse una sola vez: si cada módulo tiene su propia copia, unos verán una funcionalidad activa y otros no.

warningEl problema sin el patrón

Cada servicio hace new Configuracion() y vuelve a leer el archivo y a llamar al servicio remoto. Además, cuando las flags se refrescan, unas copias quedan actualizadas y otras no, y el comportamiento de la API depende de qué copia usó cada petición.

check_circleCómo lo resuelve el patrón

La clase Configuracion tiene el constructor privado y un método estático que crea la instancia la primera vez y después devuelve siempre la misma. Hoy lo habitual es delegar esa garantía al contenedor de dependencias, registrando la clase con ciclo de vida singleton.

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
class ServicioPagos {
  private config = new Configuracion(); // vuelve a leer archivo y red
}

class ServicioEnvios {
  private config = new Configuracion(); // otra copia, quizá con otras flags
}
check_circleCon el patrónDESPUÉS
class Configuracion {
  private static instancia?: Configuracion;
  private flags = new Map<string, boolean>();

  private constructor() {
    // carga costosa: archivo + servicio remoto
  }

  static obtener(): Configuracion {
    return (Configuracion.instancia ??= new Configuracion());
  }

  estaActiva(flag: string) { return this.flags.get(flag) ?? false; }
}

// Alternativa recomendada: el contenedor garantiza la instancia única
// y la inyecta como cualquier otra dependencia.
// contenedor.registrarSingleton(Configuracion);

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

lightbulb

Matiz importante

Singleton resuelve dos cosas a la vez (instancia única y acceso global), y por eso se considera a menudo un antipatrón: el acceso global oculta dependencias y complica las pruebas. En frameworks como ASP.NET Core, Spring o NestJS se registra el servicio como singleton en el contenedor: la instancia sigue siendo única, pero se inyecta y se puede sustituir en los tests. En entornos con varios hilos, la creación perezosa debe sincronizarse.

thumb_upCuándo usarlo

  • ✓Un recurso debe existir una sola vez por proceso: configuración, caché en memoria, registro de métricas.
  • ✓Crear la instancia es costoso y su estado tiene que ser coherente para todos.

do_not_disturb_onCuándo no usarlo

  • ✕Lo usas como variable global para no pasar dependencias: oculta el acoplamiento y complica las pruebas.
  • ✕Necesitas instancias distintas por prueba, por usuario o por petición.
  • ✕Para conexiones a base de datos: lo que puede ser único es el punto de acceso que administra un pool de conexiones, no una conexión compartida por todo el sistema.

memoryPrincipios en juego

  • •Instancia única controlada: todas las partes ven el mismo estado.
  • •Inicialización perezosa: el costo se paga solo la primera vez que se usa.

hubPatrones relacionados

  • •Abstract Factory, Builder y Prototype: sus fábricas o registros suelen ser instancias únicas.
  • •Facade: muchas veces basta con una sola fachada.
  • •Flyweight: ambos comparten instancias, pero un Singleton es una sola instancia que puede cambiar de estado, mientras que los flyweights son muchas instancias y siempre inmutables.

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_blocksSingleton en tu lenguaje

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

LO IDIOMÁTICO EN TYPESCRIPT: Un módulo ES se evalúa una sola vez, así que exportar una instancia (export const config = ...) ya funciona como singleton. La clase con constructor privado y un campo estático privado # se usa cuando la creación debe ser perezosa. ??= crea la instancia solo la primera vez.

singleton.ts · 29 líneas
export class Configuracion {
  static #instancia?: Configuracion;
  readonly #flags: ReadonlyMap<string, boolean>;

  private constructor() {
    console.log('Cargando configuración (solo ocurre una vez)...');
    this.#flags = new Map([
      ['pagos.billetera', true],
      ['envios.express', false],
    ]);
  }

  static obtener(): Configuracion {
    return (Configuracion.#instancia ??= new Configuracion());
  }

  estaActiva(flag: string): boolean {
    return this.#flags.get(flag) ?? false;
  }
}

// ── Uso ──
const desdePagos = Configuracion.obtener();
const desdeEnvios = Configuracion.obtener();

console.log(desdePagos === desdeEnvios);              // true
console.log(desdePagos.estaActiva('pagos.billetera')); // true
console.log(desdeEnvios.estaActiva('envios.express')); // false
// new Configuracion();  ← error de compilación: el constructor es privado
Ver los 23 patrones en TypeScript →