Clases en TypeScript: quién accede a cada miembro

Clases en TypeScript

Clases en TypeScript: modificadores, readonly, abstract, implements | We.Inc

Campos, constructores, parameter properties, public, protected, private y #private, readonly, abstract e implements. Comprueba quién llega a cada miembro en una matriz en vivo.

Una clase de TypeScript es una clase de JavaScript con campos tipados y reglas de acceso. Los miembros public son accesibles desde cualquier sitio, los protected dentro de la clase y sus subclases, y los private solo dentro de la clase. Esas tres comprobaciones existen solo en tiempo de compilación. Un campo #name es privado también en el JavaScript que se ejecuta, y readonly bloquea las escrituras después del constructor.

Palabras clave de clase y lo que hacen

  • Palabra clave
  • Efecto
  • Se comprueba en
  • Accesible desde cualquier sitio (el valor por defecto)
  • Tiempo de compilación
  • Solo la clase y sus subclases
  • Tiempo de compilación
  • Solo la clase que lo declara
  • Tiempo de compilación
  • Solo la clase que lo declara, impuesto por JavaScript
  • Tiempo de compilación y de ejecución
  • Se asigna solo en la declaración o en el constructor
  • Tiempo de compilación
  • Sin instancias; las subclases deben completar los miembros
  • Tiempo de compilación
  • Comprueba que la clase cumple una interfaz
  • Tiempo de compilación
  • Marca un método que reemplaza a un método de la base
  • Tiempo de compilación

Elige un modificador y la matriz muestra cinco formas en que el código podría llegar a ese miembro, con el resultado de tsc para cada una. La fila de corchetes es la que sorprende: los modificadores de tiempo de compilación se pueden esquivar con una clave de texto, mientras que un campo # no.

  • Elige un modificador: public, protected, private, #private o readonly.
  • Lee la matriz: cada fila es un lugar desde el que se usa el miembro, con Compila o el error de tsc.
  • Mira la clase de arriba para ver exactamente las declaraciones que se prueban.
  • Copia la clase para probar más casos en tu propio editor.
  • Usa campos # para todo lo que deba quedar oculto al resto del código en tiempo de ejecución, como un token que guarda un objeto cliente.
  • Activa noImplicitOverride para que, al renombrar un método de la base, falle cada método de subclase que dejó de sobrescribirlo sin avisar.
  • Mantén strictPropertyInitialization activado. Si un framework asigna un campo después de la construcción, márcalo con name!: string en lugar de desactivar la comprobación.
  • Prefiere un objeto simple y una interfaz antes que una clase cuando no hay comportamiento ni estado privado; es menos código y se serializa sin problemas.

Preguntas frecuentes

¿Qué diferencia hay entre private y #private?

private es una comprobación de TypeScript. Desaparece de la salida, y obj["secret"] sigue compilando y lee el valor. Un campo #secret es un campo privado de JavaScript: no hay ninguna clave de texto que llegue a él, y el código de fuera de la clase no puede leerlo en tiempo de ejecución.

¿Qué son las parameter properties?

Un atajo que declara y asigna un campo a partir de un parámetro del constructor. Escribir constructor(private readonly id: string) {} crea un campo id private readonly sin necesidad de cuerpo. El prefijo puede ser public, protected, private o readonly.

¿implements cambia los tipos dentro de mi clase?

No. implements solo comprueba que la clase terminada encaja con la interfaz. Los parámetros de los métodos siguen necesitando sus propias anotaciones; si omites una en modo strict, obtienes un error de any implícito, aunque la interfaz ya indique su tipo.

¿Por qué TypeScript dice que una propiedad no tiene inicializador?

strictPropertyInitialization, que strict activa, exige que cada campo declarado tenga valor en la declaración o en el constructor. Dale un valor, hazlo opcional o añade ! después del nombre si otra cosa lo asigna antes de usarlo.

¿Cuándo debo usar una clase abstracta en lugar de una interfaz?

