Obviamente, depende de los desarrolladores saber cuándo desaprobar y cuándo eliminar, pero me pregunto cómoadvertir ¿Los desarrolladores que una función de javascript ha sido desaprobado?

Algunos idiomas populares (Java, DO#, Pitón) Soporta la desaprobación de nivel de idioma de alguna forma.

Sin embargo, para Javascript, no puedo encontrar ninguna manera estándar en que los desarrolladores puedan indicar que una función ha sido desaprobada (en código). Lo mejor que puedo hacer es seguir (un gran número de) notas de la versión.

Como ejemplo, grepping la fuente completa de jQuery 1.8 muestra un mínimo de comentarios en línea:

# curl http://code.jquery.com/jquery-1.8.0.js | grep -i depre
// jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode
// *** attrChange attrName relatedNode srcElement  are not normalized, non-W3C, deprecated, will be removed in 1.8 ***
// Some plugins are using, but it's undocumented/deprecated and will be removed.
// Deprecated
// Limit scope pollution from any deprecated API
// Deprecated, use jQuery.browser.webkit instead

W3C y MDN no parecen tener una forma estándar o proporcionan sugerencias sobre cómo manejar esto.

Lo mejor que he encontrado es JSDoc's@deprecated etiqueta.

Alguien sabe si javascripthace ¿Tengo una anotación de desaprobación que he pasado por alto? ¿Hay formas mejores o más comunes de hacer esto?