Una clase base puede cambiar save() por persist() y dejar una subclase con un método save() que ya no sobrescribe nada. TypeScript todavía puede compilar ese código porque la subclase simplemente adquirió su propio método con un nombre que el contrato de la clase base ya no utiliza.
noImplicitOverride cierra esa brecha. Cuando una subclase reemplaza realmente un miembro heredado, debe escribir override. Si se renombra el método de la clase base, el compilador señala la discrepancia en vez de dejar que una sobrescritura silenciosa pase la revisión.
Este artículo explica el mecanismo, muestra la diferencia entre override y un método local y propone una migración breve con tsc --noEmit. Comprobé la fixture local con TypeScript 5.9.3 el 16 de noviembre de 2026. Demuestra el diagnóstico del compilador en un ejemplo mínimo, no el resultado de una migración en producción.
Respuesta breve
- Activa
noImplicitOverridecuando la intención de reemplazar métodos debe aparecer en el código.- Usa
overrideen cada miembro que realmente reemplace a un miembro de la clase base.- Si un método deja de sobrescribir después de un renombrado, corrige el contrato o cambia el nombre del helper. No uses
as anypara ocultar el diagnóstico.- La opción comprueba la relación entre clases. No demuestra que la jerarquía sea el diseño correcto para el dominio.
¿Qué comprueba noImplicitOverride?
TypeScript comprueba que un miembro marcado con override existe en la clase base y que la declaración puede reemplazarlo. Con noImplicitOverride: true, también exige la palabra clave cuando una subclase ya está sobrescribiendo un miembro heredado.
La referencia oficial de noImplicitOverride usa una clase Album y muestra el error cuando una subclase redefine un método sin el modificador. Las notas de TypeScript 4.3 explican el problema relacionado: después de renombrar un método en la clase base, una subclase puede conservar el nombre anterior sin que el compilador sepa que debía ser una sobrescritura.
La parte importante es la intención. El compilador no dice que todas las clases deban usar herencia. Pide que declares un reemplazo como reemplazo.
¿Por qué un renombrado puede pasar sin la opción?
Considera esta jerarquía:
class Repository {
save(value: string): string {
return value;
}
}
class AuditedRepository extends Repository {
save(value: string): string {
return `audit:${super.save(value)}`;
}
}
El segundo save sobrescribe al primero. Ahora la clase base cambia por una decisión de nomenclatura:
class Repository {
persist(value: string): string {
return value;
}
}
class AuditedRepository extends Repository {
save(value: string): string {
return `audit:${value}`;
}
}
El método de la subclase sigue siendo TypeScript válido. El problema semántico es que las llamadas hechas mediante una referencia Repository ahora usan persist, mientras que la lógica de auditoría quedó en un método que el contrato base no conoce. El nombre anterior ya no conserva la relación que existía.
Con override, la intención queda unida al contrato:
class AuditedRepository extends Repository {
override save(value: string): string {
return `audit:${super.save(value)}`;
}
}
Después de que Repository.save se convierta en Repository.persist, el compilador informa que el miembro no existe en la clase base. El error obliga a elegir entre override persist, un método local con otro nombre o un cambio más amplio en la interfaz.
¿Cómo activas la comprobación en tsconfig.json?
Añade la opción a la configuración que compila la jerarquía:
{
"compilerOptions": {
"strict": true,
"noImplicitOverride": true,
"noEmit": true
}
}
La opción no forma parte de los ajustes que activa strict. Por eso, un proyecto puede usar strict: true y todavía aceptar una sobrescritura sin el modificador override. La referencia de TSConfig es la fuente del comportamiento de la opción, mientras que el comando del proyecto determina qué configuración usa realmente el CI.
Si el repositorio tiene varios paquetes, separa esta decisión del orden de compilación. Project References en TypeScript organizan el grafo de proyectos; noImplicitOverride comprueba la intención dentro de cada clase. Son problemas de build relacionados, pero no son el mismo contrato.
¿Cuándo debes usar override o cambiar el nombre?
Usa override cuando el miembro tiene el mismo papel que el contrato heredado. El método puede llamar a super, cambiar la implementación o añadir una política, pero la relación con la clase base debe ser real.
class JsonRepository extends Repository {
override save(value: string): string {
return JSON.stringify({ value: super.save(value) });
}
}
No uses override en un helper que solo tiene un nombre parecido por casualidad. Si la clase base tiene save() y la subclase necesita saveForAuditLog(), dos nombres distintos comunican mejor el límite. Si ambos métodos tienen el mismo nombre, la opción puede revelar una relación de herencia que ya era difícil de entender.
Este límite importa: el modificador demuestra una relación nominal con la clase base, no la calidad del diseño. Una clase todavía puede sobrescribir un método con efectos incompatibles, llamar a super en un orden peligroso o depender de una precondición no documentada. Esos problemas necesitan pruebas y revisión del contrato.
¿Cómo migras una jerarquía sin borrar la señal?
Trata la activación como un cambio pequeño en el contrato del compilador:
- Ejecuta el typecheck que usa el CI y registra la configuración efectiva.
- Activa
noImplicitOverrideen un paquete o proyecto con un límite claro. - Para cada diagnóstico, confirma si el miembro debe reemplazar a un miembro de la clase base.
- Añade
overridecuando la relación sea intencional. - Cambia el nombre del método o el contrato cuando la relación ya no exista.
- Ejecuta pruebas que hagan llamadas mediante la clase base, no solo mediante la subclase concreta.
- Mantén la opción en el CI para que un renombrado futuro produzca un error en el mismo conjunto de cambios.
Una fixture mínima para comprobar el comportamiento local es:
class Repository {
save(value: string): string {
return value;
}
}
class AuditedRepository extends Repository {
override save(value: string): string {
return `audit:${super.save(value)}`;
}
formatLabel(value: string): string {
return value.trim();
}
}
const repository = new AuditedRepository();
console.log(repository.save("ready"));
console.log(repository.formatLabel(" label "));
Guarda el fragmento en un proyecto aislado, usa strict, noImplicitOverride, noEmit y types: [], y ejecuta npx -p typescript@5.9.3 tsc -p tsconfig.json --pretty false. La fixture pasa. Si renombras save en la clase base sin actualizar la subclase, el modificador override produce TS4113. Esto comprueba el límite de la configuración, pero no sustituye las pruebas del paquete real. Cuando el cambio también modifica la ruta de error de un servicio, Result o excepciones en un servicio TypeScript cubre esa decisión aparte.
¿Qué no soluciona el problema?
Algunos atajos dejan el build en verde sin conservar la intención:
- quitar
overridede todos los métodos y eliminar la relación que documenta la opción; - usar
as any,as unknown asu otra aserción para hacer que un miembro parezca compatible; - desactivar
noImplicitOverrideen todo el paquete porque un diagnóstico exige tomar una decisión; - añadir
overridesin comprobar que la clase base todavía ofrece el comportamiento que necesita la subclase.
Una aserción puede tener sentido en un límite que el compilador no puede demostrar, pero no responde a un renombrado que el código fuente sí puede corregir. satisfies para configuraciones de TypeScript cubre una decisión relacionada para valores escritos en el código: comprobar un contrato no equivale a pedirle al compilador que confíe a ciegas.
Si un agente de código cambia una clase base y sus subclases en la misma tarea, incluye en la revisión la pregunta “¿cambió el contrato o solo la implementación?”. La validación de tool calls en TypeScript muestra un límite complementario: el tipo estático no valida por sí solo una entrada que llegó en runtime. RemoteCode es la herramienta del autor para este tipo de flujo, pero la compilación y las pruebas siguen siendo la prueba del repositorio.
Preguntas frecuentes
¿noImplicitOverride exige override en toda clase hija?
No. Exige el modificador en miembros que realmente sobrescriben miembros heredados. Un método nuevo cuyo nombre no existe en la clase base no necesita override.
¿override se aplica al implementar una interfaz?
El modificador describe un reemplazo en una clase base. Implementar una interfaz es otra relación de tipos y no debe tratarse como sobrescribir una implementación. Si la clase también extiende una clase base, analiza las dos relaciones por separado.
¿Añadir override cambia el JavaScript que se ejecuta?
No por sí solo. El modificador participa en la comprobación de TypeScript y no es una política de runtime. El comportamiento todavía depende de la cadena de prototipos, del método que se llama y de las pruebas que cubren esa llamada.
Fuentes y límites
- TypeScript, “TSConfig Option: noImplicitOverride”, consultado el 16 de noviembre de 2026.
- TypeScript, “TypeScript 4.3 release notes”, consultado el 16 de noviembre de 2026.
- TypeScript Playground, “No Implicit Class Overrides”, consultado el 16 de noviembre de 2026.
Samuel Fajreldines es responsable de este artículo. La investigación comparó referencias oficiales de TypeScript con una configuración pública de un proyecto activo. La fixture local pasó con TypeScript 5.9.3 y falló con TS4113 después de un renombrado deliberado de la clase base. Esto demuestra el mecanismo en un caso mínimo, no la seguridad de una jerarquía de producción. La asistencia de IA ayudó con la investigación, la redacción, la localización y la revisión; no ejecutó la fixture ni sustituyó las fuentes o la responsabilidad editorial del autor.