Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8046038

JEP 203: Nashorn: Lexically-Scoped Variable & Constant Declarations



    • Hannes Wallnoefer
    • Feature
    • Open
    • JDK
    • nashorn dash dev at openjdk dot java dot net
    • M
    • S
    • Dev and SQE completed, no Perf needed.
    • 203



      Implement the lexically-scoped variable (let) and constant (const) declarations of the forthcoming ECMAScript 6 specification.


      • Provide support for the let and const keywords.

      • Implement lexical scope for variables and constants declared via let and const as well as function declarations as required by ECMAScript&nbsp6.

      • Make these features compatible with other JavaScript engines.


      This JEP is limited to the features listed above; it does not include any of the other new features of ECMAScript 6.


      The upcoming version 6 of the ECMAScript standard, code-named "Harmony", will be the first to support block scope for variable, constant, and function declarations. Previous versions of ECMAScript (including version 5, implemented by Nashorn) only provide the var keyword for variable declarations, which always uses the containing function body or program as scope, and does not allow the declaration of constants. ECMAScript 6 introduces two new keywords let and const to define variables and constants only within their lexical scope.

      Lack of lexical scoping is widely recognized as one of the major flaws in current JavaScript. Therefore, support for let and const and lexical scoping ranks very high on the list of ECMAScript 6 features implemented by other JavaScript engines.

      This feature has already been implemented in the V8 and Mozilla Spidermonkey JavaScript engines, and it is used by some Node.js modules. Therefore it has been requested by the Avatar.js team, among others.


      Up to version 5 of the ECMAScript standard, JavaScript only provides the var keyword to declare variables. One major problem with var is that variables are always scoped to the entire body of the containing function. For example, in the following code the variable a is defined everywhere in the function:

      function f(x){
          if (x) {
              var a = 42;
          // "a" is defined here

      This can be very problematic if some of the code is meant to access a variable with the same name defined outside the function:

      var a = 2;
      function f(x) {
          // "a" is undefined here
          if (x) {
              var a = 42;
          // "a" is 42 or undefined, depending on "x"

      Using the let keyword introduced in ECMAScript 6 allows us to limit the declaration of a to its containing block:

      let a = 2;
      function f(x) {
          // "a" is 2 here
          if (x) {
              let a = 42;
          // "a" is still 2

      The second problem with var is its inability to define constants except for the very verbose Object.defineProperty method:

      // Only way to define a constant in ECMAScript 5
      Object.defineProperty(this, "CONSTANT", { writable: false, configurable: false, value 42 });

      ECMAScript 6 significantly improves this by introducing the const keyword:

      const CONSTANT = 42;

      Like let, constants declared by const are limited to their containing lexical scope.


      So far the official ECMAScript test suite, test262, does not cover ECMAScript version 6. We will have to come up with our own tests and see what is available on the net.

      Risks and Assumptions

      ECMAScript 6 ("Harmony") has not been finalized, so it's possible that there may be changes until the final standard is released. However, the current draft is pretty much frozen and any remaining changes are expected to be small or concerning corner cases.


        Issue Links



              mtrudeau Michel Trudeau
              hannesw Hannes Wallnoefer
              Hannes Wallnoefer Hannes Wallnoefer
              Brian Goetz, Jim Laskey
              Brian Goetz
              0 Vote for this issue
              9 Start watching this issue