Function Call

Documentation Index

Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt

Use this file to discover all available pages before exploring further.

​

The Grouping Operator

( Expression )

• Precedence: It possesses the highest operator precedence, dictated by ECMAScript grammar productions (specifically as a PrimaryExpression), ensuring the enclosed expression is evaluated before adjacent operations.
• Reference Preservation: Crucially, the grouping operator preserves the internal ECMAScript Reference type of the evaluated expression. It does not perform the internal GetValue() operation on the reference unless required by the surrounding context. This mechanic allows grouped expressions to remain valid on the left-hand side of an assignment and ensures that the this binding is preserved during method invocation.

let x;
(x) = 5; // Valid assignment because (x) preserves the Reference type.

const obj = {
    val: 10,
    method() { return this.val; }
};

(obj.method)(); 
// Returns 10. The Reference is preserved, so `this` remains bound to `obj`.

(0, obj.method)(); 
// The comma operator evaluates to a value, destroying the Reference. `this` binding is lost.
// In non-strict mode, `this` defaults to the global object (returning undefined if global.val is undefined).
// In strict mode, `this` is undefined, throwing a TypeError: Cannot read properties of undefined.

• Evaluation: It evaluates the Expression and strictly returns the result of that evaluation. It does not change the type or value of the evaluated expression.
• Constraint: The grouping operator must contain an expression. An empty grouping operator () results in a SyntaxError.
• Expression Forcing: When placed at the beginning of a statement, it forces the parser to interpret the contents as an expression rather than a declaration (e.g., preventing the function keyword from being parsed as a function declaration).

​

The Function Call (Invocation) Operator

MemberExpression ( ArgumentList_opt )
CallExpression ( ArgumentList_opt )

• Reference Evaluation: The engine first evaluates the MemberExpression or CallExpression to resolve the reference to the target function.
• Argument Resolution: The ArgumentList (which is optional and can be empty) is evaluated strictly from left to right. Each argument expression is fully resolved before the next is evaluated. According to the ECMAScript EvaluateCall algorithm, this step occurs before the engine verifies if the target reference is actually callable.
• Callable Check: After the arguments are fully evaluated, the engine performs the internal IsCallable check on the resolved function reference. If the reference does not resolve to a function object, the engine throws a TypeError.

// The argument is fully evaluated (logging "evaluated" to the console) 
// BEFORE the IsCallable check occurs and throws a TypeError for `null`.
null(console.log('evaluated')); 

• Execution Context: Once the function reference is validated and arguments are resolved, the engine suspends the current execution context, pushes a new execution context onto the call stack, and transfers control to the function’s block. For standard functions, the engine binds the this keyword based on the invocation context. For arrow functions, this is not bound upon invocation; instead, it is inherited lexically from the defining scope.
• Return Value: The operator evaluates to the value yielded by the function. This value can be explicitly provided by a return statement or implicitly returned (e.g., via concise arrow functions). If a standard synchronous function completes without returning a value, the operator evaluates to undefined. However, if the invoked function is an async function, the operator evaluates to a Promise; if it is a generator function, it evaluates to a Generator object, regardless of whether a return statement is present.