Usa una clase abstracta cuando las subclases deban compartir código real, como un método que invoca un hook abstracto. Una interfaz no lleva código y una clase puede implementar varias, así que sirve para describir formas.

Campos, constructores y parameter properties

  • Una declaración de campo como count = 0 o name: string le dice al compilador qué contiene la instancia. En modo strict cada campo necesita un valor al terminar el constructor, lo que detecta el error clásico de un campo que vale undefined la primera vez que se usa.
  • Las parameter properties reducen a una sola línea el baile de declarar y luego asignar. Son prácticas para servicios que reciben sus dependencias por el constructor, aunque algunos equipos las evitan porque generan código de asignación real en lugar de sintaxis puramente de tipos.

Privacidad en compilación frente a privacidad en ejecución

  • public, protected y private se eliminan cuando TypeScript genera JavaScript. Impiden que tus compañeros usen mal un miembro en código tipado, pero cualquier cosa que ejecute la salida, incluida una sesión de consola, puede seguir leyendo la propiedad.
  • Los campos privados de JavaScript con el prefijo # forman parte del lenguaje. El motor rechaza el acceso desde fuera del cuerpo de la clase, no aparecen en Object.keys y las subclases tampoco pueden verlos.

Clases e interfaces trabajan juntas

  • Una interfaz describe una forma; una clase produce objetos que la tienen. Una clase puede implementar varias interfaces, y cualquier objeto con los miembros correctos cumple la interfaz, haya o no una clase de por medio, porque TypeScript compara formas y no nombres.
  • La guía de interfaces de este sitio explica cómo declarar y extender esas formas. Esta página trata del lado de la clase: construcción, acceso y herencia.

Patrones de clase en la práctica

Parameter properties y un campo #

El constructor declara dos campos en su lista de parámetros. La caché es un campo #, así que nada fuera de la clase puede leerla ni vaciarla.

Una base abstracta con un override

describe es código compartido; area es el hook que cada figura debe aportar. Con noImplicitOverride activado, la palabra override es obligatoria en area dentro de Circle.

implements comprueba, no infiere

La interfaz asegura que la clase tiene send con la forma correcta, pero el parámetro sigue necesitando su propia anotación de tipo.

Sin restricciones. Omitir el modificador significa lo mismo.

Dentro de los métodos de Account

Dentro de un método de Savings

Desde fuera, con un punto

Desde fuera, con una clave de texto

Desde fuera, asignando un valor nuevo

Abierto a la clase y a sus subclases. Una clave de texto sigue saltándose la comprobación, porque es solo una regla de tipos.

Dentro de los métodos de Account

Dentro de un método de Savings

Desde fuera, con un punto

Desde fuera, con una clave de texto

Desde fuera, asignando un valor nuevo

Cerrado incluso para las subclases, pero solo durante la comprobación de tipos. La forma con corchetes compila y el valor se puede leer en tiempo de ejecución.

Dentro de los métodos de Account

Dentro de un método de Savings

Desde fuera, con un punto

Desde fuera, con una clave de texto

Desde fuera, asignando un valor nuevo

Un campo privado de JavaScript. Ninguna clave de texto lo nombra, así que todas las rutas externas fallan, y el motor impone la misma regla en tiempo de ejecución.

Dentro de los métodos de Account

Dentro de un método de Savings

Desde fuera, con un punto

Desde fuera, con una clave de texto

Desde fuera, asignando un valor nuevo

Cualquiera puede leerlo; nadie puede asignarlo después de la construcción, ni siquiera los propios métodos de la clase.

Dentro de los métodos de Account

Dentro de un método de Savings

Desde fuera, con un punto

Desde fuera, con una clave de texto

Desde fuera, asignando un valor nuevo

Matriz de acceso a miembros

Elige un modificador

Acceso a un miembro {v}

Usado desde

Código

Resultado de tsc

Compila

Crea tu sitio gratis · Gratis para crear, sin tarjeta

Relacionado: Guías

Producto

Para quién es

Funciones

Recursos

Empresa

Mapa del sitio