Saltar al contenido
Clases

Decorators

Lección 5 de 59 min4 ejercicios

Si trabajas con Angular, NestJS o algunas librerías de TypeScript, ya viste líneas como @Component o @Injectable encima de una clase. Son decorators: funciones que modifican clases y métodos de forma declarativa. Todavía no son parte del estándar, pero conviene entender qué hacen y en qué estado están.

La idea

Un decorator es una función que se aplica a una clase o a uno de sus miembros con @nombre. Recibe lo que decora y puede devolver un reemplazo:

class Pedido {
  @registrar
  confirmar(id) {
    return `pedido ${id} confirmado`;
  }
}

Es una forma declarativa de escribir algo que ya sabes hacer: envolver una función con otra, como en Funciones como valores. Sin la sintaxis nueva, sería:

function registrar(metodo) {
  return function (...args) {
    console.log(`llamando con ${args.join(", ")}`);
    return metodo.apply(this, args);
  };
}

class Pedido {
  confirmar(id) {
    return `pedido ${id} confirmado`;
  }
}

Pedido.prototype.confirmar = registrar(Pedido.prototype.confirmar);
console.log(new Pedido().confirmar(7));

Cómo se escribe uno

En la propuesta actual, un decorator recibe dos argumentos: el valor decorado (el método, la clase, el campo…) y un objeto contexto con información sobre él:

function soloLectura(valor, contexto) {
  // contexto.kind: "method", "field", "class", "getter", "setter", "accessor"
  // contexto.name: el nombre del miembro
  if (contexto.kind === "field") {
    return function (inicial) {
      return Object.freeze(inicial);
    };
  }
}

class Ajustes {
  @soloLectura
  colores = { fondo: "negro" };
}

Para un método, devolver una función la reemplaza; para un campo, devolver una función transforma su valor inicial. Si no devuelve nada, el miembro queda como estaba.

La propuesta también agrega accessor, una palabra clave para crear un getter y un setter automáticos que los decorators pueden interceptar:

class Formulario {
  @validarEmail
  accessor email = "";
}

Dos versiones: la antigua y la de la propuesta

Los frameworks que usan decorators desde hace años (Angular, NestJS, TypeORM) nacieron con una versión antigua, que TypeScript activa con experimentalDecorators: true. Tiene otra firma: recibe el prototipo, el nombre y un descriptor de la propiedad.

Desde TypeScript 5.0, sin esa opción, se usan los decorators de la propuesta actual, los de esta lección. Si empiezas un proyecto nuevo, usa estos. Si trabajas con un framework que pide la versión antigua, sigue su documentación.

Resumen

  • Un decorator es una función aplicada con @nombre a una clase o a sus miembros.
  • Recibe el valor decorado y un contexto (kind, name…), y puede devolver un reemplazo.
  • Está en Stage 2.7: hoy se usa con TypeScript o Babel.
  • experimentalDecorators de TypeScript es la versión antigua; la de la propuesta es la recomendada para proyectos nuevos.
  • Sin herramientas, consigues lo mismo envolviendo el método con una función de orden superior.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Funciones que envuelven clases

Elige una respuesta en cada pregunta.

  1. ¿Qué es un decorator?

  2. ¿En qué estado están los decorators en JavaScript?

  3. Los decorators de experimentalDecorators de TypeScript, ¿son iguales a los de la propuesta?

  4. Sin decorators, ¿cómo consigues lo mismo hoy?

Ordena la salida: Un método envuelto

Imagina este código compilado con TypeScript. Ordena lo que aparecería en la consola al ejecutarlo.

function registrar(metodo, contexto) {  return function (...args) {    console.log(`→ ${contexto.name}(${args.join(", ")})`);    const resultado = metodo.apply(this, args);    console.log(`← ${resultado}`);    return resultado;  };} class Calculadora {  @registrar  sumar(a, b) {    return a + b;  }} console.log("total:", new Calculadora().sumar(2, 3));

Consola, de arriba abajo

  1. total: 5
  2. → sumar(2, 3)
  3. ← 5

Detective: Un decorator en el navegador

Este archivo funciona en un proyecto con TypeScript, pero alguien lo abrió directamente en el navegador. Encuentra la línea y elige el arreglo que funciona hoy, sin herramientas.

Consola

servicio.js:6
  @registrar
  ^

SyntaxError: Invalid or unexpected token

Paso 1: toca la línea de código que causa el error.

Laboratorio: Un decorator sin @

Escribe registrar(fn): un decorator “a mano” que envuelve una función para imprimir sus argumentos.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Imprime llamada con: 2, 3 y después 5 (pendiente)
  • Devuelve el resultado de cualquier función envuelta (pendiente)
  • No ejecuta fn hasta que se llama a la función envuelta (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.