Business
Jobs
  • About Us
  • Solutions
    • Job Postings
      Post your job and receive qualified candidates in 48h.
    • Candidate Assessments
      500+ technical and psychological tests, plus anti-fraud.
    • Headhunting
      Tailor-made executive search from start to finish.
    • Payroll + EOR
      Payroll dispersal and EOR across 15+ LATAM countries.
  • Pricing
  • Jobs

0

194
Views
¿Cómo heredar tipos de métodos de la clase principal con JsDoc?

Me gustaría poder escribir JsDoc para un método abstracto en la clase principal, de modo que se aplique a todos sus herederos.

Este ejemplo es una versión extremadamente simplificada de mi caso:

 class Shape { /** Does some complicated example stuff. * @param {number} myNumber a real value. * @param {boolean} myBoolean a flag. * @param {string} myString some text. * @returns {string} something important. */ doStuff(myNumber, myBoolean, myString) {} }

El método doStuff no está implementado porque cada una de las (muchas) subclases lo implementa de manera diferente, pero con la misma firma y los mismos parámetros.

 class Triangle extends Shape { doStuff(myNumber, myBoolean, myString) { return myBoolean ? myNumber.toString() : myString; } }

Como puede ver en la captura de pantalla, las partes de texto de la documentación se heredan, pero los tipos de parámetros y el tipo de devolución se pierden. ¿Qué puedo hacer para heredar correctamente los tipos también? Intenté jugar con las @inheritdoc , @abstract , @extends , @override y @link pero sin éxito.

VScode no transfiere tipos

Tenga en cuenta que esta es una versión extremadamente simplificada, en mi código real, el bloque de documentación tiene más de 20 líneas y copiarlo en un número cada vez mayor de subclases no es factible, ya que sería una pesadilla mantenerlo.

about 4 years ago · Juan Pablo Isaza
2 answers
Answer question

0

No creo que esto sea posible, ya que es una deficiencia de JSDoc.

De todos modos, es discutible que los tipos de parámetros deben tomarse de la función de clase base respectiva.

about 4 years ago · Juan Pablo Isaza Report

0

¿Qué tal si envuelves tu método doStuff() dentro de su propio @typedef ?

https://jsdoc.app/tags-typedef.html

 /** * @typedef doStuff * @type {Function} * @param {Number} myNumber * @param {Boolean} myBoolean * @param {String} myString * @returns {String} */

Y luego úsalo en extends :

 class Triangle extends Shape { /** @type {doStuff} */ doStuff(){} }
about 4 years ago · Juan Pablo Isaza Report
Answer question
Find remote jobs

Discover the new way to find a job!

Top jobs
Top job categories
Business
Post vacancy Pricing Sales
Legal
Terms and conditions Privacy policy
© 2026 PeakU Inc. All Rights Reserved.
Andres GPT
Show me some job opportunities
There's an error!