Add an @pure annotation · google/closure-compiler#2395

(5 评论) (0 反应) (0 负责人)Java (7,176 star) (1,197 fork)batch import

feathelp wanted

描述

I'd like to have an annotation to declare an intent that a function will not have side effects. In the presence of this annotation, I'd like the compiler to warn me if the function has side effects.

In a lot of code, you have simple helper methods that are intended to be side-effect free. It's very easy for a side effect to be accidentally introduced at a later time. I'd like to have a warning issued for this so the developer can correct it.

贡献者指南

技术栈: javajavascript
领域: toolingdeveloper experience
议题类型: feature
难度: 4
预计时间: over 1 week
活动状态: stale
清晰度: mostly clear
前置要求: JavaScriptJavaClosure Compiler internalsside effect analysis
新手友好度: 25
研究方向: Review the Closure Compiler's existing annotation system (e.g., @const, @param) and the side effect analysis pass (likely in the 'JSDocInfoParser' and 'CheckSideEffects' classes). Examine the 5 comments on the issue for any maintainer suggestions or prior attempts. Propose a concrete syntax for @pure and define what constitutes a side effect in the JavaScript context. Implement the annotation parsing and integrate with the warning system.