ECMAScript® 2021 Language Specification

Draft ECMA-262 / February 25, 2021

14.11 The with Statement

Syntax

WithStatement[Yield, Await, Return] : with ( Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] Note

The with statement adds an object Environment Record for a computed object to the lexical environment of the running execution context. It then executes a statement using this augmented lexical environment. Finally, it restores the original lexical environment.

14.11.1 Static Semantics: Early Errors

WithStatement : with ( Expression ) Statement Note

It is only necessary to apply the second rule if the extension specified in B.3.2 is implemented.

14.11.2 Runtime Semantics: Evaluation

WithStatement : with ( Expression ) Statement
  1. Let val be the result of evaluating Expression.
  2. Let obj be ? ToObject(? GetValue(val)).
  3. Let oldEnv be the running execution context's LexicalEnvironment.
  4. Let newEnv be NewObjectEnvironment(obj, oldEnv).
  5. Set the withEnvironment flag of newEnv to true.
  6. Set the running execution context's LexicalEnvironment to newEnv.
  7. Let C be the result of evaluating Statement.
  8. Set the running execution context's LexicalEnvironment to oldEnv.
  9. Return Completion(UpdateEmpty(C, undefined)).
 Note

No matter how control leaves the embedded Statement, whether normally or by some form of abrupt completion or exception, the LexicalEnvironment is always restored to its former state.