JavaScript Compiler Hint Notation Specifications (Draft)

These specs are in draft and looking for review/feedback. 👉 Motivations & Discussions.

This repository contains the community specifications commonly used JavaScript compiler hint notations, including:

• #__PURE__ Notation Specification
• #__NO_SIDE_EFFECTS__ Notation Specification

Motivation

JavaScript bundlers and minifiers often rely on compiler hint notations to optimize code. However, there is no clear specification for these notations, and the syntax and semantics of these notations vary across different tools. This makes it difficult for developers to understand and use these notations properly. This repository aims to provide a clear and concise specification for them and to help developers understand and use these notations properly.

Compatibility

This repo also maintains compatibility tables for these notations.

• #__PURE__ Notation Compatibility Table
• #__NO_SIDE_EFFECTS__ Notation Compatibility Table

Test Cases

Spec-level conformance test cases for each notation. Each case documents the code under test and the expected detected range.

• #__PURE__ Test Cases
• #__NO_SIDE_EFFECTS__ Test Cases