Creación Flexible de Objetos con el Patrón Builder en JavaScript

Tienes una función que crea objetos de usuario. Comienza con tres parámetros, luego crece a cinco, después a siete. La mitad de ellos son opcionales. Quienes la llaman deben recordar el orden exacto, y una posición incorrecta produce silenciosamente un objeto defectuoso. Este es el problema que resuelve el Patrón Builder en JavaScript.

¿Qué es el Patrón Builder en JavaScript?

El Patrón Builder es un patrón de diseño creacional que construye objetos paso a paso en lugar de todo a la vez. En lugar de pasar cada valor a una única llamada de constructor, encadenas métodos setter y finalizas la creación con un paso build() que valida y retorna el objeto completado.

No es una solución universal. Para objetos simples con dos o tres campos bien definidos, un objeto literal plano o una función factory es más limpio. El Patrón Builder gana su lugar cuando la creación de objetos implica:

• Muchos parámetros opcionales donde el orden no importa
• Reglas de validación que deben ejecutarse antes de que el objeto sea utilizado
• Campos requeridos que necesitan ser validados en el momento de la creación
• Construcción en múltiples pasos donde los estados intermedios no deben ser expuestos

El Problema: Contaminación del Constructor

Considera este patrón común:

// ❌ Difícil de leer, fácil confundir el orden de los argumentos
const request = new ApiRequest('GET', '/users', null, true, 5000, 'json')

Seis argumentos posicionales. Sin etiquetas. Sin validación. Si intercambias dos valores, nada te advierte.

Un Ejemplo Limpio del Patrón Builder en JavaScript

Aquí hay una implementación basada en clases utilizando una API fluida en JavaScript—donde cada setter retorna this, habilitando el encadenamiento de métodos:

class ApiRequestBuilder {
  constructor() {
    this.method = 'GET'        // sensible default
    this.url = null
    this.body = null
    this.timeout = 3000        // default timeout
    this.responseType = 'json'
  }

  setMethod(method) {
    this.method = method
    return this
  }

  setUrl(url) {
    this.url = url
    return this
  }

  setBody(body) {
    this.body = body
    return this
  }

  setTimeout(ms) {
    this.timeout = ms
    return this
  }

  build() {
    if (!this.url) {
      throw new Error('URL is required')
    }
    // Return a plain, frozen object—not the builder itself
    return Object.freeze({
      method: this.method,
      url: this.url,
      body: this.body,
      timeout: this.timeout,
      responseType: this.responseType,
    })
  }
}

// Usage
const request = new ApiRequestBuilder()
  .setUrl('/api/users')
  .setMethod('POST')
  .setBody({ name: 'Alice' })
  .build()

Cada llamada es autodocumentada. La validación se ejecuta en build() antes de que el objeto sea utilizado. Los valores predeterminados se aplican automáticamente. Observa que build() retorna un objeto plano congelado—no el builder—lo que mantiene el resultado limpio y previene mutaciones accidentales.

Builder vs. Alternativas Más Simples

Una función factory con parámetros nombrados como createRequest({ url, method = 'GET' }) maneja muchos casos de forma limpia. Recurre a un builder cuando la lógica de validación o la secuenciación hagan que esa función sea difícil de razonar.

Una Nota sobre TypeScript

TypeScript puede hacer que los builders sean significativamente más seguros. Puedes forzar que build() solo sea invocable después de que los setters requeridos hayan sido llamados, utilizando tipos condicionales o una interfaz step-builder. Si tu proyecto usa TypeScript, vale la pena explorarlo—pero el patrón JavaScript básico funciona bien sin él.

Conclusión

Utiliza el Patrón Builder cuando la creación de objetos tenga reglas que necesiten ser aplicadas, no solo como estrategia predeterminada de creación de objetos. La API fluida hace que el sitio de llamada sea legible, el paso build() hace que la validación sea explícita, y los valores predeterminados reducen el ruido. Para todo lo más simple, una función factory o un objeto literal plano es la herramienta correcta.

Preguntas Frecuentes

Truly understand users experience

See every user interaction, feel every frustration and track all hesitations with OpenReplay — the open-source digital experience platform. It can be self-hosted in minutes, giving you complete control over your customer data. . Check our GitHub repo and join the thousands of developers in our community..