ECMAScript® 2021 Language Specification

ECMAScript® 2021 Language Specification
Pins
Table of Contents
Introduction
Scope
Conformance
2.1
Example Clause Heading
Normative References
Overview
4.1
Web Scripting
4.2
Hosts and Implementations
4.3
ECMAScript Overview
4.3.1
Objects
4.3.2
The Strict Variant of ECMAScript
4.4
Terms and Definitions
4.4.1
implementation-approximated
4.4.2
implementation-defined
4.4.3
host-defined
4.4.4
type
4.4.5
primitive value
4.4.6
object
4.4.7
constructor
4.4.8
prototype
4.4.9
ordinary object
4.4.10
exotic object
4.4.11
standard object
4.4.12
built-in object
4.4.13
undefined value
4.4.14
Undefined type
4.4.15
null value
4.4.16
Null type
4.4.17
Boolean value
4.4.18
Boolean type
4.4.19
Boolean object
4.4.20
String value
4.4.21
String type
4.4.22
String object
4.4.23
Number value
4.4.24
Number type
4.4.25
Number object
4.4.26
Infinity
4.4.27
NaN
4.4.28
BigInt value
4.4.29
BigInt type
4.4.30
BigInt object
4.4.31
Symbol value
4.4.32
Symbol type
4.4.33
Symbol object
4.4.34
function
4.4.35
built-in function
4.4.36
property
4.4.37
method
4.4.38
built-in method
4.4.39
attribute
4.4.40
own property
4.4.41
inherited property
4.5
Organization of This Specification
Notational Conventions
5.1
Syntactic and Lexical Grammars
5.1.1
Context-Free Grammars
5.1.2
The Lexical and RegExp Grammars
5.1.3
The Numeric String Grammar
5.1.4
The Syntactic Grammar
5.1.5
Grammar Notation
5.2
Algorithm Conventions
5.2.1
Abstract Operations
5.2.2
Syntax-Directed Operations
5.2.3
Runtime Semantics
5.2.3.1
Implicit Completion Values
5.2.3.2
Throw an Exception
5.2.3.3
ReturnIfAbrupt
5.2.3.4
ReturnIfAbrupt Shorthands
5.2.4
Static Semantics
5.2.5
Mathematical Operations
5.2.6
Value Notation
ECMAScript Data Types and Values
6.1
ECMAScript Language Types
6.1.1
The Undefined Type
6.1.2
The Null Type
6.1.3
The Boolean Type
6.1.4
The String Type
6.1.4.1
StringIndexOf (
string
searchValue
fromIndex
6.1.5
The Symbol Type
6.1.5.1
Well-Known Symbols
6.1.6
Numeric Types
6.1.6.1
The Number Type
6.1.6.1.1
Number::unaryMinus (
6.1.6.1.2
Number::bitwiseNOT (
6.1.6.1.3
Number::exponentiate (
base
exponent
6.1.6.1.4
Number::multiply (
6.1.6.1.5
Number::divide (
6.1.6.1.6
Number::remainder (
6.1.6.1.7
Number::add (
6.1.6.1.8
Number::subtract (
6.1.6.1.9
Number::leftShift (
6.1.6.1.10
Number::signedRightShift (
6.1.6.1.11
Number::unsignedRightShift (
6.1.6.1.12
Number::lessThan (
6.1.6.1.13
Number::equal (
6.1.6.1.14
Number::sameValue (
6.1.6.1.15
Number::sameValueZero (
6.1.6.1.16
NumberBitwiseOp (
op
6.1.6.1.17
Number::bitwiseAND (
6.1.6.1.18
Number::bitwiseXOR (
6.1.6.1.19
Number::bitwiseOR (
6.1.6.1.20
Number::toString (
6.1.6.2
The BigInt Type
6.1.6.2.1
BigInt::unaryMinus (
6.1.6.2.2
BigInt::bitwiseNOT (
6.1.6.2.3
BigInt::exponentiate (
base
exponent
6.1.6.2.4
BigInt::multiply (
6.1.6.2.5
BigInt::divide (
6.1.6.2.6
BigInt::remainder (
6.1.6.2.7
BigInt::add (
6.1.6.2.8
BigInt::subtract (
6.1.6.2.9
BigInt::leftShift (
6.1.6.2.10
BigInt::signedRightShift (
6.1.6.2.11
BigInt::unsignedRightShift (
6.1.6.2.12
BigInt::lessThan (
6.1.6.2.13
BigInt::equal (
6.1.6.2.14
BigInt::sameValue (
6.1.6.2.15
BigInt::sameValueZero (
6.1.6.2.16
BinaryAnd (
6.1.6.2.17
BinaryOr (
6.1.6.2.18
BinaryXor (
6.1.6.2.19
BigIntBitwiseOp (
op
6.1.6.2.20
BigInt::bitwiseAND (
6.1.6.2.21
BigInt::bitwiseXOR (
6.1.6.2.22
BigInt::bitwiseOR (
6.1.6.2.23
BigInt::toString (
6.1.7
The Object Type
6.1.7.1
Property Attributes
6.1.7.2
Object Internal Methods and Internal Slots
6.1.7.3
Invariants of the Essential Internal Methods
6.1.7.4
Well-Known Intrinsic Objects
6.2
ECMAScript Specification Types
6.2.1
The List and Record Specification Types
6.2.2
The Set and Relation Specification Types
6.2.3
The Completion Record Specification Type
6.2.3.1
Await
6.2.3.1.1
Await Fulfilled Functions
6.2.3.1.2
Await Rejected Functions
6.2.3.2
NormalCompletion
6.2.3.3
ThrowCompletion
6.2.3.4
UpdateEmpty (
completionRecord
value
6.2.4
The Reference Record Specification Type
6.2.4.1
IsPropertyReference (
6.2.4.2
IsUnresolvableReference (
6.2.4.3
IsSuperReference (
6.2.4.4
GetValue (
6.2.4.5
PutValue (
6.2.4.6
GetThisValue (
6.2.4.7
InitializeReferencedBinding (
6.2.5
The Property Descriptor Specification Type
6.2.5.1
IsAccessorDescriptor (
Desc
6.2.5.2
IsDataDescriptor (
Desc
6.2.5.3
IsGenericDescriptor (
Desc
6.2.5.4
FromPropertyDescriptor (
Desc
6.2.5.5
ToPropertyDescriptor (
Obj
6.2.5.6
CompletePropertyDescriptor (
Desc
6.2.6
The Environment Record Specification Type
6.2.7
The Abstract Closure Specification Type
6.2.8
Data Blocks
6.2.8.1
CreateByteDataBlock (
size
6.2.8.2
CreateSharedByteDataBlock (
size
6.2.8.3
CopyDataBlockBytes (
toBlock
toIndex
fromBlock
fromIndex
count
Abstract Operations
7.1
Type Conversion
7.1.1
ToPrimitive (
input
[ ,
preferredType
] )
7.1.1.1
OrdinaryToPrimitive (
hint
7.1.2
ToBoolean (
argument
7.1.3
ToNumeric (
value
7.1.4
ToNumber (
argument
7.1.4.1
ToNumber Applied to the String Type
7.1.4.1.1
RS: MV
7.1.5
ToIntegerOrInfinity (
argument
7.1.6
ToInt32 (
argument
7.1.7
ToUint32 (
argument
7.1.8
ToInt16 (
argument
7.1.9
ToUint16 (
argument
7.1.10
ToInt8 (
argument
7.1.11
ToUint8 (
argument
7.1.12
ToUint8Clamp (
argument
7.1.13
ToBigInt (
argument
7.1.14
StringToBigInt (
argument
7.1.15
ToBigInt64 (
argument
7.1.16
ToBigUint64 (
argument
7.1.17
ToString (
argument
7.1.18
ToObject (
argument
7.1.19
ToPropertyKey (
argument
7.1.20
ToLength (
argument
7.1.21
CanonicalNumericIndexString (
argument
7.1.22
ToIndex (
value
7.2
Testing and Comparison Operations
7.2.1
RequireObjectCoercible (
argument
7.2.2
IsArray (
argument
7.2.3
IsCallable (
argument
7.2.4
IsConstructor (
argument
7.2.5
IsExtensible (
7.2.6
IsIntegralNumber (
argument
7.2.7
IsPropertyKey (
argument
7.2.8
IsRegExp (
argument
7.2.9
IsStringPrefix (
7.2.10
SameValue (
7.2.11
SameValueZero (
7.2.12
SameValueNonNumeric (
7.2.13
Abstract Relational Comparison
7.2.14
Abstract Equality Comparison
7.2.15
Strict Equality Comparison
7.3
Operations on Objects
7.3.1
MakeBasicObject (
internalSlotsList
7.3.2
Get (
7.3.3
GetV (
7.3.4
Set (
Throw
7.3.5
CreateDataProperty (
7.3.6
CreateMethodProperty (
7.3.7
CreateDataPropertyOrThrow (
7.3.8
DefinePropertyOrThrow (
desc
7.3.9
DeletePropertyOrThrow (
7.3.10
GetMethod (
7.3.11
HasProperty (
7.3.12
HasOwnProperty (
7.3.13
Call (
[ ,
argumentsList
] )
7.3.14
Construct (
[ ,
argumentsList
[ ,
newTarget
] ] )
7.3.15
SetIntegrityLevel (
level
7.3.16
TestIntegrityLevel (
level
7.3.17
CreateArrayFromList (
elements
7.3.18
LengthOfArrayLike (
obj
7.3.19
CreateListFromArrayLike (
obj
[ ,
elementTypes
] )
7.3.20
Invoke (
[ ,
argumentsList
] )
7.3.21
OrdinaryHasInstance (
7.3.22
SpeciesConstructor (
defaultConstructor
7.3.23
EnumerableOwnPropertyNames (
kind
7.3.24
GetFunctionRealm (
obj
7.3.25
CopyDataProperties (
target
source
excludedItems
7.4
Operations on Iterator Objects
7.4.1
GetIterator (
obj
[ ,
hint
[ ,
method
] ] )
7.4.2
IteratorNext (
iteratorRecord
[ ,
value
] )
7.4.3
IteratorComplete (
iterResult
7.4.4
IteratorValue (
iterResult
7.4.5
IteratorStep (
iteratorRecord
7.4.6
IteratorClose (
iteratorRecord
completion
7.4.7
AsyncIteratorClose (
iteratorRecord
completion
7.4.8
CreateIterResultObject (
value
done
7.4.9
CreateListIteratorRecord (
list
7.4.10
IterableToList (
items
[ ,
method
] )
Syntax-Directed Operations
8.1
Scope Analysis
8.1.1
SS: BoundNames
8.1.2
SS: DeclarationPart
8.1.3
SS: IsConstantDeclaration
8.1.4
SS: LexicallyDeclaredNames
8.1.5
SS: LexicallyScopedDeclarations
8.1.6
SS: VarDeclaredNames
8.1.7
SS: VarScopedDeclarations
8.1.8
SS: TopLevelLexicallyDeclaredNames
8.1.9
SS: TopLevelLexicallyScopedDeclarations
8.1.10
SS: TopLevelVarDeclaredNames
8.1.11
SS: TopLevelVarScopedDeclarations
8.2
Labels
8.2.1
SS: ContainsDuplicateLabels
8.2.2
SS: ContainsUndefinedBreakTarget
8.2.3
SS: ContainsUndefinedContinueTarget
8.3
Function Name Inference
8.3.1
SS: HasName
8.3.2
SS: IsFunctionDefinition
8.3.3
SS: IsAnonymousFunctionDefinition (
expr
8.3.4
SS: IsIdentifierRef
8.3.5
RS: NamedEvaluation
8.4
Contains
8.4.1
SS: Contains
8.4.2
SS: ComputedPropertyContains
8.5
Miscellaneous
8.5.1
RS: InstantiateFunctionObject
8.5.2
RS: BindingInitialization
8.5.2.1
InitializeBoundName (
name
value
environment
8.5.3
RS: IteratorBindingInitialization
8.5.4
SS: AssignmentTargetType
8.5.5
SS: PropName
Executable Code and Execution Contexts
9.1
Environment Records
9.1.1
The Environment Record Type Hierarchy
9.1.1.1
Declarative Environment Records
9.1.1.1.1
HasBinding (
9.1.1.1.2
CreateMutableBinding (
9.1.1.1.3
CreateImmutableBinding (
9.1.1.1.4
InitializeBinding (
9.1.1.1.5
SetMutableBinding (
9.1.1.1.6
GetBindingValue (
9.1.1.1.7
DeleteBinding (
9.1.1.1.8
HasThisBinding ( )
9.1.1.1.9
HasSuperBinding ( )
9.1.1.1.10
WithBaseObject ( )
9.1.1.2
Object Environment Records
9.1.1.2.1
HasBinding (
9.1.1.2.2
CreateMutableBinding (
9.1.1.2.3
CreateImmutableBinding (
9.1.1.2.4
InitializeBinding (
9.1.1.2.5
SetMutableBinding (
9.1.1.2.6
GetBindingValue (
9.1.1.2.7
DeleteBinding (
9.1.1.2.8
HasThisBinding ( )
9.1.1.2.9
HasSuperBinding ( )
9.1.1.2.10
WithBaseObject ( )
9.1.1.3
Function Environment Records
9.1.1.3.1
BindThisValue (
9.1.1.3.2
HasThisBinding ( )
9.1.1.3.3
HasSuperBinding ( )
9.1.1.3.4
GetThisBinding ( )
9.1.1.3.5
GetSuperBase ( )
9.1.1.4
Global Environment Records
9.1.1.4.1
HasBinding (
9.1.1.4.2
CreateMutableBinding (
9.1.1.4.3
CreateImmutableBinding (
9.1.1.4.4
InitializeBinding (
9.1.1.4.5
SetMutableBinding (
9.1.1.4.6
GetBindingValue (
9.1.1.4.7
DeleteBinding (
9.1.1.4.8
HasThisBinding ( )
9.1.1.4.9
HasSuperBinding ( )
9.1.1.4.10
WithBaseObject ( )
9.1.1.4.11
GetThisBinding ( )
9.1.1.4.12
HasVarDeclaration (
9.1.1.4.13
HasLexicalDeclaration (
9.1.1.4.14
HasRestrictedGlobalProperty (
9.1.1.4.15
CanDeclareGlobalVar (
9.1.1.4.16
CanDeclareGlobalFunction (
9.1.1.4.17
CreateGlobalVarBinding (
9.1.1.4.18
CreateGlobalFunctionBinding (
9.1.1.5
Module Environment Records
9.1.1.5.1
GetBindingValue (
9.1.1.5.2
DeleteBinding (
9.1.1.5.3
HasThisBinding ( )
9.1.1.5.4
GetThisBinding ( )
9.1.1.5.5
CreateImportBinding (
N2
9.1.2
Environment Record Operations
9.1.2.1
GetIdentifierReference (
env
name
strict
9.1.2.2
NewDeclarativeEnvironment (
9.1.2.3
NewObjectEnvironment (
9.1.2.4
NewFunctionEnvironment (
newTarget
9.1.2.5
NewGlobalEnvironment (
thisValue
9.1.2.6
NewModuleEnvironment (
9.2
Realms
9.2.1
CreateRealm ( )
9.2.2
CreateIntrinsics (
realmRec
9.2.3
SetRealmGlobalObject (
realmRec
globalObj
thisValue
9.2.4
SetDefaultGlobalBindings (
realmRec
9.3
Execution Contexts
9.3.1
GetActiveScriptOrModule ( )
9.3.2
ResolveBinding (
name
[ ,
env
] )
9.3.3
GetThisEnvironment ( )
9.3.4
ResolveThisBinding ( )
9.3.5
GetNewTarget ( )
9.3.6
GetGlobalObject ( )
9.4
Jobs and Host Operations to Enqueue Jobs
9.4.1
JobCallback Records
9.4.2
HostMakeJobCallback (
callback
9.4.3
HostCallJobCallback (
jobCallback
argumentsList
9.4.4
HostEnqueuePromiseJob (
job
realm
9.5
InitializeHostDefinedRealm ( )
9.6
Agents
9.6.1
AgentSignifier ( )
9.6.2
AgentCanSuspend ( )
9.7
Agent Clusters
9.8
Forward Progress
9.9
Processing Model of WeakRef and FinalizationRegistry Objects
9.9.1
Objectives
9.9.2
Liveness
9.9.3
Execution
9.9.4
Host Hooks
9.9.4.1
HostEnqueueFinalizationRegistryCleanupJob (
finalizationRegistry
9.10
ClearKeptObjects ( )
9.11
AddToKeptObjects (
object
9.12
CleanupFinalizationRegistry (
finalizationRegistry
10
Ordinary and Exotic Objects Behaviours
10.1
Ordinary Object Internal Methods and Internal Slots
10.1.1
[[GetPrototypeOf]] ( )
10.1.1.1
OrdinaryGetPrototypeOf (
10.1.2
[[SetPrototypeOf]] (
10.1.2.1
OrdinarySetPrototypeOf (
10.1.3
[[IsExtensible]] ( )
10.1.3.1
OrdinaryIsExtensible (
10.1.4
[[PreventExtensions]] ( )
10.1.4.1
OrdinaryPreventExtensions (
10.1.5
[[GetOwnProperty]] (
10.1.5.1
OrdinaryGetOwnProperty (
10.1.6
[[DefineOwnProperty]] (
Desc
10.1.6.1
OrdinaryDefineOwnProperty (
Desc
10.1.6.2
IsCompatiblePropertyDescriptor (
Extensible
Desc
Current
10.1.6.3
ValidateAndApplyPropertyDescriptor (
extensible
Desc
current
10.1.7
[[HasProperty]] (
10.1.7.1
OrdinaryHasProperty (
10.1.8
[[Get]] (
Receiver
10.1.8.1
OrdinaryGet (
Receiver
10.1.9
[[Set]] (
Receiver
10.1.9.1
OrdinarySet (
Receiver
10.1.9.2
OrdinarySetWithOwnDescriptor (
Receiver
ownDesc
10.1.10
[[Delete]] (
10.1.10.1
OrdinaryDelete (
10.1.11
[[OwnPropertyKeys]] ( )
10.1.11.1
OrdinaryOwnPropertyKeys (
10.1.12
OrdinaryObjectCreate (
proto
[ ,
additionalInternalSlotsList
] )
10.1.13
OrdinaryCreateFromConstructor (
constructor
intrinsicDefaultProto
[ ,
internalSlotsList
] )
10.1.14
GetPrototypeFromConstructor (
constructor
intrinsicDefaultProto
10.1.15
RequireInternalSlot (
internalSlot
10.2
ECMAScript Function Objects
10.2.1
[[Call]] (
thisArgument
argumentsList
10.2.1.1
PrepareForOrdinaryCall (
newTarget
10.2.1.2
OrdinaryCallBindThis (
calleeContext
thisArgument
10.2.1.3
RS: EvaluateBody
10.2.1.4
OrdinaryCallEvaluateBody (
argumentsList
10.2.2
[[Construct]] (
argumentsList
newTarget
10.2.3
OrdinaryFunctionCreate (
functionPrototype
sourceText
ParameterList
Body
thisMode
Scope
10.2.4
AddRestrictedFunctionProperties (
realm
10.2.4.1
%ThrowTypeError% ( )
10.2.5
MakeConstructor (
[ ,
writablePrototype
[ ,
prototype
] ] )
10.2.6
MakeClassConstructor (
10.2.7
MakeMethod (
homeObject
10.2.8
SetFunctionName (
name
[ ,
prefix
] )
10.2.9
SetFunctionLength (
length
10.2.10
FunctionDeclarationInstantiation (
func
argumentsList
10.3
Built-in Function Objects
10.3.1
[[Call]] (
thisArgument
argumentsList
10.3.2
[[Construct]] (
argumentsList
newTarget
10.3.3
CreateBuiltinFunction (
steps
length
name
internalSlotsList
[ ,
realm
[ ,
prototype
[ ,
prefix
] ] ] )
10.4
Built-in Exotic Object Internal Methods and Slots
10.4.1
Bound Function Exotic Objects
10.4.1.1
[[Call]] (
thisArgument
argumentsList
10.4.1.2
[[Construct]] (
argumentsList
newTarget
10.4.1.3
BoundFunctionCreate (
targetFunction
boundThis
boundArgs
10.4.2
Array Exotic Objects
10.4.2.1
[[DefineOwnProperty]] (
Desc
10.4.2.2
ArrayCreate (
length
[ ,
proto
] )
10.4.2.3
ArraySpeciesCreate (
originalArray
length
10.4.2.4
ArraySetLength (
Desc
10.4.3
String Exotic Objects
10.4.3.1
[[GetOwnProperty]] (
10.4.3.2
[[DefineOwnProperty]] (
Desc
10.4.3.3
[[OwnPropertyKeys]] ( )
10.4.3.4
StringCreate (
value
prototype
10.4.3.5
StringGetOwnProperty (
10.4.4
Arguments Exotic Objects
10.4.4.1
[[GetOwnProperty]] (
10.4.4.2
[[DefineOwnProperty]] (
Desc
10.4.4.3
[[Get]] (
Receiver
10.4.4.4
[[Set]] (
Receiver
10.4.4.5
[[Delete]] (
10.4.4.6
CreateUnmappedArgumentsObject (
argumentsList
10.4.4.7
CreateMappedArgumentsObject (
func
formals
argumentsList
env
10.4.4.7.1
MakeArgGetter (
name
env
10.4.4.7.2
MakeArgSetter (
name
env
10.4.5
Integer-Indexed Exotic Objects
10.4.5.1
[[GetOwnProperty]] (
10.4.5.2
[[HasProperty]] (
10.4.5.3
[[DefineOwnProperty]] (
Desc
10.4.5.4
[[Get]] (
Receiver
10.4.5.5
[[Set]] (
Receiver
10.4.5.6
[[Delete]] (
10.4.5.7
[[OwnPropertyKeys]] ( )
10.4.5.8
IntegerIndexedObjectCreate (
prototype
10.4.5.9
IsValidIntegerIndex (
index
10.4.5.10
IntegerIndexedElementGet (
index
10.4.5.11
IntegerIndexedElementSet (
index
value
10.4.6
Module Namespace Exotic Objects
10.4.6.1
[[SetPrototypeOf]] (
10.4.6.2
[[IsExtensible]] ( )
10.4.6.3
[[PreventExtensions]] ( )
10.4.6.4
[[GetOwnProperty]] (
10.4.6.5
[[DefineOwnProperty]] (
Desc
10.4.6.6
[[HasProperty]] (
10.4.6.7
[[Get]] (
Receiver
10.4.6.8
[[Set]] (
Receiver
10.4.6.9
[[Delete]] (
10.4.6.10
[[OwnPropertyKeys]] ( )
10.4.6.11
ModuleNamespaceCreate (
module
exports
10.4.7
Immutable Prototype Exotic Objects
10.4.7.1
[[SetPrototypeOf]] (
10.4.7.2
SetImmutablePrototype (
10.5
Proxy Object Internal Methods and Internal Slots
10.5.1
[[GetPrototypeOf]] ( )
10.5.2
[[SetPrototypeOf]] (
10.5.3
[[IsExtensible]] ( )
10.5.4
[[PreventExtensions]] ( )
10.5.5
[[GetOwnProperty]] (
10.5.6
[[DefineOwnProperty]] (
Desc
10.5.7
[[HasProperty]] (
10.5.8
[[Get]] (
Receiver
10.5.9
[[Set]] (
Receiver
10.5.10
[[Delete]] (
10.5.11
[[OwnPropertyKeys]] ( )
10.5.12
[[Call]] (
thisArgument
argumentsList
10.5.13
[[Construct]] (
argumentsList
newTarget
10.5.14
ProxyCreate (
target
handler
11
ECMAScript Language: Source Code
11.1
Source Text
11.1.1
SS: UTF16EncodeCodePoint (
cp
11.1.2
SS: CodePointsToString (
text
11.1.3
SS: UTF16SurrogatePairToCodePoint (
lead
trail
11.1.4
SS: CodePointAt (
string
position
11.1.5
SS: StringToCodePoints (
string
11.1.6
SS: ParseText (
sourceText
goalSymbol
11.2
Types of Source Code
11.2.1
Directive Prologues and the Use Strict Directive
11.2.2
Strict Mode Code
11.2.3
Non-ECMAScript Functions
12
ECMAScript Language: Lexical Grammar
12.1
Unicode Format-Control Characters
12.2
White Space
12.3
Line Terminators
12.4
Comments
12.5
Tokens
12.6
Names and Keywords
12.6.1
Identifier Names
12.6.1.1
SS: Early Errors
12.6.2
Keywords and Reserved Words
12.7
Punctuators
12.8
Literals
12.8.1
Null Literals
12.8.2
Boolean Literals
12.8.3
Numeric Literals
12.8.3.1
SS: MV
12.8.3.2
SS: NumericValue
12.8.4
String Literals
12.8.4.1
SS: SV
12.8.4.2
SS: MV
12.8.5
Regular Expression Literals
12.8.5.1
SS: Early Errors
12.8.5.2
SS: BodyText
12.8.5.3
SS: FlagText
12.8.6
Template Literal Lexical Components
12.8.6.1
SS: TV and TRV
12.9
Automatic Semicolon Insertion
12.9.1
Rules of Automatic Semicolon Insertion
12.9.2
Examples of Automatic Semicolon Insertion
12.9.3
Interesting Cases of Automatic Semicolon Insertion
12.9.3.1
Interesting Cases of Automatic Semicolon Insertion in Statement Lists
12.9.3.2
Cases of Automatic Semicolon Insertion and “[no
LineTerminator
here]”
12.9.3.2.1
List of Grammar Productions with Optional Operands and “[no
LineTerminator
here]”
13
ECMAScript Language: Expressions
13.1
Identifiers
13.1.1
SS: Early Errors
13.1.2
SS: StringValue
13.1.3
RS: Evaluation
13.2
Primary Expression
13.2.1
Semantics
13.2.1.1
SS: CoveredParenthesizedExpression
13.2.2
The
this
Keyword
13.2.2.1
RS: Evaluation
13.2.3
Identifier Reference
13.2.4
Literals
13.2.4.1
RS: Evaluation
13.2.5
Array Initializer
13.2.5.1
RS: ArrayAccumulation
13.2.5.2
RS: Evaluation
13.2.6
Object Initializer
13.2.6.1
SS: Early Errors
13.2.6.2
SS: IsComputedPropertyKey
13.2.6.3
SS: PropertyNameList
13.2.6.4
RS: Evaluation
13.2.6.5
RS: PropertyDefinitionEvaluation
13.2.7
Function Defining Expressions
13.2.8
Regular Expression Literals
13.2.8.1
SS: Early Errors
13.2.8.2
SS: IsValidRegularExpressionLiteral (
literal
13.2.8.3
RS: Evaluation
13.2.9
Template Literals
13.2.9.1
SS: Early Errors
13.2.9.2
SS: TemplateStrings
13.2.9.3
GetTemplateObject (
templateLiteral
13.2.9.4
RS: SubstitutionEvaluation
13.2.9.5
RS: Evaluation
13.2.10
The Grouping Operator
13.2.10.1
SS: Early Errors
13.2.10.2
RS: Evaluation
13.3
Left-Hand-Side Expressions
13.3.1
Static Semantics
13.3.1.1
SS: Early Errors
13.3.1.2
SS: CoveredCallExpression
13.3.2
Property Accessors
13.3.2.1
RS: Evaluation
13.3.3
EvaluatePropertyAccessWithExpressionKey (
baseValue
expression
strict
13.3.4
EvaluatePropertyAccessWithIdentifierKey (
baseValue
identifierName
strict
13.3.5
The
new
Operator
13.3.5.1
RS: Evaluation
13.3.5.1.1
EvaluateNew (
constructExpr
arguments
13.3.6
Function Calls
13.3.6.1
RS: Evaluation
13.3.6.2
EvaluateCall (
func
ref
arguments
tailPosition
13.3.7
The
super
Keyword
13.3.7.1
RS: Evaluation
13.3.7.2
GetSuperConstructor ( )
13.3.7.3
MakeSuperPropertyReference (
actualThis
propertyKey
strict
13.3.8
Argument Lists
13.3.8.1
RS: ArgumentListEvaluation
13.3.9
Optional Chains
13.3.9.1
RS: Evaluation
13.3.9.2
RS: ChainEvaluation
13.3.10
Import Calls
13.3.10.1
RS: Evaluation
13.3.11
Tagged Templates
13.3.11.1
RS: Evaluation
13.3.12
Meta Properties
13.3.12.1
RS: Evaluation
13.3.12.1.1
HostGetImportMetaProperties (
moduleRecord
13.3.12.1.2
HostFinalizeImportMeta (
importMeta
moduleRecord
13.4
Update Expressions
13.4.1
SS: Early Errors
13.4.2
Postfix Increment Operator
13.4.2.1
RS: Evaluation
13.4.3
Postfix Decrement Operator
13.4.3.1
RS: Evaluation
13.4.4
Prefix Increment Operator
13.4.4.1
RS: Evaluation
13.4.5
Prefix Decrement Operator
13.4.5.1
RS: Evaluation
13.5
Unary Operators
13.5.1
The
delete
Operator
13.5.1.1
SS: Early Errors
13.5.1.2
RS: Evaluation
13.5.2
The
void
Operator
13.5.2.1
RS: Evaluation
13.5.3
The
typeof
Operator
13.5.3.1
RS: Evaluation
13.5.4
Unary
Operator
13.5.4.1
RS: Evaluation
13.5.5
Unary
Operator
13.5.5.1
RS: Evaluation
13.5.6
Bitwise NOT Operator (
13.5.6.1
RS: Evaluation
13.5.7
Logical NOT Operator (
13.5.7.1
RS: Evaluation
13.6
Exponentiation Operator
13.6.1
RS: Evaluation
13.7
Multiplicative Operators
13.7.1
RS: Evaluation
13.8
Additive Operators
13.8.1
The Addition Operator (
13.8.1.1
RS: Evaluation
13.8.2
The Subtraction Operator (
13.8.2.1
RS: Evaluation
13.9
Bitwise Shift Operators
13.9.1
The Left Shift Operator (
<<
13.9.1.1
RS: Evaluation
13.9.2
The Signed Right Shift Operator (
>>
13.9.2.1
RS: Evaluation
13.9.3
The Unsigned Right Shift Operator (
>>>
13.9.3.1
RS: Evaluation
13.10
Relational Operators
13.10.1
RS: Evaluation
13.10.2
InstanceofOperator (
target
13.11
Equality Operators
13.11.1
RS: Evaluation
13.12
Binary Bitwise Operators
13.12.1
RS: Evaluation
13.13
Binary Logical Operators
13.13.1
RS: Evaluation
13.14
Conditional Operator (
? :
13.14.1
RS: Evaluation
13.15
Assignment Operators
13.15.1
SS: Early Errors
13.15.2
RS: Evaluation
13.15.3
ApplyStringOrNumericBinaryOperator (
lval
opText
rval
13.15.4
EvaluateStringOrNumericBinaryExpression (
leftOperand
opText
rightOperand
13.15.5
Destructuring Assignment
13.15.5.1
SS: Early Errors
13.15.5.2
RS: DestructuringAssignmentEvaluation
13.15.5.3
RS: PropertyDestructuringAssignmentEvaluation
13.15.5.4
RS: RestDestructuringAssignmentEvaluation
13.15.5.5
RS: IteratorDestructuringAssignmentEvaluation
13.15.5.6
RS: KeyedDestructuringAssignmentEvaluation
13.16
Comma Operator (
13.16.1
RS: Evaluation
14
ECMAScript Language: Statements and Declarations
14.1
Statement Semantics
14.1.1
RS: Evaluation
14.2
Block
14.2.1
SS: Early Errors
14.2.2
RS: Evaluation
14.2.3
BlockDeclarationInstantiation (
code
env
14.3
Declarations and the Variable Statement
14.3.1
Let and Const Declarations
14.3.1.1
SS: Early Errors
14.3.1.2
RS: Evaluation
14.3.2
Variable Statement
14.3.2.1
RS: Evaluation
14.3.3
Destructuring Binding Patterns
14.3.3.1
RS: PropertyBindingInitialization
14.3.3.2
RS: RestBindingInitialization
14.3.3.3
RS: KeyedBindingInitialization
14.4
Empty Statement
14.4.1
RS: Evaluation
14.5
Expression Statement
14.5.1
RS: Evaluation
14.6
The
if
Statement
14.6.1
SS: Early Errors
14.6.2
RS: Evaluation
14.7
Iteration Statements
14.7.1
Semantics
14.7.1.1
LoopContinues (
completion
labelSet
14.7.1.2
RS: LoopEvaluation
14.7.2
The
do
while
Statement
14.7.2.1
SS: Early Errors
14.7.2.2
RS: DoWhileLoopEvaluation
14.7.3
The
while
Statement
14.7.3.1
SS: Early Errors
14.7.3.2
RS: WhileLoopEvaluation
14.7.4
The
for
Statement
14.7.4.1
SS: Early Errors
14.7.4.2
RS: ForLoopEvaluation
14.7.4.3
ForBodyEvaluation (
test
increment
stmt
perIterationBindings
labelSet
14.7.4.4
CreatePerIterationEnvironment (
perIterationBindings
14.7.5
The
for
in
for
of
, and
for
await
of
Statements
14.7.5.1
SS: Early Errors
14.7.5.2
SS: IsDestructuring
14.7.5.3
RS: ForDeclarationBindingInitialization
14.7.5.4
RS: ForDeclarationBindingInstantiation
14.7.5.5
RS: ForInOfLoopEvaluation
14.7.5.6
ForIn/OfHeadEvaluation (
uninitializedBoundNames
expr
iterationKind
14.7.5.7
ForIn/OfBodyEvaluation (
lhs
stmt
iteratorRecord
iterationKind
lhsKind
labelSet
[ ,
iteratorKind
] )
14.7.5.8
RS: Evaluation
14.7.5.9
EnumerateObjectProperties (
14.7.5.10
For-In Iterator Objects
14.7.5.10.1
CreateForInIterator (
object
14.7.5.10.2
The %ForInIteratorPrototype% Object
14.7.5.10.2.1
%ForInIteratorPrototype%.next ( )
14.7.5.10.3
Properties of For-In Iterator Instances
14.8
The
continue
Statement
14.8.1
SS: Early Errors
14.8.2
RS: Evaluation
14.9
The
break
Statement
14.9.1
SS: Early Errors
14.9.2
RS: Evaluation
14.10
The
return
Statement
14.10.1
RS: Evaluation
14.11
The
with
Statement
14.11.1
SS: Early Errors
14.11.2
RS: Evaluation
14.12
The
switch
Statement
14.12.1
SS: Early Errors
14.12.2
RS: CaseBlockEvaluation
14.12.3
CaseClauseIsSelected (
input
14.12.4
RS: Evaluation
14.13
Labelled Statements
14.13.1
SS: Early Errors
14.13.2
SS: IsLabelledFunction (
stmt
14.13.3
RS: Evaluation
14.13.4
RS: LabelledEvaluation
14.14
The
throw
Statement
14.14.1
RS: Evaluation
14.15
The
try
Statement
14.15.1
SS: Early Errors
14.15.2
RS: CatchClauseEvaluation
14.15.3
RS: Evaluation
14.16
The
debugger
Statement
14.16.1
RS: Evaluation
15
ECMAScript Language: Functions and Classes
15.1
Parameter Lists
15.1.1
SS: Early Errors
15.1.2
SS: ContainsExpression
15.1.3
SS: IsSimpleParameterList
15.1.4
SS: HasInitializer
15.1.5
SS: ExpectedArgumentCount
15.2
Function Definitions
15.2.1
SS: Early Errors
15.2.2
SS: FunctionBodyContainsUseStrict
15.2.3
RS: EvaluateFunctionBody
15.2.4
RS: InstantiateOrdinaryFunctionObject
15.2.5
RS: InstantiateOrdinaryFunctionExpression
15.2.6
RS: Evaluation
15.3
Arrow Function Definitions
15.3.1
SS: Early Errors
15.3.2
SS: ConciseBodyContainsUseStrict
15.3.3
SS: CoveredFormalsList
15.3.4
RS: EvaluateConciseBody
15.3.5
RS: InstantiateArrowFunctionExpression
15.3.6
RS: Evaluation
15.4
Method Definitions
15.4.1
SS: Early Errors
15.4.2
SS: HasDirectSuper
15.4.3
SS: SpecialMethod
15.4.4
RS: DefineMethod
15.4.5
RS: MethodDefinitionEvaluation
15.5
Generator Function Definitions
15.5.1
SS: Early Errors
15.5.2
RS: EvaluateGeneratorBody
15.5.3
RS: InstantiateGeneratorFunctionObject
15.5.4
RS: InstantiateGeneratorFunctionExpression
15.5.5
RS: Evaluation
15.6
Async Generator Function Definitions
15.6.1
SS: Early Errors
15.6.2
RS: EvaluateAsyncGeneratorBody
15.6.3
RS: InstantiateAsyncGeneratorFunctionObject
15.6.4
RS: InstantiateAsyncGeneratorFunctionExpression
15.6.5
RS: Evaluation
15.7
Class Definitions
15.7.1
SS: Early Errors
15.7.2
SS: ClassElementKind
15.7.3
SS: ConstructorMethod
15.7.4
SS: IsStatic
15.7.5
SS: NonConstructorMethodDefinitions
15.7.6
SS: PrototypePropertyNameList
15.7.7
RS: ClassDefinitionEvaluation
15.7.7.1
Default Constructor Functions
15.7.8
RS: BindingClassDeclarationEvaluation
15.7.9
RS: Evaluation
15.8
Async Function Definitions
15.8.1
SS: Early Errors
15.8.2
RS: InstantiateAsyncFunctionObject
15.8.3
RS: InstantiateAsyncFunctionExpression
15.8.4
RS: EvaluateAsyncFunctionBody
15.8.5
RS: Evaluation
15.9
Async Arrow Function Definitions
15.9.1
SS: Early Errors
15.9.2
SS: CoveredAsyncArrowHead
15.9.3
SS: AsyncConciseBodyContainsUseStrict
15.9.4
RS: EvaluateAsyncConciseBody
15.9.5
RS: InstantiateAsyncArrowFunctionExpression
15.9.6
RS: Evaluation
15.10
Tail Position Calls
15.10.1
SS: IsInTailPosition (
call
15.10.2
SS: HasCallInTailPosition
15.10.2.1
Statement Rules
15.10.2.2
Expression Rules
15.10.3
PrepareForTailCall ( )
16
ECMAScript Language: Scripts and Modules
16.1
Scripts
16.1.1
SS: Early Errors
16.1.2
SS: IsStrict
16.1.3
RS: Evaluation
16.1.4
Script Records
16.1.5
ParseScript (
sourceText
realm
hostDefined
16.1.6
ScriptEvaluation (
scriptRecord
16.1.7
GlobalDeclarationInstantiation (
script
env
16.2
Modules
16.2.1
Module Semantics
16.2.1.1
SS: Early Errors
16.2.1.2
SS: ImportedLocalNames (
importEntries
16.2.1.3
SS: ModuleRequests
16.2.1.4
Abstract Module Records
16.2.1.5
Cyclic Module Records
16.2.1.5.1
Link ( ) Concrete Method
16.2.1.5.1.1
InnerModuleLinking (
module
stack
index
16.2.1.5.2
Evaluate ( ) Concrete Method
16.2.1.5.2.1
InnerModuleEvaluation (
module
stack
index
16.2.1.5.3
Example Cyclic Module Record Graphs
16.2.1.6
Source Text Module Records
16.2.1.6.1
ParseModule (
sourceText
realm
hostDefined
16.2.1.6.2
GetExportedNames ( [
exportStarSet
] ) Concrete Method
16.2.1.6.3
ResolveExport (
exportName
[ ,
resolveSet
] ) Concrete Method
16.2.1.6.4
InitializeEnvironment ( ) Concrete Method
16.2.1.6.5
ExecuteModule ( ) Concrete Method
16.2.1.7
HostResolveImportedModule (
referencingScriptOrModule
specifier
16.2.1.8
HostImportModuleDynamically (
referencingScriptOrModule
specifier
promiseCapability
16.2.1.9
FinishDynamicImport (
referencingScriptOrModule
specifier
promiseCapability
completion
16.2.1.10
GetModuleNamespace (
module
16.2.1.11
RS: Evaluation
16.2.2
Imports
16.2.2.1
SS: Early Errors
16.2.2.2
SS: ImportEntries
16.2.2.3
SS: ImportEntriesForModule
16.2.3
Exports
16.2.3.1
SS: Early Errors
16.2.3.2
SS: ExportedBindings
16.2.3.3
SS: ExportedNames
16.2.3.4
SS: ExportEntries
16.2.3.5
SS: ExportEntriesForModule
16.2.3.6
SS: ReferencedBindings
16.2.3.7
RS: Evaluation
17
Error Handling and Language Extensions
17.1
Forbidden Extensions
18
ECMAScript Standard Built-in Objects
19
The Global Object
19.1
Value Properties of the Global Object
19.1.1
globalThis
19.1.2
Infinity
19.1.3
NaN
19.1.4
undefined
19.2
Function Properties of the Global Object
19.2.1
eval (
19.2.1.1
PerformEval (
callerRealm
strictCaller
direct
19.2.1.2
HostEnsureCanCompileStrings (
callerRealm
calleeRealm
19.2.1.3
EvalDeclarationInstantiation (
body
varEnv
lexEnv
strict
19.2.2
isFinite (
number
19.2.3
isNaN (
number
19.2.4
parseFloat (
string
19.2.5
parseInt (
string
radix
19.2.6
URI Handling Functions
19.2.6.1
URI Syntax and Semantics
19.2.6.1.1
Encode (
string
unescapedSet
19.2.6.1.2
Decode (
string
reservedSet
19.2.6.2
decodeURI (
encodedURI
19.2.6.3
decodeURIComponent (
encodedURIComponent
19.2.6.4
encodeURI (
uri
19.2.6.5
encodeURIComponent (
uriComponent
19.3
Constructor Properties of the Global Object
19.3.1
Array ( . . . )
19.3.2
ArrayBuffer ( . . . )
19.3.3
BigInt ( . . . )
19.3.4
BigInt64Array ( . . . )
19.3.5
BigUint64Array ( . . . )
19.3.6
Boolean ( . . . )
19.3.7
DataView ( . . . )
19.3.8
Date ( . . . )
19.3.9
Error ( . . . )
19.3.10
EvalError ( . . . )
19.3.11
FinalizationRegistry ( . . . )
19.3.12
Float32Array ( . . . )
19.3.13
Float64Array ( . . . )
19.3.14
Function ( . . . )
19.3.15
Int8Array ( . . . )
19.3.16
Int16Array ( . . . )
19.3.17
Int32Array ( . . . )
19.3.18
Map ( . . . )
19.3.19
Number ( . . . )
19.3.20
Object ( . . . )
19.3.21
Promise ( . . . )
19.3.22
Proxy ( . . . )
19.3.23
RangeError ( . . . )
19.3.24
ReferenceError ( . . . )
19.3.25
RegExp ( . . . )
19.3.26
Set ( . . . )
19.3.27
SharedArrayBuffer ( . . . )
19.3.28
String ( . . . )
19.3.29
Symbol ( . . . )
19.3.30
SyntaxError ( . . . )
19.3.31
TypeError ( . . . )
19.3.32
Uint8Array ( . . . )
19.3.33
Uint8ClampedArray ( . . . )
19.3.34
Uint16Array ( . . . )
19.3.35
Uint32Array ( . . . )
19.3.36
URIError ( . . . )
19.3.37
WeakMap ( . . . )
19.3.38
WeakRef ( . . . )
19.3.39
WeakSet ( . . . )
19.4
Other Properties of the Global Object
19.4.1
Atomics
19.4.2
JSON
19.4.3
Math
19.4.4
Reflect
20
Fundamental Objects
20.1
Object Objects
20.1.1
The Object Constructor
20.1.1.1
Object ( [
value
] )
20.1.2
Properties of the Object Constructor
20.1.2.1
Object.assign (
target
, ...
sources
20.1.2.2
Object.create (
Properties
20.1.2.3
Object.defineProperties (
Properties
20.1.2.3.1
ObjectDefineProperties (
Properties
20.1.2.4
Object.defineProperty (
Attributes
20.1.2.5
Object.entries (
20.1.2.6
Object.freeze (
20.1.2.7
Object.fromEntries (
iterable
20.1.2.7.1
CreateDataPropertyOnObject Functions
20.1.2.8
Object.getOwnPropertyDescriptor (
20.1.2.9
Object.getOwnPropertyDescriptors (
20.1.2.10
Object.getOwnPropertyNames (
20.1.2.11
Object.getOwnPropertySymbols (
20.1.2.11.1
GetOwnPropertyKeys (
type
20.1.2.12
Object.getPrototypeOf (
20.1.2.13
Object.is (
value1
value2
20.1.2.14
Object.isExtensible (
20.1.2.15
Object.isFrozen (
20.1.2.16
Object.isSealed (
20.1.2.17
Object.keys (
20.1.2.18
Object.preventExtensions (
20.1.2.19
Object.prototype
20.1.2.20
Object.seal (
20.1.2.21
Object.setPrototypeOf (
proto
20.1.2.22
Object.values (
20.1.3
Properties of the Object Prototype Object
20.1.3.1
Object.prototype.constructor
20.1.3.2
Object.prototype.hasOwnProperty (
20.1.3.3
Object.prototype.isPrototypeOf (
20.1.3.4
Object.prototype.propertyIsEnumerable (
20.1.3.5
Object.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
20.1.3.6
Object.prototype.toString ( )
20.1.3.7
Object.prototype.valueOf ( )
20.1.4
Properties of Object Instances
20.2
Function Objects
20.2.1
The Function Constructor
20.2.1.1
Function (
p1
p2
, … ,
pn
body
20.2.1.1.1
CreateDynamicFunction (
constructor
newTarget
kind
args
20.2.2
Properties of the Function Constructor
20.2.2.1
Function.length
20.2.2.2
Function.prototype
20.2.3
Properties of the Function Prototype Object
20.2.3.1
Function.prototype.apply (
thisArg
argArray
20.2.3.2
Function.prototype.bind (
thisArg
, ...
args
20.2.3.3
Function.prototype.call (
thisArg
, ...
args
20.2.3.4
Function.prototype.constructor
20.2.3.5
Function.prototype.toString ( )
20.2.3.6
Function.prototype [ @@hasInstance ] (
20.2.4
Function Instances
20.2.4.1
length
20.2.4.2
name
20.2.4.3
prototype
20.2.5
HostHasSourceTextAvailable (
func
20.3
Boolean Objects
20.3.1
The Boolean Constructor
20.3.1.1
Boolean (
value
20.3.2
Properties of the Boolean Constructor
20.3.2.1
Boolean.prototype
20.3.3
Properties of the Boolean Prototype Object
20.3.3.1
Boolean.prototype.constructor
20.3.3.2
Boolean.prototype.toString ( )
20.3.3.3
Boolean.prototype.valueOf ( )
20.3.4
Properties of Boolean Instances
20.4
Symbol Objects
20.4.1
The Symbol Constructor
20.4.1.1
Symbol ( [
description
] )
20.4.2
Properties of the Symbol Constructor
20.4.2.1
Symbol.asyncIterator
20.4.2.2
Symbol.for (
key
20.4.2.3
Symbol.hasInstance
20.4.2.4
Symbol.isConcatSpreadable
20.4.2.5
Symbol.iterator
20.4.2.6
Symbol.keyFor (
sym
20.4.2.7
Symbol.match
20.4.2.8
Symbol.matchAll
20.4.2.9
Symbol.prototype
20.4.2.10
Symbol.replace
20.4.2.11
Symbol.search
20.4.2.12
Symbol.species
20.4.2.13
Symbol.split
20.4.2.14
Symbol.toPrimitive
20.4.2.15
Symbol.toStringTag
20.4.2.16
Symbol.unscopables
20.4.3
Properties of the Symbol Prototype Object
20.4.3.1
Symbol.prototype.constructor
20.4.3.2
get Symbol.prototype.description
20.4.3.3
Symbol.prototype.toString ( )
20.4.3.3.1
SymbolDescriptiveString (
sym
20.4.3.4
Symbol.prototype.valueOf ( )
20.4.3.5
Symbol.prototype [ @@toPrimitive ] (
hint
20.4.3.6
Symbol.prototype [ @@toStringTag ]
20.4.4
Properties of Symbol Instances
20.5
Error Objects
20.5.1
The Error Constructor
20.5.1.1
Error (
message
20.5.2
Properties of the Error Constructor
20.5.2.1
Error.prototype
20.5.3
Properties of the Error Prototype Object
20.5.3.1
Error.prototype.constructor
20.5.3.2
Error.prototype.message
20.5.3.3
Error.prototype.name
20.5.3.4
Error.prototype.toString ( )
20.5.4
Properties of Error Instances
20.5.5
Native Error Types Used in This Standard
20.5.5.1
EvalError
20.5.5.2
RangeError
20.5.5.3
ReferenceError
20.5.5.4
SyntaxError
20.5.5.5
TypeError
20.5.5.6
URIError
20.5.6
NativeError
Object Structure
20.5.6.1
The
NativeError
Constructors
20.5.6.1.1
NativeError
message
20.5.6.2
Properties of the
NativeError
Constructors
20.5.6.2.1
NativeError
.prototype
20.5.6.3
Properties of the
NativeError
Prototype Objects
20.5.6.3.1
NativeError
.prototype.constructor
20.5.6.3.2
NativeError
.prototype.message
20.5.6.3.3
NativeError
.prototype.name
20.5.6.4
Properties of
NativeError
Instances
20.5.7
AggregateError Objects
20.5.7.1
The AggregateError Constructor
20.5.7.1.1
AggregateError (
errors
message
20.5.7.2
Properties of the AggregateError Constructor
20.5.7.2.1
AggregateError.prototype
20.5.7.3
Properties of the AggregateError Prototype Object
20.5.7.3.1
AggregateError.prototype.constructor
20.5.7.3.2
AggregateError.prototype.message
20.5.7.3.3
AggregateError.prototype.name
20.5.7.4
Properties of AggregateError Instances
21
Numbers and Dates
21.1
Number Objects
21.1.1
The Number Constructor
21.1.1.1
Number (
value
21.1.2
Properties of the Number Constructor
21.1.2.1
Number.EPSILON
21.1.2.2
Number.isFinite (
number
21.1.2.3
Number.isInteger (
number
21.1.2.4
Number.isNaN (
number
21.1.2.5
Number.isSafeInteger (
number
21.1.2.6
Number.MAX_SAFE_INTEGER
21.1.2.7
Number.MAX_VALUE
21.1.2.8
Number.MIN_SAFE_INTEGER
21.1.2.9
Number.MIN_VALUE
21.1.2.10
Number.NaN
21.1.2.11
Number.NEGATIVE_INFINITY
21.1.2.12
Number.parseFloat (
string
21.1.2.13
Number.parseInt (
string
radix
21.1.2.14
Number.POSITIVE_INFINITY
21.1.2.15
Number.prototype
21.1.3
Properties of the Number Prototype Object
21.1.3.1
Number.prototype.constructor
21.1.3.2
Number.prototype.toExponential (
fractionDigits
21.1.3.3
Number.prototype.toFixed (
fractionDigits
21.1.3.4
Number.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
21.1.3.5
Number.prototype.toPrecision (
precision
21.1.3.6
Number.prototype.toString ( [
radix
] )
21.1.3.7
Number.prototype.valueOf ( )
21.1.4
Properties of Number Instances
21.2
BigInt Objects
21.2.1
The BigInt Constructor
21.2.1.1
BigInt (
value
21.2.1.1.1
NumberToBigInt (
number
21.2.2
Properties of the BigInt Constructor
21.2.2.1
BigInt.asIntN (
bits
bigint
21.2.2.2
BigInt.asUintN (
bits
bigint
21.2.2.3
BigInt.prototype
21.2.3
Properties of the BigInt Prototype Object
21.2.3.1
BigInt.prototype.constructor
21.2.3.2
BigInt.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
21.2.3.3
BigInt.prototype.toString ( [
radix
] )
21.2.3.4
BigInt.prototype.valueOf ( )
21.2.3.5
BigInt.prototype [ @@toStringTag ]
21.3
The Math Object
21.3.1
Value Properties of the Math Object
21.3.1.1
Math.E
21.3.1.2
Math.LN10
21.3.1.3
Math.LN2
21.3.1.4
Math.LOG10E
21.3.1.5
Math.LOG2E
21.3.1.6
Math.PI
21.3.1.7
Math.SQRT1_2
21.3.1.8
Math.SQRT2
21.3.1.9
Math [ @@toStringTag ]
21.3.2
Function Properties of the Math Object
21.3.2.1
Math.abs (
21.3.2.2
Math.acos (
21.3.2.3
Math.acosh (
21.3.2.4
Math.asin (
21.3.2.5
Math.asinh (
21.3.2.6
Math.atan (
21.3.2.7
Math.atanh (
21.3.2.8
Math.atan2 (
21.3.2.9
Math.cbrt (
21.3.2.10
Math.ceil (
21.3.2.11
Math.clz32 (
21.3.2.12
Math.cos (
21.3.2.13
Math.cosh (
21.3.2.14
Math.exp (
21.3.2.15
Math.expm1 (
21.3.2.16
Math.floor (
21.3.2.17
Math.fround (
21.3.2.18
Math.hypot ( ...
args
21.3.2.19
Math.imul (
21.3.2.20
Math.log (
21.3.2.21
Math.log1p (
21.3.2.22
Math.log10 (
21.3.2.23
Math.log2 (
21.3.2.24
Math.max ( ...
args
21.3.2.25
Math.min ( ...
args
21.3.2.26
Math.pow (
base
exponent
21.3.2.27
Math.random ( )
21.3.2.28
Math.round (
21.3.2.29
Math.sign (
21.3.2.30
Math.sin (
21.3.2.31
Math.sinh (
21.3.2.32
Math.sqrt (
21.3.2.33
Math.tan (
21.3.2.34
Math.tanh (
21.3.2.35
Math.trunc (
21.4
Date Objects
21.4.1
Overview of Date Objects and Definitions of Abstract Operations
21.4.1.1
Time Values and Time Range
21.4.1.2
Day Number and Time within Day
21.4.1.3
Year Number
21.4.1.4
Month Number
21.4.1.5
Date Number
21.4.1.6
Week Day
21.4.1.7
LocalTZA (
isUTC
21.4.1.8
LocalTime (
21.4.1.9
UTC (
21.4.1.10
Hours, Minutes, Second, and Milliseconds
21.4.1.11
MakeTime (
hour
min
sec
ms
21.4.1.12
MakeDay (
year
month
date
21.4.1.13
MakeDate (
day
time
21.4.1.14
TimeClip (
time
21.4.1.15
Date Time String Format
21.4.1.15.1
Expanded Years
21.4.2
The Date Constructor
21.4.2.1
Date ( ...
values
21.4.3
Properties of the Date Constructor
21.4.3.1
Date.now ( )
21.4.3.2
Date.parse (
string
21.4.3.3
Date.prototype
21.4.3.4
Date.UTC (
year
[ ,
month
[ ,
date
[ ,
hours
[ ,
minutes
[ ,
seconds
[ ,
ms
] ] ] ] ] ] )
21.4.4
Properties of the Date Prototype Object
21.4.4.1
Date.prototype.constructor
21.4.4.2
Date.prototype.getDate ( )
21.4.4.3
Date.prototype.getDay ( )
21.4.4.4
Date.prototype.getFullYear ( )
21.4.4.5
Date.prototype.getHours ( )
21.4.4.6
Date.prototype.getMilliseconds ( )
21.4.4.7
Date.prototype.getMinutes ( )
21.4.4.8
Date.prototype.getMonth ( )
21.4.4.9
Date.prototype.getSeconds ( )
21.4.4.10
Date.prototype.getTime ( )
21.4.4.11
Date.prototype.getTimezoneOffset ( )
21.4.4.12
Date.prototype.getUTCDate ( )
21.4.4.13
Date.prototype.getUTCDay ( )
21.4.4.14
Date.prototype.getUTCFullYear ( )
21.4.4.15
Date.prototype.getUTCHours ( )
21.4.4.16
Date.prototype.getUTCMilliseconds ( )
21.4.4.17
Date.prototype.getUTCMinutes ( )
21.4.4.18
Date.prototype.getUTCMonth ( )
21.4.4.19
Date.prototype.getUTCSeconds ( )
21.4.4.20
Date.prototype.setDate (
date
21.4.4.21
Date.prototype.setFullYear (
year
[ ,
month
[ ,
date
] ] )
21.4.4.22
Date.prototype.setHours (
hour
[ ,
min
[ ,
sec
[ ,
ms
] ] ] )
21.4.4.23
Date.prototype.setMilliseconds (
ms
21.4.4.24
Date.prototype.setMinutes (
min
[ ,
sec
[ ,
ms
] ] )
21.4.4.25
Date.prototype.setMonth (
month
[ ,
date
] )
21.4.4.26
Date.prototype.setSeconds (
sec
[ ,
ms
] )
21.4.4.27
Date.prototype.setTime (
time
21.4.4.28
Date.prototype.setUTCDate (
date
21.4.4.29
Date.prototype.setUTCFullYear (
year
[ ,
month
[ ,
date
] ] )
21.4.4.30
Date.prototype.setUTCHours (
hour
[ ,
min
[ ,
sec
[ ,
ms
] ] ] )
21.4.4.31
Date.prototype.setUTCMilliseconds (
ms
21.4.4.32
Date.prototype.setUTCMinutes (
min
[ ,
sec
[ ,
ms
] ] )
21.4.4.33
Date.prototype.setUTCMonth (
month
[ ,
date
] )
21.4.4.34
Date.prototype.setUTCSeconds (
sec
[ ,
ms
] )
21.4.4.35
Date.prototype.toDateString ( )
21.4.4.36
Date.prototype.toISOString ( )
21.4.4.37
Date.prototype.toJSON (
key
21.4.4.38
Date.prototype.toLocaleDateString ( [
reserved1
[ ,
reserved2
] ] )
21.4.4.39
Date.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
21.4.4.40
Date.prototype.toLocaleTimeString ( [
reserved1
[ ,
reserved2
] ] )
21.4.4.41
Date.prototype.toString ( )
21.4.4.41.1
TimeString (
tv
21.4.4.41.2
DateString (
tv
21.4.4.41.3
TimeZoneString (
tv
21.4.4.41.4
ToDateString (
tv
21.4.4.42
Date.prototype.toTimeString ( )
21.4.4.43
Date.prototype.toUTCString ( )
21.4.4.44
Date.prototype.valueOf ( )
21.4.4.45
Date.prototype [ @@toPrimitive ] (
hint
21.4.5
Properties of Date Instances
22
Text Processing
22.1
String Objects
22.1.1
The String Constructor
22.1.1.1
String (
value
22.1.2
Properties of the String Constructor
22.1.2.1
String.fromCharCode ( ...
codeUnits
22.1.2.2
String.fromCodePoint ( ...
codePoints
22.1.2.3
String.prototype
22.1.2.4
String.raw (
template
, ...
substitutions
22.1.3
Properties of the String Prototype Object
22.1.3.1
String.prototype.charAt (
pos
22.1.3.2
String.prototype.charCodeAt (
pos
22.1.3.3
String.prototype.codePointAt (
pos
22.1.3.4
String.prototype.concat ( ...
args
22.1.3.5
String.prototype.constructor
22.1.3.6
String.prototype.endsWith (
searchString
[ ,
endPosition
] )
22.1.3.7
String.prototype.includes (
searchString
[ ,
position
] )
22.1.3.8
String.prototype.indexOf (
searchString
[ ,
position
] )
22.1.3.9
String.prototype.lastIndexOf (
searchString
[ ,
position
] )
22.1.3.10
String.prototype.localeCompare (
that
[ ,
reserved1
[ ,
reserved2
] ] )
22.1.3.11
String.prototype.match (
regexp
22.1.3.12
String.prototype.matchAll (
regexp
22.1.3.13
String.prototype.normalize ( [
form
] )
22.1.3.14
String.prototype.padEnd (
maxLength
[ ,
fillString
] )
22.1.3.15
String.prototype.padStart (
maxLength
[ ,
fillString
] )
22.1.3.15.1
StringPad (
maxLength
fillString
placement
22.1.3.16
String.prototype.repeat (
count
22.1.3.17
String.prototype.replace (
searchValue
replaceValue
22.1.3.17.1
GetSubstitution (
matched
str
position
captures
namedCaptures
replacement
22.1.3.18
String.prototype.replaceAll (
searchValue
replaceValue
22.1.3.19
String.prototype.search (
regexp
22.1.3.20
String.prototype.slice (
start
end
22.1.3.21
String.prototype.split (
separator
limit
22.1.3.21.1
SplitMatch (
22.1.3.22
String.prototype.startsWith (
searchString
[ ,
position
] )
22.1.3.23
String.prototype.substring (
start
end
22.1.3.24
String.prototype.toLocaleLowerCase ( [
reserved1
[ ,
reserved2
] ] )
22.1.3.25
String.prototype.toLocaleUpperCase ( [
reserved1
[ ,
reserved2
] ] )
22.1.3.26
String.prototype.toLowerCase ( )
22.1.3.27
String.prototype.toString ( )
22.1.3.28
String.prototype.toUpperCase ( )
22.1.3.29
String.prototype.trim ( )
22.1.3.29.1
TrimString (
string
where
22.1.3.30
String.prototype.trimEnd ( )
22.1.3.31
String.prototype.trimStart ( )
22.1.3.32
String.prototype.valueOf ( )
22.1.3.33
String.prototype [ @@iterator ] ( )
22.1.4
Properties of String Instances
22.1.4.1
length
22.1.5
String Iterator Objects
22.1.5.1
The %StringIteratorPrototype% Object
22.1.5.1.1
%StringIteratorPrototype%.next ( )
22.1.5.1.2
%StringIteratorPrototype% [ @@toStringTag ]
22.2
RegExp (Regular Expression) Objects
22.2.1
Patterns
22.2.1.1
SS: Early Errors
22.2.1.2
SS: CapturingGroupNumber
22.2.1.3
SS: IsCharacterClass
22.2.1.4
SS: CharacterValue
22.2.1.5
SS: SourceText
22.2.1.6
SS: CapturingGroupName
22.2.2
Pattern Semantics
22.2.2.1
Notation
22.2.2.2
Pattern
22.2.2.3
Disjunction
22.2.2.4
Alternative
22.2.2.5
Term
22.2.2.5.1
RepeatMatcher (
min
max
greedy
parenIndex
parenCount
22.2.2.6
Assertion
22.2.2.6.1
IsWordChar (
22.2.2.7
Quantifier
22.2.2.8
Atom
22.2.2.8.1
CharacterSetMatcher (
invert
direction
22.2.2.8.2
Canonicalize (
ch
22.2.2.8.3
UnicodeMatchProperty (
22.2.2.8.4
UnicodeMatchPropertyValue (
22.2.2.9
AtomEscape
22.2.2.9.1
BackreferenceMatcher (
direction
22.2.2.10
CharacterEscape
22.2.2.11
DecimalEscape
22.2.2.12
CharacterClassEscape
22.2.2.13
CharacterClass
22.2.2.14
ClassRanges
22.2.2.15
NonemptyClassRanges
22.2.2.15.1
CharacterRange (
22.2.2.16
NonemptyClassRangesNoDash
22.2.2.17
ClassAtom
22.2.2.18
ClassAtomNoDash
22.2.2.19
ClassEscape
22.2.3
The RegExp Constructor
22.2.3.1
RegExp (
pattern
flags
22.2.3.2
Abstract Operations for the RegExp Constructor
22.2.3.2.1
RegExpAlloc (
newTarget
22.2.3.2.2
RegExpInitialize (
obj
pattern
flags
22.2.3.2.3
SS: ParsePattern (
patternText
22.2.3.2.4
RegExpCreate (
22.2.3.2.5
EscapeRegExpPattern (
22.2.4
Properties of the RegExp Constructor
22.2.4.1
RegExp.prototype
22.2.4.2
get RegExp [ @@species ]
22.2.5
Properties of the RegExp Prototype Object
22.2.5.1
RegExp.prototype.constructor
22.2.5.2
RegExp.prototype.exec (
string
22.2.5.2.1
RegExpExec (
22.2.5.2.2
RegExpBuiltinExec (
22.2.5.2.3
AdvanceStringIndex (
index
unicode
22.2.5.3
get RegExp.prototype.dotAll
22.2.5.4
get RegExp.prototype.flags
22.2.5.5
get RegExp.prototype.global
22.2.5.6
get RegExp.prototype.ignoreCase
22.2.5.7
RegExp.prototype [ @@match ] (
string
22.2.5.8
RegExp.prototype [ @@matchAll ] (
string
22.2.5.9
get RegExp.prototype.multiline
22.2.5.10
RegExp.prototype [ @@replace ] (
string
replaceValue
22.2.5.11
RegExp.prototype [ @@search ] (
string
22.2.5.12
get RegExp.prototype.source
22.2.5.13
RegExp.prototype [ @@split ] (
string
limit
22.2.5.14
get RegExp.prototype.sticky
22.2.5.15
RegExp.prototype.test (
22.2.5.16
RegExp.prototype.toString ( )
22.2.5.17
get RegExp.prototype.unicode
22.2.6
Properties of RegExp Instances
22.2.6.1
lastIndex
22.2.7
RegExp String Iterator Objects
22.2.7.1
CreateRegExpStringIterator (
global
fullUnicode
22.2.7.2
The %RegExpStringIteratorPrototype% Object
22.2.7.2.1
%RegExpStringIteratorPrototype%.next ( )
22.2.7.2.2
%RegExpStringIteratorPrototype% [ @@toStringTag ]
23
Indexed Collections
23.1
Array Objects
23.1.1
The Array Constructor
23.1.1.1
Array ( ...
values
23.1.2
Properties of the Array Constructor
23.1.2.1
Array.from (
items
[ ,
mapfn
[ ,
thisArg
] ] )
23.1.2.2
Array.isArray (
arg
23.1.2.3
Array.of ( ...
items
23.1.2.4
Array.prototype
23.1.2.5
get Array [ @@species ]
23.1.3
Properties of the Array Prototype Object
23.1.3.1
Array.prototype.concat ( ...
items
23.1.3.1.1
IsConcatSpreadable (
23.1.3.2
Array.prototype.constructor
23.1.3.3
Array.prototype.copyWithin (
target
start
[ ,
end
] )
23.1.3.4
Array.prototype.entries ( )
23.1.3.5
Array.prototype.every (
callbackfn
[ ,
thisArg
] )
23.1.3.6
Array.prototype.fill (
value
[ ,
start
[ ,
end
] ] )
23.1.3.7
Array.prototype.filter (
callbackfn
[ ,
thisArg
] )
23.1.3.8
Array.prototype.find (
predicate
[ ,
thisArg
] )
23.1.3.9
Array.prototype.findIndex (
predicate
[ ,
thisArg
] )
23.1.3.10
Array.prototype.flat ( [
depth
] )
23.1.3.10.1
FlattenIntoArray (
target
source
sourceLen
start
depth
[ ,
mapperFunction
thisArg
] )
23.1.3.11
Array.prototype.flatMap (
mapperFunction
[ ,
thisArg
] )
23.1.3.12
Array.prototype.forEach (
callbackfn
[ ,
thisArg
] )
23.1.3.13
Array.prototype.includes (
searchElement
[ ,
fromIndex
] )
23.1.3.14
Array.prototype.indexOf (
searchElement
[ ,
fromIndex
] )
23.1.3.15
Array.prototype.join (
separator
23.1.3.16
Array.prototype.keys ( )
23.1.3.17
Array.prototype.lastIndexOf (
searchElement
[ ,
fromIndex
] )
23.1.3.18
Array.prototype.map (
callbackfn
[ ,
thisArg
] )
23.1.3.19
Array.prototype.pop ( )
23.1.3.20
Array.prototype.push ( ...
items
23.1.3.21
Array.prototype.reduce (
callbackfn
[ ,
initialValue
] )
23.1.3.22
Array.prototype.reduceRight (
callbackfn
[ ,
initialValue
] )
23.1.3.23
Array.prototype.reverse ( )
23.1.3.24
Array.prototype.shift ( )
23.1.3.25
Array.prototype.slice (
start
end
23.1.3.26
Array.prototype.some (
callbackfn
[ ,
thisArg
] )
23.1.3.27
Array.prototype.sort (
comparefn
23.1.3.27.1
SortCompare (
23.1.3.28
Array.prototype.splice (
start
deleteCount
, ...
items
23.1.3.29
Array.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
23.1.3.30
Array.prototype.toString ( )
23.1.3.31
Array.prototype.unshift ( ...
items
23.1.3.32
Array.prototype.values ( )
23.1.3.33
Array.prototype [ @@iterator ] ( )
23.1.3.34
Array.prototype [ @@unscopables ]
23.1.4
Properties of Array Instances
23.1.4.1
length
23.1.5
Array Iterator Objects
23.1.5.1
CreateArrayIterator (
array
kind
23.1.5.2
The %ArrayIteratorPrototype% Object
23.1.5.2.1
%ArrayIteratorPrototype%.next ( )
23.1.5.2.2
%ArrayIteratorPrototype% [ @@toStringTag ]
23.2
TypedArray Objects
23.2.1
The %TypedArray% Intrinsic Object
23.2.1.1
%TypedArray% ( )
23.2.2
Properties of the %TypedArray% Intrinsic Object
23.2.2.1
%TypedArray%.from (
source
[ ,
mapfn
[ ,
thisArg
] ] )
23.2.2.2
%TypedArray%.of ( ...
items
23.2.2.3
%TypedArray%.prototype
23.2.2.4
get %TypedArray% [ @@species ]
23.2.3
Properties of the %TypedArray% Prototype Object
23.2.3.1
get %TypedArray%.prototype.buffer
23.2.3.2
get %TypedArray%.prototype.byteLength
23.2.3.3
get %TypedArray%.prototype.byteOffset
23.2.3.4
%TypedArray%.prototype.constructor
23.2.3.5
%TypedArray%.prototype.copyWithin (
target
start
[ ,
end
] )
23.2.3.6
%TypedArray%.prototype.entries ( )
23.2.3.7
%TypedArray%.prototype.every (
callbackfn
[ ,
thisArg
] )
23.2.3.8
%TypedArray%.prototype.fill (
value
[ ,
start
[ ,
end
] ] )
23.2.3.9
%TypedArray%.prototype.filter (
callbackfn
[ ,
thisArg
] )
23.2.3.10
%TypedArray%.prototype.find (
predicate
[ ,
thisArg
] )
23.2.3.11
%TypedArray%.prototype.findIndex (
predicate
[ ,
thisArg
] )
23.2.3.12
%TypedArray%.prototype.forEach (
callbackfn
[ ,
thisArg
] )
23.2.3.13
%TypedArray%.prototype.includes (
searchElement
[ ,
fromIndex
] )
23.2.3.14
%TypedArray%.prototype.indexOf (
searchElement
[ ,
fromIndex
] )
23.2.3.15
%TypedArray%.prototype.join (
separator
23.2.3.16
%TypedArray%.prototype.keys ( )
23.2.3.17
%TypedArray%.prototype.lastIndexOf (
searchElement
[ ,
fromIndex
] )
23.2.3.18
get %TypedArray%.prototype.length
23.2.3.19
%TypedArray%.prototype.map (
callbackfn
[ ,
thisArg
] )
23.2.3.20
%TypedArray%.prototype.reduce (
callbackfn
[ ,
initialValue
] )
23.2.3.21
%TypedArray%.prototype.reduceRight (
callbackfn
[ ,
initialValue
] )
23.2.3.22
%TypedArray%.prototype.reverse ( )
23.2.3.23
%TypedArray%.prototype.set (
source
[ ,
offset
] )
23.2.3.23.1
SetTypedArrayFromTypedArray (
target
targetOffset
source
23.2.3.23.2
SetTypedArrayFromArrayLike (
target
targetOffset
source
23.2.3.24
%TypedArray%.prototype.slice (
start
end
23.2.3.25
%TypedArray%.prototype.some (
callbackfn
[ ,
thisArg
] )
23.2.3.26
%TypedArray%.prototype.sort (
comparefn
23.2.3.27
%TypedArray%.prototype.subarray (
begin
end
23.2.3.28
%TypedArray%.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
23.2.3.29
%TypedArray%.prototype.toString ( )
23.2.3.30
%TypedArray%.prototype.values ( )
23.2.3.31
%TypedArray%.prototype [ @@iterator ] ( )
23.2.3.32
get %TypedArray%.prototype [ @@toStringTag ]
23.2.4
Abstract Operations for TypedArray Objects
23.2.4.1
TypedArraySpeciesCreate (
exemplar
argumentList
23.2.4.2
TypedArrayCreate (
constructor
argumentList
23.2.4.3
ValidateTypedArray (
23.2.5
The
TypedArray
Constructors
23.2.5.1
TypedArray
( ...
args
23.2.5.1.1
AllocateTypedArray (
constructorName
newTarget
defaultProto
[ ,
length
] )
23.2.5.1.2
InitializeTypedArrayFromTypedArray (
srcArray
23.2.5.1.3
InitializeTypedArrayFromArrayBuffer (
buffer
byteOffset
length
23.2.5.1.4
InitializeTypedArrayFromList (
values
23.2.5.1.5
InitializeTypedArrayFromArrayLike (
arrayLike
23.2.5.1.6
AllocateTypedArrayBuffer (
length
23.2.6
Properties of the
TypedArray
Constructors
23.2.6.1
TypedArray
.BYTES_PER_ELEMENT
23.2.6.2
TypedArray
.prototype
23.2.7
Properties of the
TypedArray
Prototype Objects
23.2.7.1
TypedArray
.prototype.BYTES_PER_ELEMENT
23.2.7.2
TypedArray
.prototype.constructor
23.2.8
Properties of
TypedArray
Instances
24
Keyed Collections
24.1
Map Objects
24.1.1
The Map Constructor
24.1.1.1
Map ( [
iterable
] )
24.1.1.2
AddEntriesFromIterable (
target
iterable
adder
24.1.2
Properties of the Map Constructor
24.1.2.1
Map.prototype
24.1.2.2
get Map [ @@species ]
24.1.3
Properties of the Map Prototype Object
24.1.3.1
Map.prototype.clear ( )
24.1.3.2
Map.prototype.constructor
24.1.3.3
Map.prototype.delete (
key
24.1.3.4
Map.prototype.entries ( )
24.1.3.5
Map.prototype.forEach (
callbackfn
[ ,
thisArg
] )
24.1.3.6
Map.prototype.get (
key
24.1.3.7
Map.prototype.has (
key
24.1.3.8
Map.prototype.keys ( )
24.1.3.9
Map.prototype.set (
key
value
24.1.3.10
get Map.prototype.size
24.1.3.11
Map.prototype.values ( )
24.1.3.12
Map.prototype [ @@iterator ] ( )
24.1.3.13
Map.prototype [ @@toStringTag ]
24.1.4
Properties of Map Instances
24.1.5
Map Iterator Objects
24.1.5.1
CreateMapIterator (
map
kind
24.1.5.2
The %MapIteratorPrototype% Object
24.1.5.2.1
%MapIteratorPrototype%.next ( )
24.1.5.2.2
%MapIteratorPrototype% [ @@toStringTag ]
24.2
Set Objects
24.2.1
The Set Constructor
24.2.1.1
Set ( [
iterable
] )
24.2.2
Properties of the Set Constructor
24.2.2.1
Set.prototype
24.2.2.2
get Set [ @@species ]
24.2.3
Properties of the Set Prototype Object
24.2.3.1
Set.prototype.add (
value
24.2.3.2
Set.prototype.clear ( )
24.2.3.3
Set.prototype.constructor
24.2.3.4
Set.prototype.delete (
value
24.2.3.5
Set.prototype.entries ( )
24.2.3.6
Set.prototype.forEach (
callbackfn
[ ,
thisArg
] )
24.2.3.7
Set.prototype.has (
value
24.2.3.8
Set.prototype.keys ( )
24.2.3.9
get Set.prototype.size
24.2.3.10
Set.prototype.values ( )
24.2.3.11
Set.prototype [ @@iterator ] ( )
24.2.3.12
Set.prototype [ @@toStringTag ]
24.2.4
Properties of Set Instances
24.2.5
Set Iterator Objects
24.2.5.1
CreateSetIterator (
set
kind
24.2.5.2
The %SetIteratorPrototype% Object
24.2.5.2.1
%SetIteratorPrototype%.next ( )
24.2.5.2.2
%SetIteratorPrototype% [ @@toStringTag ]
24.3
WeakMap Objects
24.3.1
The WeakMap Constructor
24.3.1.1
WeakMap ( [
iterable
] )
24.3.2
Properties of the WeakMap Constructor
24.3.2.1
WeakMap.prototype
24.3.3
Properties of the WeakMap Prototype Object
24.3.3.1
WeakMap.prototype.constructor
24.3.3.2
WeakMap.prototype.delete (
key
24.3.3.3
WeakMap.prototype.get (
key
24.3.3.4
WeakMap.prototype.has (
key
24.3.3.5
WeakMap.prototype.set (
key
value
24.3.3.6
WeakMap.prototype [ @@toStringTag ]
24.3.4
Properties of WeakMap Instances
24.4
WeakSet Objects
24.4.1
The WeakSet Constructor
24.4.1.1
WeakSet ( [
iterable
] )
24.4.2
Properties of the WeakSet Constructor
24.4.2.1
WeakSet.prototype
24.4.3
Properties of the WeakSet Prototype Object
24.4.3.1
WeakSet.prototype.add (
value
24.4.3.2
WeakSet.prototype.constructor
24.4.3.3
WeakSet.prototype.delete (
value
24.4.3.4
WeakSet.prototype.has (
value
24.4.3.5
WeakSet.prototype [ @@toStringTag ]
24.4.4
Properties of WeakSet Instances
25
Structured Data
25.1
ArrayBuffer Objects
25.1.1
Notation
25.1.2
Abstract Operations For ArrayBuffer Objects
25.1.2.1
AllocateArrayBuffer (
constructor
byteLength
25.1.2.2
IsDetachedBuffer (
arrayBuffer
25.1.2.3
DetachArrayBuffer (
arrayBuffer
[ ,
key
] )
25.1.2.4
CloneArrayBuffer (
srcBuffer
srcByteOffset
srcLength
cloneConstructor
25.1.2.5
IsUnsignedElementType (
type
25.1.2.6
IsUnclampedIntegerElementType (
type
25.1.2.7
IsBigIntElementType (
type
25.1.2.8
IsNoTearConfiguration (
type
order
25.1.2.9
RawBytesToNumeric (
type
rawBytes
isLittleEndian
25.1.2.10
GetValueFromBuffer (
arrayBuffer
byteIndex
type
isTypedArray
order
[ ,
isLittleEndian
] )
25.1.2.11
NumericToRawBytes (
type
value
isLittleEndian
25.1.2.12
SetValueInBuffer (
arrayBuffer
byteIndex
type
value
isTypedArray
order
[ ,
isLittleEndian
] )
25.1.2.13
GetModifySetValueInBuffer (
arrayBuffer
byteIndex
type
value
op
[ ,
isLittleEndian
] )
25.1.3
The ArrayBuffer Constructor
25.1.3.1
ArrayBuffer (
length
25.1.4
Properties of the ArrayBuffer Constructor
25.1.4.1
ArrayBuffer.isView (
arg
25.1.4.2
ArrayBuffer.prototype
25.1.4.3
get ArrayBuffer [ @@species ]
25.1.5
Properties of the ArrayBuffer Prototype Object
25.1.5.1
get ArrayBuffer.prototype.byteLength
25.1.5.2
ArrayBuffer.prototype.constructor
25.1.5.3
ArrayBuffer.prototype.slice (
start
end
25.1.5.4
ArrayBuffer.prototype [ @@toStringTag ]
25.1.6
Properties of ArrayBuffer Instances
25.2
SharedArrayBuffer Objects
25.2.1
Abstract Operations for SharedArrayBuffer Objects
25.2.1.1
AllocateSharedArrayBuffer (
constructor
byteLength
25.2.1.2
IsSharedArrayBuffer (
obj
25.2.2
The SharedArrayBuffer Constructor
25.2.2.1
SharedArrayBuffer ( [
length
] )
25.2.3
Properties of the SharedArrayBuffer Constructor
25.2.3.1
SharedArrayBuffer.prototype
25.2.3.2
get SharedArrayBuffer [ @@species ]
25.2.4
Properties of the SharedArrayBuffer Prototype Object
25.2.4.1
get SharedArrayBuffer.prototype.byteLength
25.2.4.2
SharedArrayBuffer.prototype.constructor
25.2.4.3
SharedArrayBuffer.prototype.slice (
start
end
25.2.4.4
SharedArrayBuffer.prototype [ @@toStringTag ]
25.2.5
Properties of SharedArrayBuffer Instances
25.3
DataView Objects
25.3.1
Abstract Operations For DataView Objects
25.3.1.1
GetViewValue (
view
requestIndex
isLittleEndian
type
25.3.1.2
SetViewValue (
view
requestIndex
isLittleEndian
type
value
25.3.2
The DataView Constructor
25.3.2.1
DataView (
buffer
[ ,
byteOffset
[ ,
byteLength
] ] )
25.3.3
Properties of the DataView Constructor
25.3.3.1
DataView.prototype
25.3.4
Properties of the DataView Prototype Object
25.3.4.1
get DataView.prototype.buffer
25.3.4.2
get DataView.prototype.byteLength
25.3.4.3
get DataView.prototype.byteOffset
25.3.4.4
DataView.prototype.constructor
25.3.4.5
DataView.prototype.getBigInt64 (
byteOffset
[ ,
littleEndian
] )
25.3.4.6
DataView.prototype.getBigUint64 (
byteOffset
[ ,
littleEndian
] )
25.3.4.7
DataView.prototype.getFloat32 (
byteOffset
[ ,
littleEndian
] )
25.3.4.8
DataView.prototype.getFloat64 (
byteOffset
[ ,
littleEndian
] )
25.3.4.9
DataView.prototype.getInt8 (
byteOffset
25.3.4.10
DataView.prototype.getInt16 (
byteOffset
[ ,
littleEndian
] )
25.3.4.11
DataView.prototype.getInt32 (
byteOffset
[ ,
littleEndian
] )
25.3.4.12
DataView.prototype.getUint8 (
byteOffset
25.3.4.13
DataView.prototype.getUint16 (
byteOffset
[ ,
littleEndian
] )
25.3.4.14
DataView.prototype.getUint32 (
byteOffset
[ ,
littleEndian
] )
25.3.4.15
DataView.prototype.setBigInt64 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.16
DataView.prototype.setBigUint64 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.17
DataView.prototype.setFloat32 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.18
DataView.prototype.setFloat64 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.19
DataView.prototype.setInt8 (
byteOffset
value
25.3.4.20
DataView.prototype.setInt16 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.21
DataView.prototype.setInt32 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.22
DataView.prototype.setUint8 (
byteOffset
value
25.3.4.23
DataView.prototype.setUint16 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.24
DataView.prototype.setUint32 (
byteOffset
value
[ ,
littleEndian
] )
25.3.4.25
DataView.prototype [ @@toStringTag ]
25.3.5
Properties of DataView Instances
25.4
The Atomics Object
25.4.1
Abstract Operations for Atomics
25.4.1.1
ValidateIntegerTypedArray (
typedArray
[ ,
waitable
] )
25.4.1.2
ValidateAtomicAccess (
typedArray
requestIndex
25.4.1.3
GetWaiterList (
block
25.4.1.4
EnterCriticalSection (
WL
25.4.1.5
LeaveCriticalSection (
WL
25.4.1.6
AddWaiter (
WL
25.4.1.7
RemoveWaiter (
WL
25.4.1.8
RemoveWaiters (
WL
25.4.1.9
SuspendAgent (
WL
timeout
25.4.1.10
NotifyWaiter (
WL
25.4.1.11
AtomicReadModifyWrite (
typedArray
index
value
op
25.4.1.12
ByteListBitwiseOp (
op
xBytes
yBytes
25.4.1.13
ByteListEqual (
xBytes
yBytes
25.4.2
Atomics.add (
typedArray
index
value
25.4.3
Atomics.and (
typedArray
index
value
25.4.4
Atomics.compareExchange (
typedArray
index
expectedValue
replacementValue
25.4.5
Atomics.exchange (
typedArray
index
value
25.4.6
Atomics.isLockFree (
size
25.4.7
Atomics.load (
typedArray
index
25.4.8
Atomics.or (
typedArray
index
value
25.4.9
Atomics.store (
typedArray
index
value
25.4.10
Atomics.sub (
typedArray
index
value
25.4.11
Atomics.wait (
typedArray
index
value
timeout
25.4.12
Atomics.notify (
typedArray
index
count
25.4.13
Atomics.xor (
typedArray
index
value
25.4.14
Atomics [ @@toStringTag ]
25.5
The JSON Object
25.5.1
JSON.parse (
text
[ ,
reviver
] )
25.5.1.1
InternalizeJSONProperty (
holder
name
reviver
25.5.2
JSON.stringify (
value
[ ,
replacer
[ ,
space
] ] )
25.5.2.1
SerializeJSONProperty (
state
key
holder
25.5.2.2
QuoteJSONString (
value
25.5.2.3
UnicodeEscape (
25.5.2.4
SerializeJSONObject (
state
value
25.5.2.5
SerializeJSONArray (
state
value
25.5.3
JSON [ @@toStringTag ]
26
Managing Memory
26.1
WeakRef Objects
26.1.1
The WeakRef Constructor
26.1.1.1
WeakRef (
target
26.1.2
Properties of the WeakRef Constructor
26.1.2.1
WeakRef.prototype
26.1.3
Properties of the WeakRef Prototype Object
26.1.3.1
WeakRef.prototype.constructor
26.1.3.2
WeakRef.prototype.deref ( )
26.1.3.3
WeakRef.prototype [ @@toStringTag ]
26.1.4
WeakRef Abstract Operations
26.1.4.1
WeakRefDeref (
weakRef
26.1.5
Properties of WeakRef Instances
26.2
FinalizationRegistry Objects
26.2.1
The FinalizationRegistry Constructor
26.2.1.1
FinalizationRegistry (
cleanupCallback
26.2.2
Properties of the FinalizationRegistry Constructor
26.2.2.1
FinalizationRegistry.prototype
26.2.3
Properties of the FinalizationRegistry Prototype Object
26.2.3.1
FinalizationRegistry.prototype.constructor
26.2.3.2
FinalizationRegistry.prototype.register (
target
heldValue
[ ,
unregisterToken
] )
26.2.3.3
FinalizationRegistry.prototype.unregister (
unregisterToken
26.2.3.4
FinalizationRegistry.prototype [ @@toStringTag ]
26.2.4
Properties of FinalizationRegistry Instances
27
Control Abstraction Objects
27.1
Iteration
27.1.1
Common Iteration Interfaces
27.1.1.1
The
Iterable
Interface
27.1.1.2
The
Iterator
Interface
27.1.1.3
The
AsyncIterable
Interface
27.1.1.4
The
AsyncIterator
Interface
27.1.1.5
The
IteratorResult
Interface
27.1.2
The %IteratorPrototype% Object
27.1.2.1
%IteratorPrototype% [ @@iterator ] ( )
27.1.3
The %AsyncIteratorPrototype% Object
27.1.3.1
%AsyncIteratorPrototype% [ @@asyncIterator ] ( )
27.1.4
Async-from-Sync Iterator Objects
27.1.4.1
CreateAsyncFromSyncIterator (
syncIteratorRecord
27.1.4.2
The %AsyncFromSyncIteratorPrototype% Object
27.1.4.2.1
%AsyncFromSyncIteratorPrototype%.next ( [
value
] )
27.1.4.2.2
%AsyncFromSyncIteratorPrototype%.return ( [
value
] )
27.1.4.2.3
%AsyncFromSyncIteratorPrototype%.throw ( [
value
] )
27.1.4.2.4
Async-from-Sync Iterator Value Unwrap Functions
27.1.4.3
Properties of Async-from-Sync Iterator Instances
27.1.4.4
AsyncFromSyncIteratorContinuation (
result
promiseCapability
27.2
Promise Objects
27.2.1
Promise Abstract Operations
27.2.1.1
PromiseCapability Records
27.2.1.1.1
IfAbruptRejectPromise (
value
capability
27.2.1.2
PromiseReaction Records
27.2.1.3
CreateResolvingFunctions (
promise
27.2.1.3.1
Promise Reject Functions
27.2.1.3.2
Promise Resolve Functions
27.2.1.4
FulfillPromise (
promise
value
27.2.1.5
NewPromiseCapability (
27.2.1.5.1
GetCapabilitiesExecutor Functions
27.2.1.6
IsPromise (
27.2.1.7
RejectPromise (
promise
reason
27.2.1.8
TriggerPromiseReactions (
reactions
argument
27.2.1.9
HostPromiseRejectionTracker (
promise
operation
27.2.2
Promise Jobs
27.2.2.1
NewPromiseReactionJob (
reaction
argument
27.2.2.2
NewPromiseResolveThenableJob (
promiseToResolve
thenable
then
27.2.3
The Promise Constructor
27.2.3.1
Promise (
executor
27.2.4
Properties of the Promise Constructor
27.2.4.1
Promise.all (
iterable
27.2.4.1.1
GetPromiseResolve (
promiseConstructor
27.2.4.1.2
PerformPromiseAll (
iteratorRecord
constructor
resultCapability
promiseResolve
27.2.4.1.3
Promise.all
Resolve Element Functions
27.2.4.2
Promise.allSettled (
iterable
27.2.4.2.1
PerformPromiseAllSettled (
iteratorRecord
constructor
resultCapability
promiseResolve
27.2.4.2.2
Promise.allSettled
Resolve Element Functions
27.2.4.2.3
Promise.allSettled
Reject Element Functions
27.2.4.3
Promise.any (
iterable
27.2.4.3.1
PerformPromiseAny (
iteratorRecord
constructor
resultCapability
promiseResolve
27.2.4.3.2
Promise.any
Reject Element Functions
27.2.4.4
Promise.prototype
27.2.4.5
Promise.race (
iterable
27.2.4.5.1
PerformPromiseRace (
iteratorRecord
constructor
resultCapability
promiseResolve
27.2.4.6
Promise.reject (
27.2.4.7
Promise.resolve (
27.2.4.7.1
PromiseResolve (
27.2.4.8
get Promise [ @@species ]
27.2.5
Properties of the Promise Prototype Object
27.2.5.1
Promise.prototype.catch (
onRejected
27.2.5.2
Promise.prototype.constructor
27.2.5.3
Promise.prototype.finally (
onFinally
27.2.5.3.1
Then Finally Functions
27.2.5.3.2
Catch Finally Functions
27.2.5.4
Promise.prototype.then (
onFulfilled
onRejected
27.2.5.4.1
PerformPromiseThen (
promise
onFulfilled
onRejected
[ ,
resultCapability
] )
27.2.5.5
Promise.prototype [ @@toStringTag ]
27.2.6
Properties of Promise Instances
27.3
GeneratorFunction Objects
27.3.1
The GeneratorFunction Constructor
27.3.1.1
GeneratorFunction (
p1
p2
, … ,
pn
body
27.3.2
Properties of the GeneratorFunction Constructor
27.3.2.1
GeneratorFunction.length
27.3.2.2
GeneratorFunction.prototype
27.3.3
Properties of the GeneratorFunction Prototype Object
27.3.3.1
GeneratorFunction.prototype.constructor
27.3.3.2
GeneratorFunction.prototype.prototype
27.3.3.3
GeneratorFunction.prototype [ @@toStringTag ]
27.3.4
GeneratorFunction Instances
27.3.4.1
length
27.3.4.2
name
27.3.4.3
prototype
27.4
AsyncGeneratorFunction Objects
27.4.1
The AsyncGeneratorFunction Constructor
27.4.1.1
AsyncGeneratorFunction (
p1
p2
, … ,
pn
body
27.4.2
Properties of the AsyncGeneratorFunction Constructor
27.4.2.1
AsyncGeneratorFunction.length
27.4.2.2
AsyncGeneratorFunction.prototype
27.4.3
Properties of the AsyncGeneratorFunction Prototype Object
27.4.3.1
AsyncGeneratorFunction.prototype.constructor
27.4.3.2
AsyncGeneratorFunction.prototype.prototype
27.4.3.3
AsyncGeneratorFunction.prototype [ @@toStringTag ]
27.4.4
AsyncGeneratorFunction Instances
27.4.4.1
length
27.4.4.2
name
27.4.4.3
prototype
27.5
Generator Objects
27.5.1
Properties of the Generator Prototype Object
27.5.1.1
Generator.prototype.constructor
27.5.1.2
Generator.prototype.next (
value
27.5.1.3
Generator.prototype.return (
value
27.5.1.4
Generator.prototype.throw (
exception
27.5.1.5
Generator.prototype [ @@toStringTag ]
27.5.2
Properties of Generator Instances
27.5.3
Generator Abstract Operations
27.5.3.1
GeneratorStart (
generator
generatorBody
27.5.3.2
GeneratorValidate (
generator
generatorBrand
27.5.3.3
GeneratorResume (
generator
value
generatorBrand
27.5.3.4
GeneratorResumeAbrupt (
generator
abruptCompletion
generatorBrand
27.5.3.5
GetGeneratorKind ( )
27.5.3.6
GeneratorYield (
iterNextObj
27.5.3.7
Yield (
value
27.5.3.8
CreateIteratorFromClosure (
closure
generatorBrand
generatorPrototype
27.6
AsyncGenerator Objects
27.6.1
Properties of the AsyncGenerator Prototype Object
27.6.1.1
AsyncGenerator.prototype.constructor
27.6.1.2
AsyncGenerator.prototype.next (
value
27.6.1.3
AsyncGenerator.prototype.return (
value
27.6.1.4
AsyncGenerator.prototype.throw (
exception
27.6.1.5
AsyncGenerator.prototype [ @@toStringTag ]
27.6.2
Properties of AsyncGenerator Instances
27.6.3
AsyncGenerator Abstract Operations
27.6.3.1
AsyncGeneratorRequest Records
27.6.3.2
AsyncGeneratorStart (
generator
generatorBody
27.6.3.3
AsyncGeneratorValidate (
generator
generatorBrand
27.6.3.4
AsyncGeneratorResolve (
generator
value
done
27.6.3.5
AsyncGeneratorReject (
generator
exception
27.6.3.6
AsyncGeneratorResumeNext (
generator
27.6.3.6.1
AsyncGeneratorResumeNext Return Processor Fulfilled Functions
27.6.3.6.2
AsyncGeneratorResumeNext Return Processor Rejected Functions
27.6.3.7
AsyncGeneratorEnqueue (
generator
completion
generatorBrand
27.6.3.8
AsyncGeneratorYield (
value
27.6.3.9
CreateAsyncIteratorFromClosure (
closure
generatorBrand
generatorPrototype
27.7
AsyncFunction Objects
27.7.1
The AsyncFunction Constructor
27.7.1.1
AsyncFunction (
p1
p2
, … ,
pn
body
27.7.2
Properties of the AsyncFunction Constructor
27.7.2.1
AsyncFunction.length
27.7.2.2
AsyncFunction.prototype
27.7.3
Properties of the AsyncFunction Prototype Object
27.7.3.1
AsyncFunction.prototype.constructor
27.7.3.2
AsyncFunction.prototype [ @@toStringTag ]
27.7.4
AsyncFunction Instances
27.7.4.1
length
27.7.4.2
name
27.7.5
Async Functions Abstract Operations
27.7.5.1
AsyncFunctionStart (
promiseCapability
asyncFunctionBody
28
Reflection
28.1
The Reflect Object
28.1.1
Reflect.apply (
target
thisArgument
argumentsList
28.1.2
Reflect.construct (
target
argumentsList
[ ,
newTarget
] )
28.1.3
Reflect.defineProperty (
target
propertyKey
attributes
28.1.4
Reflect.deleteProperty (
target
propertyKey
28.1.5
Reflect.get (
target
propertyKey
[ ,
receiver
] )
28.1.6
Reflect.getOwnPropertyDescriptor (
target
propertyKey
28.1.7
Reflect.getPrototypeOf (
target
28.1.8
Reflect.has (
target
propertyKey
28.1.9
Reflect.isExtensible (
target
28.1.10
Reflect.ownKeys (
target
28.1.11
Reflect.preventExtensions (
target
28.1.12
Reflect.set (
target
propertyKey
[ ,
receiver
] )
28.1.13
Reflect.setPrototypeOf (
target
proto
28.1.14
Reflect [ @@toStringTag ]
28.2
Proxy Objects
28.2.1
The Proxy Constructor
28.2.1.1
Proxy (
target
handler
28.2.2
Properties of the Proxy Constructor
28.2.2.1
Proxy.revocable (
target
handler
28.2.2.1.1
Proxy Revocation Functions
28.3
Module Namespace Objects
28.3.1
@@toStringTag
29
Memory Model
29.1
Memory Model Fundamentals
29.2
Agent Events Records
29.3
Chosen Value Records
29.4
Candidate Executions
29.5
Abstract Operations for the Memory Model
29.5.1
EventSet (
execution
29.5.2
SharedDataBlockEventSet (
execution
29.5.3
HostEventSet (
execution
29.5.4
ComposeWriteEventBytes (
execution
byteIndex
Ws
29.5.5
ValueOfReadEvent (
execution
29.6
Relations of Candidate Executions
29.6.1
agent-order
29.6.2
reads-bytes-from
29.6.3
reads-from
29.6.4
host-synchronizes-with
29.6.5
synchronizes-with
29.6.6
happens-before
29.7
Properties of Valid Executions
29.7.1
Valid Chosen Reads
29.7.2
Coherent Reads
29.7.3
Tear Free Reads
29.7.4
Sequentially Consistent Atomics
29.7.5
Valid Executions
29.8
Races
29.9
Data Races
29.10
Data Race Freedom
29.11
Shared Memory Guidelines
Grammar Summary
A.1
Lexical Grammar
A.2
Expressions
A.3
Statements
A.4
Functions and Classes
A.5
Scripts and Modules
A.6
Number Conversions
A.7
Universal Resource Identifier Character Classes
A.8
Regular Expressions
Additional ECMAScript Features for Web Browsers
B.1
Additional Syntax
B.1.1
Numeric Literals
B.1.1.1
Static Semantics
B.1.2
String Literals
B.1.2.1
Static Semantics
B.1.3
HTML-like Comments
B.1.4
Regular Expressions Patterns
B.1.4.1
SS: Early Errors
B.1.4.2
SS: IsCharacterClass
B.1.4.3
SS: CharacterValue
B.1.4.4
Pattern Semantics
B.1.4.4.1
CharacterRangeOrUnion (
B.2
Additional Built-in Properties
B.2.1
Additional Properties of the Global Object
B.2.1.1
escape (
string
B.2.1.2
unescape (
string
B.2.2
Additional Properties of the Object.prototype Object
B.2.2.1
Object.prototype.__proto__
B.2.2.1.1
get Object.prototype.__proto__
B.2.2.1.2
set Object.prototype.__proto__
B.2.2.2
Object.prototype.__defineGetter__ (
getter
B.2.2.3
Object.prototype.__defineSetter__ (
setter
B.2.2.4
Object.prototype.__lookupGetter__ (
B.2.2.5
Object.prototype.__lookupSetter__ (
B.2.3
Additional Properties of the String.prototype Object
B.2.3.1
String.prototype.substr (
start
length
B.2.3.2
String.prototype.anchor (
name
B.2.3.2.1
CreateHTML (
string
tag
attribute
value
B.2.3.3
String.prototype.big ( )
B.2.3.4
String.prototype.blink ( )
B.2.3.5
String.prototype.bold ( )
B.2.3.6
String.prototype.fixed ( )
B.2.3.7
String.prototype.fontcolor (
color
B.2.3.8
String.prototype.fontsize (
size
B.2.3.9
String.prototype.italics ( )
B.2.3.10
String.prototype.link (
url
B.2.3.11
String.prototype.small ( )
B.2.3.12
String.prototype.strike ( )
B.2.3.13
String.prototype.sub ( )
B.2.3.14
String.prototype.sup ( )
B.2.3.15
String.prototype.trimLeft ( )
B.2.3.16
String.prototype.trimRight ( )
B.2.4
Additional Properties of the Date.prototype Object
B.2.4.1
Date.prototype.getYear ( )
B.2.4.2
Date.prototype.setYear (
year
B.2.4.3
Date.prototype.toGMTString ( )
B.2.5
Additional Properties of the RegExp.prototype Object
B.2.5.1
RegExp.prototype.compile (
pattern
flags
B.3
Other Additional Features
B.3.1
__proto__ Property Names in Object Initializers
B.3.2
Labelled Function Declarations
B.3.3
Block-Level Function Declarations Web Legacy Compatibility Semantics
B.3.3.1
Changes to FunctionDeclarationInstantiation
B.3.3.2
Changes to GlobalDeclarationInstantiation
B.3.3.3
Changes to EvalDeclarationInstantiation
B.3.3.4
Changes to Block SS: Early Errors
B.3.3.5
Changes to
switch
Statement SS: Early Errors
B.3.3.6
Changes to BlockDeclarationInstantiation
B.3.4
FunctionDeclarations in IfStatement Statement Clauses
B.3.5
VariableStatements in Catch Blocks
B.3.6
Initializers in ForIn Statement Heads
B.3.7
The [[IsHTMLDDA]] Internal Slot
B.3.7.1
Changes to ToBoolean
B.3.7.2
Changes to Abstract Equality Comparison
B.3.7.3
Changes to the
typeof
Operator
The Strict Mode of ECMAScript
Host Layering Points
D.1
Host Hooks
D.2
Host-defined Fields
D.3
Host-defined Objects
D.4
Running Jobs
D.5
Internal Methods of Exotic Objects
D.6
Built-in Objects and Methods
Corrections and Clarifications in ECMAScript 2015 with Possible Compatibility Impact
Additions and Changes That Introduce Incompatibilities with Prior Editions
Colophon
Bibliography
Copyright & Software License
ECMA-262, 12
th
edition, June 2021
ECMAScript® 2021 Language Specification
About this Specification
The document at
is the most accurate and up-to-date ECMAScript specification. It
contains the content of the most recent yearly snapshot plus any
finished proposals
(those that have reached Stage 4 in the
proposal process
and thus are implemented in several implementations and will be in the next practical revision) since that snapshot was taken.
Contributing to this Specification
This specification is developed on GitHub with the help of the
ECMAScript community. There are a number of ways to contribute to the
development of this specification:
GitHub Repository:
Issues:
All Issues
File a New Issue
Pull Requests:
All Pull Requests
Create a New Pull Request
Test Suite:
Test262
Editors:
Jordan Harband
@ljharb
Shu-yu Guo
@_shu
Michael Ficarra
@smooshMap
Kevin Gibbons
@bakkoting
Community:
Discourse:
IRC:
#tc39
on
freenode
Mailing
List
Archives:
Refer to the
colophon
for more information on how this document is created.
Introduction
This Ecma Standard defines the ECMAScript 2021 Language. It is the
twelfth edition of the ECMAScript Language Specification. Since
publication of the first edition in 1997, ECMAScript has grown to be one
of the world's most widely used general-purpose programming languages.
It is best known as the language embedded in web browsers but has also
been widely adopted for server and embedded applications.
ECMAScript is based on several originating technologies, the most
well-known being JavaScript (Netscape) and JScript (Microsoft). The
language was invented by Brendan Eich at Netscape and first appeared in
that company's Navigator 2.0 browser. It has appeared in all subsequent
browsers from Netscape and in all browsers from Microsoft starting with
Internet Explorer 3.0.
The development of the ECMAScript Language Specification started in
November 1996. The first edition of this Ecma Standard was adopted by
the Ecma General Assembly of June 1997.
That Ecma Standard was submitted to ISO/IEC JTC 1 for adoption
under the fast-track procedure, and approved as international standard
ISO/IEC 16262, in April 1998. The Ecma General Assembly of June 1998
approved the second edition of ECMA-262 to keep it fully aligned with
ISO/IEC 16262. Changes between the first and the second edition are
editorial in nature.
The third edition of the Standard introduced powerful regular
expressions, better string handling, new control statements, try/catch
exception handling, tighter definition of errors, formatting for numeric
output and minor changes in anticipation of future language growth. The
third edition of the ECMAScript standard was adopted by the Ecma
General Assembly of December 1999 and published as ISO/IEC 16262:2002 in
June 2002.
After publication of the third edition, ECMAScript achieved massive
adoption in conjunction with the World Wide Web where it has become the
programming language that is supported by essentially all web browsers.
Significant work was done to develop a fourth edition of ECMAScript.
However, that work was not completed and not published as the fourth
edition of ECMAScript but some of it was incorporated into the
development of the sixth edition.
The fifth edition of ECMAScript (published as ECMA-262 5
th
edition) codified de facto interpretations of the language
specification that have become common among browser implementations and
added support for new features that had emerged since the publication of
the third edition. Such features include accessor properties,
reflective creation and inspection of objects, program control of
property attributes, additional array manipulation functions, support
for the JSON object encoding format, and a strict mode that provides
enhanced error checking and program security. The fifth edition was
adopted by the Ecma General Assembly of December 2009.
The fifth edition was submitted to ISO/IEC JTC 1 for adoption under
the fast-track procedure, and approved as international standard
ISO/IEC 16262:2011. Edition 5.1 of the ECMAScript Standard incorporated
minor corrections and is the same text as ISO/IEC 16262:2011. The 5.1
Edition was adopted by the Ecma General Assembly of June 2011.
Focused development of the sixth edition started in 2009, as the
fifth edition was being prepared for publication. However, this was
preceded by significant experimentation and language enhancement design
efforts dating to the publication of the third edition in 1999. In a
very real sense, the completion of the sixth edition is the culmination
of a fifteen year effort. The goals for this edition included providing
better support for large applications, library creation, and for use of
ECMAScript as a compilation target for other languages. Some of its
major enhancements included modules, class declarations, lexical block
scoping, iterators and generators, promises for asynchronous
programming, destructuring patterns, and proper tail calls. The
ECMAScript library of built-ins was expanded to support additional data
abstractions including maps, sets, and arrays of binary numeric values
as well as additional support for Unicode supplemental characters in
strings and regular expressions. The built-ins were also made extensible
via subclassing. The sixth edition provides the foundation for regular,
incremental language and library enhancements. The sixth edition was
adopted by the General Assembly of June 2015.
ECMAScript 2016 was the first ECMAScript edition released under
Ecma TC39's new yearly release cadence and open development process. A
plain-text source document was built from the ECMAScript 2015 source
document to serve as the base for further development entirely on
GitHub. Over the year of this standard's development, hundreds of pull
requests and issues were filed representing thousands of bug fixes,
editorial fixes and other improvements. Additionally, numerous software
tools were developed to aid in this effort including Ecmarkup,
Ecmarkdown, and Grammarkdown. ES2016 also included support for a new
exponentiation operator and adds a new method to
Array.prototype
called
includes
ECMAScript 2017 introduced Async Functions, Shared Memory, and
Atomics along with smaller language and library enhancements, bug fixes,
and editorial updates. Async functions improve the asynchronous
programming experience by providing syntax for promise-returning
functions. Shared Memory and Atomics introduce a new
memory model
that allows multi-
agent
programs to communicate using atomic operations that ensure a
well-defined execution order even on parallel CPUs. It also included new
static methods on Object:
Object.values
Object.entries
, and
Object.getOwnPropertyDescriptors
ECMAScript 2018 introduced support for asynchronous iteration via
the AsyncIterator protocol and async generators. It also included four
new regular expression features: the
dotAll
flag, named
capture groups, Unicode property escapes, and look-behind assertions.
Lastly it included object rest and spread properties.
ECMAScript 2019 introduced a few new built-in functions:
flat
and
flatMap
on
Array.prototype
for flattening arrays,
Object.fromEntries
for directly turning the return value of
Object.entries
into a new Object, and
trimStart
and
trimEnd
on
String.prototype
as better-named alternatives to the widely implemented but non-standard
String.prototype.trimLeft
and
trimRight
built-ins. In addition, it included a few minor updates to syntax and
semantics. Updated syntax included optional catch binding parameters and
allowing U+2028 (LINE SEPARATOR) and U+2029 (PARAGRAPH SEPARATOR) in
string literals to align with JSON. Other updates included requiring
that
Array.prototype.sort
be a stable sort, requiring that
JSON.stringify
return well-formed UTF-8 regardless of input, and clarifying
Function.prototype.toString
by requiring that it either return the corresponding original source text or a standard placeholder.
ECMAScript 2020, the 11
th
edition, introduces the
matchAll
method for Strings, to produce an iterator for all match objects generated by a global regular expression;
import()
, a syntax to asynchronously import Modules with a dynamic specifier;
BigInt
, a new number primitive for working with arbitrary precision integers;
Promise.allSettled
, a new Promise combinator that does not short-circuit;
globalThis
, a universal way to access the global
this
value; dedicated
export * as ns from 'module'
syntax for use within modules; increased standardization of
for-in
enumeration order;
import.meta
, a
host
-populated
object available in Modules that may contain contextual information
about the Module; as well as adding two new syntax features to improve
working with “nullish” values (
null
or
undefined
):
nullish coalescing, a value selection operator; and optional chaining, a
property access and function invocation operator that short-circuits if
the value to access/invoke is nullish.
This specification, the 12
th
edition, introduces the
replaceAll
method for Strings;
Promise.any
, a Promise combinator that short-circuits when an input value is fulfilled;
AggregateError
, a new Error type to represent multiple errors at once; logical assignment operators (
??=
&&=
||=
);
WeakRef
, for referring to a target object without preserving it from garbage collection, and
FinalizationRegistry
to manage registration and unregistration of cleanup operations
performed when target objects are garbage collected; separators for
numeric literals (
1_000
); and
Array.prototype.sort
was made more precise, reducing the amount of cases that result in an
implementation-defined
sort order.
Dozens of individuals representing many organizations have made
very significant contributions within Ecma TC39 to the development of
this edition and to the prior editions. In addition, a vibrant community
has emerged supporting TC39's ECMAScript efforts. This community has
reviewed numerous drafts, filed thousands of bug reports, performed
implementation experiments, contributed test suites, and educated the
world-wide developer community about ECMAScript. Unfortunately, it is
impossible to identify and acknowledge every person and organization who
has contributed to this effort.
Allen Wirfs-Brock
ECMA-262, Project Editor, 6
th
Edition
Brian Terlson
ECMA-262, Project Editor, 7
th
through 10
th
Editions
Jordan Harband
ECMA-262, Project Editor, 10
th
through 12
th
Editions
Scope
This Standard defines the ECMAScript 2021 general-purpose programming language.
Conformance
A conforming implementation of ECMAScript must provide and support
all the types, values, objects, properties, functions, and program
syntax and semantics described in this specification.
A conforming implementation of ECMAScript must interpret source
text input in conformance with the latest version of the Unicode
Standard and ISO/IEC 10646.
A conforming implementation of ECMAScript that provides an
application programming interface (API) that supports programs that need
to adapt to the linguistic and cultural conventions used by different
human languages and countries must implement the interface defined by
the most recent edition of ECMA-402 that is compatible with this
specification.
A conforming implementation of ECMAScript may provide additional
types, values, objects, properties, and functions beyond those described
in this specification. In particular, a conforming implementation of
ECMAScript may provide properties not described in this specification,
and values for those properties, for objects that are described in this
specification.
A conforming implementation of ECMAScript may support program and
regular expression syntax not described in this specification. In
particular, a conforming implementation of ECMAScript may support
program syntax that makes use of any “future reserved words” noted in
subclause
12.6.2
of this specification.
A conforming implementation of ECMAScript must not implement any extension that is listed as a Forbidden Extension in subclause
17.1
A conforming implementation of ECMAScript must not redefine any facilities that are not
implementation-defined
implementation-approximated
, or
host-defined
A conforming implementation of ECMAScript may choose to implement or not implement
Normative Optional
subclauses. If any Normative Optional behaviour is implemented, all of
the behaviour in the containing Normative Optional clause must be
implemented. A Normative Optional clause is denoted in this
specification with the words "Normative Optional" in a coloured box, as
shown below.
Normative Optional
2.1
Example Clause Heading
Example clause contents.
Normative References
The following referenced documents are indispensable for the
application of this document. For dated references, only the edition
cited applies. For undated references, the latest edition of the
referenced document (including any amendments) applies.
ISO/IEC 10646
Information Technology — Universal Multiple-Octet
Coded Character Set (UCS) plus Amendment 1:2005, Amendment 2:2006,
Amendment 3:2008, and Amendment 4:2008
, plus additional amendments and corrigenda, or successor
ECMA-402,
ECMAScript 2015 Internationalization API Specification
ECMA-404,
The JSON Data Interchange Format
Overview
This section contains a non-normative overview of the ECMAScript language.
ECMAScript is an object-oriented programming language for
performing computations and manipulating computational objects within a
host environment
ECMAScript as defined here is not intended to be computationally
self-sufficient; indeed, there are no provisions in this specification
for input of external data or output of computed results. Instead, it is
expected that the computational environment of an ECMAScript program
will provide not only the objects and other facilities described in this
specification but also certain environment-specific objects, whose
description and behaviour are beyond the scope of this specification
except to indicate that they may provide certain properties that can be
accessed and certain functions that can be called from an ECMAScript
program.
ECMAScript was originally designed to be used as a scripting
language, but has become widely used as a general-purpose programming
language. A
scripting language
is a programming language that
is used to manipulate, customize, and automate the facilities of an
existing system. In such systems, useful functionality is already
available through a user interface, and the scripting language is a
mechanism for exposing that functionality to program control. In this
way, the existing system is said to provide a
host environment
of objects and facilities, which completes the capabilities of the
scripting language. A scripting language is intended for use by both
professional and non-professional programmers.
ECMAScript was originally designed to be a
Web scripting language
providing a mechanism to enliven Web pages in browsers and to perform
server computation as part of a Web-based client-server architecture.
ECMAScript is now used to provide core scripting capabilities for a
variety of
host
environments. Therefore the core language is specified in this document apart from any particular
host environment
ECMAScript usage has moved beyond simple scripting and it is now
used for the full spectrum of programming tasks in many different
environments and scales. As the usage of ECMAScript has expanded, so
have the features and facilities it provides. ECMAScript is now a fully
featured general-purpose programming language.
4.1
Web Scripting
A web browser provides an ECMAScript
host environment
for client-side computation including, for instance, objects that
represent windows, menus, pop-ups, dialog boxes, text areas, anchors,
frames, history, cookies, and input/output. Further, the
host environment
provides a means to attach scripting code to events such as change of
focus, page and image loading, unloading, error and abort, selection,
form submission, and mouse actions. Scripting code appears within the
HTML and the displayed page is a combination of user interface elements
and fixed and computed text and images. The scripting code is reactive
to user interaction, and there is no need for a main program.
A web server provides a different
host environment
for server-side computation including objects representing requests,
clients, and files; and mechanisms to lock and share data. By using
browser-side and server-side scripting together, it is possible to
distribute computation between the client and server while providing a
customized user interface for a Web-based application.
Each Web browser and server that supports ECMAScript supplies its own
host environment
, completing the ECMAScript execution environment.
4.2
Hosts and Implementations
To aid integrating ECMAScript into
host
environments, this specification defers the definition of certain facilities (e.g.,
abstract operations
),
either in whole or in part, to a source outside of this specification.
Editorially, this specification distinguishes the following kinds of
deferrals.
An
implementation
is an external source that further defines facilities enumerated in Annex
or those that are marked as
implementation-defined
or
implementation-approximated
. In informal use, an implementation refers to a concrete artefact, such as a particular web browser.
An
implementation-defined
facility is one that defers its definition to an external source without
further qualification. This specification does not make any
recommendations for particular behaviours, and conforming
implementations are free to choose any behaviour within the constraints
put forth by this specification.
An
implementation-approximated
facility is one that defers its definition to an external source while
recommending an ideal behaviour. While conforming implementations are
free to choose any behaviour within the constraints put forth by this
specification, they are encouraged to strive to approximate the ideal.
Some mathematical operations, such as
Math.exp
, are
implementation-approximated
host
is an external source that further defines facilities listed in Annex
but does not further define other
implementation-defined
or
implementation-approximated
facilities. In informal use, a
host
refers to the set of all implementations, such as the set of all web
browsers, that interface with this specification in the same way via
Annex
. A
host
is often an external specification, such as WHATWG HTML (
). In other words, facilities that are
host-defined
are often further defined in external specifications.
host hook
is an abstract operation that is defined in whole or in part by an external source. All
host
hooks must be listed in Annex
host-defined
facility is one that defers its definition to an external source without further qualification and is listed in Annex
. Implementations that are not hosts may also provide definitions for
host-defined
facilities.
host environment
is a particular choice of definition for all
host-defined
facilities. A
host environment
typically includes objects or functions which allow obtaining input and providing output as
host-defined
properties of the
global object
This specification follows the editorial convention of always using the most specific term. For example, if a facility is
host-defined
, it should not be referred to as
implementation-defined
Both hosts and implementations may interface with this specification via the language types, specification types,
abstract operations
, grammar productions, intrinsic objects, and intrinsic symbols defined herein.
4.3
ECMAScript Overview
The following is an informal overview of ECMAScript—not all parts
of the language are described. This overview is not part of the
standard proper.
ECMAScript is object-based: basic language and
host
facilities are provided by objects, and an ECMAScript program is a cluster of communicating objects. In ECMAScript, an
object
is a collection of zero or more
properties
each with
attributes
that determine how each property can be used—for example, when the Writable attribute for a property is set to
false
any attempt by executed ECMAScript code to assign a different value to
the property fails. Properties are containers that hold other objects,
primitive values
, or
functions
. A primitive value is a member of one of the following built-in types:
Undefined
Null
Boolean
Number
BigInt
String
, and
Symbol;
an object is a member of the built-in type
Object
; and a function is a callable object. A function that is associated with an object via a property is called a
method
ECMAScript defines a collection of
built-in objects
that round out the definition of ECMAScript entities. These built-in objects include the
global object
; objects that are fundamental to the
runtime semantics
of the language including
Object
Function
Boolean
Symbol
, and various
Error
objects; objects that represent and manipulate numeric values including
Math
Number
, and
Date
; the text processing objects
String
and
RegExp
; objects that are indexed collections of values including
Array
and nine different kinds of Typed Arrays whose elements all have a
specific numeric data representation; keyed collections including
Map
and
Set
objects; objects supporting structured data including the
JSON
object,
ArrayBuffer
SharedArrayBuffer
, and
DataView
; objects supporting control abstractions including generator functions and
Promise
objects; and reflection objects including
Proxy
and
Reflect
ECMAScript also defines a set of built-in
operators
ECMAScript operators include various unary operations, multiplicative
operators, additive operators, bitwise shift operators, relational
operators, equality operators, binary bitwise operators, binary logical
operators, assignment operators, and the comma operator.
Large ECMAScript programs are supported by
modules
which
allow a program to be divided into multiple sequences of statements and
declarations. Each module explicitly identifies declarations it uses
that need to be provided by other modules and which of its declarations
are available for use by other modules.
ECMAScript syntax intentionally resembles Java syntax. ECMAScript
syntax is relaxed to enable it to serve as an easy-to-use scripting
language. For example, a variable is not required to have its type
declared nor are types associated with properties, and defined functions
are not required to have their declarations appear textually before
calls to them.
4.3.1
Objects
Even though ECMAScript includes syntax for class definitions,
ECMAScript objects are not fundamentally class-based such as those in
C++, Smalltalk, or Java. Instead objects may be created in various ways
including via a literal notation or via
constructors
which
create objects and then execute code that initializes all or part of
them by assigning initial values to their properties. Each
constructor
is a function that has a property named
"prototype"
that is used to implement
prototype-based inheritance
and
shared properties
. Objects are created by using constructors in
new
expressions; for example,
new Date(2009, 11)
creates a new Date object. Invoking a
constructor
without using
new
has consequences that depend on the
constructor
. For example,
Date()
produces a string representation of the current date and time rather than an object.
Every object created by a
constructor
has an implicit reference (called the object's
prototype
) to the value of its
constructor
's
"prototype"
property. Furthermore, a prototype may have a non-null implicit reference to its prototype, and so on; this is called the
prototype chain
When a reference is made to a property in an object, that reference is
to the property of that name in the first object in the prototype chain
that contains a property of that name. In other words, first the object
mentioned directly is examined for such a property; if that object
contains the named property, that is the property to which the reference
refers; if that object does not contain the named property, the
prototype for that object is examined next; and so on.
Figure 1: Object/Prototype Relationships
In a class-based object-oriented language, in general, state is
carried by instances, methods are carried by classes, and inheritance
is only of structure and behaviour. In ECMAScript, the state and methods
are carried by objects, while structure, behaviour, and state are all
inherited.
All objects that do not directly contain a particular property
that their prototype contains share that property and its value. Figure 1
illustrates this:
CF
is a
constructor
(and also an object). Five objects have been created by using
new
expressions:
cf
cf
cf
cf
, and
cf
. Each of these objects contains properties named
"q1"
and
"q2"
. The dashed lines represent the implicit prototype relationship; so, for example,
cf
's prototype is
CF
. The
constructor
CF
, has two properties itself, named
"P1"
and
"P2"
, which are not visible to
CF
cf
cf
cf
cf
, or
cf
. The property named
"CFP1"
in
CF
is shared by
cf
cf
cf
cf
, and
cf
(but not by
CF
), as are any properties found in
CF
's implicit prototype chain that are not named
"q1"
"q2"
, or
"CFP1"
. Notice that there is no implicit prototype link between
CF
and
CF
Unlike most class-based object languages, properties can be
added to objects dynamically by assigning values to them. That is,
constructors are not required to name or assign values to all or any of
the constructed object's properties. In the above diagram, one could add
a new shared property for
cf
cf
cf
cf
, and
cf
by assigning a new value to the property in
CF
Although ECMAScript objects are not inherently class-based, it
is often convenient to define class-like abstractions based upon a
common pattern of
constructor
functions, prototype objects, and methods. The ECMAScript built-in
objects themselves follow such a class-like pattern. Beginning with
ECMAScript 2015, the ECMAScript language includes syntactic class
definitions that permit programmers to concisely define objects that
conform to the same class-like abstraction pattern used by the built-in
objects.
4.3.2
The Strict Variant of ECMAScript
The ECMAScript Language recognizes the possibility that some
users of the language may wish to restrict their usage of some features
available in the language. They might do so in the interests of
security, to avoid what they consider to be error-prone features, to get
enhanced error checking, or for other reasons of their choosing. In
support of this possibility, ECMAScript defines a strict variant of the
language. The strict variant of the language excludes some specific
syntactic and semantic features of the regular ECMAScript language and
modifies the detailed semantics of some features. The strict variant
also specifies additional error conditions that must be reported by
throwing error exceptions in situations that are not specified as errors
by the non-strict form of the language.
The strict variant of ECMAScript is commonly referred to as the
strict mode
of the language. Strict mode selection and use of the strict mode
syntax and semantics of ECMAScript is explicitly made at the level of
individual ECMAScript source text units as described in
11.2.2
Because strict mode is selected at the level of a syntactic source text
unit, strict mode only imposes restrictions that have local effect
within such a source text unit. Strict mode does not restrict or modify
any aspect of the ECMAScript semantics that must operate consistently
across multiple source text units. A complete ECMAScript program may be
composed of both strict mode and non-strict mode ECMAScript source text
units. In this case, strict mode only applies when actually executing
code that is defined within a strict mode source text unit.
In order to conform to this specification, an ECMAScript
implementation must implement both the full unrestricted ECMAScript
language and the strict variant of the ECMAScript language as defined by
this specification. In addition, an implementation must support the
combination of unrestricted and strict mode source text units into a
single composite program.
4.4
Terms and Definitions
For the purposes of this document, the following terms and definitions apply.
4.4.1
implementation-approximated
an
implementation-approximated
facility is defined in whole or in part by an external source but has a recommended, ideal behaviour in this specification
4.4.2
implementation-defined
an
implementation-defined
facility is defined in whole or in part by an external source to this specification
4.4.3
host-defined
same as
implementation-defined
Note
Editorially, see clause
4.2
4.4.4
type
set of data values as defined in clause
4.4.5
primitive value
member of one of the types Undefined, Null, Boolean, Number, BigInt, Symbol, or String as defined in clause
Note
A primitive value is a datum that is represented directly at the lowest level of the language implementation.
4.4.6
object
member of the type Object
Note
An object is a collection of properties and has a single prototype object. The prototype may be the null value.
4.4.7
constructor
function object
that creates and initializes objects
Note
The value of a
constructor
's
"prototype"
property is a prototype object that is used to implement inheritance and shared properties.
4.4.8
prototype
object that provides shared properties for other objects
Note
When a
constructor
creates an object, that object implicitly references the
constructor
's
"prototype"
property for the purpose of resolving property references. The
constructor
's
"prototype"
property can be referenced by the program expression
constructor
.prototype
and properties added to an object's prototype are shared, through
inheritance, by all objects sharing the prototype. Alternatively, a new
object may be created with an explicitly specified prototype by using
the
Object.create
built-in function.
4.4.9
ordinary object
object that has the default behaviour for the essential internal methods that must be supported by all objects
4.4.10
exotic object
object that does not have the default behaviour for one or more of the essential internal methods
Note
Any object that is not an
ordinary object
is an
exotic object
4.4.11
standard object
object whose semantics are defined by this specification
4.4.12
built-in object
object specified and supplied by an ECMAScript implementation
Note
Standard built-in objects are defined in this specification.
An ECMAScript implementation may specify and supply additional kinds of
built-in objects. A
built-in
constructor
is a built-in object that is also a
constructor
4.4.13
undefined value
primitive value used when a variable has not been assigned a value
4.4.14
Undefined type
type whose sole value is the
undefined
value
4.4.15
null value
primitive value that represents the intentional absence of any object value
4.4.16
Null type
type whose sole value is the
null
value
4.4.17
Boolean value
member of the Boolean type
Note
There are only two Boolean values,
true
and
false
4.4.18
Boolean type
type consisting of the primitive values
true
and
false
4.4.19
Boolean object
member of the Object type that is an instance of the standard built-in Boolean
constructor
Note
A Boolean object is created by using the Boolean
constructor
in a
new
expression, supplying a Boolean value as an argument. The resulting
object has an internal slot whose value is the Boolean value. A Boolean
object can be coerced to a Boolean value.
4.4.20
String value
primitive value that is a finite ordered sequence of zero or more 16-bit unsigned
integer
values
Note
A String value is a member of the String type. Each
integer
value in the sequence usually represents a single 16-bit unit of UTF-16
text. However, ECMAScript does not place any restrictions or
requirements on the values except that they must be 16-bit unsigned
integers.
4.4.21
String type
set of all possible String values
4.4.22
String object
member of the Object type that is an instance of the standard built-in String
constructor
Note
A String object is created by using the String
constructor
in a
new
expression, supplying a String value as an argument. The resulting
object has an internal slot whose value is the String value. A String
object can be coerced to a String value by calling the String
constructor
as a function (
22.1.1.1
).
4.4.23
Number value
primitive value corresponding to a double-precision 64-bit binary format
IEEE 754-2019
value
Note
Number value
is a member of the Number type and is a direct representation of a number.
4.4.24
Number type
set of all possible Number values including the special “Not-a-Number” (NaN) value, positive infinity, and negative infinity
4.4.25
Number object
member of the Object type that is an instance of the standard built-in Number
constructor
Note
A Number object is created by using the Number
constructor
in a
new
expression, supplying a
Number value
as an argument. The resulting object has an internal slot whose value is the
Number value
. A Number object can be coerced to a
Number value
by calling the Number
constructor
as a function (
21.1.1.1
).
4.4.26
Infinity
Number value
that is the positive infinite
Number value
4.4.27
NaN
Number value
that is an
IEEE 754-2019
“Not-a-Number” value
4.4.28
BigInt value
primitive value corresponding to an arbitrary-precision
integer
value
4.4.29
BigInt type
set of all possible BigInt values
4.4.30
BigInt object
member of the Object type that is an instance of the standard built-in BigInt
constructor
4.4.31
Symbol value
primitive value that represents a unique, non-String Object property key
4.4.32
Symbol type
set of all possible Symbol values
4.4.33
Symbol object
member of the Object type that is an instance of the standard built-in Symbol
constructor
4.4.34
function
member of the Object type that may be invoked as a subroutine
Note
In addition to its properties, a function contains executable
code and state that determine how it behaves when invoked. A function's
code may or may not be written in ECMAScript.
4.4.35
built-in function
built-in object that is a function
Note
Examples of built-in functions include
parseInt
and
Math.exp
. A
host
or implementation may provide additional built-in functions that are not described in this specification.
4.4.36
property
part of an object that associates a key (either a String value or a Symbol value) and a value
Note
Depending upon the form of the property the value may be
represented either directly as a data value (a primitive value, an
object, or a
function object
) or indirectly by a pair of accessor functions.
4.4.37
method
function that is the value of a property
Note
When a function is called as a method of an object, the object is passed to the function as its
this
value.
4.4.38
built-in method
method that is a built-in function
Note
Standard built-in methods are defined in this specification. A
host
or implementation may provide additional built-in methods that are not described in this specification.
4.4.39
attribute
internal value that defines some characteristic of a property
4.4.40
own property
property that is directly contained by its object
4.4.41
inherited property
property of an object that is not an own property but is a property (either own or inherited) of the object's prototype
4.5
Organization of This Specification
The remainder of this specification is organized as follows:
Clause
defines the notational conventions used throughout the specification.
Clauses
through
10
define the execution environment within which ECMAScript programs operate.
Clauses
11
through
17
define the actual ECMAScript programming language including its
syntactic encoding and the execution semantics of all language features.
Clauses
18
through
28
define the ECMAScript standard library. They include the definitions of
all of the standard objects that are available for use by ECMAScript
programs as they execute.
Clause
29
describes the memory consistency model of accesses on SharedArrayBuffer-backed memory and methods of the Atomics object.
Notational Conventions
5.1
Syntactic and Lexical Grammars
5.1.1
Context-Free Grammars
context-free grammar
consists of a number of
productions
. Each production has an abstract symbol called a
nonterminal
as its
left-hand side
, and a sequence of zero or more nonterminal and
terminal
symbols as its
right-hand side
. For each grammar, the terminal symbols are drawn from a specified alphabet.
chain production
is a production that has exactly one nonterminal symbol on its right-hand side along with zero or more terminal symbols.
Starting from a sentence consisting of a single distinguished nonterminal, called the
goal symbol
, a given context-free grammar specifies a
language
namely, the (perhaps infinite) set of possible sequences of terminal
symbols that can result from repeatedly replacing any nonterminal in the
sequence with a right-hand side of a production for which the
nonterminal is the left-hand side.
5.1.2
The Lexical and RegExp Grammars
lexical grammar
for ECMAScript is given in clause
12
. This grammar has as its terminal symbols Unicode code points that conform to the rules for
SourceCharacter
defined in
11.1
. It defines a set of productions, starting from the
goal symbol
InputElementDiv
InputElementTemplateTail
, or
InputElementRegExp
, or
InputElementRegExpOrTemplateTail
, that describe how sequences of such code points are translated into a sequence of input elements.
Input elements other than white space and comments form the
terminal symbols for the syntactic grammar for ECMAScript and are called
ECMAScript
tokens
. These tokens are the reserved words,
identifiers, literals, and punctuators of the ECMAScript language.
Moreover, line terminators, although not considered to be tokens, also
become part of the stream of input elements and guide the process of
automatic semicolon insertion (
12.9
).
Simple white space and single-line comments are discarded and do not
appear in the stream of input elements for the syntactic grammar. A
MultiLineComment
(that is, a comment of the form
/*
*/
regardless of whether it spans more than one line) is likewise simply discarded if it contains no line terminator; but if a
MultiLineComment
contains one or more line terminators, then it is replaced by a single
line terminator, which becomes part of the stream of input elements for
the syntactic grammar.
RegExp grammar
for ECMAScript is given in
22.2.1
. This grammar also has as its terminal symbols the code points as defined by
SourceCharacter
. It defines a set of productions, starting from the
goal symbol
Pattern
, that describe how sequences of code points are translated into regular expression patterns.
Productions of the lexical and RegExp grammars are distinguished by having two colons “
::
” as separating punctuation. The lexical and RegExp grammars share some productions.
5.1.3
The Numeric String Grammar
Another grammar is used for translating Strings into numeric
values. This grammar is similar to the part of the lexical grammar
having to do with numeric literals and has as its terminal symbols
SourceCharacter
. This grammar appears in
7.1.4.1
Productions of the numeric string grammar are distinguished by having three colons “
:::
” as punctuation.
5.1.4
The Syntactic Grammar
The
syntactic grammar
for ECMAScript is given in clauses
13
through
16
. This grammar has ECMAScript tokens defined by the lexical grammar as its terminal symbols (
5.1.2
). It defines a set of productions, starting from two alternative goal symbols
Script
and
Module
, that describe how sequences of tokens form syntactically correct independent components of ECMAScript programs.
When a stream of code points is to be parsed as an ECMAScript
Script
or
Module
it is first converted to a stream of input elements by repeated
application of the lexical grammar; this stream of input elements is
then parsed by a single application of the syntactic grammar. The input
stream is syntactically in error if the tokens in the stream of input
elements cannot be parsed as a single instance of the goal nonterminal (
Script
or
Module
), with no tokens left over.
When a parse is successful, it constructs a
parse tree
, a rooted tree structure in which each node is a
Parse Node
. Each Parse Node is an
instance
of a symbol in the grammar; it represents a span of the source text
that can be derived from that symbol. The root node of the parse tree,
representing the whole of the source text, is an instance of the parse's
goal symbol
When a Parse Node is an instance of a nonterminal, it is also an
instance of some production that has that nonterminal as its left-hand
side. Moreover, it has zero or more
children
, one for each
symbol on the production's right-hand side: each child is a Parse Node
that is an instance of the corresponding symbol.
New Parse Nodes are instantiated for each invocation of the
parser and never reused between parses even of identical source text.
Parse Nodes are considered
the same Parse Node
if and only if
they represent the same span of source text, are instances of the same
grammar symbol, and resulted from the same parser invocation.
Note 1
Parsing the same String multiple times will lead to different Parse Nodes. For example, consider:
let
str =
"1 + 1;"
eval
(str);
eval
(str);
Each call to
eval
converts the value of
str
into an ECMAScript source text and performs an independent parse that
creates its own separate tree of Parse Nodes. The trees are distinct
even though each parse operates upon a source text that was derived from
the same String value.
Note 2
Parse Nodes are specification artefacts, and implementations are not required to use an analogous data structure.
Productions of the syntactic grammar are distinguished by having just one colon “
” as punctuation.
The syntactic grammar as presented in clauses
13
through
16
is not a complete account of which token sequences are accepted as a correct ECMAScript
Script
or
Module
Certain additional token sequences are also accepted, namely, those
that would be described by the grammar if only semicolons were added to
the sequence in certain places (such as before line terminator
characters). Furthermore, certain token sequences that are described by
the grammar are not considered acceptable if a line terminator character
appears in certain “awkward” places.
In certain cases, in order to avoid ambiguities, the syntactic
grammar uses generalized productions that permit token sequences that do
not form a valid ECMAScript
Script
or
Module
. For example, this technique is used for object literals and object destructuring patterns. In such cases a more restrictive
supplemental grammar
is provided that further restricts the acceptable token sequences. Typically, an
early error
rule will then define an error condition if "
is not
covering
an
", where
is a Parse Node (an instance of the generalized production) and
is a nonterminal from the supplemental grammar. Here, the sequence of tokens originally matched by
is parsed again using
as the
goal symbol
. (If
takes grammatical parameters, then they are set to the same values used when
was originally parsed.) An error occurs if the sequence of tokens cannot be parsed as a single instance of
, with no tokens left over. Subsequently, algorithms access the result of the parse using a phrase of the form "the
that is
covered
by
". This will always be a Parse Node (an instance of
, unique for a given
), since any parsing failure would have been detected by an
early error
rule.
5.1.5
Grammar Notation
Terminal symbols are shown in
fixed width
font,
both in the productions of the grammars and throughout this
specification whenever the text directly refers to such a terminal
symbol. These are to appear in a script exactly as written. All terminal
symbol code points specified in this way are to be understood as the
appropriate Unicode code points from the Basic Latin range, as opposed
to any similar-looking code points from other Unicode ranges. A code
point in a terminal symbol cannot be expressed by a
UnicodeEscapeSequence
Nonterminal symbols are shown in
italic
type. The
definition of a nonterminal (also called a “production”) is introduced
by the name of the nonterminal being defined followed by one or more
colons. (The number of colons indicates to which grammar the production
belongs.) One or more alternative right-hand sides for the nonterminal
then follow on succeeding lines. For example, the syntactic definition:
WhileStatement
while
Expression
Statement
states that the nonterminal
WhileStatement
represents the token
while
, followed by a left parenthesis token, followed by an
Expression
, followed by a right parenthesis token, followed by a
Statement
. The occurrences of
Expression
and
Statement
are themselves nonterminals. As another example, the syntactic definition:
ArgumentList
AssignmentExpression
ArgumentList
AssignmentExpression
states that an
ArgumentList
may represent either a single
AssignmentExpression
or an
ArgumentList
, followed by a comma, followed by an
AssignmentExpression
. This definition of
ArgumentList
is recursive, that is, it is defined in terms of itself. The result is that an
ArgumentList
may contain any positive number of arguments, separated by commas, where each argument expression is an
AssignmentExpression
. Such recursive definitions of nonterminals are common.
The subscripted suffix “
opt
”, which may appear after
a terminal or nonterminal, indicates an optional symbol. The
alternative containing the optional symbol actually specifies two
right-hand sides, one that omits the optional element and one that
includes it. This means that:
VariableDeclaration
BindingIdentifier
Initializer
opt
is a convenient abbreviation for:
VariableDeclaration
BindingIdentifier
BindingIdentifier
Initializer
and that:
ForStatement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
is a convenient abbreviation for:
ForStatement
for
LexicalDeclaration
Expression
opt
Statement
for
LexicalDeclaration
Expression
Expression
opt
Statement
which in turn is an abbreviation for:
ForStatement
for
LexicalDeclaration
Statement
for
LexicalDeclaration
Expression
Statement
for
LexicalDeclaration
Expression
Statement
for
LexicalDeclaration
Expression
Expression
Statement
so, in this example, the nonterminal
ForStatement
actually has four alternative right-hand sides.
A production may be parameterized by a subscripted annotation of the form “
[parameters]
”, which may appear as a suffix to the nonterminal symbol defined by the production. “
parameters
may be either a single name or a comma separated list of names. A
parameterized production is shorthand for a set of productions defining
all combinations of the parameter names, preceded by an underscore,
appended to the parameterized nonterminal symbol. This means that:
StatementList
[Return]
ReturnStatement
ExpressionStatement
is a convenient abbreviation for:
StatementList
ReturnStatement
ExpressionStatement
StatementList_Return
ReturnStatement
ExpressionStatement
and that:
StatementList
[Return, In]
ReturnStatement
ExpressionStatement
is an abbreviation for:
StatementList
ReturnStatement
ExpressionStatement
StatementList_Return
ReturnStatement
ExpressionStatement
StatementList_In
ReturnStatement
ExpressionStatement
StatementList_Return_In
ReturnStatement
ExpressionStatement
Multiple parameters produce a combinatory number of
productions, not all of which are necessarily referenced in a complete
grammar.
References to nonterminals on the right-hand side of a production can also be parameterized. For example:
StatementList
ReturnStatement
ExpressionStatement
[+In]
is equivalent to saying:
StatementList
ReturnStatement
ExpressionStatement_In
and:
StatementList
ReturnStatement
ExpressionStatement
[~In]
is equivalent to:
StatementList
ReturnStatement
ExpressionStatement
A nonterminal reference may have both a parameter list and an “
opt
” suffix. For example:
VariableDeclaration
BindingIdentifier
Initializer
[+In]
opt
is an abbreviation for:
VariableDeclaration
BindingIdentifier
BindingIdentifier
Initializer_In
Prefixing a parameter name with “
” on a right-hand
side nonterminal reference makes that parameter value dependent upon the
occurrence of the parameter name on the reference to the current
production's left-hand side symbol. For example:
VariableDeclaration
[In]
BindingIdentifier
Initializer
[?In]
is an abbreviation for:
VariableDeclaration
BindingIdentifier
Initializer
VariableDeclaration_In
BindingIdentifier
Initializer_In
If a right-hand side alternative is prefixed with
“[+parameter]” that alternative is only available if the named parameter
was used in referencing the production's nonterminal symbol. If a
right-hand side alternative is prefixed with “[~parameter]” that
alternative is only available if the named parameter was
not
used in referencing the production's nonterminal symbol. This means that:
StatementList
[Return]
[+Return]
ReturnStatement
ExpressionStatement
is an abbreviation for:
StatementList
ExpressionStatement
StatementList_Return
ReturnStatement
ExpressionStatement
and that:
StatementList
[Return]
[~Return]
ReturnStatement
ExpressionStatement
is an abbreviation for:
StatementList
ReturnStatement
ExpressionStatement
StatementList_Return
ExpressionStatement
When the words “
one of
” follow the colon(s) in a grammar
definition, they signify that each of the terminal symbols on the
following line or lines is an alternative definition. For example, the
lexical grammar for ECMAScript contains the production:
NonZeroDigit
::
one of
which is merely a convenient abbreviation for:
NonZeroDigit
::
If the phrase “[empty]” appears as the right-hand side of a
production, it indicates that the production's right-hand side contains
no terminals or nonterminals.
If the phrase “[lookahead =
seq
]” appears in the right-hand side of a production, it indicates that the production may only be used if the token sequence
seq
is a prefix of the immediately following input token sequence. Similarly, “[lookahead ∈
set
]”, where
set
is a finite nonempty set of token sequences, indicates that the production may only be used if some element of
set
is a prefix of the immediately following token sequence. For
convenience, the set can also be written as a nonterminal, in which case
it represents the set of all token sequences to which that nonterminal
could expand. It is considered an editorial error if the nonterminal
could expand to infinitely many distinct token sequences.
These conditions may be negated. “[lookahead ≠
seq
]” indicates that the containing production may only be used if
seq
is
not
a prefix of the immediately following input token sequence, and “[lookahead ∉
set
]” indicates that the production may only be used if
no
element of
set
is a prefix of the immediately following token sequence.
As an example, given the definitions:
DecimalDigit
::
one of
DecimalDigits
::
DecimalDigit
DecimalDigits
DecimalDigit
the definition:
LookaheadExample
::
[lookahead ∉ {
}]
DecimalDigits
DecimalDigit
[lookahead ∉
DecimalDigit
matches either the letter
followed by one or more decimal digits the first of which is even, or a decimal digit not followed by another decimal digit.
Note that when these phrases are used in the syntactic grammar,
it may not be possible to unambiguously identify the immediately
following token sequence because determining later tokens requires
knowing which lexical
goal symbol
to use at later positions. As such, when these are used in the
syntactic grammar, it is considered an editorial error for a token
sequence
seq
to appear in a lookahead restriction (including
as part of a set of sequences) if the choices of lexical goal symbols to
use could change whether or not
seq
would be a prefix of the resulting token sequence.
If the phrase “[no
LineTerminator
here]” appears in the right-hand side of a production of the syntactic grammar, it indicates that the production is
a restricted production
: it may not be used if a
LineTerminator
occurs in the input stream at the indicated position. For example, the production:
ThrowStatement
throw
[no
LineTerminator
here]
Expression
indicates that the production may not be used if a
LineTerminator
occurs in the script between the
throw
token and the
Expression
Unless the presence of a
LineTerminator
is forbidden by a restricted production, any number of occurrences of
LineTerminator
may appear between any two consecutive tokens in the stream of input
elements without affecting the syntactic acceptability of the script.
When an alternative in a production of the lexical grammar or
the numeric string grammar appears to be a multi-code point token, it
represents the sequence of code points that would make up such a token.
The right-hand side of a production may specify that certain expansions are not permitted by using the phrase “
but not
” and then indicating the expansions to be excluded. For example, the production:
Identifier
::
IdentifierName
but not
ReservedWord
means that the nonterminal
Identifier
may be replaced by any sequence of code points that could replace
IdentifierName
provided that the same sequence of code points could not replace
ReservedWord
Finally, a few nonterminal symbols are described by a
descriptive phrase in sans-serif type in cases where it would be
impractical to list all the alternatives:
SourceCharacter
::
any Unicode code point
5.2
Algorithm Conventions
The specification often uses a numbered list to specify steps in
an algorithm. These algorithms are used to precisely specify the
required semantics of ECMAScript language constructs. The algorithms are
not intended to imply the use of any specific implementation technique.
In practice, there may be more efficient algorithms available to
implement a given feature.
Algorithms may be explicitly parameterized with an ordered,
comma-separated sequence of alias names which may be used within the
algorithm steps to reference the argument passed in that position.
Optional parameters are denoted with surrounding brackets ([ ,
name
]) and are no different from required parameters within algorithm
steps. A rest parameter may appear at the end of a parameter list,
denoted with leading ellipsis (, ...
name
). The rest parameter captures all of the arguments provided following the required and optional parameters into a
List
. If there are no such additional arguments, that
List
is empty.
Algorithm steps may be subdivided into sequential substeps.
Substeps are indented and may themselves be further divided into
indented substeps. Outline numbering conventions are used to identify
substeps with the first level of substeps labelled with lower case
alphabetic characters and the second level of substeps labelled with
lower case roman numerals. If more than three levels are required these
rules repeat with the fourth level using numeric labels. For example:
1.
Top-level step
a.
Substep.
b.
Substep.
i.
Subsubstep.
1.
Subsubsubstep
a.
Subsubsubsubstep
i.
Subsubsubsubsubstep
A step or substep may be written as an “if” predicate that
conditions its substeps. In this case, the substeps are only applied if
the predicate is true. If a step or substep begins with the word “else”,
it is a predicate that is the negation of the preceding “if” predicate
step at the same level.
A step may specify the iterative application of its substeps.
A step that begins with “
Assert
:” asserts
an invariant condition of its algorithm. Such assertions are used to
make explicit algorithmic invariants that would otherwise be implicit.
Such assertions add no additional semantic requirements and hence need
not be checked by an implementation. They are used simply to clarify
algorithms.
Algorithm steps may declare named aliases for any value using the form “Let
be
someValue
”. These aliases are reference-like in that both
and
someValue
refer to the same underlying data and modifications to either are
visible to both. Algorithm steps that want to avoid this reference-like
behaviour should explicitly make a copy of the right-hand side: “Let
be a copy of
someValue
” creates a shallow copy of
someValue
Once declared, an alias may be referenced in any subsequent steps
and must not be referenced from steps prior to the alias's declaration.
Aliases may be modified using the form “Set
to
someOtherValue
”.
5.2.1
Abstract Operations
In order to facilitate their use in multiple parts of this specification, some algorithms, called
abstract operations
are named and written in parameterized functional form so that they may
be referenced by name from within other algorithms. Abstract operations
are typically referenced using a functional application style such as
OperationName(
arg1
arg2
). Some abstract
operations are treated as polymorphically dispatched methods of
class-like specification abstractions. Such method-like abstract
operations are typically referenced using a method application style
such as
someValue
.OperationName(
arg1
arg2
).
5.2.2
Syntax-Directed Operations
syntax-directed operation
is a named operation
whose definition consists of algorithms, each of which is associated
with one or more productions from one of the ECMAScript grammars. A
production that has multiple alternative definitions will typically have
a distinct algorithm for each alternative. When an algorithm is
associated with a grammar production, it may reference the terminal and
nonterminal symbols of the production alternative as if they were
parameters of the algorithm. When used in this manner, nonterminal
symbols refer to the actual alternative definition that is matched when
parsing the source text. The
source text matched by
a grammar
production is the portion of the source text that starts at the
beginning of the first terminal that participated in the match and ends
at the end of the last terminal that participated in the match.
When an algorithm is associated with a production alternative,
the alternative is typically shown without any “[ ]” grammar
annotations. Such annotations should only affect the syntactic
recognition of the alternative and have no effect on the associated
semantics for the alternative.
Syntax-directed operations are invoked with a parse node and, optionally, other parameters by using the conventions on steps
, and
in the following algorithm:
1.
Let
status
be SyntaxDirectedOperation of
SomeNonTerminal
2.
Let
someParseNode
be the parse of some source text.
3.
Perform SyntaxDirectedOperation of
someParseNode
4.
Perform SyntaxDirectedOperation of
someParseNode
passing
"value"
as the argument.
Unless explicitly specified otherwise, all chain productions
have an implicit definition for every operation that might be applied to
that production's left-hand side nonterminal. The implicit definition
simply reapplies the same operation with the same parameters, if any, to
the
chain production
's
sole right-hand side nonterminal and then returns the result. For
example, assume that some algorithm has a step of the form: “Return the
result of evaluating
Block
” and that there is a production:
Block
StatementList
but the Evaluation operation does not associate an algorithm
with that production. In that case, the Evaluation operation implicitly
includes an association of the form:
Runtime Semantics: Evaluation
Block
StatementList
1.
Return the result of evaluating
StatementList
5.2.3
Runtime Semantics
Algorithms which specify semantics that must be called at runtime are called
runtime semantics
. Runtime semantics are defined by
abstract operations
or syntax-directed operations. Such algorithms always return a completion record.
5.2.3.1
Implicit Completion Values
The algorithms of this specification often implicitly return
Completion
Records whose [[Type]] is
normal
. Unless it is otherwise obvious from the context, an algorithm statement that returns a value that is not a
Completion Record
, such as:
1.
Return
"Infinity"
means the same thing as:
1.
Return
NormalCompletion
"Infinity"
).
However, if the value expression of a “return” statement is a
Completion Record
construction literal, the resulting
Completion Record
is returned. If the value expression is a call to an abstract operation, the “return” statement simply returns the
Completion Record
produced by the abstract operation.
The abstract operation
Completion
completionRecord
) is used to emphasize that a previously computed
Completion Record
is being returned. The
Completion
abstract operation takes a single argument,
completionRecord
, and performs the following steps:
1.
Assert
completionRecord
is a
Completion Record
2.
Return
completionRecord
as the
Completion Record
of this abstract operation.
A “return” statement without a value in an algorithm step means the same thing as:
1.
Return
NormalCompletion
undefined
).
Any reference to a
Completion Record
value that is in a context that does not explicitly require a complete
Completion Record
value is equivalent to an explicit reference to the [[Value]] field of the
Completion Record
value unless the
Completion Record
is an
abrupt completion
5.2.3.2
Throw an Exception
Algorithms steps that say to throw an exception, such as
1.
Throw a
TypeError
exception.
mean the same things as:
1.
Return
ThrowCompletion
(a newly created
TypeError
object).
5.2.3.3
ReturnIfAbrupt
Algorithms steps that say or are otherwise equivalent to:
1.
ReturnIfAbrupt
argument
).
mean the same thing as:
1.
If
argument
is an
abrupt completion
, return
argument
2.
Else if
argument
is a
Completion Record
, set
argument
to
argument
.[[Value]].
Algorithms steps that say or are otherwise equivalent to:
1.
ReturnIfAbrupt
(AbstractOperation()).
mean the same thing as:
1.
Let
hygienicTemp
be AbstractOperation().
2.
If
hygienicTemp
is an
abrupt completion
, return
hygienicTemp
3.
Else if
hygienicTemp
is a
Completion Record
, set
hygienicTemp
to
hygienicTemp
.[[Value]].
Where
hygienicTemp
is ephemeral and visible only in the steps pertaining to ReturnIfAbrupt.
Algorithms steps that say or are otherwise equivalent to:
1.
Let
result
be AbstractOperation(
ReturnIfAbrupt
argument
)).
mean the same thing as:
1.
If
argument
is an
abrupt completion
, return
argument
2.
If
argument
is a
Completion Record
, set
argument
to
argument
.[[Value]].
3.
Let
result
be AbstractOperation(
argument
).
5.2.3.4
ReturnIfAbrupt Shorthands
Invocations of
abstract operations
and syntax-directed operations that are prefixed by
indicate that
ReturnIfAbrupt
should be applied to the resulting
Completion Record
. For example, the step:
1.
? OperationName().
is equivalent to the following step:
1.
ReturnIfAbrupt
(OperationName()).
Similarly, for method application style, the step:
1.
someValue
.OperationName().
is equivalent to:
1.
ReturnIfAbrupt
someValue
.OperationName()).
Similarly, prefix
is used to indicate that the following invocation of an abstract or
syntax-directed operation
will never return an
abrupt completion
and that the resulting
Completion Record
's [[Value]] field should be used in place of the return value of the operation. For example, the step:
1.
Let
val
be ! OperationName().
is equivalent to the following steps:
1.
Let
val
be OperationName().
2.
Assert
val
is never an
abrupt completion
3.
If
val
is a
Completion Record
, set
val
to
val
.[[Value]].
Syntax-directed operations for
runtime semantics
make use of this shorthand by placing
or
before the invocation of the operation:
1.
Perform ! SyntaxDirectedOperation of
NonTerminal
5.2.4
Static Semantics
Context-free grammars are not sufficiently powerful to express
all the rules that define whether a stream of input elements form a
valid ECMAScript
Script
or
Module
that may be evaluated. In some situations additional rules are needed
that may be expressed using either ECMAScript algorithm conventions or
prose requirements. Such rules are always associated with a production
of a grammar and are called the
static semantics
of the production.
Static Semantic Rules have names and typically are defined
using an algorithm. Named Static Semantic Rules are associated with
grammar productions and a production that has multiple alternative
definitions will typically have for each alternative a distinct
algorithm for each applicable named static semantic rule.
A special kind of static semantic rule is an
Early Error Rule
Early error
rules define
early error
conditions (see clause
17
) that are associated with specific grammar productions. Evaluation of most
early error
rules are not explicitly invoked within the algorithms of this
specification. A conforming implementation must, prior to the first
evaluation of a
Script
or
Module
, validate all of the
early error
rules of the productions used to parse that
Script
or
Module
. If any of the
early error
rules are violated the
Script
or
Module
is invalid and cannot be evaluated.
5.2.5
Mathematical Operations
This specification makes reference to these kinds of numeric values:
Mathematical values
: Arbitrary real numbers, used as the default numeric type.
Extended mathematical values
: Mathematical values together with +∞ and -∞.
Numbers
IEEE 754-2019
double-precision floating point values.
BigInts
: ECMAScript values representing arbitrary integers in a one-to-one correspondence.
In the language of this specification, numerical values are
distinguished among different numeric kinds using subscript suffixes.
The subscript
refers to Numbers, and the subscript
refers to BigInts. Numeric values without a subscript suffix refer to mathematical values.
Numeric operators such as +, ×, =, and ≥ refer to those
operations as determined by the type of the operands. When applied to
mathematical values, the operators refer to the usual mathematical
operations. When applied to Numbers, the operators refer to the relevant
operations within
IEEE 754-2019
. When applied to BigInts, the operators refer to the usual mathematical operations applied to the
mathematical value
of the BigInt.
In general, when this specification refers to a numerical value, such as in the phrase, "the length of
" or "the
integer
represented by the four hexadecimal digits ...", without explicitly specifying a numeric kind, the phrase refers to a
mathematical value
. Phrases which refer to a Number or a BigInt value are explicitly annotated as such; for example, "the
Number value
for the number of code points in …" or "the BigInt value for …".
Numeric operators applied to mixed-type operands (such as a Number and a
mathematical value
) are not defined and should be considered an editorial error in this specification.
This specification denotes most numeric values in base 10; it
also uses numeric values of the form 0x followed by digits 0-9 or A-F as
base-16 values.
When the term
integer
is used in this specification, it refers to a
mathematical value
which is in the set of integers, unless otherwise stated. When the term
integral Number
is used in this specification, it refers to a
Number value
whose
mathematical value
is in the set of integers.
Conversions between mathematical values and Numbers or BigInts are always explicit in this document. A conversion from a
mathematical value
or
extended mathematical value
to a Number is denoted as "the
Number value
for
" or
), and is defined in
6.1.6.1
. A conversion from an
integer
to a BigInt is denoted as "the BigInt value for
" or
). A conversion from a Number or BigInt
to a
mathematical value
is denoted as "the
mathematical value
of
", or
). The
mathematical value
of
+0
and
-0
is the
mathematical value
0. The
mathematical value
of non-finite values is not defined. The
extended mathematical value
of
is the
mathematical value
of
for finite values, and is +∞ and -∞ for
+∞
and
-∞
respectively; it is not defined for
NaN
The mathematical function
abs(
produces the absolute value of
, which is
if
< 0 and otherwise is
itself.
The mathematical function
min(
x1
x2
, … ,
xN
produces the mathematically smallest of
x1
through
xN
. The mathematical function
max(
x1
x2
, ...,
xN
produces the mathematically largest of
x1
through
xN
. The domain and range of these mathematical functions are the extended mathematical values.
The notation “
modulo
” (
must be finite and non-zero) computes a value
of the same sign as
(or zero) such that
abs
) <
abs
) and
for some
integer
The phrase "the result of
clamping
between
lower
and
upper
" (where
is an
extended mathematical value
and
lower
and
upper
are mathematical values such that
lower
upper
) produces
lower
if
lower
, produces
upper
if
upper
, and otherwise produces
The mathematical function
floor(
produces the largest
integer
(closest to +∞) that is not larger than
Mathematical functions min, max,
abs
, and
floor
are not defined for Numbers and BigInts, and any usage of those methods that have non-
mathematical value
arguments would be an editorial error in this specification.
Note
floor
) =
- (
modulo
1)
5.2.6
Value Notation
In this specification, ECMAScript language values are displayed in
bold
. Examples include
null
true
, or
"hello"
. These are distinguished from longer ECMAScript code sequences such as
Function.prototype.apply
or
let n = 42;
Values which are internal to the specification and not directly observable from ECMAScript code are indicated with a
sans-serif
typeface. For instance, a
Completion Record
's [[Type]] field takes on values like
normal
return
, or
throw
ECMAScript Data Types and Values
Algorithms within this specification manipulate values each of
which has an associated type. The possible value types are exactly those
defined in this clause. Types are further subclassified into ECMAScript
language types and specification types.
Within this specification, the notation “Type(
)” is used as shorthand for “the
type
of
where “type” refers to the ECMAScript language and specification types
defined in this clause. When the term “empty” is used as if it was
naming a value, it is equivalent to saying “no value of any type”.
6.1
ECMAScript Language Types
An
ECMAScript language type
corresponds to values that
are directly manipulated by an ECMAScript programmer using the
ECMAScript language. The ECMAScript language types are Undefined, Null,
Boolean, String, Symbol, Number, BigInt, and Object. An
ECMAScript language value
is a value that is characterized by an ECMAScript language type.
6.1.1
The Undefined Type
The Undefined type has exactly one value, called
undefined
. Any variable that has not been assigned a value has the value
undefined
6.1.2
The Null Type
The Null type has exactly one value, called
null
6.1.3
The Boolean Type
The Boolean type represents a logical entity having two values, called
true
and
false
6.1.4
The String Type
The String type is the set of all ordered sequences of zero or more 16-bit unsigned
integer
values (“elements”) up to a maximum length of 2
53
- 1 elements. The String type is generally used to represent textual
data in a running ECMAScript program, in which case each element in the
String is treated as a UTF-16 code unit value. Each element is regarded
as occupying a position within the sequence. These positions are indexed
with non-negative integers. The first element (if any) is at index 0,
the next element (if any) at index 1, and so on. The length of a String
is the number of elements (i.e., 16-bit values) within it. The empty
String has length zero and therefore contains no elements.
ECMAScript operations that do not interpret String contents
apply no further semantics. Operations that do interpret String values
treat each element as a single UTF-16 code unit. However, ECMAScript
does not restrict the value of or relationships between these code
units, so operations that further interpret String contents as sequences
of Unicode code points encoded in UTF-16 must account for ill-formed
subsequences. Such operations apply special treatment to every code unit
with a numeric value in the inclusive range 0xD800 to 0xDBFF (defined
by the Unicode Standard as a
leading surrogate
, or more formally as a
high-surrogate code unit
) and every code unit with a numeric value in the inclusive range 0xDC00 to 0xDFFF (defined as a
trailing surrogate
, or more formally as a
low-surrogate code unit
) using the following rules:
A code unit that is not a
leading surrogate
and not a
trailing surrogate
is interpreted as a code point with the same value.
A sequence of two code units, where the first code unit
c1
is a
leading surrogate
and the second code unit
c2
trailing surrogate
, is a
surrogate pair
and is interpreted as a code point with the value (
c1
- 0xD800) × 0x400 + (
c2
- 0xDC00) + 0x10000. (See
11.1.3
A code unit that is a
leading surrogate
or
trailing surrogate
, but is not part of a
surrogate pair
, is interpreted as a code point with the same value.
The function
String.prototype.normalize
(see
22.1.3.13
) can be used to explicitly normalize a String value.
String.prototype.localeCompare
(see
22.1.3.10
internally normalizes String values, but no other operations implicitly
normalize the strings upon which they operate. Only operations that are
explicitly specified to be language or locale sensitive produce
language-sensitive results.
Note
The rationale behind this design was to keep the
implementation of Strings as simple and high-performing as possible. If
ECMAScript source text is in Normalized Form C, string literals are
guaranteed to also be normalized, as long as they do not contain any
Unicode escape sequences.
In this specification, the phrase "the
string-concatenation
of
..." (where each argument is a String value, a code unit, or a sequence
of code units) denotes the String value whose sequence of code units is
the concatenation of the code units (in order) of each of the arguments
(in order).
The phrase "the
substring
of
from
inclusiveStart
to
exclusiveEnd
" (where
is a String value or a sequence of code units and
inclusiveStart
and
exclusiveEnd
are integers) denotes the String value consisting of the consecutive code units of
beginning at index
inclusiveStart
and ending immediately before index
exclusiveEnd
(which is the empty String when
inclusiveStart
exclusiveEnd
). If the "to" suffix is omitted, the length of
is used as the value of
exclusiveEnd
6.1.4.1
StringIndexOf (
string
searchValue
fromIndex
The abstract operation StringIndexOf takes arguments
string
(a String),
searchValue
(a String), and
fromIndex
(a non-negative
integer
). It performs the following steps when called:
1.
Assert
Type
string
) is String.
2.
Assert
Type
searchValue
) is String.
3.
Assert
fromIndex
is a non-negative
integer
4.
Let
len
be the length of
string
5.
If
searchValue
is the empty String and
fromIndex
len
, return
fromIndex
6.
Let
searchLen
be the length of
searchValue
7.
For each
integer
starting with
fromIndex
such that
len
searchLen
, in ascending order, do
a.
Let
candidate
be the
substring
of
string
from
to
searchLen
b.
If
candidate
is the same sequence of code units as
searchValue
, return
8.
Return -1.
Note 1
If
searchValue
is the empty String and
fromIndex
is less than or equal to the length of
string
, this algorithm returns
fromIndex
. The empty String is effectively found at every position within a string, including after the last code unit.
Note 2
This algorithm always returns -1 if
fromIndex
> the length of
string
6.1.5
The Symbol Type
The Symbol type is the set of all non-String values that may be used as the key of an Object property (
6.1.7
).
Each possible Symbol value is unique and immutable.
Each Symbol value immutably holds an associated value called [[Description]] that is either
undefined
or a String value.
6.1.5.1
Well-Known Symbols
Well-known symbols are built-in Symbol values that are
explicitly referenced by algorithms of this specification. They are
typically used as the keys of properties whose values serve as extension
points of a specification algorithm. Unless otherwise specified,
well-known symbols values are shared by all realms (
9.2
).
Within this specification a well-known symbol is referred to
by using a notation of the form @@name, where “name” is one of the
values listed in
Table 1
Table 1: Well-known Symbols
Specification Name
[[Description]]
Value and Purpose
@@asyncIterator
"Symbol.asyncIterator"
A method that returns the default AsyncIterator for an object. Called by the semantics of the
for
await
of
statement.
@@hasInstance
"Symbol.hasInstance"
A method that determines if a
constructor
object recognizes an object as one of the
constructor
's instances. Called by the semantics of the
instanceof
operator.
@@isConcatSpreadable
"Symbol.isConcatSpreadable"
A Boolean valued property that if true indicates that an object should be flattened to its array elements by
Array.prototype.concat
@@iterator
"Symbol.iterator"
A method that returns the default Iterator for an object. Called by the semantics of the for-of statement.
@@match
"Symbol.match"
A regular expression method that matches the regular expression against a string. Called by the
String.prototype.match
method.
@@matchAll
"Symbol.matchAll"
A regular expression method that returns an iterator,
that yields matches of the regular expression against a string. Called
by the
String.prototype.matchAll
method.
@@replace
"Symbol.replace"
A regular expression method that replaces matched substrings of a string. Called by the
String.prototype.replace
method.
@@search
"Symbol.search"
A regular expression method that returns the index
within a string that matches the regular expression. Called by the
String.prototype.search
method.
@@species
"Symbol.species"
A function valued property that is the
constructor
function that is used to create derived objects.
@@split
"Symbol.split"
A regular expression method that splits a string at the
indices that match the regular expression. Called by the
String.prototype.split
method.
@@toPrimitive
"Symbol.toPrimitive"
A method that converts an object to a corresponding primitive value. Called by the
ToPrimitive
abstract operation.
@@toStringTag
"Symbol.toStringTag"
A String valued property that is used in the creation of
the default string description of an object. Accessed by the built-in
method
Object.prototype.toString
@@unscopables
"Symbol.unscopables"
An object valued property whose own and inherited property names are property names that are excluded from the
with
environment bindings of the associated object.
6.1.6
Numeric Types
ECMAScript has two built-in numeric types: Number and BigInt. In this specification, every numeric type
contains a multiplicative identity value denoted
::unit. The specification types also have the following
abstract operations
, likewise denoted
::
op
for a given operation with specification name
op
. All argument types are
The "Result" column shows the return type, along with an indication if
it is possible for some invocations of the operation to return an
abrupt completion
Table 2: Numeric Type Operations
Invocation Synopsis
Example source
Invoked by the Evaluation semantics of ...
Result
::unaryMinus(x)
-x
Unary
Operator
::bitwiseNOT(x)
~x
Bitwise NOT Operator (
::exponentiate(x, y)
x ** y
Exponentiation Operator
and
Math.pow (
base
exponent
, may throw
RangeError
::multiply(x, y)
x * y
Multiplicative Operators
::divide(x, y)
x / y
Multiplicative Operators
, may throw
RangeError
::remainder(x, y)
x % y
Multiplicative Operators
, may throw
RangeError
::add(x, y)
x ++
++ x
x + y
Postfix Increment Operator
Prefix Increment Operator
and
The Addition Operator (
::subtract(x, y)
x --
-- x
x - y
Postfix Decrement Operator
Prefix Decrement Operator
and
The Subtraction Operator (
::leftShift(x, y)
x << y
The Left Shift Operator (
<<
::signedRightShift(x, y)
x >> y
The Signed Right Shift Operator (
>>
::unsignedRightShift(x, y)
x >>> y
The Unsigned Right Shift Operator (
>>>
, may throw
TypeError
::lessThan(x, y)
x < y
x > y
x <= y
x >= y
Relational Operators
via
Abstract Relational Comparison
Boolean or
undefined
(for unordered inputs)
::equal(x, y)
x == y
x != y
x === y
x !== y
Equality Operators
via
Strict Equality Comparison
Boolean
::sameValue(x, y)
Object internal methods,
via
SameValue (
to test exact value equality
Boolean
::sameValueZero(x, y)
Array, Map, and Set methods,
via
SameValueZero (
to test value equality ignoring differences among members of the zero cohort (i.e.,
-0
and
+0
Boolean
::bitwiseAND(x, y)
x & y
Binary Bitwise Operators
::bitwiseXOR(x, y)
x ^ y
Binary Bitwise Operators
::bitwiseOR(x, y)
x | y
Binary Bitwise Operators
::toString(x)
String(x)
Many expressions and built-in functions, via
ToString (
argument
String
The
::unit value and
::
op
operations are not a part of the ECMAScript language; they are defined
here solely to aid the specification of the semantics of the ECMAScript
language. Other
abstract operations
are defined throughout this specification.
Because the numeric types are in general not convertible
without loss of precision or truncation, the ECMAScript language
provides no implicit conversion among these types. Programmers must
explicitly call
Number
and
BigInt
functions to convert among types when calling a function which requires another type.
Note
The first and subsequent editions of ECMAScript have
provided, for certain operators, implicit numeric conversions that could
lose precision or truncate. These legacy implicit conversions are
maintained for backward compatibility, but not provided for BigInt in
order to minimize opportunity for programmer error, and to leave open
the option of generalized
value types
in a future edition.
6.1.6.1
The Number Type
The Number type has exactly 18,437,736,874,454,810,627 (that is,
64
- 2
53
+ 3
) values, representing the double-precision 64-bit format
IEEE 754-2019
values as specified in the IEEE Standard for Binary Floating-Point Arithmetic, except that the 9,007,199,254,740,990 (that is,
53
- 2
) distinct “Not-a-Number” values of the IEEE Standard are represented in ECMAScript as a single special
NaN
value. (Note that the
NaN
value is produced by the program expression
NaN
.)
In some implementations, external code might be able to detect a
difference between various Not-a-Number values, but such behaviour is
implementation-defined
; to ECMAScript code, all
NaN
values are indistinguishable from each other.
Note
The bit pattern that might be observed in an ArrayBuffer (see
25.1
) or a SharedArrayBuffer (see
25.2
) after a
Number value
has been stored into it is not necessarily the same as the internal representation of that
Number value
used by the ECMAScript implementation.
There are two other special values, called
positive Infinity
and
negative Infinity
. For brevity, these values are also referred to for expository purposes by the symbols
+∞
and
-∞
, respectively. (Note that these two infinite Number values are produced by the program expressions
+Infinity
(or simply
Infinity
) and
-Infinity
.)
The other 18,437,736,874,454,810,624 (that is,
64
- 2
53
values are called the finite numbers. Half of these are positive
numbers and half are negative numbers; for every finite positive
Number value
there is a corresponding negative value having the same magnitude.
Note that there is both a
positive zero
and a
negative zero
. For brevity, these values are also referred to for expository purposes by the symbols
+0
and
-0
, respectively. (Note that these two different zero Number values are produced by the program expressions
+0
(or simply
) and
-0
.)
The 18,437,736,874,454,810,622 (that is,
64
- 2
53
- 2
) finite non-zero values are of two kinds:
18,428,729,675,200,069,632 (that is,
64
- 2
54
) of them are normalized, having the form
× 2
where
is 1 or -1,
is an
integer
such that 2
52
< 2
53
, and
is an
integer
such that -1074 ≤
≤ 971.
The remaining 9,007,199,254,740,990 (that is,
53
- 2
) values are denormalized, having the form
× 2
where
is 1 or -1,
is an
integer
such that 0 <
< 2
52
, and
is -1074.
Note that all the positive and negative integers whose magnitude is no greater than 2
53
are representable in the Number type. The
integer
0 has two representations in the Number type:
+0
and
-0
A finite number has an
odd significand
if it is non-zero and the
integer
used to express it (in one of the two forms shown above) is odd. Otherwise, it has an
even significand
In this specification, the phrase “the
Number value
for
” where
represents an exact real mathematical quantity (which might even be an irrational number such as π) means a
Number value
chosen in the following manner. Consider the set of all finite values of the Number type, with
-0
removed and with two additional values added to it that are not representable in the Number type, namely 2
1024
(which is
+1 × 2
53
× 2
971
) and
-2
1024
(which is
-1 × 2
53
× 2
971
). Choose the member of this set that is closest in value to
If two values of the set are equally close, then the one with an even
significand is chosen; for this purpose, the two extra values 2
1024
and
-2
1024
are considered to have even significands. Finally, if 2
1024
was chosen, replace it with
+∞
; if
-2
1024
was chosen, replace it with
-∞
; if
+0
was chosen, replace it with
-0
if and only if
< 0; any other chosen value is used unchanged. The result is the
Number value
for
. (This procedure corresponds exactly to the behaviour of the
IEEE 754-2019
roundTiesToEven mode.)
The
Number value
for +∞ is
+∞
, and the
Number value
for -∞ is
-∞
Some ECMAScript operators deal only with integers in specific ranges such as
-2
31
through
31
- 1
, inclusive, or in the range 0 through
16
- 1
, inclusive. These operators accept any value of the Number type but first convert each such value to an
integer
value in the expected range. See the descriptions of the numeric conversion operations in
7.1
The Number::unit value is
6.1.6.1.1
Number::unaryMinus (
The abstract operation Number::unaryMinus takes argument
(a Number). It performs the following steps when called:
1.
If
is
NaN
, return
NaN
2.
Return the result of negating
; that is, compute a Number with the same magnitude but opposite sign.
6.1.6.1.2
Number::bitwiseNOT (
The abstract operation Number::bitwiseNOT takes argument
(a Number). It performs the following steps when called:
1.
Let
oldValue
be !
ToInt32
).
2.
Return the result of applying bitwise complement to
oldValue
. The
mathematical value
of the result is exactly representable as a 32-bit two's complement bit string.
6.1.6.1.3
Number::exponentiate (
base
exponent
The abstract operation Number::exponentiate takes arguments
base
(a Number) and
exponent
(a Number). It returns an
implementation-approximated
value representing the result of raising
base
to the
exponent
power. It performs the following steps when called:
1.
If
exponent
is
NaN
, return
NaN
2.
If
exponent
is
+0
or
exponent
is
-0
, return
3.
If
base
is
NaN
, return
NaN
4.
If
base
is
+∞
, then
a.
If
exponent
+0
, return
+∞
. Otherwise, return
+0
5.
If
base
is
-∞
, then
a.
If
exponent
+0
, then
i.
If
exponent
is an odd
integral Number
, return
-∞
. Otherwise, return
+∞
b.
Else,
i.
If
exponent
is an odd
integral Number
, return
-0
. Otherwise, return
+0
6.
If
base
is
+0
, then
a.
If
exponent
+0
, return
+0
. Otherwise, return
+∞
7.
If
base
is
-0
, then
a.
If
exponent
+0
, then
i.
If
exponent
is an odd
integral Number
, return
-0
. Otherwise, return
+0
b.
Else,
i.
If
exponent
is an odd
integral Number
, return
-∞
. Otherwise, return
+∞
8.
Assert
base
is finite and is neither
+0
nor
-0
9.
If
exponent
is
+∞
, then
a.
If
abs
base
)) > 1, return
+∞
b.
If
abs
base
)) is 1, return
NaN
c.
If
abs
base
)) < 1, return
+0
10.
If
exponent
is
-∞
, then
a.
If
abs
base
)) > 1, return
+0
b.
If
abs
base
)) is 1, return
NaN
c.
If
abs
base
)) < 1, return
+∞
11.
Assert
exponent
is finite and is neither
+0
nor
-0
12.
If
base
+0
and
exponent
is not an
integral Number
, return
NaN
13.
Return an
implementation-approximated
value representing the result of raising
base
) to the
exponent
) power.
Note
The result of
base
**
exponent
when
base
is
or
-1
and
exponent
is
+∞
or
-∞
, or when
base
is
and
exponent
is
NaN
, differs from
IEEE 754-2019
. The first edition of ECMAScript specified a result of
NaN
for this operation, whereas later versions of
IEEE 754-2019
specified
. The historical ECMAScript behaviour is preserved for compatibility reasons.
6.1.6.1.4
Number::multiply (
The abstract operation Number::multiply takes arguments
(a Number) and
(a Number). It performs multiplication according to the rules of
IEEE 754-2019
binary double-precision arithmetic, producing the product of
and
. It performs the following steps when called:
1.
If
is
NaN
or
is
NaN
, return
NaN
2.
If
is
+∞
or
is
-∞
, then
a.
If
is
+0
or
is
-0
, return
NaN
b.
If
+0
, return
c.
Return -
3.
If
is
+∞
or
is
-∞
, then
a.
If
is
+0
or
is
-0
, return
NaN
b.
If
+0
, return
c.
Return -
4.
Return
) ×
)).
Note
Finite-precision multiplication is commutative, but not always associative.
6.1.6.1.5
Number::divide (
The abstract operation Number::divide takes arguments
(a Number) and
(a Number). It performs division according to the rules of
IEEE 754-2019
binary double-precision arithmetic, producing the quotient of
and
where
is the dividend and
is the divisor. It performs the following steps when called:
1.
If
is
NaN
or
is
NaN
, return
NaN
2.
If
is
+∞
or
is
-∞
, then
a.
If
is
+∞
or
is
-∞
, return
NaN
b.
If
is
+0
or
+0
, return
c.
Return -
3.
If
is
+∞
, then
a.
If
is
+0
or
+0
, return
+0
. Otherwise, return
-0
4.
If
is
-∞
, then
a.
If
is
+0
or
+0
, return
-0
. Otherwise, return
+0
5.
If
is
+0
or
is
-0
, then
a.
If
is
+0
or
is
-0
, return
NaN
b.
If
+0
, return
c.
Return -
6.
If
is
+0
, then
a.
If
+0
, return
+∞
. Otherwise, return
-∞
7.
If
is
-0
, then
a.
If
+0
, return
-∞
. Otherwise, return
+∞
8.
Return
) /
)).
6.1.6.1.6
Number::remainder (
The abstract operation Number::remainder takes arguments
(a Number) and
(a Number). It yields the remainder from an implied division of its operands where
is the dividend and
is the divisor. It performs the following steps when called:
1.
If
is
NaN
or
is
NaN
, return
NaN
2.
If
is
+∞
or
is
-∞
, return
NaN
3.
If
is
+∞
or
is
-∞
, return
4.
If
is
+0
or
is
-0
, return
NaN
5.
If
is
+0
or
is
-0
, return
6.
Assert
and
are finite and non-zero.
7.
Let
be
) - (
) ×
) where
is an
integer
that is negative if and only if
and
have opposite sign, and whose magnitude is as large as possible without exceeding the magnitude of
) /
).
8.
Return
).
Note 1
In C and C++, the remainder operator accepts only integral operands; in ECMAScript, it also accepts floating-point operands.
Note 2
The result of a floating-point remainder operation as computed by the
operator is not the same as the “remainder” operation defined by
IEEE 754-2019
. The
IEEE 754-2019
“remainder” operation computes the remainder from a rounding division,
not a truncating division, and so its behaviour is not analogous to that
of the usual
integer
remainder operator. Instead the ECMAScript language defines
on floating-point operations to behave in a manner analogous to that of the Java
integer
remainder operator; this may be compared with the C library function fmod.
6.1.6.1.7
Number::add (
The abstract operation Number::add takes arguments
(a Number) and
(a Number). It performs addition according to the rules of
IEEE 754-2019
binary double-precision arithmetic, producing the sum of its arguments. It performs the following steps when called:
1.
If
is
NaN
or
is
NaN
, return
NaN
2.
If
is
+∞
and
is
-∞
, return
NaN
3.
If
is
-∞
and
is
+∞
, return
NaN
4.
If
is
+∞
or
is
-∞
, return
5.
If
is
+∞
or
is
-∞
, return
6.
Assert
and
are both finite.
7.
If
is
-0
and
is
-0
, return
-0
8.
Return
) +
)).
Note
Finite-precision addition is commutative, but not always associative.
6.1.6.1.8
Number::subtract (
The abstract operation Number::subtract takes arguments
(a Number) and
(a Number). It performs subtraction, producing the difference of its operands;
is the minuend and
is the subtrahend. It performs the following steps when called:
1.
Return Number::add(
, Number::unaryMinus(
)).
Note
It is always the case that
x - y
produces the same result as
x + (-y)
6.1.6.1.9
Number::leftShift (
The abstract operation Number::leftShift takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Let
lnum
be !
ToInt32
).
2.
Let
rnum
be !
ToUint32
).
3.
Let
shiftCount
be
rnum
modulo
32.
4.
Return the result of left shifting
lnum
by
shiftCount
bits. The
mathematical value
of the result is exactly representable as a 32-bit two's complement bit string.
6.1.6.1.10
Number::signedRightShift (
The abstract operation Number::signedRightShift takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Let
lnum
be !
ToInt32
).
2.
Let
rnum
be !
ToUint32
).
3.
Let
shiftCount
be
rnum
modulo
32.
4.
Return the result of performing a sign-extending right shift of
lnum
by
shiftCount
bits. The most significant bit is propagated. The
mathematical value
of the result is exactly representable as a 32-bit two's complement bit string.
6.1.6.1.11
Number::unsignedRightShift (
The abstract operation Number::unsignedRightShift takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Let
lnum
be !
ToUint32
).
2.
Let
rnum
be !
ToUint32
).
3.
Let
shiftCount
be
rnum
modulo
32.
4.
Return the result of performing a zero-filling right shift of
lnum
by
shiftCount
bits. Vacated bits are filled with zero. The
mathematical value
of the result is exactly representable as a 32-bit unsigned bit string.
6.1.6.1.12
Number::lessThan (
The abstract operation Number::lessThan takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
If
is
NaN
, return
undefined
2.
If
is
NaN
, return
undefined
3.
If
and
are the same
Number value
, return
false
4.
If
is
+0
and
is
-0
, return
false
5.
If
is
-0
and
is
+0
, return
false
6.
If
is
+∞
, return
false
7.
If
is
+∞
, return
true
8.
If
is
-∞
, return
false
9.
If
is
-∞
, return
true
10.
Assert
and
are finite and non-zero.
11.
If
) <
), return
true
. Otherwise, return
false
6.1.6.1.13
Number::equal (
The abstract operation Number::equal takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
If
is
NaN
, return
false
2.
If
is
NaN
, return
false
3.
If
is the same
Number value
as
, return
true
4.
If
is
+0
and
is
-0
, return
true
5.
If
is
-0
and
is
+0
, return
true
6.
Return
false
6.1.6.1.14
Number::sameValue (
The abstract operation Number::sameValue takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
If
is
NaN
and
is
NaN
, return
true
2.
If
is
+0
and
is
-0
, return
false
3.
If
is
-0
and
is
+0
, return
false
4.
If
is the same
Number value
as
, return
true
5.
Return
false
6.1.6.1.15
Number::sameValueZero (
The abstract operation Number::sameValueZero takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
If
is
NaN
and
is
NaN
, return
true
2.
If
is
+0
and
is
-0
, return
true
3.
If
is
-0
and
is
+0
, return
true
4.
If
is the same
Number value
as
, return
true
5.
Return
false
6.1.6.1.16
NumberBitwiseOp (
op
The abstract operation NumberBitwiseOp takes arguments
op
(a sequence of Unicode code points),
, and
. It performs the following steps when called:
1.
Assert
op
is
, or
2.
Let
lnum
be !
ToInt32
).
3.
Let
rnum
be !
ToInt32
).
4.
Let
lbits
be the 32-bit two's complement bit string representing
lnum
).
5.
Let
rbits
be the 32-bit two's complement bit string representing
rnum
).
6.
If
op
is
, let
result
be the result of applying the bitwise AND operation to
lbits
and
rbits
7.
Else if
op
is
, let
result
be the result of applying the bitwise exclusive OR (XOR) operation to
lbits
and
rbits
8.
Else,
op
is
. Let
result
be the result of applying the bitwise inclusive OR operation to
lbits
and
rbits
9.
Return the
Number value
for the
integer
represented by the 32-bit two's complement bit string
result
6.1.6.1.17
Number::bitwiseAND (
The abstract operation Number::bitwiseAND takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Return
NumberBitwiseOp
).
6.1.6.1.18
Number::bitwiseXOR (
The abstract operation Number::bitwiseXOR takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Return
NumberBitwiseOp
).
6.1.6.1.19
Number::bitwiseOR (
The abstract operation Number::bitwiseOR takes arguments
(a Number) and
(a Number). It performs the following steps when called:
1.
Return
NumberBitwiseOp
).
6.1.6.1.20
Number::toString (
The abstract operation Number::toString takes argument
(a Number). It converts
to String format. It performs the following steps when called:
1.
If
is
NaN
, return the String
"NaN"
2.
If
is
+0
or
-0
, return the String
"0"
3.
If
+0
, return the
string-concatenation
of
"-"
and !
Number::toString
(-
).
4.
If
is
+∞
, return the String
"Infinity"
5.
Otherwise, let
, and
be integers such that
≥ 1, 10
- 1
< 10
× 10
is
), and
is as small as possible. Note that
is the number of digits in the decimal representation of
, that
is not divisible by 10, and that the least significant digit of
is not necessarily uniquely determined by these criteria.
6.
If
≤ 21, return the
string-concatenation
of:
the code units of the
digits of the decimal representation of
(in order, with no leading zeroes)
occurrences of the code unit 0x0030 (DIGIT ZERO)
7.
If 0 <
≤ 21, return the
string-concatenation
of:
the code units of the most significant
digits of the decimal representation of
the code unit 0x002E (FULL STOP)
the code units of the remaining
digits of the decimal representation of
8.
If -6 <
≤ 0, return the
string-concatenation
of:
the code unit 0x0030 (DIGIT ZERO)
the code unit 0x002E (FULL STOP)
occurrences of the code unit 0x0030 (DIGIT ZERO)
the code units of the
digits of the decimal representation of
9.
Otherwise, if
= 1, return the
string-concatenation
of:
the code unit of the single digit of
the code unit 0x0065 (LATIN SMALL LETTER E)
the code unit 0x002B (PLUS SIGN) or the code unit 0x002D (HYPHEN-MINUS) according to whether
- 1 is positive or negative
the code units of the decimal representation of the
integer
abs
- 1) (with no leading zeroes)
10.
Return the
string-concatenation
of:
the code units of the most significant digit of the decimal representation of
the code unit 0x002E (FULL STOP)
the code units of the remaining
- 1 digits of the decimal representation of
the code unit 0x0065 (LATIN SMALL LETTER E)
the code unit 0x002B (PLUS SIGN) or the code unit 0x002D (HYPHEN-MINUS) according to whether
- 1 is positive or negative
the code units of the decimal representation of the
integer
abs
- 1) (with no leading zeroes)
Note 1
The following observations may be useful as guidelines
for implementations, but are not part of the normative requirements of
this Standard:
If x is any
Number value
other than
-0
, then
ToNumber
ToString
(x)) is exactly the same
Number value
as x.
The least significant digit of s is not always uniquely determined by the requirements listed in step
Note 2
For implementations that provide more accurate
conversions than required by the rules above, it is recommended that the
following alternative version of step
be used as a guideline:
1.
Otherwise, let
, and
be integers such that
≥ 1, 10
- 1
< 10
× 10
is
), and
is as small as possible. If there are multiple possibilities for
, choose the value of
for which
× 10
is closest in value to
). If there are two such possible values of
, choose the one that is even. Note that
is the number of digits in the decimal representation of
and that
is not divisible by 10.
Note 3
Implementers of ECMAScript may find useful the paper and
code written by David M. Gay for binary-to-decimal conversion of
floating-point numbers:
Gay, David M. Correctly Rounded Binary-Decimal and
Decimal-Binary Conversions. Numerical Analysis, Manuscript 90-10.
AT&T Bell Laboratories (Murray Hill, New Jersey). 30 November 1990.
Available as
. Associated code available as
and as
and may also be found at the various
netlib
mirror sites.
6.1.6.2
The BigInt Type
The BigInt type represents an
integer
value. The value may be any size and is not limited to a particular
bit-width. Generally, where not otherwise noted, operations are designed
to return exact mathematically-based answers. For binary operations,
BigInts act as two's complement binary strings, with negative numbers
treated as having bits set infinitely to the left.
The BigInt::unit value is
6.1.6.2.1
BigInt::unaryMinus (
The abstract operation BigInt::unaryMinus takes argument
(a BigInt). It performs the following steps when called:
1.
If
is
, return
2.
Return the BigInt value that represents the negation of
).
6.1.6.2.2
BigInt::bitwiseNOT (
The abstract operation BigInt::bitwiseNOT takes argument
(a BigInt). It returns the one's complement of
; that is, -
6.1.6.2.3
BigInt::exponentiate (
base
exponent
The abstract operation BigInt::exponentiate takes arguments
base
(a BigInt) and
exponent
(a BigInt). It performs the following steps when called:
1.
If
exponent
, throw a
RangeError
exception.
2.
If
base
is
and
exponent
is
, return
3.
Return the BigInt value that represents
base
) raised to the power
exponent
).
6.1.6.2.4
BigInt::multiply (
The abstract operation BigInt::multiply takes arguments
(a BigInt) and
(a BigInt). It returns the BigInt value that represents the result of multiplying
and
Note
Even if the result has a much larger bit width than the input, the exact mathematical answer is given.
6.1.6.2.5
BigInt::divide (
The abstract operation BigInt::divide takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
If
is
, throw a
RangeError
exception.
2.
Let
quotient
be
) /
).
3.
Return the BigInt value that represents
quotient
rounded towards 0 to the next
integer
value.
6.1.6.2.6
BigInt::remainder (
The abstract operation BigInt::remainder takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
If
is
, throw a
RangeError
exception.
2.
If
is
, return
3.
Let
be the BigInt defined by the mathematical relation
- (
) where
is a BigInt that is negative only if
is negative and positive only if
is positive, and whose magnitude is as large as possible without exceeding the magnitude of the true mathematical quotient of
and
4.
Return
Note
The sign of the result equals the sign of the dividend.
6.1.6.2.7
BigInt::add (
The abstract operation BigInt::add takes arguments
(a BigInt) and
(a BigInt). It returns the BigInt value that represents the sum of
and
6.1.6.2.8
BigInt::subtract (
The abstract operation BigInt::subtract takes arguments
(a BigInt) and
(a BigInt). It returns the BigInt value that represents the difference
minus
6.1.6.2.9
BigInt::leftShift (
The abstract operation BigInt::leftShift takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
If
, then
a.
Return the BigInt value that represents
) / 2
, rounding down to the nearest
integer
, including for negative numbers.
2.
Return the BigInt value that represents
) × 2
Note
Semantics
here should be equivalent to a bitwise shift, treating the BigInt as an
infinite length string of binary two's complement digits.
6.1.6.2.10
BigInt::signedRightShift (
The abstract operation BigInt::signedRightShift takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return BigInt::leftShift(
, -
).
6.1.6.2.11
BigInt::unsignedRightShift (
The abstract operation BigInt::unsignedRightShift takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Throw a
TypeError
exception.
6.1.6.2.12
BigInt::lessThan (
The abstract operation BigInt::lessThan takes arguments
(a BigInt) and
(a BigInt). It returns
true
if
) <
) and
false
otherwise.
6.1.6.2.13
BigInt::equal (
The abstract operation BigInt::equal takes arguments
(a BigInt) and
(a BigInt). It returns
true
if
) =
) and
false
otherwise.
6.1.6.2.14
BigInt::sameValue (
The abstract operation BigInt::sameValue takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return BigInt::equal(
).
6.1.6.2.15
BigInt::sameValueZero (
The abstract operation BigInt::sameValueZero takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return BigInt::equal(
).
6.1.6.2.16
BinaryAnd (
The abstract operation BinaryAnd takes arguments
and
. It performs the following steps when called:
1.
Assert
is 0 or 1.
2.
Assert
is 0 or 1.
3.
If
is 1 and
is 1, return 1.
4.
Else, return 0.
6.1.6.2.17
BinaryOr (
The abstract operation BinaryOr takes arguments
and
. It performs the following steps when called:
1.
Assert
is 0 or 1.
2.
Assert
is 0 or 1.
3.
If
is 1 or
is 1, return 1.
4.
Else, return 0.
6.1.6.2.18
BinaryXor (
The abstract operation BinaryXor takes arguments
and
. It performs the following steps when called:
1.
Assert
is 0 or 1.
2.
Assert
is 0 or 1.
3.
If
is 1 and
is 0, return 1.
4.
Else if
is 0 and
is 1, return 1.
5.
Else, return 0.
6.1.6.2.19
BigIntBitwiseOp (
op
The abstract operation BigIntBitwiseOp takes arguments
op
(a sequence of Unicode code points),
(a BigInt), and
(a BigInt). It performs the following steps when called:
1.
Assert
op
is
, or
2.
Set
to
).
3.
Set
to
).
4.
Let
result
be 0.
5.
Let
shift
be 0.
6.
Repeat, until (
= 0 or
= -1) and (
= 0 or
= -1),
a.
Let
xDigit
be
modulo
2.
b.
Let
yDigit
be
modulo
2.
c.
If
op
is
, set
result
to
result
+ 2
shift
BinaryAnd
xDigit
yDigit
).
d.
Else if
op
is
, set
result
to
result
+ 2
shift
BinaryOr
xDigit
yDigit
).
e.
Else,
i.
Assert
op
is
ii.
Set
result
to
result
+ 2
shift
BinaryXor
xDigit
yDigit
).
f.
Set
shift
to
shift
+ 1.
g.
Set
to (
xDigit
) / 2.
h.
Set
to (
yDigit
) / 2.
7.
If
op
is
, let
tmp
be
BinaryAnd
modulo
2,
modulo
2).
8.
Else if
op
is
, let
tmp
be
BinaryOr
modulo
2,
modulo
2).
9.
Else,
a.
Assert
op
is
b.
Let
tmp
be
BinaryXor
modulo
2,
modulo
2).
10.
If
tmp
≠ 0, then
a.
Set
result
to
result
- 2
shift
b.
NOTE: This extends the sign.
11.
Return the BigInt value for
result
6.1.6.2.20
BigInt::bitwiseAND (
The abstract operation BigInt::bitwiseAND takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return
BigIntBitwiseOp
).
6.1.6.2.21
BigInt::bitwiseXOR (
The abstract operation BigInt::bitwiseXOR takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return
BigIntBitwiseOp
).
6.1.6.2.22
BigInt::bitwiseOR (
The abstract operation BigInt::bitwiseOR takes arguments
(a BigInt) and
(a BigInt). It performs the following steps when called:
1.
Return
BigIntBitwiseOp
).
6.1.6.2.23
BigInt::toString (
The abstract operation BigInt::toString takes argument
(a BigInt). It converts
to String format. It performs the following steps when called:
1.
If
, return the
string-concatenation
of the String
"-"
and !
BigInt::toString
(-
).
2.
Return the String value consisting of the code units of the digits of the decimal representation of
6.1.7
The Object Type
An Object is logically a collection of properties. Each property is either a data property, or an accessor property:
data property
associates a key value with an
ECMAScript language value
and a set of Boolean attributes.
An
accessor property
associates a key value with
one or two accessor functions, and a set of Boolean attributes. The
accessor functions are used to store or retrieve an
ECMAScript language value
that is associated with the property.
Properties are identified using key values. A property key
value is either an ECMAScript String value or a Symbol value. All String
and Symbol values, including the empty String, are valid as property
keys. A
property name
is a property key that is a String value.
An
integer index
is a String-valued property key that is a canonical numeric String (see
7.1.21
) and whose numeric value is either
+0
or a positive
integral Number
(2
53
- 1). An
array index
is an
integer index
whose numeric value
is in the range
+0
(2
32
- 1)
Property keys are used to access properties and their values. There are two kinds of access for properties:
get
and
set
, corresponding to value retrieval and assignment, respectively. The properties accessible via get and set access includes both
own properties
that are a direct part of an object and
inherited properties
which are provided by another associated object via a property
inheritance relationship. Inherited properties may be either own or
inherited properties of the associated object. Each own property of an
object must each have a key value that is distinct from the key values
of the other own properties of that object.
All objects are logically collections of properties, but there
are multiple forms of objects that differ in their semantics for
accessing and manipulating their properties. Please see
6.1.7.2
for definitions of the multiple forms of objects.
6.1.7.1
Property Attributes
Attributes are used in this specification to define and explain the state of Object properties. A
data property
associates a key value with the attributes listed in
Table 3
Table 3: Attributes of a Data Property
Attribute Name
Value Domain
Description
[[Value]]
Any
ECMAScript language type
The value retrieved by a get access of the property.
[[Writable]]
Boolean
If
false
, attempts by ECMAScript code to change the property's [[Value]] attribute using [[Set]] will not succeed.
[[Enumerable]]
Boolean
If
true
, the property will be enumerated by a for-in enumeration (see
14.7.5
). Otherwise, the property is said to be non-enumerable.
[[Configurable]]
Boolean
If
false
, attempts to delete the property, change the property to be an
accessor property
, or change its attributes (other than [[Value]], or changing [[Writable]] to
false
) will fail.
An
accessor property
associates a key value with the attributes listed in
Table 4
Table 4: Attributes of an Accessor Property
Attribute Name
Value Domain
Description
[[Get]]
Object | Undefined
If the value is an Object it must be a
function object
. The function's [[Call]] internal method (
Table 7
) is called with an empty arguments list to retrieve the property value each time a get access of the property is performed.
[[Set]]
Object | Undefined
If the value is an Object it must be a
function object
. The function's [[Call]] internal method (
Table 7
is called with an arguments list containing the assigned value as its
sole argument each time a set access of the property is performed. The
effect of a property's [[Set]] internal method may, but is not required
to, have an effect on the value returned by subsequent calls to the
property's [[Get]] internal method.
[[Enumerable]]
Boolean
If
true
, the property is to be enumerated by a for-in enumeration (see
14.7.5
). Otherwise, the property is said to be non-enumerable.
[[Configurable]]
Boolean
If
false
, attempts to delete the property, change the property to be a
data property
, or change its attributes will fail.
If the initial values of a property's attributes are not
explicitly specified by this specification, the default value defined in
Table 5
is used.
Table 5: Default Attribute Values
Attribute Name
Default Value
[[Value]]
undefined
[[Get]]
undefined
[[Set]]
undefined
[[Writable]]
false
[[Enumerable]]
false
[[Configurable]]
false
6.1.7.2
Object Internal Methods and Internal Slots
The actual semantics of objects, in ECMAScript, are specified via algorithms called
internal methods
Each object in an ECMAScript engine is associated with a set of
internal methods that defines its runtime behaviour. These internal
methods are not part of the ECMAScript language. They are defined by
this specification purely for expository purposes. However, each object
within an implementation of ECMAScript must behave as specified by the
internal methods associated with it. The exact manner in which this is
accomplished is determined by the implementation.
Internal method names are polymorphic. This means that
different object values may perform different algorithms when a common
internal method name is invoked upon them. That actual object upon which
an internal method is invoked is the “target” of the invocation. If, at
runtime, the implementation of an algorithm attempts to use an internal
method of an object that the object does not support, a
TypeError
exception is thrown.
Internal slots correspond to internal state that is
associated with objects and used by various ECMAScript specification
algorithms. Internal slots are not object properties and they are not
inherited. Depending upon the specific internal slot specification, such
state may consist of values of any
ECMAScript language type
or of specific ECMAScript specification type values. Unless explicitly
specified otherwise, internal slots are allocated as part of the process
of creating an object and may not be dynamically added to an object.
Unless specified otherwise, the initial value of an internal slot is the
value
undefined
. Various algorithms within this
specification create objects that have internal slots. However, the
ECMAScript language provides no direct way to associate internal slots
with an object.
Internal methods and internal slots are identified within
this specification using names enclosed in double square brackets [[ ]].
Table 6
summarizes the
essential internal methods
used by this specification that are applicable to all objects created
or manipulated by ECMAScript code. Every object must have algorithms for
all of the essential internal methods. However, all objects do not
necessarily use the same algorithms for those methods.
An
ordinary object
is an object that satisfies all of the following criteria:
For the internal methods listed in
Table 6
, the object uses those defined in
10.1
If the object has a [[Call]] internal method, it uses the one defined in
10.2.1
If the object has a [[Construct]] internal method, it uses the one defined in
10.2.2
An
exotic object
is an object that is not an
ordinary object
This specification recognizes different kinds of exotic
objects by those objects' internal methods. An object that is
behaviourally equivalent to a particular kind of
exotic object
(such as an
Array exotic object
or a
bound function exotic object
), but does not have the same collection of internal methods specified for that kind, is not recognized as that kind of
exotic object
The “Signature” column of
Table 6
and other similar tables describes the invocation pattern for each
internal method. The invocation pattern always includes a parenthesized
list of descriptive parameter names. If a parameter name is the same as
an ECMAScript type name then the name describes the required type of the
parameter value. If an internal method explicitly returns a value, its
parameter list is followed by the symbol “→” and the type name of the
returned value. The type names used in signatures refer to the types
defined in clause
augmented by the following additional names. “
any
” means the value may be any
ECMAScript language type
In addition to its parameters, an internal method always has access to the object that is the target of the method invocation.
An internal method implicitly returns a
Completion Record
, either a normal completion that wraps a value of the return type shown in its invocation pattern, or a throw completion.
Table 6: Essential Internal Methods
Internal Method
Signature
Description
[[GetPrototypeOf]]
( )
Object | Null
Determine the object that provides inherited properties for this object. A
null
value indicates that there are no inherited properties.
[[SetPrototypeOf]]
(Object | Null)
Boolean
Associate this object with another object that provides inherited properties. Passing
null
indicates that there are no inherited properties. Returns
true
indicating that the operation was completed successfully or
false
indicating that the operation was not successful.
[[IsExtensible]]
( )
Boolean
Determine whether it is permitted to add additional properties to this object.
[[PreventExtensions]]
( )
Boolean
Control whether new properties may be added to this object. Returns
true
if the operation was successful or
false
if the operation was unsuccessful.
[[GetOwnProperty]]
propertyKey
Undefined |
Property Descriptor
Return a
Property Descriptor
for the own property of this object whose key is
propertyKey
, or
undefined
if no such property exists.
[[DefineOwnProperty]]
propertyKey
PropertyDescriptor
Boolean
Create or alter the own property, whose key is
propertyKey
, to have the state described by
PropertyDescriptor
. Return
true
if that property was successfully created/updated or
false
if the property could not be created or updated.
[[HasProperty]]
propertyKey
Boolean
Return a Boolean value indicating whether this object
already has either an own or inherited property whose key is
propertyKey
[[Get]]
propertyKey
Receiver
any
Return the value of the property whose key is
propertyKey
from this object. If any ECMAScript code must be executed to retrieve the property value,
Receiver
is used as the
this
value when evaluating the code.
[[Set]]
propertyKey
value
Receiver
Boolean
Set the value of the property whose key is
propertyKey
to
value
. If any ECMAScript code must be executed to set the property value,
Receiver
is used as the
this
value when evaluating the code. Returns
true
if the property value was set or
false
if it could not be set.
[[Delete]]
propertyKey
Boolean
Remove the own property whose key is
propertyKey
from this object. Return
false
if the property was not deleted and is still present. Return
true
if the property was deleted or is not present.
[[OwnPropertyKeys]]
( )
List
of propertyKey
Return a
List
whose elements are all of the own property keys for the object.
Table 7
summarizes additional essential internal methods that are supported by objects that may be called as functions. A
function object
is an object that supports the [[Call]] internal method. A
constructor
is an object that supports the [[Construct]] internal method. Every
object that supports [[Construct]] must support [[Call]]; that is, every
constructor
must be a
function object
. Therefore, a
constructor
may also be referred to as a
constructor
function
or
constructor
function object
Table 7: Additional Essential Internal Methods of Function Objects
Internal Method
Signature
Description
[[Call]]
any
, a
List
of
any
any
Executes code associated with this object. Invoked via a
function call expression. The arguments to the internal method are a
this
value and a
List
whose elements are the arguments passed to the function by a call expression. Objects that implement this internal method are
callable
[[Construct]]
(a
List
of
any
, Object)
Object
Creates an object. Invoked via the
new
operator or a
super
call. The first argument to the internal method is a
List
whose elements are the arguments of the
constructor
invocation or the
super
call. The second argument is the object to which the
new
operator was initially applied. Objects that implement this internal method are called
constructors
. A
function object
is not necessarily a
constructor
and such non-
constructor
function objects do not have a [[Construct]] internal method.
The semantics of the essential internal methods for ordinary objects and standard exotic objects are specified in clause
10
. If any specified use of an internal method of an
exotic object
is not supported by an implementation, that usage must throw a
TypeError
exception when attempted.
6.1.7.3
Invariants of the Essential Internal Methods
The Internal Methods of Objects of an ECMAScript engine must
conform to the list of invariants specified below. Ordinary ECMAScript
Objects as well as all standard exotic objects in this specification
maintain these invariants. ECMAScript Proxy objects maintain these
invariants by means of runtime checks on the result of traps invoked on
the [[ProxyHandler]] object.
Any implementation provided exotic objects must also maintain
these invariants for those objects. Violation of these invariants may
cause ECMAScript code to have unpredictable behaviour and create
security issues. However, violation of these invariants must never
compromise the memory safety of an implementation.
An implementation must not allow these invariants to be
circumvented in any manner such as by providing alternative interfaces
that implement the functionality of the essential internal methods
without enforcing their invariants.
Definitions:
The
target
of an internal method is the object upon which the internal method is called.
A target is
non-extensible
if it has been observed to return
false
from its [[IsExtensible]] internal method, or
true
from its [[PreventExtensions]] internal method.
non-existent
property is a property that does not exist as an own property on a non-extensible target.
All references to
SameValue
are according to the definition of the
SameValue
algorithm.
Return value:
The value returned by any internal method must be a
Completion Record
with either:
[[Type]] =
normal
, [[Target]] =
empty
, and [[Value]] = a value of the "normal return type" shown below for that internal method, or
[[Type]] =
throw
, [[Target]] =
empty
, and [[Value]] = any
ECMAScript language value
Note 1
An internal method must not return a completion with [[Type]] =
continue
break
, or
return
[[GetPrototypeOf]] ( )
The normal return type is either Object or Null.
If target is non-extensible, and [[GetPrototypeOf]] returns a value
, then any future calls to [[GetPrototypeOf]] should return the
SameValue
as
Note 2
An object's prototype chain should have finite length (that
is, starting from any object, recursively applying the
[[GetPrototypeOf]] internal method to its result should eventually lead
to the value
null
). However, this requirement is not
enforceable as an object level invariant if the prototype chain includes
any exotic objects that do not use the
ordinary object
definition of [[GetPrototypeOf]]. Such a circular prototype chain may
result in infinite loops when accessing object properties.
[[SetPrototypeOf]] (
The normal return type is Boolean.
If target is non-extensible, [[SetPrototypeOf]] must return
false
, unless
is the
SameValue
as the target's observed [[GetPrototypeOf]] value.
[[IsExtensible]] ( )
The normal return type is Boolean.
If [[IsExtensible]] returns
false
, all future calls to [[IsExtensible]] on the target must return
false
[[PreventExtensions]] ( )
The normal return type is Boolean.
If [[PreventExtensions]] returns
true
, all future calls to [[IsExtensible]] on the target must return
false
and the target is now considered non-extensible.
[[GetOwnProperty]] (
The normal return type is either
Property Descriptor
or Undefined.
If the Type of the return value is
Property Descriptor
, the return value must be a fully populated
Property Descriptor
If
is described as a non-configurable, non-writable own
data property
, all future calls to [[GetOwnProperty]] (
) must return
Property Descriptor
whose [[Value]] is
SameValue
as
's [[Value]] attribute.
If
's attributes other than [[Writable]] may change over time or if the property might be deleted, then
's [[Configurable]] attribute must be
true
If the [[Writable]] attribute may change from
false
to
true
, then the [[Configurable]] attribute must be
true
If the target is non-extensible and
is non-existent, then all future calls to [[GetOwnProperty]] (
) on the target must describe
as non-existent (i.e. [[GetOwnProperty]] (
) must return
undefined
).
Note 3
As a consequence of the third invariant, if a property is described as a
data property
and it may return different values over time, then either or both of the [[Writable]] and [[Configurable]] attributes must be
true
even if no mechanism to change the value is exposed via the other essential internal methods.
[[DefineOwnProperty]] (
Desc
The normal return type is Boolean.
[[DefineOwnProperty]] must return
false
if
has previously been observed as a non-configurable own property of the target, unless either:
is a writable
data property
. A non-configurable writable
data property
can be changed into a non-configurable non-writable
data property
All attributes of
Desc
are the
SameValue
as
's attributes.
[[DefineOwnProperty]] (
Desc
) must return
false
if target is non-extensible and
is a non-existent own property. That is, a non-extensible target object cannot be extended with new properties.
[[HasProperty]] (
The normal return type is Boolean.
If
was previously observed as a non-configurable own data or
accessor property
of the target, [[HasProperty]] must return
true
[[Get]] (
Receiver
The normal return type is any
ECMAScript language type
If
was previously observed as a non-configurable, non-writable own
data property
of the target with value
, then [[Get]] must return the
SameValue
as
If
was previously observed as a non-configurable own
accessor property
of the target whose [[Get]] attribute is
undefined
, the [[Get]] operation must return
undefined
[[Set]] (
Receiver
The normal return type is Boolean.
If
was previously observed as a non-configurable, non-writable own
data property
of the target, then [[Set]] must return
false
unless
is the
SameValue
as
's [[Value]] attribute.
If
was previously observed as a non-configurable own
accessor property
of the target whose [[Set]] attribute is
undefined
, the [[Set]] operation must return
false
[[Delete]] (
The normal return type is Boolean.
If
was previously observed as a non-configurable own data or
accessor property
of the target, [[Delete]] must return
false
[[OwnPropertyKeys]] ( )
The normal return type is
List
The returned
List
must not contain any duplicate entries.
The Type of each element of the returned
List
is either String or Symbol.
The returned
List
must contain at least the keys of all non-configurable own properties that have previously been observed.
If the target is non-extensible, the returned
List
must contain only the keys of all own properties of the target that are observable using [[GetOwnProperty]].
[[Call]] ( )
The normal return type is any
ECMAScript language type
[[Construct]] ( )
The normal return type is Object.
The target must also have a [[Call]] internal method.
6.1.7.4
Well-Known Intrinsic Objects
Well-known intrinsics are built-in objects that are
explicitly referenced by the algorithms of this specification and which
usually have
realm
-specific
identities. Unless otherwise specified each intrinsic object actually
corresponds to a set of similar objects, one per
realm
Within this specification a reference such as %name% means the intrinsic object, associated with the current
realm
corresponding to the name. A reference such as %name.a.b% means, as if
the "b" property of the "a" property of the intrinsic object %name% was
accessed prior to any ECMAScript code being evaluated. Determination of
the current
realm
and its intrinsics is described in
9.3
. The well-known intrinsics are listed in
Table 8
Table 8: Well-Known Intrinsic Objects
Intrinsic Name
Global Name
ECMAScript Language Association
%AggregateError%
AggregateError
The
AggregateError
constructor
20.5.7.1
%Array%
Array
The Array
constructor
23.1.1
%ArrayBuffer%
ArrayBuffer
The ArrayBuffer
constructor
25.1.3
%ArrayIteratorPrototype%
The prototype of Array iterator objects (
23.1.5
%AsyncFromSyncIteratorPrototype%
The prototype of async-from-sync iterator objects (
27.1.4
%AsyncFunction%
The
constructor
of async function objects (
27.7.1
%AsyncGeneratorFunction%
The
constructor
of async iterator objects (
27.4.1
%AsyncIteratorPrototype%
An object that all standard built-in async iterator objects indirectly inherit from
%Atomics%
Atomics
The
Atomics
object (
25.4
%BigInt%
BigInt
The BigInt
constructor
21.2.1
%BigInt64Array%
BigInt64Array
The BigInt64Array
constructor
23.2
%BigUint64Array%
BigUint64Array
The BigUint64Array
constructor
23.2
%Boolean%
Boolean
The Boolean
constructor
20.3.1
%DataView%
DataView
The DataView
constructor
25.3.2
%Date%
Date
The Date
constructor
21.4.2
%decodeURI%
decodeURI
The
decodeURI
function (
19.2.6.2
%decodeURIComponent%
decodeURIComponent
The
decodeURIComponent
function (
19.2.6.3
%encodeURI%
encodeURI
The
encodeURI
function (
19.2.6.4
%encodeURIComponent%
encodeURIComponent
The
encodeURIComponent
function (
19.2.6.5
%Error%
Error
The Error
constructor
20.5.1
%eval%
eval
The
eval
function (
19.2.1
%EvalError%
EvalError
The EvalError
constructor
20.5.5.1
%FinalizationRegistry%
FinalizationRegistry
The
FinalizationRegistry
constructor
26.2.1
%Float32Array%
Float32Array
The Float32Array
constructor
23.2
%Float64Array%
Float64Array
The Float64Array
constructor
23.2
%ForInIteratorPrototype%
The prototype of For-In iterator objects (
14.7.5.10
%Function%
Function
The Function
constructor
20.2.1
%GeneratorFunction%
The
constructor
of generator objects (
27.3.1
%Int8Array%
Int8Array
The Int8Array
constructor
23.2
%Int16Array%
Int16Array
The Int16Array
constructor
23.2
%Int32Array%
Int32Array
The Int32Array
constructor
23.2
%isFinite%
isFinite
The
isFinite
function (
19.2.2
%isNaN%
isNaN
The
isNaN
function (
19.2.3
%IteratorPrototype%
An object that all standard built-in iterator objects indirectly inherit from
%JSON%
JSON
The
JSON
object (
25.5
%Map%
Map
The Map
constructor
24.1.1
%MapIteratorPrototype%
The prototype of Map iterator objects (
24.1.5
%Math%
Math
The
Math
object (
21.3
%Number%
Number
The Number
constructor
21.1.1
%Object%
Object
The Object
constructor
20.1.1
%parseFloat%
parseFloat
The
parseFloat
function (
19.2.4
%parseInt%
parseInt
The
parseInt
function (
19.2.5
%Promise%
Promise
The Promise
constructor
27.2.3
%Proxy%
Proxy
The Proxy
constructor
28.2.1
%RangeError%
RangeError
The RangeError
constructor
20.5.5.2
%ReferenceError%
ReferenceError
The ReferenceError
constructor
20.5.5.3
%Reflect%
Reflect
The
Reflect
object (
28.1
%RegExp%
RegExp
The RegExp
constructor
22.2.3
%RegExpStringIteratorPrototype%
The prototype of RegExp String Iterator objects (
22.2.7
%Set%
Set
The Set
constructor
24.2.1
%SetIteratorPrototype%
The prototype of Set iterator objects (
24.2.5
%SharedArrayBuffer%
SharedArrayBuffer
The SharedArrayBuffer
constructor
25.2.2
%String%
String
The String
constructor
22.1.1
%StringIteratorPrototype%
The prototype of String iterator objects (
22.1.5
%Symbol%
Symbol
The Symbol
constructor
20.4.1
%SyntaxError%
SyntaxError
The SyntaxError
constructor
20.5.5.4
%ThrowTypeError%
function object
that unconditionally throws a new instance of
%TypeError%
%TypedArray%
The super class of all typed Array constructors (
23.2.1
%TypeError%
TypeError
The TypeError
constructor
20.5.5.5
%Uint8Array%
Uint8Array
The Uint8Array
constructor
23.2
%Uint8ClampedArray%
Uint8ClampedArray
The Uint8ClampedArray
constructor
23.2
%Uint16Array%
Uint16Array
The Uint16Array
constructor
23.2
%Uint32Array%
Uint32Array
The Uint32Array
constructor
23.2
%URIError%
URIError
The URIError
constructor
20.5.5.6
%WeakMap%
WeakMap
The WeakMap
constructor
24.3.1
%WeakRef%
WeakRef
The
WeakRef
constructor
26.1.1
%WeakSet%
WeakSet
The WeakSet
constructor
24.4.1
Note
Additional entries in
Table 82
6.2
ECMAScript Specification Types
A specification type corresponds to meta-values that are used
within algorithms to describe the semantics of ECMAScript language
constructs and ECMAScript language types. The specification types
include
Reference
List
Completion
Property Descriptor
Environment Record
Abstract Closure
, and
Data Block
Specification type values are specification artefacts that do not
necessarily correspond to any specific entity within an ECMAScript
implementation. Specification type values may be used to describe
intermediate results of ECMAScript expression evaluation but such values
cannot be stored as properties of objects or values of ECMAScript
language variables.
6.2.1
The List and Record Specification Types
The
List
type is used to explain the evaluation of argument lists (see
13.3.8
) in
new
expressions, in function calls, and in other algorithms where a simple
ordered list of values is needed. Values of the List type are simply
ordered sequences of list elements containing the individual values.
These sequences may be of any length. The elements of a list may be
randomly accessed using 0-origin indices. For notational convenience an
array-like syntax can be used to access List elements. For example,
arguments
[2] is shorthand for saying the 3
rd
element of the List
arguments
When an algorithm iterates over the elements of a List without
specifying an order, the order used is the order of the elements in the
List.
For notational convenience within this specification, a literal
syntax can be used to express a new List value. For example, « 1, 2 »
defines a List value that has two elements each of which is initialized
to a specific value. A new empty List can be expressed as « ».
The
Record
type is used to describe data
aggregations within the algorithms of this specification. A Record type
value consists of one or more named fields. The value of each field is
either an ECMAScript value or an abstract value represented by a name
associated with the Record type. Field names are always enclosed in
double brackets, for example [[Value]].
For notational convenience within this specification, an object
literal-like syntax can be used to express a Record value. For example,
{ [[Field1]]: 42, [[Field2]]:
false
, [[Field3]]:
empty
} defines a Record value that has three fields, each of which is
initialized to a specific value. Field name order is not significant.
Any fields that are not explicitly listed are considered to be absent.
In specification text and algorithms, dot notation may be used
to refer to a specific field of a Record value. For example, if R is the
record shown in the previous paragraph then R.[[Field2]] is shorthand
for “the field of R named [[Field2]]”.
Schema for commonly used Record field combinations may be
named, and that name may be used as a prefix to a literal Record value
to identify the specific kind of aggregations that is being described.
For example: PropertyDescriptor { [[Value]]: 42, [[Writable]]:
false
, [[Configurable]]:
true
}.
6.2.2
The Set and Relation Specification Types
The
Set
type is used to explain a collection of unordered elements for use in the
memory model
Values of the Set type are simple collections of elements, where no
element appears more than once. Elements may be added to and removed
from Sets. Sets may be unioned, intersected, or subtracted from each
other.
The
Relation
type is used to explain constraints on
Sets. Values of the Relation type are Sets of ordered pairs of values
from its value domain. For example, a Relation on events is a set of
ordered pairs of events. For a Relation
and two values
and
in the value domain of
is shorthand for saying the ordered pair (
) is a member of
. A Relation is least with respect to some conditions when it is the smallest Relation that satisfies those conditions.
strict partial order
is a Relation value
that satisfies the following.
For all
, and
in
's domain:
It is not the case that
, and
If
and
, then
Note 1
The two properties above are called irreflexivity and transitivity, respectively.
strict total order
is a Relation value
that satisfies the following.
For all
, and
in
's domain:
is identical to
or
or
, and
It is not the case that
, and
If
and
, then
Note 2
The three properties above are called totality, irreflexivity, and transitivity, respectively.
6.2.3
The Completion Record Specification Type
The Completion type is a
Record
used to explain the runtime propagation of values and control flow such as the behaviour of statements (
break
continue
return
and
throw
) that perform nonlocal transfers of control.
Values of the Completion type are
Record
values whose fields are defined by
Table 9
. Such values are referred to as
Completion Record
s.
Table 9:
Completion Record
Fields
Field Name
Value
Meaning
[[Type]]
One of
normal
break
continue
return
, or
throw
The type of completion that occurred.
[[Value]]
any
ECMAScript language value
or
empty
The value that was produced.
[[Target]]
any ECMAScript string or
empty
The target label for directed control transfers.
The term “
abrupt completion
” refers to any completion with a [[Type]] value other than
normal
6.2.3.1
Await
Algorithm steps that say
1.
Let
completion
be
Await
value
).
mean the same thing as:
1.
Let
asyncContext
be the
running execution context
2.
Let
promise
be ?
PromiseResolve
%Promise%
value
).
3.
Let
stepsFulfilled
be the algorithm steps defined in
Await Fulfilled Functions
4.
Let
lengthFulfilled
be the number of non-optional parameters of the function definition in
Await Fulfilled Functions
5.
Let
onFulfilled
be !
CreateBuiltinFunction
stepsFulfilled
lengthFulfilled
""
, « [[AsyncContext]] »).
6.
Set
onFulfilled
.[[AsyncContext]] to
asyncContext
7.
Let
stepsRejected
be the algorithm steps defined in
Await Rejected Functions
8.
Let
lengthRejected
be the number of non-optional parameters of the function definition in
Await Rejected Functions
9.
Let
onRejected
be !
CreateBuiltinFunction
stepsRejected
lengthRejected
""
, « [[AsyncContext]] »).
10.
Set
onRejected
.[[AsyncContext]] to
asyncContext
11.
Perform !
PerformPromiseThen
promise
onFulfilled
onRejected
).
12.
Remove
asyncContext
from the
execution context stack
and restore the
execution context
that is at the top of the
execution context stack
as the
running execution context
13.
Set the code evaluation state of
asyncContext
such that when evaluation is resumed with a
Completion
completion
, the following steps of the algorithm that invoked
Await
will be performed, with
completion
available.
14.
Return.
15.
NOTE: This returns to the evaluation of the operation that had most previously resumed evaluation of
asyncContext
where all aliases in the above steps, with the exception of
completion
, are ephemeral and visible only in the steps pertaining to Await.
Note
Await can be combined with the
and
prefixes, so that for example
1.
Let
result
be ?
Await
value
).
means the same thing as:
1.
Let
result
be
Await
value
).
2.
ReturnIfAbrupt
result
).
6.2.3.1.1
Await Fulfilled Functions
An
Await
fulfilled function is an anonymous built-in function that is used as part of the
Await
specification device to deliver the promise fulfillment value to the caller as a normal completion. Each
Await
fulfilled function has an [[AsyncContext]] internal slot.
When an
Await
fulfilled function is called with argument
value
, the following steps are taken:
1.
Let
be the
active function object
2.
Let
asyncContext
be
.[[AsyncContext]].
3.
Let
prevContext
be the
running execution context
4.
Suspend
prevContext
5.
Push
asyncContext
onto the
execution context stack
asyncContext
is now the
running execution context
6.
Resume the suspended evaluation of
asyncContext
using
NormalCompletion
value
) as the result of the operation that suspended it.
7.
Assert
: When we reach this step,
asyncContext
has already been removed from the
execution context stack
and
prevContext
is the currently
running execution context
8.
Return
undefined
The
"length"
property of an
Await
fulfilled function is
6.2.3.1.2
Await Rejected Functions
An
Await
rejected function is an anonymous built-in function that is used as part of the
Await
specification device to deliver the promise rejection reason to the caller as an abrupt throw completion. Each
Await
rejected function has an [[AsyncContext]] internal slot.
When an
Await
rejected function is called with argument
reason
, the following steps are taken:
1.
Let
be the
active function object
2.
Let
asyncContext
be
.[[AsyncContext]].
3.
Let
prevContext
be the
running execution context
4.
Suspend
prevContext
5.
Push
asyncContext
onto the
execution context stack
asyncContext
is now the
running execution context
6.
Resume the suspended evaluation of
asyncContext
using
ThrowCompletion
reason
) as the result of the operation that suspended it.
7.
Assert
: When we reach this step,
asyncContext
has already been removed from the
execution context stack
and
prevContext
is the currently
running execution context
8.
Return
undefined
The
"length"
property of an
Await
rejected function is
6.2.3.2
NormalCompletion
The abstract operation NormalCompletion with a single
argument
, such as:
1.
Return
NormalCompletion
argument
).
Is a shorthand that is defined as follows:
1.
Return
Completion
{ [[Type]]:
normal
, [[Value]]:
argument
, [[Target]]:
empty
}.
6.2.3.3
ThrowCompletion
The abstract operation ThrowCompletion with a single
argument
, such as:
1.
Return
ThrowCompletion
argument
).
Is a shorthand that is defined as follows:
1.
Return
Completion
{ [[Type]]:
throw
, [[Value]]:
argument
, [[Target]]:
empty
}.
6.2.3.4
UpdateEmpty (
completionRecord
value
The abstract operation UpdateEmpty takes arguments
completionRecord
and
value
. It performs the following steps when called:
1.
Assert
: If
completionRecord
.[[Type]] is either
return
or
throw
, then
completionRecord
.[[Value]] is not
empty
2.
If
completionRecord
.[[Value]] is not
empty
, return
Completion
completionRecord
).
3.
Return
Completion
{ [[Type]]:
completionRecord
.[[Type]], [[Value]]:
value
, [[Target]]:
completionRecord
.[[Target]] }.
6.2.4
The Reference Record Specification Type
The
Reference Record
type is used to explain the behaviour of such operators as
delete
typeof
, the assignment operators, the
super
keyword
and other language features. For example, the left-hand operand of an assignment is expected to produce a Reference Record.
A Reference Record is a resolved name or property binding; its fields are defined by
Table 10
Table 10:
Reference Record
Fields
Field Name
Value
Meaning
[[Base]]
One of:
any
ECMAScript language value
except
undefined
or
null
an
Environment Record
, or
unresolvable
The value or
Environment Record
which holds the binding. A [[Base]] of
unresolvable
indicates that the binding could not be resolved.
[[ReferencedName]]
String or Symbol
The name of the binding. Always a String if [[Base]] value is an
Environment Record
[[Strict]]
Boolean
true
if the
Reference Record
originated in
strict mode code
false
otherwise.
[[ThisValue]]
any
ECMAScript language value
or
empty
If not
empty
, the
Reference Record
represents a property binding that was expressed using the
super
keyword
; it is called a
Super Reference Record
and its [[Base]] value will never be an
Environment Record
. In that case, the [[ThisValue]] field holds the
this
value at the time the
Reference Record
was created.
The following
abstract operations
are used in this specification to operate upon References:
6.2.4.1
IsPropertyReference (
The abstract operation IsPropertyReference takes argument
. It performs the following steps when called:
1.
Assert
is a
Reference Record
2.
If
.[[Base]] is
unresolvable
, return
false
3.
If
Type
.[[Base]]) is Boolean, String, Symbol, BigInt, Number, or Object, return
true
; otherwise return
false
6.2.4.2
IsUnresolvableReference (
The abstract operation IsUnresolvableReference takes argument
. It performs the following steps when called:
1.
Assert
is a
Reference Record
2.
If
.[[Base]] is
unresolvable
, return
true
; otherwise return
false
6.2.4.3
IsSuperReference (
The abstract operation IsSuperReference takes argument
. It performs the following steps when called:
1.
Assert
is a
Reference Record
2.
If
.[[ThisValue]] is not
empty
, return
true
; otherwise return
false
6.2.4.4
GetValue (
The abstract operation GetValue takes argument
. It performs the following steps when called:
1.
ReturnIfAbrupt
).
2.
If
is not a
Reference Record
, return
3.
If
IsUnresolvableReference
) is
true
, throw a
ReferenceError
exception.
4.
If
IsPropertyReference
) is
true
, then
a.
Let
baseObj
be !
ToObject
.[[Base]]).
b.
Return ?
baseObj
.[[Get]](
.[[ReferencedName]],
GetThisValue
)).
5.
Else,
a.
Let
base
be
.[[Base]].
b.
Assert
base
is an
Environment Record
c.
Return ?
base
.GetBindingValue(
.[[ReferencedName]],
.[[Strict]]) (see
9.1
).
Note
The object that may be created in step
4.a
is not accessible outside of the above abstract operation and the
ordinary object
[[Get]] internal method. An implementation might choose to avoid the actual creation of the object.
6.2.4.5
PutValue (
The abstract operation PutValue takes arguments
and
. It performs the following steps when called:
1.
ReturnIfAbrupt
).
2.
ReturnIfAbrupt
).
3.
If
is not a
Reference Record
, throw a
ReferenceError
exception.
4.
If
IsUnresolvableReference
) is
true
, then
a.
If
.[[Strict]] is
true
, throw a
ReferenceError
exception.
b.
Let
globalObj
be
GetGlobalObject
().
c.
Return ?
Set
globalObj
.[[ReferencedName]],
false
).
5.
If
IsPropertyReference
) is
true
, then
a.
Let
baseObj
be !
ToObject
.[[Base]]).
b.
Let
succeeded
be ?
baseObj
.[[Set]](
.[[ReferencedName]],
GetThisValue
)).
c.
If
succeeded
is
false
and
.[[Strict]] is
true
, throw a
TypeError
exception.
d.
Return.
6.
Else,
a.
Let
base
be
.[[Base]].
b.
Assert
base
is an
Environment Record
c.
Return ?
base
.SetMutableBinding(
.[[ReferencedName]],
.[[Strict]]) (see
9.1
).
Note
The object that may be created in step
5.a
is not accessible outside of the above abstract operation and the
ordinary object
[[Set]] internal method. An implementation might choose to avoid the actual creation of that object.
6.2.4.6
GetThisValue (
The abstract operation GetThisValue takes argument
. It performs the following steps when called:
1.
Assert
IsPropertyReference
) is
true
2.
If
IsSuperReference
) is
true
, return
.[[ThisValue]]; otherwise return
.[[Base]].
6.2.4.7
InitializeReferencedBinding (
The abstract operation InitializeReferencedBinding takes arguments
and
. It performs the following steps when called:
1.
ReturnIfAbrupt
).
2.
ReturnIfAbrupt
).
3.
Assert
is a
Reference Record
4.
Assert
IsUnresolvableReference
) is
false
5.
Let
base
be
.[[Base]].
6.
Assert
base
is an
Environment Record
7.
Return
base
.InitializeBinding(
.[[ReferencedName]],
).
6.2.5
The Property Descriptor Specification Type
The
Property Descriptor
type is used to explain the
manipulation and reification of Object property attributes. Values of
the Property Descriptor type are Records. Each field's name is an
attribute name and its value is a corresponding attribute value as
specified in
6.1.7.1
In addition, any field may be present or absent. The schema name used
within this specification to tag literal descriptions of Property
Descriptor records is “PropertyDescriptor”.
Property Descriptor values may be further classified as data
Property Descriptors and accessor Property Descriptors based upon the
existence or use of certain fields. A data Property Descriptor is one
that includes any fields named either [[Value]] or [[Writable]]. An
accessor Property Descriptor is one that includes any fields named
either [[Get]] or [[Set]]. Any Property Descriptor may have fields named
[[Enumerable]] and [[Configurable]]. A Property Descriptor value may
not be both a data Property Descriptor and an accessor Property
Descriptor; however, it may be neither. A generic Property Descriptor is
a Property Descriptor value that is neither a data Property Descriptor
nor an accessor Property Descriptor. A fully populated Property
Descriptor is one that is either an accessor Property Descriptor or a
data Property Descriptor and that has all of the fields that correspond
to the property attributes defined in either
Table 3
or
Table 4
The following
abstract operations
are used in this specification to operate upon Property Descriptor values:
6.2.5.1
IsAccessorDescriptor (
Desc
The abstract operation IsAccessorDescriptor takes argument
Desc
(a
Property Descriptor
or
undefined
). It performs the following steps when called:
1.
If
Desc
is
undefined
, return
false
2.
If both
Desc
.[[Get]] and
Desc
.[[Set]] are absent, return
false
3.
Return
true
6.2.5.2
IsDataDescriptor (
Desc
The abstract operation IsDataDescriptor takes argument
Desc
(a
Property Descriptor
or
undefined
). It performs the following steps when called:
1.
If
Desc
is
undefined
, return
false
2.
If both
Desc
.[[Value]] and
Desc
.[[Writable]] are absent, return
false
3.
Return
true
6.2.5.3
IsGenericDescriptor (
Desc
The abstract operation IsGenericDescriptor takes argument
Desc
(a
Property Descriptor
or
undefined
). It performs the following steps when called:
1.
If
Desc
is
undefined
, return
false
2.
If
IsAccessorDescriptor
Desc
) and
IsDataDescriptor
Desc
) are both
false
, return
true
3.
Return
false
6.2.5.4
FromPropertyDescriptor (
Desc
The abstract operation FromPropertyDescriptor takes argument
Desc
(a
Property Descriptor
or
undefined
). It performs the following steps when called:
1.
If
Desc
is
undefined
, return
undefined
2.
Let
obj
be !
OrdinaryObjectCreate
%Object.prototype%
).
3.
Assert
obj
is an extensible
ordinary object
with no own properties.
4.
If
Desc
has a [[Value]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"value"
Desc
.[[Value]]).
5.
If
Desc
has a [[Writable]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"writable"
Desc
.[[Writable]]).
6.
If
Desc
has a [[Get]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"get"
Desc
.[[Get]]).
7.
If
Desc
has a [[Set]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"set"
Desc
.[[Set]]).
8.
If
Desc
has an [[Enumerable]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"enumerable"
Desc
.[[Enumerable]]).
9.
If
Desc
has a [[Configurable]] field, then
a.
Perform !
CreateDataPropertyOrThrow
obj
"configurable"
Desc
.[[Configurable]]).
10.
Return
obj
6.2.5.5
ToPropertyDescriptor (
Obj
The abstract operation ToPropertyDescriptor takes argument
Obj
. It performs the following steps when called:
1.
If
Type
Obj
) is not Object, throw a
TypeError
exception.
2.
Let
desc
be a new
Property Descriptor
that initially has no fields.
3.
Let
hasEnumerable
be ?
HasProperty
Obj
"enumerable"
).
4.
If
hasEnumerable
is
true
, then
a.
Let
enumerable
be !
ToBoolean
(?
Get
Obj
"enumerable"
)).
b.
Set
desc
.[[Enumerable]] to
enumerable
5.
Let
hasConfigurable
be ?
HasProperty
Obj
"configurable"
).
6.
If
hasConfigurable
is
true
, then
a.
Let
configurable
be !
ToBoolean
(?
Get
Obj
"configurable"
)).
b.
Set
desc
.[[Configurable]] to
configurable
7.
Let
hasValue
be ?
HasProperty
Obj
"value"
).
8.
If
hasValue
is
true
, then
a.
Let
value
be ?
Get
Obj
"value"
).
b.
Set
desc
.[[Value]] to
value
9.
Let
hasWritable
be ?
HasProperty
Obj
"writable"
).
10.
If
hasWritable
is
true
, then
a.
Let
writable
be !
ToBoolean
(?
Get
Obj
"writable"
)).
b.
Set
desc
.[[Writable]] to
writable
11.
Let
hasGet
be ?
HasProperty
Obj
"get"
).
12.
If
hasGet
is
true
, then
a.
Let
getter
be ?
Get
Obj
"get"
).
b.
If
IsCallable
getter
) is
false
and
getter
is not
undefined
, throw a
TypeError
exception.
c.
Set
desc
.[[Get]] to
getter
13.
Let
hasSet
be ?
HasProperty
Obj
"set"
).
14.
If
hasSet
is
true
, then
a.
Let
setter
be ?
Get
Obj
"set"
).
b.
If
IsCallable
setter
) is
false
and
setter
is not
undefined
, throw a
TypeError
exception.
c.
Set
desc
.[[Set]] to
setter
15.
If
desc
.[[Get]] is present or
desc
.[[Set]] is present, then
a.
If
desc
.[[Value]] is present or
desc
.[[Writable]] is present, throw a
TypeError
exception.
16.
Return
desc
6.2.5.6
CompletePropertyDescriptor (
Desc
The abstract operation CompletePropertyDescriptor takes argument
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Assert
Desc
is a
Property Descriptor
2.
Let
like
be the
Record
{ [[Value]]:
undefined
, [[Writable]]:
false
, [[Get]]:
undefined
, [[Set]]:
undefined
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
3.
If
IsGenericDescriptor
Desc
) is
true
or
IsDataDescriptor
Desc
) is
true
, then
a.
If
Desc
does not have a [[Value]] field, set
Desc
.[[Value]] to
like
.[[Value]].
b.
If
Desc
does not have a [[Writable]] field, set
Desc
.[[Writable]] to
like
.[[Writable]].
4.
Else,
a.
If
Desc
does not have a [[Get]] field, set
Desc
.[[Get]] to
like
.[[Get]].
b.
If
Desc
does not have a [[Set]] field, set
Desc
.[[Set]] to
like
.[[Set]].
5.
If
Desc
does not have an [[Enumerable]] field, set
Desc
.[[Enumerable]] to
like
.[[Enumerable]].
6.
If
Desc
does not have a [[Configurable]] field, set
Desc
.[[Configurable]] to
like
.[[Configurable]].
7.
Return
Desc
6.2.6
The Environment Record Specification Type
The
Environment Record
type is used to explain the behaviour of name resolution in nested
functions and blocks. This type and the operations upon it are defined
in
9.1
6.2.7
The Abstract Closure Specification Type
The
Abstract Closure
specification type is used to
refer to algorithm steps together with a collection of values. Abstract
Closures are meta-values and are invoked using function application
style such as
closure
arg1
arg2
). Like
abstract operations
, invocations perform the algorithm steps described by the Abstract Closure.
In algorithm steps that create an Abstract Closure, values are
captured with the verb "capture" followed by a list of aliases. When an
Abstract Closure is created, it captures the value that is associated
with each alias at that time. In steps that specify the algorithm to be
performed when an Abstract Closure is called, each captured value is
referred to by the alias that was used to capture the value.
If an Abstract Closure returns a
Completion Record
, that
Completion Record
's [[Type]] must be either
normal
or
throw
Abstract Closures are created inline as part of other algorithms, shown in the following example.
1.
Let
addend
be 41.
2.
Let
closure
be a new
Abstract Closure
with parameters (
) that captures
addend
and performs the following steps when called:
a.
Return
addend
3.
Let
val
be
closure
(1).
4.
Assert
val
is 42.
6.2.8
Data Blocks
The
Data Block
specification type is used to describe a distinct and mutable sequence of byte-sized (8 bit) numeric values. A
byte value
is an
integer
value in the range 0 through 255, inclusive. A Data Block value is
created with a fixed number of bytes that each have the initial value 0.
For notational convenience within this specification, an
array-like syntax can be used to access the individual bytes of a Data
Block value. This notation presents a Data Block value as a 0-origined
integer
-indexed sequence of bytes. For example, if
db
is a 5 byte Data Block value then
db
[2] can be used to access its 3
rd
byte.
A data block that resides in memory that can be referenced from multiple agents concurrently is designated a
Shared Data Block
. A Shared Data Block has an identity (for the purposes of equality testing Shared Data Block values) that is
address-free
it is tied not to the virtual addresses the block is mapped to in any
process, but to the set of locations in memory that the block
represents. Two data blocks are equal only if the sets of the locations
they contain are equal; otherwise, they are not equal and the
intersection of the sets of locations they contain is empty. Finally,
Shared Data Blocks can be distinguished from Data Blocks.
The semantics of Shared Data Blocks is defined using Shared Data Block events by the
memory model
Abstract operations
below introduce Shared Data Block events and act as the interface between evaluation semantics and the event semantics of the
memory model
. The events form a
candidate execution
, on which the
memory model
acts as a filter. Please consult the
memory model
for full semantics.
Shared Data Block events are modeled by Records, defined in the
memory model
The following
abstract operations
are used in this specification to operate upon Data Block values:
6.2.8.1
CreateByteDataBlock (
size
The abstract operation CreateByteDataBlock takes argument
size
(an
integer
). It performs the following steps when called:
1.
Assert
size
≥ 0.
2.
Let
db
be a new
Data Block
value consisting of
size
bytes. If it is impossible to create such a
Data Block
, throw a
RangeError
exception.
3.
Set all of the bytes of
db
to 0.
4.
Return
db
6.2.8.2
CreateSharedByteDataBlock (
size
The abstract operation CreateSharedByteDataBlock takes argument
size
(a non-negative
integer
). It performs the following steps when called:
1.
Assert
size
≥ 0.
2.
Let
db
be a new
Shared Data Block
value consisting of
size
bytes. If it is impossible to create such a
Shared Data Block
, throw a
RangeError
exception.
3.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
4.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
5.
Let
zero
be « 0 ».
6.
For each index
of
db
, do
a.
Append
WriteSharedMemory
{ [[Order]]:
Init
, [[NoTear]]:
true
, [[Block]]:
db
, [[ByteIndex]]:
, [[ElementSize]]: 1, [[Payload]]:
zero
} to
eventList
7.
Return
db
6.2.8.3
CopyDataBlockBytes (
toBlock
toIndex
fromBlock
fromIndex
count
The abstract operation CopyDataBlockBytes takes arguments
toBlock
toIndex
(a non-negative
integer
),
fromBlock
fromIndex
(a non-negative
integer
), and
count
(a non-negative
integer
). It performs the following steps when called:
1.
Assert
fromBlock
and
toBlock
are distinct
Data Block
or
Shared Data Block
values.
2.
Let
fromSize
be the number of bytes in
fromBlock
3.
Assert
fromIndex
count
fromSize
4.
Let
toSize
be the number of bytes in
toBlock
5.
Assert
toIndex
count
toSize
6.
Repeat, while
count
> 0,
a.
If
fromBlock
is a
Shared Data Block
, then
i.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
ii.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
iii.
Let
bytes
be a
List
whose sole element is a nondeterministically chosen
byte value
iv.
NOTE: In implementations,
bytes
is the result of a non-atomic read instruction on the underlying
hardware. The nondeterminism is a semantic prescription of the
memory model
to describe observable behaviour of hardware with weak consistency.
v.
Let
readEvent
be
ReadSharedMemory
{ [[Order]]:
Unordered
, [[NoTear]]:
true
, [[Block]]:
fromBlock
, [[ByteIndex]]:
fromIndex
, [[ElementSize]]: 1 }.
vi.
Append
readEvent
to
eventList
vii.
Append
Chosen Value Record
{ [[Event]]:
readEvent
, [[ChosenValue]]:
bytes
} to
execution
.[[ChosenValues]].
viii.
If
toBlock
is a
Shared Data Block
, then
1.
Append
WriteSharedMemory
{ [[Order]]:
Unordered
, [[NoTear]]:
true
, [[Block]]:
toBlock
, [[ByteIndex]]:
toIndex
, [[ElementSize]]: 1, [[Payload]]:
bytes
} to
eventList
ix.
Else,
1.
Set
toBlock
toIndex
] to
bytes
[0].
b.
Else,
i.
Assert
toBlock
is not a
Shared Data Block
ii.
Set
toBlock
toIndex
] to
fromBlock
fromIndex
].
c.
Set
toIndex
to
toIndex
+ 1.
d.
Set
fromIndex
to
fromIndex
+ 1.
e.
Set
count
to
count
- 1.
7.
Return
NormalCompletion
empty
).
Abstract Operations
These operations are not a part of the ECMAScript language; they
are defined here solely to aid the specification of the semantics of the
ECMAScript language. Other, more specialized
abstract operations
are defined throughout this specification.
7.1
Type Conversion
The ECMAScript language implicitly performs automatic type
conversion as needed. To clarify the semantics of certain constructs it
is useful to define a set of conversion
abstract operations
. The conversion
abstract operations
are polymorphic; they can accept a value of any
ECMAScript language type
. But no other specification types are used with these operations.
The BigInt type has no implicit conversions in the ECMAScript
language; programmers must call BigInt explicitly to convert values from
other types.
7.1.1
ToPrimitive (
input
[ ,
preferredType
] )
The abstract operation ToPrimitive takes argument
input
and optional argument
preferredType
. It converts its
input
argument to a non-Object type. If an object is capable of converting to
more than one primitive type, it may use the optional hint
preferredType
to favour that type. It performs the following steps when called:
1.
Assert
input
is an
ECMAScript language value
2.
If
Type
input
) is Object, then
a.
Let
exoticToPrim
be ?
GetMethod
input
@@toPrimitive
).
b.
If
exoticToPrim
is not
undefined
, then
i.
If
preferredType
is not present, let
hint
be
"default"
ii.
Else if
preferredType
is
string
, let
hint
be
"string"
iii.
Else,
1.
Assert
preferredType
is
number
2.
Let
hint
be
"number"
iv.
Let
result
be ?
Call
exoticToPrim
input
, «
hint
»).
v.
If
Type
result
) is not Object, return
result
vi.
Throw a
TypeError
exception.
c.
If
preferredType
is not present, let
preferredType
be
number
d.
Return ?
OrdinaryToPrimitive
input
preferredType
).
3.
Return
input
Note
When ToPrimitive is called with no hint, then it generally behaves as if the hint were
number
. However, objects may over-ride this behaviour by defining a
@@toPrimitive
method. Of the objects defined in this specification only Date objects (see
21.4.4.45
) and Symbol objects (see
20.4.3.5
) over-ride the default ToPrimitive behaviour. Date objects treat no hint as if the hint were
string
7.1.1.1
OrdinaryToPrimitive (
hint
The abstract operation OrdinaryToPrimitive takes arguments
and
hint
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
hint
is either
string
or
number
3.
If
hint
is
string
, then
a.
Let
methodNames
be «
"toString"
"valueOf"
».
4.
Else,
a.
Let
methodNames
be «
"valueOf"
"toString"
».
5.
For each element
name
of
methodNames
, do
a.
Let
method
be ?
Get
name
).
b.
If
IsCallable
method
) is
true
, then
i.
Let
result
be ?
Call
method
).
ii.
If
Type
result
) is not Object, return
result
6.
Throw a
TypeError
exception.
7.1.2
ToBoolean (
argument
The abstract operation ToBoolean takes argument
argument
. It converts
argument
to a value of type Boolean according to
Table 11
Table 11:
ToBoolean
Conversions
Argument Type
Result
Undefined
Return
false
Null
Return
false
Boolean
Return
argument
Number
If
argument
is
+0
-0
, or
NaN
, return
false
; otherwise return
true
String
If
argument
is the empty String (its length is 0), return
false
; otherwise return
true
Symbol
Return
true
BigInt
If
argument
is
, return
false
; otherwise return
true
Object
Return
true
Note
An alternate algorithm related to the
[[IsHTMLDDA]] internal slot
is mandated in section
B.3.7.1
7.1.3
ToNumeric (
value
The abstract operation ToNumeric takes argument
value
. It returns
value
converted to a Number or a BigInt. It performs the following steps when called:
1.
Let
primValue
be ?
ToPrimitive
value
number
).
2.
If
Type
primValue
) is BigInt, return
primValue
3.
Return ?
ToNumber
primValue
).
7.1.4
ToNumber (
argument
The abstract operation ToNumber takes argument
argument
. It converts
argument
to a value of type Number according to
Table 12
Table 12:
ToNumber
Conversions
Argument Type
Result
Undefined
Return
NaN
Null
Return
+0
Boolean
If
argument
is
true
, return
. If
argument
is
false
, return
+0
Number
Return
argument
(no conversion).
String
See grammar and conversion algorithm below.
Symbol
Throw a
TypeError
exception.
BigInt
Throw a
TypeError
exception.
Object
Apply the following steps:
1.
Let
primValue
be ?
ToPrimitive
argument
number
).
2.
Return ?
ToNumber
primValue
).
7.1.4.1
ToNumber Applied to the String Type
ToNumber
applied to Strings applies the following grammar to the input String interpreted as a sequence of UTF-16 encoded code points (
6.1.4
). If the grammar cannot interpret the String as an expansion of
StringNumericLiteral
, then the result of
ToNumber
is
NaN
Note 1
The terminal symbols of this grammar are all composed of
characters in the Unicode Basic Multilingual Plane (BMP). Therefore, the
result of
ToNumber
will be
NaN
if the string contains any
leading surrogate
or
trailing surrogate
code units, whether paired or unpaired.
Syntax
StringNumericLiteral
:::
StrWhiteSpace
opt
StrWhiteSpace
opt
StrNumericLiteral
StrWhiteSpace
opt
StrWhiteSpace
:::
StrWhiteSpaceChar
StrWhiteSpace
opt
StrWhiteSpaceChar
:::
WhiteSpace
LineTerminator
StrNumericLiteral
:::
StrDecimalLiteral
NonDecimalIntegerLiteral
[~Sep]
StrDecimalLiteral
:::
StrUnsignedDecimalLiteral
StrUnsignedDecimalLiteral
StrUnsignedDecimalLiteral
StrUnsignedDecimalLiteral
:::
Infinity
DecimalDigits
[~Sep]
DecimalDigits
[~Sep]
opt
ExponentPart
[~Sep]
opt
DecimalDigits
[~Sep]
ExponentPart
[~Sep]
opt
DecimalDigits
[~Sep]
ExponentPart
[~Sep]
opt
All grammar symbols not explicitly defined above have the definitions used in the Lexical Grammar for numeric literals (
12.8.3
Note 2
Some differences should be noted between the syntax of a
StringNumericLiteral
and a
NumericLiteral
StringNumericLiteral
may include leading and/or trailing white space and/or line terminators.
StringNumericLiteral
that is decimal may have any number of leading
digits.
StringNumericLiteral
that is decimal may include a
or
to indicate its sign.
StringNumericLiteral
that is empty or contains only white space is converted to
+0
Infinity
and
-Infinity
are recognized as a
StringNumericLiteral
but not as a
NumericLiteral
StringNumericLiteral
cannot include a
BigIntLiteralSuffix
7.1.4.1.1
Runtime Semantics: MV
The conversion of a String to a
Number value
is similar overall to the determination of the
Number value
for a numeric literal (see
12.8.3
),
but some of the details are different, so the process for converting a
String numeric literal to a value of Number type is given here. This
value is determined in two steps: first, a
mathematical value
(MV) is derived from the String numeric literal; second, this
mathematical value
is rounded as described below. The MV on any grammar symbol, not provided below, is the MV for that symbol defined in
12.8.3.1
The MV of
StringNumericLiteral
:::
[empty]
is 0.
The MV of
StringNumericLiteral
:::
StrWhiteSpace
is 0.
The MV of
StringNumericLiteral
:::
StrWhiteSpace
opt
StrNumericLiteral
StrWhiteSpace
opt
is the MV of
StrNumericLiteral
, no matter whether white space is present or not.
The MV of
StrDecimalLiteral
:::
StrUnsignedDecimalLiteral
is the negative of the MV of
StrUnsignedDecimalLiteral
. (Note that if the MV of
StrUnsignedDecimalLiteral
is 0, the negative of this MV is also 0. The rounding rule described
below handles the conversion of this signless mathematical zero to a
floating-point
+0
or
-0
as appropriate.)
The MV of
StrUnsignedDecimalLiteral
:::
Infinity
is 10
10000
(a value so large that it will round to
+∞
).
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
DecimalDigits
is the MV of the first
DecimalDigits
plus (the MV of the second
DecimalDigits
times 10
), where
is the number of code points in the second
DecimalDigits
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
ExponentPart
is the MV of
DecimalDigits
times 10
, where
is the MV of
ExponentPart
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
DecimalDigits
ExponentPart
is (the MV of the first
DecimalDigits
plus (the MV of the second
DecimalDigits
times 10
)) times 10
, where
is the number of code points in the second
DecimalDigits
and
is the MV of
ExponentPart
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
is the MV of
DecimalDigits
times 10
, where
is the number of code points in
DecimalDigits
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
ExponentPart
is the MV of
DecimalDigits
times 10
, where
is the number of code points in
DecimalDigits
and
is the MV of
ExponentPart
The MV of
StrUnsignedDecimalLiteral
:::
DecimalDigits
ExponentPart
is the MV of
DecimalDigits
times 10
, where
is the MV of
ExponentPart
Once the exact MV for a String numeric literal has been
determined, it is then rounded to a value of the Number type. If the MV
is 0, then the rounded value is
+0
unless the first non white space code point in the String numeric literal is
, in which case the rounded value is
-0
. Otherwise, the rounded value must be the
Number value
for the MV (in the sense defined in
6.1.6.1
), unless the literal includes a
StrUnsignedDecimalLiteral
and the literal has more than 20 significant digits, in which case the
Number value
may be either the
Number value
for the MV of a literal produced by replacing each significant digit after the 20th with a 0 digit or the
Number value
for the MV of a literal produced by replacing each significant digit
after the 20th with a 0 digit and then incrementing the literal at the
20th digit position. A digit is significant if it is not part of an
ExponentPart
and
it is not
; or
there is a non-zero digit to its left and there is a non-zero digit, not in the
ExponentPart
, to its right.
7.1.5
ToIntegerOrInfinity (
argument
The abstract operation ToIntegerOrInfinity takes argument
argument
. It converts
argument
to an
integer
, +∞, or -∞. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
, or
-0
, return 0.
3.
If
number
is
+∞
, return +∞.
4.
If
number
is
-∞
, return -∞.
5.
Let
integer
be
floor
abs
number
))).
6.
If
number
+0
, set
integer
to -
integer
7.
Return
integer
7.1.6
ToInt32 (
argument
The abstract operation ToInt32 takes argument
argument
. It converts
argument
to one of 2
32
integral Number
values in the range
-2
31
) through
31
- 1
), inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int32bit
be
int
modulo
32
5.
If
int32bit
≥ 2
31
, return
int32bit
- 2
32
); otherwise return
int32bit
).
Note
Given the above definition of ToInt32:
The ToInt32 abstract operation is idempotent: if applied to a
result that it produced, the second application leaves that value
unchanged.
ToInt32(
ToUint32
)) is the same value as ToInt32(
) for all values of
. (It is to preserve this latter property that
+∞
and
-∞
are mapped to
+0
.)
ToInt32 maps
-0
to
+0
7.1.7
ToUint32 (
argument
The abstract operation ToUint32 takes argument
argument
. It converts
argument
to one of 2
32
integral Number
values in the range
+0
through
32
- 1
), inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int32bit
be
int
modulo
32
5.
Return
int32bit
).
Note
Given the above definition of ToUint32:
Step
is the only difference between ToUint32 and
ToInt32
The ToUint32 abstract operation is idempotent: if applied to
a result that it produced, the second application leaves that value
unchanged.
ToUint32(
ToInt32
)) is the same value as ToUint32(
) for all values of
. (It is to preserve this latter property that
+∞
and
-∞
are mapped to
+0
.)
ToUint32 maps
-0
to
+0
7.1.8
ToInt16 (
argument
The abstract operation ToInt16 takes argument
argument
. It converts
argument
to one of 2
16
integral Number
values in the range
-2
15
) through
15
- 1
), inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int16bit
be
int
modulo
16
5.
If
int16bit
≥ 2
15
, return
int16bit
- 2
16
); otherwise return
int16bit
).
7.1.9
ToUint16 (
argument
The abstract operation ToUint16 takes argument
argument
. It converts
argument
to one of 2
16
integral Number
values in the range
+0
through
16
- 1
), inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int16bit
be
int
modulo
16
5.
Return
int16bit
).
Note
Given the above definition of ToUint16:
The substitution of 2
16
for 2
32
in step
is the only difference between
ToUint32
and ToUint16.
ToUint16 maps
-0
to
+0
7.1.10
ToInt8 (
argument
The abstract operation ToInt8 takes argument
argument
. It converts
argument
to one of 2
integral Number
values in the range
-128
through
127
, inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int8bit
be
int
modulo
5.
If
int8bit
≥ 2
, return
int8bit
- 2
); otherwise return
int8bit
).
7.1.11
ToUint8 (
argument
The abstract operation ToUint8 takes argument
argument
. It converts
argument
to one of 2
integral Number
values in the range
+0
through
255
, inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
+0
-0
+∞
, or
-∞
, return
+0
3.
Let
int
be the
mathematical value
that is the same sign as
number
and whose magnitude is
floor
abs
number
))).
4.
Let
int8bit
be
int
modulo
5.
Return
int8bit
).
7.1.12
ToUint8Clamp (
argument
The abstract operation ToUint8Clamp takes argument
argument
. It converts
argument
to one of 2
integral Number
values in the range
+0
through
255
, inclusive. It performs the following steps when called:
1.
Let
number
be ?
ToNumber
argument
).
2.
If
number
is
NaN
, return
+0
3.
If
number
) ≤ 0, return
+0
4.
If
number
) ≥ 255, return
255
5.
Let
be
floor
number
)).
6.
If
+ 0.5 <
number
), return
+ 1).
7.
If
number
) <
+ 0.5, return
).
8.
If
is odd, return
+ 1).
9.
Return
).
Note
Unlike the other ECMAScript
integer
conversion abstract operation, ToUint8Clamp rounds rather than truncates non-integral values and does not convert
+∞
to
+0
. ToUint8Clamp does “round half to even” tie-breaking. This differs from
Math.round
which does “round half up” tie-breaking.
7.1.13
ToBigInt (
argument
The abstract operation ToBigInt takes argument
argument
. It converts
argument
to a BigInt value, or throws if an implicit conversion from Number
would be required. It performs the following steps when called:
1.
Let
prim
be ?
ToPrimitive
argument
number
).
2.
Return the value that
prim
corresponds to in
Table 13
Table 13: BigInt Conversions
Argument Type
Result
Undefined
Throw a
TypeError
exception.
Null
Throw a
TypeError
exception.
Boolean
Return
1n
if
prim
is
true
and
0n
if
prim
is
false
BigInt
Return
prim
Number
Throw a
TypeError
exception.
String
1.
Let
be !
StringToBigInt
prim
).
2.
If
is
NaN
, throw a
SyntaxError
exception.
3.
Return
Symbol
Throw a
TypeError
exception.
7.1.14
StringToBigInt (
argument
Apply the algorithm in
7.1.4.1
with the following changes:
Replace the
StrUnsignedDecimalLiteral
production with
DecimalDigits
to not allow
Infinity
, decimal points, or exponents.
If the MV is
NaN
, return
NaN
, otherwise return the BigInt which exactly corresponds to the MV, rather than rounding to a Number.
7.1.15
ToBigInt64 (
argument
The abstract operation ToBigInt64 takes argument
argument
. It converts
argument
to one of 2
64
BigInt values in the range
(-2
63
) through
(2
63
-1), inclusive. It performs the following steps when called:
1.
Let
be ?
ToBigInt
argument
).
2.
Let
int64bit
be
modulo
64
3.
If
int64bit
≥ 2
63
, return
int64bit
- 2
64
); otherwise return
int64bit
).
7.1.16
ToBigUint64 (
argument
The abstract operation ToBigUint64 takes argument
argument
. It converts
argument
to one of 2
64
BigInt values in the range
through the BigInt value for
(2
64
-1), inclusive. It performs the following steps when called:
1.
Let
be ?
ToBigInt
argument
).
2.
Let
int64bit
be
modulo
64
3.
Return
int64bit
).
7.1.17
ToString (
argument
The abstract operation ToString takes argument
argument
. It converts
argument
to a value of type String according to
Table 14
Table 14:
ToString
Conversions
Argument Type
Result
Undefined
Return
"undefined"
Null
Return
"null"
Boolean
If
argument
is
true
, return
"true"
If
argument
is
false
, return
"false"
Number
Return !
Number::toString
argument
).
String
Return
argument
Symbol
Throw a
TypeError
exception.
BigInt
Return !
BigInt::toString
argument
).
Object
Apply the following steps:
1.
Let
primValue
be ?
ToPrimitive
argument
string
).
2.
Return ?
ToString
primValue
).
7.1.18
ToObject (
argument
The abstract operation ToObject takes argument
argument
. It converts
argument
to a value of type Object according to
Table 15
Table 15:
ToObject
Conversions
Argument Type
Result
Undefined
Throw a
TypeError
exception.
Null
Throw a
TypeError
exception.
Boolean
Return a new Boolean object whose [[BooleanData]] internal slot is set to
argument
. See
20.3
for a description of Boolean objects.
Number
Return a new Number object whose [[NumberData]] internal slot is set to
argument
. See
21.1
for a description of Number objects.
String
Return a new String object whose [[StringData]] internal slot is set to
argument
. See
22.1
for a description of String objects.
Symbol
Return a new Symbol object whose [[SymbolData]] internal slot is set to
argument
. See
20.4
for a description of Symbol objects.
BigInt
Return a new BigInt object whose [[BigIntData]] internal slot is set to
argument
. See
21.2
for a description of BigInt objects.
Object
Return
argument
7.1.19
ToPropertyKey (
argument
The abstract operation ToPropertyKey takes argument
argument
. It converts
argument
to a value that can be used as a property key. It performs the following steps when called:
1.
Let
key
be ?
ToPrimitive
argument
string
).
2.
If
Type
key
) is Symbol, then
a.
Return
key
3.
Return !
ToString
key
).
7.1.20
ToLength (
argument
The abstract operation ToLength takes argument
argument
. It converts
argument
to an
integral Number
suitable for use as the length of an
array-like object
. It performs the following steps when called:
1.
Let
len
be ?
ToIntegerOrInfinity
argument
).
2.
If
len
≤ 0, return
+0
3.
Return
min
len
, 2
53
- 1)).
7.1.21
CanonicalNumericIndexString (
argument
The abstract operation CanonicalNumericIndexString takes argument
argument
. It returns
argument
converted to a
Number value
if it is a String representation of a Number that would be produced by
ToString
, or the string
"-0"
. Otherwise, it returns
undefined
. It performs the following steps when called:
1.
Assert
Type
argument
) is String.
2.
If
argument
is
"-0"
, return
-0
3.
Let
be !
ToNumber
argument
).
4.
If
SameValue
(!
ToString
),
argument
) is
false
, return
undefined
5.
Return
canonical numeric string
is any String value for which the CanonicalNumericIndexString abstract operation does not return
undefined
7.1.22
ToIndex (
value
The abstract operation ToIndex takes argument
value
. It returns
value
argument converted to a non-negative
integer
if it is a valid
integer index
value. It performs the following steps when called:
1.
If
value
is
undefined
, then
a.
Return 0.
2.
Else,
a.
Let
integerIndex
be
(?
ToIntegerOrInfinity
value
)).
b.
If
integerIndex
+0
, throw a
RangeError
exception.
c.
Let
index
be !
ToLength
integerIndex
).
d.
If !
SameValue
integerIndex
index
) is
false
, throw a
RangeError
exception.
e.
Return
index
).
7.2
Testing and Comparison Operations
7.2.1
RequireObjectCoercible (
argument
The abstract operation RequireObjectCoercible takes argument
argument
. It throws an error if
argument
is a value that cannot be converted to an Object using
ToObject
. It is defined by
Table 16
Table 16:
RequireObjectCoercible
Results
Argument Type
Result
Undefined
Throw a
TypeError
exception.
Null
Throw a
TypeError
exception.
Boolean
Return
argument
Number
Return
argument
String
Return
argument
Symbol
Return
argument
BigInt
Return
argument
Object
Return
argument
7.2.2
IsArray (
argument
The abstract operation IsArray takes argument
argument
. It performs the following steps when called:
1.
If
Type
argument
) is not Object, return
false
2.
If
argument
is an
Array exotic object
, return
true
3.
If
argument
is a
Proxy exotic object
, then
a.
If
argument
.[[ProxyHandler]] is
null
, throw a
TypeError
exception.
b.
Let
target
be
argument
.[[ProxyTarget]].
c.
Return ?
IsArray
target
).
4.
Return
false
7.2.3
IsCallable (
argument
The abstract operation IsCallable takes argument
argument
(an
ECMAScript language value
). It determines if
argument
is a callable function with a [[Call]] internal method. It performs the following steps when called:
1.
If
Type
argument
) is not Object, return
false
2.
If
argument
has a [[Call]] internal method, return
true
3.
Return
false
7.2.4
IsConstructor (
argument
The abstract operation IsConstructor takes argument
argument
(an
ECMAScript language value
). It determines if
argument
is a
function object
with a [[Construct]] internal method. It performs the following steps when called:
1.
If
Type
argument
) is not Object, return
false
2.
If
argument
has a [[Construct]] internal method, return
true
3.
Return
false
7.2.5
IsExtensible (
The abstract operation IsExtensible takes argument
(an Object) and returns a completion record which, if its [[Type]] is
normal
, has a [[Value]] which is a Boolean. It is used to determine whether additional properties can be added to
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Return ?
.[[IsExtensible]]().
7.2.6
IsIntegralNumber (
argument
The abstract operation IsIntegralNumber takes argument
argument
. It determines if
argument
is a finite
integral Number
value. It performs the following steps when called:
1.
If
Type
argument
) is not Number, return
false
2.
If
argument
is
NaN
+∞
, or
-∞
, return
false
3.
If
floor
abs
argument
))) ≠
abs
argument
)), return
false
4.
Return
true
7.2.7
IsPropertyKey (
argument
The abstract operation IsPropertyKey takes argument
argument
(an
ECMAScript language value
). It determines if
argument
is a value that may be used as a property key. It performs the following steps when called:
1.
If
Type
argument
) is String, return
true
2.
If
Type
argument
) is Symbol, return
true
3.
Return
false
7.2.8
IsRegExp (
argument
The abstract operation IsRegExp takes argument
argument
. It performs the following steps when called:
1.
If
Type
argument
) is not Object, return
false
2.
Let
matcher
be ?
Get
argument
@@match
).
3.
If
matcher
is not
undefined
, return !
ToBoolean
matcher
).
4.
If
argument
has a [[RegExpMatcher]] internal slot, return
true
5.
Return
false
7.2.9
IsStringPrefix (
The abstract operation IsStringPrefix takes arguments
(a String) and
(a String). It determines if
is a prefix of
. It performs the following steps when called:
1.
Assert
Type
) is String.
2.
Assert
Type
) is String.
3.
If
can be the
string-concatenation
of
and some other String
, return
true
. Otherwise, return
false
Note
Any String is a prefix of itself, because
may be the empty String.
7.2.10
SameValue (
The abstract operation SameValue takes arguments
(an
ECMAScript language value
) and
(an
ECMAScript language value
) and returns a completion record whose [[Type]] is
normal
and whose [[Value]] is a Boolean. It performs the following steps when called:
1.
If
Type
) is different from
Type
), return
false
2.
If
Type
) is Number or BigInt, then
a.
Return !
Type
)::sameValue(
).
3.
Return !
SameValueNonNumeric
).
Note
This algorithm differs from the
Strict Equality Comparison
Algorithm in its treatment of signed zeroes and NaNs.
7.2.11
SameValueZero (
The abstract operation SameValueZero takes arguments
(an
ECMAScript language value
) and
(an
ECMAScript language value
) and returns a completion record whose [[Type]] is
normal
and whose [[Value]] is a Boolean. It performs the following steps when called:
1.
If
Type
) is different from
Type
), return
false
2.
If
Type
) is Number or BigInt, then
a.
Return !
Type
)::sameValueZero(
).
3.
Return !
SameValueNonNumeric
).
Note
SameValueZero differs from
SameValue
only in its treatment of
+0
and
-0
7.2.12
SameValueNonNumeric (
The abstract operation SameValueNonNumeric takes arguments
(an
ECMAScript language value
) and
(an
ECMAScript language value
) and returns a completion record whose [[Type]] is
normal
and whose [[Value]] is a Boolean. It performs the following steps when called:
1.
Assert
Type
) is not Number or BigInt.
2.
Assert
Type
) is the same as
Type
).
3.
If
Type
) is Undefined, return
true
4.
If
Type
) is Null, return
true
5.
If
Type
) is String, then
a.
If
and
are exactly the same sequence of code units (same length and same code units at corresponding indices), return
true
; otherwise, return
false
6.
If
Type
) is Boolean, then
a.
If
and
are both
true
or both
false
, return
true
; otherwise, return
false
7.
If
Type
) is Symbol, then
a.
If
and
are both the same Symbol value, return
true
; otherwise, return
false
8.
If
and
are the same Object value, return
true
. Otherwise, return
false
7.2.13
Abstract Relational Comparison
The comparison
, where
and
are values, produces
true
false
, or
undefined
(which indicates that at least one operand is
NaN
). In addition to
and
the algorithm takes a Boolean flag named
LeftFirst
as a parameter. The flag is used to control the order in which
operations with potentially visible side-effects are performed upon
and
. It is necessary because ECMAScript specifies left to right evaluation of expressions. The default value of
LeftFirst
is
true
and indicates that the
parameter corresponds to an expression that occurs to the left of the
parameter's corresponding expression. If
LeftFirst
is
false
, the reverse is the case and operations must be performed upon
before
. Such a comparison is performed as follows:
1.
If the
LeftFirst
flag is
true
, then
a.
Let
px
be ?
ToPrimitive
number
).
b.
Let
py
be ?
ToPrimitive
number
).
2.
Else,
a.
NOTE: The order of evaluation needs to be reversed to preserve left to right evaluation.
b.
Let
py
be ?
ToPrimitive
number
).
c.
Let
px
be ?
ToPrimitive
number
).
3.
If
Type
px
) is String and
Type
py
) is String, then
a.
If
IsStringPrefix
py
px
) is
true
, return
false
b.
If
IsStringPrefix
px
py
) is
true
, return
true
c.
Let
be the smallest non-negative
integer
such that the code unit at index
within
px
is different from the code unit at index
within
py
. (There must be such a
, for neither String is a prefix of the other.)
d.
Let
be the
integer
that is the numeric value of the code unit at index
within
px
e.
Let
be the
integer
that is the numeric value of the code unit at index
within
py
f.
If
, return
true
. Otherwise, return
false
4.
Else,
a.
If
Type
px
) is BigInt and
Type
py
) is String, then
i.
Let
ny
be !
StringToBigInt
py
).
ii.
If
ny
is
NaN
, return
undefined
iii.
Return BigInt::lessThan(
px
ny
).
b.
If
Type
px
) is String and
Type
py
) is BigInt, then
i.
Let
nx
be !
StringToBigInt
px
).
ii.
If
nx
is
NaN
, return
undefined
iii.
Return BigInt::lessThan(
nx
py
).
c.
NOTE: Because
px
and
py
are primitive values, evaluation order is not important.
d.
Let
nx
be !
ToNumeric
px
).
e.
Let
ny
be !
ToNumeric
py
).
f.
If
Type
nx
) is the same as
Type
ny
), return
Type
nx
)::lessThan(
nx
ny
).
g.
Assert
Type
nx
) is BigInt and
Type
ny
) is Number, or
Type
nx
) is Number and
Type
ny
) is BigInt.
h.
If
nx
or
ny
is
NaN
, return
undefined
i.
If
nx
is
-∞
or
ny
is
+∞
, return
true
j.
If
nx
is
+∞
or
ny
is
-∞
, return
false
k.
If
nx
) <
ny
), return
true
; otherwise return
false
Note 1
Step
differs from step
2.c
in the algorithm that handles the addition operator
13.15.3
) by using the logical-and operation instead of the logical-or operation.
Note 2
The comparison of Strings uses a simple lexicographic
ordering on sequences of code unit values. There is no attempt to use
the more complex, semantically oriented definitions of character or
string equality and collating order defined in the Unicode
specification. Therefore String values that are canonically equal
according to the Unicode standard could test as unequal. In effect this
algorithm assumes that both Strings are already in normalized form.
Also, note that for strings containing supplementary characters,
lexicographic ordering on sequences of UTF-16 code unit values differs
from that on sequences of code point values.
7.2.14
Abstract Equality Comparison
The comparison
==
, where
and
are values, produces
true
or
false
. Such a comparison is performed as follows:
1.
If
Type
) is the same as
Type
), then
a.
Return the result of performing
Strict Equality Comparison
===
2.
If
is
null
and
is
undefined
, return
true
3.
If
is
undefined
and
is
null
, return
true
4.
NOTE: This step is replaced in section
B.3.7.2
5.
If
Type
) is Number and
Type
) is String, return the result of the comparison
== !
ToNumber
).
6.
If
Type
) is String and
Type
) is Number, return the result of the comparison !
ToNumber
) ==
7.
If
Type
) is BigInt and
Type
) is String, then
a.
Let
be !
StringToBigInt
).
b.
If
is
NaN
, return
false
c.
Return the result of the comparison
==
8.
If
Type
) is String and
Type
) is BigInt, return the result of the comparison
==
9.
If
Type
) is Boolean, return the result of the comparison !
ToNumber
) ==
10.
If
Type
) is Boolean, return the result of the comparison
== !
ToNumber
).
11.
If
Type
) is either String, Number, BigInt, or Symbol and
Type
) is Object, return the result of the comparison
== ?
ToPrimitive
).
12.
If
Type
) is Object and
Type
) is either String, Number, BigInt, or Symbol, return the result of the comparison ?
ToPrimitive
) ==
13.
If
Type
) is BigInt and
Type
) is Number, or if
Type
) is Number and
Type
) is BigInt, then
a.
If
or
are any of
NaN
+∞
, or
-∞
, return
false
b.
If
) =
), return
true
; otherwise return
false
14.
Return
false
7.2.15
Strict Equality Comparison
The comparison
===
, where
and
are values, produces
true
or
false
. Such a comparison is performed as follows:
1.
If
Type
) is different from
Type
), return
false
2.
If
Type
) is Number or BigInt, then
a.
Return !
Type
)::equal(
).
3.
Return !
SameValueNonNumeric
).
Note
This algorithm differs from the
SameValue
Algorithm in its treatment of signed zeroes and NaNs.
7.3
Operations on Objects
7.3.1
MakeBasicObject (
internalSlotsList
The abstract operation MakeBasicObject takes argument
internalSlotsList
It is the source of all ECMAScript objects that are created
algorithmically, including both ordinary objects and exotic objects. It
factors out common steps used in creating all objects, and centralizes
object creation. It performs the following steps when called:
1.
Assert
internalSlotsList
is a
List
of internal slot names.
2.
Let
obj
be a newly created object with an internal slot for each name in
internalSlotsList
3.
Set
obj
's essential internal methods to the default
ordinary object
definitions specified in
10.1
4.
Assert
: If the caller will not be overriding both
obj
's [[GetPrototypeOf]] and [[SetPrototypeOf]] essential internal methods, then
internalSlotsList
contains [[Prototype]].
5.
Assert
: If the caller will not be overriding all of
obj
's [[SetPrototypeOf]], [[IsExtensible]], and [[PreventExtensions]] essential internal methods, then
internalSlotsList
contains [[Extensible]].
6.
If
internalSlotsList
contains [[Extensible]], set
obj
.[[Extensible]] to
true
7.
Return
obj
Note
Within this specification, exotic objects are created in
abstract operations
such as
ArrayCreate
and
BoundFunctionCreate
by first calling MakeBasicObject to obtain a basic, foundational
object, and then overriding some or all of that object's internal
methods. In order to encapsulate
exotic object
creation, the object's essential internal methods are never modified outside those operations.
7.3.2
Get (
The abstract operation Get takes arguments
(an Object) and
(a property key). It is used to retrieve the value of a specific
property of an object. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Return ?
.[[Get]](
).
7.3.3
GetV (
The abstract operation GetV takes arguments
(an
ECMAScript language value
) and
(a property key). It is used to retrieve the value of a specific property of an
ECMAScript language value
If the value is not an object, the property lookup is performed using a
wrapper object appropriate for the type of the value. It performs the
following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
be ?
ToObject
).
3.
Return ?
.[[Get]](
).
7.3.4
Set (
Throw
The abstract operation Set takes arguments
(an Object),
(a property key),
(an
ECMAScript language value
), and
Throw
(a Boolean). It is used to set the value of a specific property of an object.
is the new value for the property. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Assert
Type
Throw
) is Boolean.
4.
Let
success
be ?
.[[Set]](
).
5.
If
success
is
false
and
Throw
is
true
, throw a
TypeError
exception.
6.
Return
success
7.3.5
CreateDataProperty (
The abstract operation CreateDataProperty takes arguments
(an Object),
(a property key), and
(an
ECMAScript language value
). It is used to create a new own property of an object. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
newDesc
be the PropertyDescriptor { [[Value]]:
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
true
}.
4.
Return ?
.[[DefineOwnProperty]](
newDesc
).
Note
This abstract operation creates a property whose attributes
are set to the same defaults used for properties created by the
ECMAScript language assignment operator. Normally, the property will not
already exist. If it does exist and is not configurable or if
is not extensible, [[DefineOwnProperty]] will return
false
7.3.6
CreateMethodProperty (
The abstract operation CreateMethodProperty takes arguments
(an Object),
(a property key), and
(an
ECMAScript language value
). It is used to create a new own property of an object. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
newDesc
be the PropertyDescriptor { [[Value]]:
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
4.
Return ?
.[[DefineOwnProperty]](
newDesc
).
Note
This abstract operation creates a property whose attributes
are set to the same defaults used for built-in methods and methods
defined using class declaration syntax. Normally, the property will not
already exist. If it does exist and is not configurable or if
is not extensible, [[DefineOwnProperty]] will return
false
7.3.7
CreateDataPropertyOrThrow (
The abstract operation CreateDataPropertyOrThrow takes arguments
(an Object),
(a property key), and
(an
ECMAScript language value
). It is used to create a new own property of an object. It throws a
TypeError
exception if the requested property update cannot be performed. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
success
be ?
CreateDataProperty
).
4.
If
success
is
false
, throw a
TypeError
exception.
5.
Return
success
Note
This abstract operation creates a property whose attributes
are set to the same defaults used for properties created by the
ECMAScript language assignment operator. Normally, the property will not
already exist. If it does exist and is not configurable or if
is not extensible, [[DefineOwnProperty]] will return
false
causing this operation to throw a
TypeError
exception.
7.3.8
DefinePropertyOrThrow (
desc
The abstract operation DefinePropertyOrThrow takes arguments
(an Object),
(a property key), and
desc
(a
Property Descriptor
). It is used to call the [[DefineOwnProperty]] internal method of an object in a manner that will throw a
TypeError
exception if the requested property update cannot be performed. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
success
be ?
.[[DefineOwnProperty]](
desc
).
4.
If
success
is
false
, throw a
TypeError
exception.
5.
Return
success
7.3.9
DeletePropertyOrThrow (
The abstract operation DeletePropertyOrThrow takes arguments
(an Object) and
(a property key). It is used to remove a specific own property of an
object. It throws an exception if the property is not configurable. It
performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
success
be ?
.[[Delete]](
).
4.
If
success
is
false
, throw a
TypeError
exception.
5.
Return
success
7.3.10
GetMethod (
The abstract operation GetMethod takes arguments
(an
ECMAScript language value
) and
(a property key). It is used to get the value of a specific property of an
ECMAScript language value
when the value of the property is expected to be a function. It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
func
be ?
GetV
).
3.
If
func
is either
undefined
or
null
, return
undefined
4.
If
IsCallable
func
) is
false
, throw a
TypeError
exception.
5.
Return
func
7.3.11
HasProperty (
The abstract operation HasProperty takes arguments
(an Object) and
(a property key) and returns a completion record which, if its [[Type]] is
normal
has a [[Value]] which is a Boolean. It is used to determine whether an
object has a property with the specified property key. The property may
be either an own or inherited. It performs the following steps when
called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Return ?
.[[HasProperty]](
).
7.3.12
HasOwnProperty (
The abstract operation HasOwnProperty takes arguments
(an Object) and
(a property key) and returns a completion record which, if its [[Type]] is
normal
has a [[Value]] which is a Boolean. It is used to determine whether an
object has an own property with the specified property key. It performs
the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
IsPropertyKey
) is
true
3.
Let
desc
be ?
.[[GetOwnProperty]](
).
4.
If
desc
is
undefined
, return
false
5.
Return
true
7.3.13
Call (
[ ,
argumentsList
] )
The abstract operation Call takes arguments
(an
ECMAScript language value
) and
(an
ECMAScript language value
) and optional argument
argumentsList
(a
List
of ECMAScript language values). It is used to call the [[Call]] internal method of a
function object
is the
function object
is an
ECMAScript language value
that is the
this
value of the [[Call]], and
argumentsList
is the value passed to the corresponding argument of the internal method. If
argumentsList
is not present, a new empty
List
is used as its value. It performs the following steps when called:
1.
If
argumentsList
is not present, set
argumentsList
to a new empty
List
2.
If
IsCallable
) is
false
, throw a
TypeError
exception.
3.
Return ?
.[[Call]](
argumentsList
).
7.3.14
Construct (
[ ,
argumentsList
[ ,
newTarget
] ] )
The abstract operation Construct takes argument
(a
function object
) and optional arguments
argumentsList
and
newTarget
. It is used to call the [[Construct]] internal method of a
function object
argumentsList
and
newTarget
are the values to be passed as the corresponding arguments of the internal method. If
argumentsList
is not present, a new empty
List
is used as its value. If
newTarget
is not present,
is used as its value. It performs the following steps when called:
1.
If
newTarget
is not present, set
newTarget
to
2.
If
argumentsList
is not present, set
argumentsList
to a new empty
List
3.
Assert
IsConstructor
) is
true
4.
Assert
IsConstructor
newTarget
) is
true
5.
Return ?
.[[Construct]](
argumentsList
newTarget
).
Note
If
newTarget
is not present, this operation is equivalent to:
new F(...argumentsList)
7.3.15
SetIntegrityLevel (
level
The abstract operation SetIntegrityLevel takes arguments
and
level
. It is used to fix the set of own properties of an object. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
level
is either
sealed
or
frozen
3.
Let
status
be ?
.[[PreventExtensions]]().
4.
If
status
is
false
, return
false
5.
Let
keys
be ?
.[[OwnPropertyKeys]]().
6.
If
level
is
sealed
, then
a.
For each element
of
keys
, do
i.
Perform ?
DefinePropertyOrThrow
, PropertyDescriptor { [[Configurable]]:
false
}).
7.
Else,
a.
Assert
level
is
frozen
b.
For each element
of
keys
, do
i.
Let
currentDesc
be ?
.[[GetOwnProperty]](
).
ii.
If
currentDesc
is not
undefined
, then
1.
If
IsAccessorDescriptor
currentDesc
) is
true
, then
a.
Let
desc
be the PropertyDescriptor { [[Configurable]]:
false
}.
2.
Else,
a.
Let
desc
be the PropertyDescriptor { [[Configurable]]:
false
, [[Writable]]:
false
}.
3.
Perform ?
DefinePropertyOrThrow
desc
).
8.
Return
true
7.3.16
TestIntegrityLevel (
level
The abstract operation TestIntegrityLevel takes arguments
and
level
. It is used to determine if the set of own properties of an object are fixed. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
level
is either
sealed
or
frozen
3.
Let
extensible
be ?
IsExtensible
).
4.
If
extensible
is
true
, return
false
5.
NOTE: If the object is extensible, none of its properties are examined.
6.
Let
keys
be ?
.[[OwnPropertyKeys]]().
7.
For each element
of
keys
, do
a.
Let
currentDesc
be ?
.[[GetOwnProperty]](
).
b.
If
currentDesc
is not
undefined
, then
i.
If
currentDesc
.[[Configurable]] is
true
, return
false
ii.
If
level
is
frozen
and
IsDataDescriptor
currentDesc
) is
true
, then
1.
If
currentDesc
.[[Writable]] is
true
, return
false
8.
Return
true
7.3.17
CreateArrayFromList (
elements
The abstract operation CreateArrayFromList takes argument
elements
(a
List
). It is used to create an Array object whose elements are provided by
elements
. It performs the following steps when called:
1.
Assert
elements
is a
List
whose elements are all ECMAScript language values.
2.
Let
array
be !
ArrayCreate
(0).
3.
Let
be 0.
4.
For each element
of
elements
, do
a.
Perform !
CreateDataPropertyOrThrow
array
, !
ToString
)),
).
b.
Set
to
+ 1.
5.
Return
array
7.3.18
LengthOfArrayLike (
obj
The abstract operation LengthOfArrayLike takes argument
obj
. It returns the value of the
"length"
property of an array-like object (as a non-negative
integer
). It performs the following steps when called:
1.
Assert
Type
obj
) is Object.
2.
Return
(?
ToLength
(?
Get
obj
"length"
))).
An
array-like object
is any object for which this operation returns an
integer
rather than an
abrupt completion
Note 1
Typically, an array-like object would also have some properties with
integer index
names. However, that is not a requirement of this definition.
Note 2
Array objects and String objects are examples of array-like objects.
7.3.19
CreateListFromArrayLike (
obj
[ ,
elementTypes
] )
The abstract operation CreateListFromArrayLike takes argument
obj
and optional argument
elementTypes
(a
List
of names of ECMAScript Language Types). It is used to create a
List
value whose elements are provided by the indexed properties of
obj
elementTypes
contains the names of ECMAScript Language Types that are allowed for element values of the
List
that is created. It performs the following steps when called:
1.
If
elementTypes
is not present, set
elementTypes
to « Undefined, Null, Boolean, String, Symbol, Number, BigInt, Object ».
2.
If
Type
obj
) is not Object, throw a
TypeError
exception.
3.
Let
len
be ?
LengthOfArrayLike
obj
).
4.
Let
list
be a new empty
List
5.
Let
index
be 0.
6.
Repeat, while
index
len
a.
Let
indexName
be !
ToString
index
)).
b.
Let
next
be ?
Get
obj
indexName
).
c.
If
Type
next
) is not an element of
elementTypes
, throw a
TypeError
exception.
d.
Append
next
as the last element of
list
e.
Set
index
to
index
+ 1.
7.
Return
list
7.3.20
Invoke (
[ ,
argumentsList
] )
The abstract operation Invoke takes arguments
(an
ECMAScript language value
) and
(a property key) and optional argument
argumentsList
(a
List
of ECMAScript language values). It is used to call a method property of an
ECMAScript language value
serves as both the lookup point for the property and the
this
value of the call.
argumentsList
is the list of arguments values passed to the method. If
argumentsList
is not present, a new empty
List
is used as its value. It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
argumentsList
is not present, set
argumentsList
to a new empty
List
3.
Let
func
be ?
GetV
).
4.
Return ?
Call
func
argumentsList
).
7.3.21
OrdinaryHasInstance (
The abstract operation OrdinaryHasInstance takes arguments
(an
ECMAScript language value
) and
. It implements the default algorithm for determining if
inherits from the instance object inheritance path provided by
. It performs the following steps when called:
1.
If
IsCallable
) is
false
, return
false
2.
If
has a [[BoundTargetFunction]] internal slot, then
a.
Let
BC
be
.[[BoundTargetFunction]].
b.
Return ?
InstanceofOperator
BC
).
3.
If
Type
) is not Object, return
false
4.
Let
be ?
Get
"prototype"
).
5.
If
Type
) is not Object, throw a
TypeError
exception.
6.
Repeat,
a.
Set
to ?
.[[GetPrototypeOf]]().
b.
If
is
null
, return
false
c.
If
SameValue
) is
true
, return
true
7.3.22
SpeciesConstructor (
defaultConstructor
The abstract operation SpeciesConstructor takes arguments
(an Object) and
defaultConstructor
(a
constructor
). It is used to retrieve the
constructor
that should be used to create new objects that are derived from
defaultConstructor
is the
constructor
to use if a
constructor
@@species
property cannot be found starting from
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Let
be ?
Get
"constructor"
).
3.
If
is
undefined
, return
defaultConstructor
4.
If
Type
) is not Object, throw a
TypeError
exception.
5.
Let
be ?
Get
@@species
).
6.
If
is either
undefined
or
null
, return
defaultConstructor
7.
If
IsConstructor
) is
true
, return
8.
Throw a
TypeError
exception.
7.3.23
EnumerableOwnPropertyNames (
kind
The abstract operation EnumerableOwnPropertyNames takes arguments
(an Object) and
kind
(one of
key
value
, or
key+value
). It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Let
ownKeys
be ?
.[[OwnPropertyKeys]]().
3.
Let
properties
be a new empty
List
4.
For each element
key
of
ownKeys
, do
a.
If
Type
key
) is String, then
i.
Let
desc
be ?
.[[GetOwnProperty]](
key
).
ii.
If
desc
is not
undefined
and
desc
.[[Enumerable]] is
true
, then
1.
If
kind
is
key
, append
key
to
properties
2.
Else,
a.
Let
value
be ?
Get
key
).
b.
If
kind
is
value
, append
value
to
properties
c.
Else,
i.
Assert
kind
is
key+value
ii.
Let
entry
be !
CreateArrayFromList
(«
key
value
»).
iii.
Append
entry
to
properties
5.
Return
properties
7.3.24
GetFunctionRealm (
obj
The abstract operation GetFunctionRealm takes argument
obj
. It performs the following steps when called:
1.
Assert
: !
IsCallable
obj
) is
true
2.
If
obj
has a [[Realm]] internal slot, then
a.
Return
obj
.[[Realm]].
3.
If
obj
is a
bound function exotic object
, then
a.
Let
target
be
obj
.[[BoundTargetFunction]].
b.
Return ?
GetFunctionRealm
target
).
4.
If
obj
is a
Proxy exotic object
, then
a.
If
obj
.[[ProxyHandler]] is
null
, throw a
TypeError
exception.
b.
Let
proxyTarget
be
obj
.[[ProxyTarget]].
c.
Return ?
GetFunctionRealm
proxyTarget
).
5.
Return
the current Realm Record
Note
Step
will only be reached if
obj
is a non-standard function
exotic object
that does not have a [[Realm]] internal slot.
7.3.25
CopyDataProperties (
target
source
excludedItems
The abstract operation CopyDataProperties takes arguments
target
source
, and
excludedItems
. It performs the following steps when called:
1.
Assert
Type
target
) is Object.
2.
Assert
excludedItems
is a
List
of property keys.
3.
If
source
is
undefined
or
null
, return
target
4.
Let
from
be !
ToObject
source
).
5.
Let
keys
be ?
from
.[[OwnPropertyKeys]]().
6.
For each element
nextKey
of
keys
, do
a.
Let
excluded
be
false
b.
For each element
of
excludedItems
, do
i.
If
SameValue
nextKey
) is
true
, then
1.
Set
excluded
to
true
c.
If
excluded
is
false
, then
i.
Let
desc
be ?
from
.[[GetOwnProperty]](
nextKey
).
ii.
If
desc
is not
undefined
and
desc
.[[Enumerable]] is
true
, then
1.
Let
propValue
be ?
Get
from
nextKey
).
2.
Perform !
CreateDataPropertyOrThrow
target
nextKey
propValue
).
7.
Return
target
Note
The target passed in here is always a newly created object which is not directly accessible in case of an error being thrown.
7.4
Operations on Iterator Objects
See Common Iteration Interfaces (
27.1
).
7.4.1
GetIterator (
obj
[ ,
hint
[ ,
method
] ] )
The abstract operation GetIterator takes argument
obj
and optional arguments
hint
and
method
. It performs the following steps when called:
1.
If
hint
is not present, set
hint
to
sync
2.
Assert
hint
is either
sync
or
async
3.
If
method
is not present, then
a.
If
hint
is
async
, then
i.
Set
method
to ?
GetMethod
obj
@@asyncIterator
).
ii.
If
method
is
undefined
, then
1.
Let
syncMethod
be ?
GetMethod
obj
@@iterator
).
2.
Let
syncIteratorRecord
be ?
GetIterator
obj
sync
syncMethod
).
3.
Return !
CreateAsyncFromSyncIterator
syncIteratorRecord
).
b.
Otherwise, set
method
to ?
GetMethod
obj
@@iterator
).
4.
Let
iterator
be ?
Call
method
obj
).
5.
If
Type
iterator
) is not Object, throw a
TypeError
exception.
6.
Let
nextMethod
be ?
GetV
iterator
"next"
).
7.
Let
iteratorRecord
be the
Record
{ [[Iterator]]:
iterator
, [[NextMethod]]:
nextMethod
, [[Done]]:
false
}.
8.
Return
iteratorRecord
7.4.2
IteratorNext (
iteratorRecord
[ ,
value
] )
The abstract operation IteratorNext takes argument
iteratorRecord
and optional argument
value
. It performs the following steps when called:
1.
If
value
is not present, then
a.
Let
result
be ?
Call
iteratorRecord
.[[NextMethod]],
iteratorRecord
.[[Iterator]]).
2.
Else,
a.
Let
result
be ?
Call
iteratorRecord
.[[NextMethod]],
iteratorRecord
.[[Iterator]], «
value
»).
3.
If
Type
result
) is not Object, throw a
TypeError
exception.
4.
Return
result
7.4.3
IteratorComplete (
iterResult
The abstract operation IteratorComplete takes argument
iterResult
. It performs the following steps when called:
1.
Assert
Type
iterResult
) is Object.
2.
Return !
ToBoolean
(?
Get
iterResult
"done"
)).
7.4.4
IteratorValue (
iterResult
The abstract operation IteratorValue takes argument
iterResult
. It performs the following steps when called:
1.
Assert
Type
iterResult
) is Object.
2.
Return ?
Get
iterResult
"value"
).
7.4.5
IteratorStep (
iteratorRecord
The abstract operation IteratorStep takes argument
iteratorRecord
. It requests the next value from
iteratorRecord
.[[Iterator]] by calling
iteratorRecord
.[[NextMethod]] and returns either
false
indicating that the iterator has reached its end or the IteratorResult
object if a next value is available. It performs the following steps
when called:
1.
Let
result
be ?
IteratorNext
iteratorRecord
).
2.
Let
done
be ?
IteratorComplete
result
).
3.
If
done
is
true
, return
false
4.
Return
result
7.4.6
IteratorClose (
iteratorRecord
completion
The abstract operation IteratorClose takes arguments
iteratorRecord
and
completion
It is used to notify an iterator that it should perform any actions it
would normally perform when it has reached its completed state. It
performs the following steps when called:
1.
Assert
Type
iteratorRecord
.[[Iterator]]) is Object.
2.
Assert
completion
is a
Completion Record
3.
Let
iterator
be
iteratorRecord
.[[Iterator]].
4.
Let
innerResult
be
GetMethod
iterator
"return"
).
5.
If
innerResult
.[[Type]] is
normal
, then
a.
Let
return
be
innerResult
.[[Value]].
b.
If
return
is
undefined
, return
Completion
completion
).
c.
Set
innerResult
to
Call
return
iterator
).
6.
If
completion
.[[Type]] is
throw
, return
Completion
completion
).
7.
If
innerResult
.[[Type]] is
throw
, return
Completion
innerResult
).
8.
If
Type
innerResult
.[[Value]]) is not Object, throw a
TypeError
exception.
9.
Return
Completion
completion
).
7.4.7
AsyncIteratorClose (
iteratorRecord
completion
The abstract operation AsyncIteratorClose takes arguments
iteratorRecord
and
completion
It is used to notify an async iterator that it should perform any
actions it would normally perform when it has reached its completed
state. It performs the following steps when called:
1.
Assert
Type
iteratorRecord
.[[Iterator]]) is Object.
2.
Assert
completion
is a
Completion Record
3.
Let
iterator
be
iteratorRecord
.[[Iterator]].
4.
Let
innerResult
be
GetMethod
iterator
"return"
).
5.
If
innerResult
.[[Type]] is
normal
, then
a.
Let
return
be
innerResult
.[[Value]].
b.
If
return
is
undefined
, return
Completion
completion
).
c.
Set
innerResult
to
Call
return
iterator
).
d.
If
innerResult
.[[Type]] is
normal
, set
innerResult
to
Await
innerResult
.[[Value]]).
6.
If
completion
.[[Type]] is
throw
, return
Completion
completion
).
7.
If
innerResult
.[[Type]] is
throw
, return
Completion
innerResult
).
8.
If
Type
innerResult
.[[Value]]) is not Object, throw a
TypeError
exception.
9.
Return
Completion
completion
).
7.4.8
CreateIterResultObject (
value
done
The abstract operation CreateIterResultObject takes arguments
value
and
done
. It creates an object that supports the IteratorResult interface. It performs the following steps when called:
1.
Assert
Type
done
) is Boolean.
2.
Let
obj
be !
OrdinaryObjectCreate
%Object.prototype%
).
3.
Perform !
CreateDataPropertyOrThrow
obj
"value"
value
).
4.
Perform !
CreateDataPropertyOrThrow
obj
"done"
done
).
5.
Return
obj
7.4.9
CreateListIteratorRecord (
list
The abstract operation CreateListIteratorRecord takes argument
list
. It creates an Iterator (
27.1.1.2
) object record whose next method returns the successive elements of
list
. It performs the following steps when called:
1.
Let
closure
be a new
Abstract Closure
with no parameters that captures
list
and performs the following steps when called:
a.
For each element
of
list
, do
i.
Perform ?
Yield
).
b.
Return
undefined
2.
Let
iterator
be !
CreateIteratorFromClosure
closure
empty
%IteratorPrototype%
).
3.
Return
Record
{ [[Iterator]]:
iterator
, [[NextMethod]]: %GeneratorFunction.prototype.prototype.next%, [[Done]]:
false
}.
Note
The list iterator object is never directly accessible to ECMAScript code.
7.4.10
IterableToList (
items
[ ,
method
] )
The abstract operation IterableToList takes argument
items
and optional argument
method
. It performs the following steps when called:
1.
If
method
is present, then
a.
Let
iteratorRecord
be ?
GetIterator
items
sync
method
).
2.
Else,
a.
Let
iteratorRecord
be ?
GetIterator
items
sync
).
3.
Let
values
be a new empty
List
4.
Let
next
be
true
5.
Repeat, while
next
is not
false
a.
Set
next
to ?
IteratorStep
iteratorRecord
).
b.
If
next
is not
false
, then
i.
Let
nextValue
be ?
IteratorValue
next
).
ii.
Append
nextValue
to the end of the
List
values
6.
Return
values
Syntax-Directed Operations
In addition to those defined in this section, specialized syntax-directed operations are defined throughout this specification.
8.1
Scope Analysis
8.1.1
Static Semantics: BoundNames
Note
"*default*"
is used within this
specification as a synthetic name for hoistable anonymous functions that
are defined using export declarations.
BindingIdentifier
Identifier
1.
Return a
List
whose sole element is the
StringValue
of
Identifier
BindingIdentifier
yield
1.
Return a
List
whose sole element is
"yield"
BindingIdentifier
await
1.
Return a
List
whose sole element is
"await"
LexicalDeclaration
LetOrConst
BindingList
1.
Return the
BoundNames
of
BindingList
BindingList
BindingList
LexicalBinding
1.
Let
names
be the
BoundNames
of
BindingList
2.
Append to
names
the elements of the
BoundNames
of
LexicalBinding
3.
Return
names
LexicalBinding
BindingIdentifier
Initializer
opt
1.
Return the
BoundNames
of
BindingIdentifier
LexicalBinding
BindingPattern
Initializer
1.
Return the
BoundNames
of
BindingPattern
VariableDeclarationList
VariableDeclarationList
VariableDeclaration
1.
Let
names
be
BoundNames
of
VariableDeclarationList
2.
Append to
names
the elements of
BoundNames
of
VariableDeclaration
3.
Return
names
VariableDeclaration
BindingIdentifier
Initializer
opt
1.
Return the
BoundNames
of
BindingIdentifier
VariableDeclaration
BindingPattern
Initializer
1.
Return the
BoundNames
of
BindingPattern
ObjectBindingPattern
1.
Return a new empty
List
ObjectBindingPattern
BindingPropertyList
BindingRestProperty
1.
Let
names
be
BoundNames
of
BindingPropertyList
2.
Append to
names
the elements of
BoundNames
of
BindingRestProperty
3.
Return
names
ArrayBindingPattern
Elision
opt
1.
Return a new empty
List
ArrayBindingPattern
Elision
opt
BindingRestElement
1.
Return the
BoundNames
of
BindingRestElement
ArrayBindingPattern
BindingElementList
Elision
opt
1.
Return the
BoundNames
of
BindingElementList
ArrayBindingPattern
BindingElementList
Elision
opt
BindingRestElement
1.
Let
names
be
BoundNames
of
BindingElementList
2.
Append to
names
the elements of
BoundNames
of
BindingRestElement
3.
Return
names
BindingPropertyList
BindingPropertyList
BindingProperty
1.
Let
names
be
BoundNames
of
BindingPropertyList
2.
Append to
names
the elements of
BoundNames
of
BindingProperty
3.
Return
names
BindingElementList
BindingElementList
BindingElisionElement
1.
Let
names
be
BoundNames
of
BindingElementList
2.
Append to
names
the elements of
BoundNames
of
BindingElisionElement
3.
Return
names
BindingElisionElement
Elision
opt
BindingElement
1.
Return
BoundNames
of
BindingElement
BindingProperty
PropertyName
BindingElement
1.
Return the
BoundNames
of
BindingElement
SingleNameBinding
BindingIdentifier
Initializer
opt
1.
Return the
BoundNames
of
BindingIdentifier
BindingElement
BindingPattern
Initializer
opt
1.
Return the
BoundNames
of
BindingPattern
ForDeclaration
LetOrConst
ForBinding
1.
Return the
BoundNames
of
ForBinding
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
1.
Return the
BoundNames
of
BindingIdentifier
FunctionDeclaration
function
FormalParameters
FunctionBody
1.
Return «
"*default*"
».
FormalParameters
[empty]
1.
Return a new empty
List
FormalParameters
FormalParameterList
FunctionRestParameter
1.
Let
names
be
BoundNames
of
FormalParameterList
2.
Append to
names
the
BoundNames
of
FunctionRestParameter
3.
Return
names
FormalParameterList
FormalParameterList
FormalParameter
1.
Let
names
be
BoundNames
of
FormalParameterList
2.
Append to
names
the
BoundNames
of
FormalParameter
3.
Return
names
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return the
BoundNames
of
formals
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
1.
Return the
BoundNames
of
BindingIdentifier
GeneratorDeclaration
function
FormalParameters
GeneratorBody
1.
Return «
"*default*"
».
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
1.
Return the
BoundNames
of
BindingIdentifier
AsyncGeneratorDeclaration
async
function
FormalParameters
AsyncGeneratorBody
1.
Return «
"*default*"
».
ClassDeclaration
class
BindingIdentifier
ClassTail
1.
Return the
BoundNames
of
BindingIdentifier
ClassDeclaration
class
ClassTail
1.
Return «
"*default*"
».
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
1.
Return the
BoundNames
of
BindingIdentifier
AsyncFunctionDeclaration
async
function
FormalParameters
AsyncFunctionBody
1.
Return «
"*default*"
».
CoverCallExpressionAndAsyncArrowHead
MemberExpression
Arguments
1.
Let
head
be
CoveredAsyncArrowHead
of
CoverCallExpressionAndAsyncArrowHead
2.
Return the
BoundNames
of
head
ImportDeclaration
import
ImportClause
FromClause
1.
Return the
BoundNames
of
ImportClause
ImportDeclaration
import
ModuleSpecifier
1.
Return a new empty
List
ImportClause
ImportedDefaultBinding
NameSpaceImport
1.
Let
names
be the
BoundNames
of
ImportedDefaultBinding
2.
Append to
names
the elements of the
BoundNames
of
NameSpaceImport
3.
Return
names
ImportClause
ImportedDefaultBinding
NamedImports
1.
Let
names
be the
BoundNames
of
ImportedDefaultBinding
2.
Append to
names
the elements of the
BoundNames
of
NamedImports
3.
Return
names
NamedImports
1.
Return a new empty
List
ImportsList
ImportsList
ImportSpecifier
1.
Let
names
be the
BoundNames
of
ImportsList
2.
Append to
names
the elements of the
BoundNames
of
ImportSpecifier
3.
Return
names
ImportSpecifier
IdentifierName
as
ImportedBinding
1.
Return the
BoundNames
of
ImportedBinding
ExportDeclaration
export
ExportFromClause
FromClause
export
NamedExports
1.
Return a new empty
List
ExportDeclaration
export
VariableStatement
1.
Return the
BoundNames
of
VariableStatement
ExportDeclaration
export
Declaration
1.
Return the
BoundNames
of
Declaration
ExportDeclaration
export
default
HoistableDeclaration
1.
Let
declarationNames
be the
BoundNames
of
HoistableDeclaration
2.
If
declarationNames
does not include the element
"*default*"
, append
"*default*"
to
declarationNames
3.
Return
declarationNames
ExportDeclaration
export
default
ClassDeclaration
1.
Let
declarationNames
be the
BoundNames
of
ClassDeclaration
2.
If
declarationNames
does not include the element
"*default*"
, append
"*default*"
to
declarationNames
3.
Return
declarationNames
ExportDeclaration
export
default
AssignmentExpression
1.
Return «
"*default*"
».
8.1.2
Static Semantics: DeclarationPart
HoistableDeclaration
FunctionDeclaration
1.
Return
FunctionDeclaration
HoistableDeclaration
GeneratorDeclaration
1.
Return
GeneratorDeclaration
HoistableDeclaration
AsyncFunctionDeclaration
1.
Return
AsyncFunctionDeclaration
HoistableDeclaration
AsyncGeneratorDeclaration
1.
Return
AsyncGeneratorDeclaration
Declaration
ClassDeclaration
1.
Return
ClassDeclaration
Declaration
LexicalDeclaration
1.
Return
LexicalDeclaration
8.1.3
Static Semantics: IsConstantDeclaration
LexicalDeclaration
LetOrConst
BindingList
1.
Return
IsConstantDeclaration
of
LetOrConst
LetOrConst
let
1.
Return
false
LetOrConst
const
1.
Return
true
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
function
FormalParameters
FunctionBody
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
function
FormalParameters
GeneratorBody
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
async
function
FormalParameters
AsyncGeneratorBody
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
async
function
FormalParameters
AsyncFunctionBody
1.
Return
false
ClassDeclaration
class
BindingIdentifier
ClassTail
class
ClassTail
1.
Return
false
ExportDeclaration
export
ExportFromClause
FromClause
export
NamedExports
export
default
AssignmentExpression
1.
Return
false
Note
It is not necessary to treat
export default
AssignmentExpression
as a constant declaration because there is no syntax that permits
assignment to the internal bound name used to reference a module's
default object.
8.1.4
Static Semantics: LexicallyDeclaredNames
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
names
be
LexicallyDeclaredNames
of
StatementList
2.
Append to
names
the elements of the
LexicallyDeclaredNames
of
StatementListItem
3.
Return
names
StatementListItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
LexicallyDeclaredNames
of
LabelledStatement
2.
Return a new empty
List
StatementListItem
Declaration
1.
Return the
BoundNames
of
Declaration
CaseBlock
1.
Return a new empty
List
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, let
names
be the
LexicallyDeclaredNames
of the first
CaseClauses
2.
Else, let
names
be a new empty
List
3.
Append to
names
the elements of the
LexicallyDeclaredNames
of
DefaultClause
4.
If the second
CaseClauses
is not present, return
names
5.
Return the result of appending to
names
the elements of the
LexicallyDeclaredNames
of the second
CaseClauses
CaseClauses
CaseClauses
CaseClause
1.
Let
names
be
LexicallyDeclaredNames
of
CaseClauses
2.
Append to
names
the elements of the
LexicallyDeclaredNames
of
CaseClause
3.
Return
names
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return the
LexicallyDeclaredNames
of
StatementList
2.
Return a new empty
List
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return the
LexicallyDeclaredNames
of
StatementList
2.
Return a new empty
List
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
LexicallyDeclaredNames
of
LabelledItem
LabelledItem
Statement
1.
Return a new empty
List
LabelledItem
FunctionDeclaration
1.
Return
BoundNames
of
FunctionDeclaration
FunctionStatementList
[empty]
1.
Return a new empty
List
FunctionStatementList
StatementList
1.
Return
TopLevelLexicallyDeclaredNames
of
StatementList
ConciseBody
ExpressionBody
1.
Return a new empty
List
AsyncConciseBody
ExpressionBody
1.
Return a new empty
List
ScriptBody
StatementList
1.
Return
TopLevelLexicallyDeclaredNames
of
StatementList
Note 1
At the top level of a
Script
, function declarations are treated like var declarations rather than like lexical declarations.
Note 2
The LexicallyDeclaredNames of a
Module
includes the names of all of its imported bindings.
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
names
be
LexicallyDeclaredNames
of
ModuleItemList
2.
Append to
names
the elements of the
LexicallyDeclaredNames
of
ModuleItem
3.
Return
names
ModuleItem
ImportDeclaration
1.
Return the
BoundNames
of
ImportDeclaration
ModuleItem
ExportDeclaration
1.
If
ExportDeclaration
is
export
VariableStatement
, return a new empty
List
2.
Return the
BoundNames
of
ExportDeclaration
ModuleItem
StatementListItem
1.
Return
LexicallyDeclaredNames
of
StatementListItem
Note 3
At the top level of a
Module
, function declarations are treated like lexical declarations rather than like var declarations.
8.1.5
Static Semantics: LexicallyScopedDeclarations
StatementList
StatementList
StatementListItem
1.
Let
declarations
be
LexicallyScopedDeclarations
of
StatementList
2.
Append to
declarations
the elements of the
LexicallyScopedDeclarations
of
StatementListItem
3.
Return
declarations
StatementListItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
LexicallyScopedDeclarations
of
LabelledStatement
2.
Return a new empty
List
StatementListItem
Declaration
1.
Return a
List
whose sole element is
DeclarationPart
of
Declaration
CaseBlock
1.
Return a new empty
List
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, let
declarations
be the
LexicallyScopedDeclarations
of the first
CaseClauses
2.
Else, let
declarations
be a new empty
List
3.
Append to
declarations
the elements of the
LexicallyScopedDeclarations
of
DefaultClause
4.
If the second
CaseClauses
is not present, return
declarations
5.
Return the result of appending to
declarations
the elements of the
LexicallyScopedDeclarations
of the second
CaseClauses
CaseClauses
CaseClauses
CaseClause
1.
Let
declarations
be
LexicallyScopedDeclarations
of
CaseClauses
2.
Append to
declarations
the elements of the
LexicallyScopedDeclarations
of
CaseClause
3.
Return
declarations
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return the
LexicallyScopedDeclarations
of
StatementList
2.
Return a new empty
List
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return the
LexicallyScopedDeclarations
of
StatementList
2.
Return a new empty
List
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
LexicallyScopedDeclarations
of
LabelledItem
LabelledItem
Statement
1.
Return a new empty
List
LabelledItem
FunctionDeclaration
1.
Return a
List
whose sole element is
FunctionDeclaration
FunctionStatementList
[empty]
1.
Return a new empty
List
FunctionStatementList
StatementList
1.
Return the
TopLevelLexicallyScopedDeclarations
of
StatementList
ConciseBody
ExpressionBody
1.
Return a new empty
List
AsyncConciseBody
ExpressionBody
1.
Return a new empty
List
ScriptBody
StatementList
1.
Return
TopLevelLexicallyScopedDeclarations
of
StatementList
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
declarations
be
LexicallyScopedDeclarations
of
ModuleItemList
2.
Append to
declarations
the elements of the
LexicallyScopedDeclarations
of
ModuleItem
3.
Return
declarations
ModuleItem
ImportDeclaration
1.
Return a new empty
List
ExportDeclaration
export
ExportFromClause
FromClause
export
NamedExports
export
VariableStatement
1.
Return a new empty
List
ExportDeclaration
export
Declaration
1.
Return a
List
whose sole element is
DeclarationPart
of
Declaration
ExportDeclaration
export
default
HoistableDeclaration
1.
Return a
List
whose sole element is
DeclarationPart
of
HoistableDeclaration
ExportDeclaration
export
default
ClassDeclaration
1.
Return a
List
whose sole element is
ClassDeclaration
ExportDeclaration
export
default
AssignmentExpression
1.
Return a
List
whose sole element is this
ExportDeclaration
8.1.6
Static Semantics: VarDeclaredNames
Statement
EmptyStatement
ExpressionStatement
ContinueStatement
BreakStatement
ReturnStatement
ThrowStatement
DebuggerStatement
1.
Return a new empty
List
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
names
be
VarDeclaredNames
of
StatementList
2.
Append to
names
the elements of the
VarDeclaredNames
of
StatementListItem
3.
Return
names
StatementListItem
Declaration
1.
Return a new empty
List
VariableStatement
var
VariableDeclarationList
1.
Return
BoundNames
of
VariableDeclarationList
IfStatement
if
Expression
Statement
else
Statement
1.
Let
names
be
VarDeclaredNames
of the first
Statement
2.
Append to
names
the elements of the
VarDeclaredNames
of the second
Statement
3.
Return
names
IfStatement
if
Expression
Statement
1.
Return the
VarDeclaredNames
of
Statement
DoWhileStatement
do
Statement
while
Expression
1.
Return the
VarDeclaredNames
of
Statement
WhileStatement
while
Expression
Statement
1.
Return the
VarDeclaredNames
of
Statement
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
1.
Return the
VarDeclaredNames
of
Statement
ForStatement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
1.
Let
names
be
BoundNames
of
VariableDeclarationList
2.
Append to
names
the elements of the
VarDeclaredNames
of
Statement
3.
Return
names
ForStatement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Return the
VarDeclaredNames
of
Statement
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Return the
VarDeclaredNames
of
Statement
ForInOfStatement
for
var
ForBinding
in
Expression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
1.
Let
names
be the
BoundNames
of
ForBinding
2.
Append to
names
the elements of the
VarDeclaredNames
of
Statement
3.
Return
names
Note
This section is extended by Annex
B.3.6
WithStatement
with
Expression
Statement
1.
Return the
VarDeclaredNames
of
Statement
SwitchStatement
switch
Expression
CaseBlock
1.
Return the
VarDeclaredNames
of
CaseBlock
CaseBlock
1.
Return a new empty
List
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, let
names
be the
VarDeclaredNames
of the first
CaseClauses
2.
Else, let
names
be a new empty
List
3.
Append to
names
the elements of the
VarDeclaredNames
of
DefaultClause
4.
If the second
CaseClauses
is not present, return
names
5.
Return the result of appending to
names
the elements of the
VarDeclaredNames
of the second
CaseClauses
CaseClauses
CaseClauses
CaseClause
1.
Let
names
be
VarDeclaredNames
of
CaseClauses
2.
Append to
names
the elements of the
VarDeclaredNames
of
CaseClause
3.
Return
names
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return the
VarDeclaredNames
of
StatementList
2.
Return a new empty
List
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return the
VarDeclaredNames
of
StatementList
2.
Return a new empty
List
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
VarDeclaredNames
of
LabelledItem
LabelledItem
FunctionDeclaration
1.
Return a new empty
List
TryStatement
try
Block
Catch
1.
Let
names
be
VarDeclaredNames
of
Block
2.
Append to
names
the elements of the
VarDeclaredNames
of
Catch
3.
Return
names
TryStatement
try
Block
Finally
1.
Let
names
be
VarDeclaredNames
of
Block
2.
Append to
names
the elements of the
VarDeclaredNames
of
Finally
3.
Return
names
TryStatement
try
Block
Catch
Finally
1.
Let
names
be
VarDeclaredNames
of
Block
2.
Append to
names
the elements of the
VarDeclaredNames
of
Catch
3.
Append to
names
the elements of the
VarDeclaredNames
of
Finally
4.
Return
names
Catch
catch
CatchParameter
Block
1.
Return the
VarDeclaredNames
of
Block
FunctionStatementList
[empty]
1.
Return a new empty
List
FunctionStatementList
StatementList
1.
Return
TopLevelVarDeclaredNames
of
StatementList
ConciseBody
ExpressionBody
1.
Return a new empty
List
AsyncConciseBody
ExpressionBody
1.
Return a new empty
List
ScriptBody
StatementList
1.
Return
TopLevelVarDeclaredNames
of
StatementList
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
names
be
VarDeclaredNames
of
ModuleItemList
2.
Append to
names
the elements of the
VarDeclaredNames
of
ModuleItem
3.
Return
names
ModuleItem
ImportDeclaration
1.
Return a new empty
List
ModuleItem
ExportDeclaration
1.
If
ExportDeclaration
is
export
VariableStatement
, return
BoundNames
of
ExportDeclaration
2.
Return a new empty
List
8.1.7
Static Semantics: VarScopedDeclarations
Statement
EmptyStatement
ExpressionStatement
ContinueStatement
BreakStatement
ReturnStatement
ThrowStatement
DebuggerStatement
1.
Return a new empty
List
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
declarations
be
VarScopedDeclarations
of
StatementList
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
StatementListItem
3.
Return
declarations
StatementListItem
Declaration
1.
Return a new empty
List
VariableDeclarationList
VariableDeclaration
1.
Return a
List
whose sole element is
VariableDeclaration
VariableDeclarationList
VariableDeclarationList
VariableDeclaration
1.
Let
declarations
be
VarScopedDeclarations
of
VariableDeclarationList
2.
Append
VariableDeclaration
to
declarations
3.
Return
declarations
IfStatement
if
Expression
Statement
else
Statement
1.
Let
declarations
be
VarScopedDeclarations
of the first
Statement
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of the second
Statement
3.
Return
declarations
IfStatement
if
Expression
Statement
1.
Return the
VarScopedDeclarations
of
Statement
DoWhileStatement
do
Statement
while
Expression
1.
Return the
VarScopedDeclarations
of
Statement
WhileStatement
while
Expression
Statement
1.
Return the
VarScopedDeclarations
of
Statement
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
1.
Return the
VarScopedDeclarations
of
Statement
ForStatement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
1.
Let
declarations
be
VarScopedDeclarations
of
VariableDeclarationList
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Statement
3.
Return
declarations
ForStatement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Return the
VarScopedDeclarations
of
Statement
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Return the
VarScopedDeclarations
of
Statement
ForInOfStatement
for
var
ForBinding
in
Expression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
1.
Let
declarations
be a
List
whose sole element is
ForBinding
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Statement
3.
Return
declarations
Note
This section is extended by Annex
B.3.6
WithStatement
with
Expression
Statement
1.
Return the
VarScopedDeclarations
of
Statement
SwitchStatement
switch
Expression
CaseBlock
1.
Return the
VarScopedDeclarations
of
CaseBlock
CaseBlock
1.
Return a new empty
List
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, let
declarations
be the
VarScopedDeclarations
of the first
CaseClauses
2.
Else, let
declarations
be a new empty
List
3.
Append to
declarations
the elements of the
VarScopedDeclarations
of
DefaultClause
4.
If the second
CaseClauses
is not present, return
declarations
5.
Return the result of appending to
declarations
the elements of the
VarScopedDeclarations
of the second
CaseClauses
CaseClauses
CaseClauses
CaseClause
1.
Let
declarations
be
VarScopedDeclarations
of
CaseClauses
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
CaseClause
3.
Return
declarations
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return the
VarScopedDeclarations
of
StatementList
2.
Return a new empty
List
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return the
VarScopedDeclarations
of
StatementList
2.
Return a new empty
List
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
VarScopedDeclarations
of
LabelledItem
LabelledItem
FunctionDeclaration
1.
Return a new empty
List
TryStatement
try
Block
Catch
1.
Let
declarations
be
VarScopedDeclarations
of
Block
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Catch
3.
Return
declarations
TryStatement
try
Block
Finally
1.
Let
declarations
be
VarScopedDeclarations
of
Block
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Finally
3.
Return
declarations
TryStatement
try
Block
Catch
Finally
1.
Let
declarations
be
VarScopedDeclarations
of
Block
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Catch
3.
Append to
declarations
the elements of the
VarScopedDeclarations
of
Finally
4.
Return
declarations
Catch
catch
CatchParameter
Block
1.
Return the
VarScopedDeclarations
of
Block
FunctionStatementList
[empty]
1.
Return a new empty
List
FunctionStatementList
StatementList
1.
Return the
TopLevelVarScopedDeclarations
of
StatementList
ConciseBody
ExpressionBody
1.
Return a new empty
List
AsyncConciseBody
ExpressionBody
1.
Return a new empty
List
ScriptBody
StatementList
1.
Return
TopLevelVarScopedDeclarations
of
StatementList
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
declarations
be
VarScopedDeclarations
of
ModuleItemList
2.
Append to
declarations
the elements of the
VarScopedDeclarations
of
ModuleItem
3.
Return
declarations
ModuleItem
ImportDeclaration
1.
Return a new empty
List
ModuleItem
ExportDeclaration
1.
If
ExportDeclaration
is
export
VariableStatement
, return
VarScopedDeclarations
of
VariableStatement
2.
Return a new empty
List
8.1.8
Static Semantics: TopLevelLexicallyDeclaredNames
StatementList
StatementList
StatementListItem
1.
Let
names
be
TopLevelLexicallyDeclaredNames
of
StatementList
2.
Append to
names
the elements of the
TopLevelLexicallyDeclaredNames
of
StatementListItem
3.
Return
names
StatementListItem
Statement
1.
Return a new empty
List
StatementListItem
Declaration
1.
If
Declaration
is
Declaration
HoistableDeclaration
, then
a.
Return « ».
2.
Return the
BoundNames
of
Declaration
Note
At the top level of a function, or script, function
declarations are treated like var declarations rather than like lexical
declarations.
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return a new empty
List
8.1.9
Static Semantics: TopLevelLexicallyScopedDeclarations
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
declarations
be
TopLevelLexicallyScopedDeclarations
of
StatementList
2.
Append to
declarations
the elements of the
TopLevelLexicallyScopedDeclarations
of
StatementListItem
3.
Return
declarations
StatementListItem
Statement
1.
Return a new empty
List
StatementListItem
Declaration
1.
If
Declaration
is
Declaration
HoistableDeclaration
, then
a.
Return « ».
2.
Return a
List
whose sole element is
Declaration
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return a new empty
List
8.1.10
Static Semantics: TopLevelVarDeclaredNames
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
names
be
TopLevelVarDeclaredNames
of
StatementList
2.
Append to
names
the elements of the
TopLevelVarDeclaredNames
of
StatementListItem
3.
Return
names
StatementListItem
Declaration
1.
If
Declaration
is
Declaration
HoistableDeclaration
, then
a.
Return the
BoundNames
of
HoistableDeclaration
2.
Return a new empty
List
StatementListItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
TopLevelVarDeclaredNames
of
Statement
2.
Return
VarDeclaredNames
of
Statement
Note
At the top level of a function or script, inner function declarations are treated like var declarations.
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
TopLevelVarDeclaredNames
of
LabelledItem
LabelledItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
TopLevelVarDeclaredNames
of
Statement
2.
Return
VarDeclaredNames
of
Statement
LabelledItem
FunctionDeclaration
1.
Return
BoundNames
of
FunctionDeclaration
8.1.11
Static Semantics: TopLevelVarScopedDeclarations
Block
1.
Return a new empty
List
StatementList
StatementList
StatementListItem
1.
Let
declarations
be
TopLevelVarScopedDeclarations
of
StatementList
2.
Append to
declarations
the elements of the
TopLevelVarScopedDeclarations
of
StatementListItem
3.
Return
declarations
StatementListItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
TopLevelVarScopedDeclarations
of
Statement
2.
Return
VarScopedDeclarations
of
Statement
StatementListItem
Declaration
1.
If
Declaration
is
Declaration
HoistableDeclaration
, then
a.
Let
declaration
be
DeclarationPart
of
HoistableDeclaration
b.
Return «
declaration
».
2.
Return a new empty
List
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return the
TopLevelVarScopedDeclarations
of
LabelledItem
LabelledItem
Statement
1.
If
Statement
is
Statement
LabelledStatement
, return
TopLevelVarScopedDeclarations
of
Statement
2.
Return
VarScopedDeclarations
of
Statement
LabelledItem
FunctionDeclaration
1.
Return a
List
whose sole element is
FunctionDeclaration
8.2
Labels
8.2.1
Static Semantics: ContainsDuplicateLabels
With parameter
labelSet
Statement
VariableStatement
EmptyStatement
ExpressionStatement
ContinueStatement
BreakStatement
ReturnStatement
ThrowStatement
DebuggerStatement
Block
StatementListItem
Declaration
1.
Return
false
StatementList
StatementList
StatementListItem
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
StatementList
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of
StatementListItem
with argument
labelSet
IfStatement
if
Expression
Statement
else
Statement
1.
Let
hasDuplicate
be
ContainsDuplicateLabels
of the first
Statement
with argument
labelSet
2.
If
hasDuplicate
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of the second
Statement
with argument
labelSet
IfStatement
if
Expression
Statement
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
DoWhileStatement
do
Statement
while
Expression
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
WhileStatement
while
Expression
Statement
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
var
ForBinding
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
Note
This section is extended by Annex
B.3.6
WithStatement
with
Expression
Statement
1.
Return
ContainsDuplicateLabels
of
Statement
with argument
labelSet
SwitchStatement
switch
Expression
CaseBlock
1.
Return
ContainsDuplicateLabels
of
CaseBlock
with argument
labelSet
CaseBlock
1.
Return
false
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, then
a.
Let
hasDuplicates
be
ContainsDuplicateLabels
of the first
CaseClauses
with argument
labelSet
b.
If
hasDuplicates
is
true
, return
true
2.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
DefaultClause
with argument
labelSet
3.
If
hasDuplicates
is
true
, return
true
4.
If the second
CaseClauses
is not present, return
false
5.
Return
ContainsDuplicateLabels
of the second
CaseClauses
with argument
labelSet
CaseClauses
CaseClauses
CaseClause
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
CaseClauses
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of
CaseClause
with argument
labelSet
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return
ContainsDuplicateLabels
of
StatementList
with argument
labelSet
2.
Return
false
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return
ContainsDuplicateLabels
of
StatementList
with argument
labelSet
2.
Return
false
LabelledStatement
LabelIdentifier
LabelledItem
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
If
label
is an element of
labelSet
, return
true
3.
Let
newLabelSet
be a copy of
labelSet
with
label
appended.
4.
Return
ContainsDuplicateLabels
of
LabelledItem
with argument
newLabelSet
LabelledItem
FunctionDeclaration
1.
Return
false
TryStatement
try
Block
Catch
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
Block
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of
Catch
with argument
labelSet
TryStatement
try
Block
Finally
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
Block
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of
Finally
with argument
labelSet
TryStatement
try
Block
Catch
Finally
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
Block
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
Catch
with argument
labelSet
4.
If
hasDuplicates
is
true
, return
true
5.
Return
ContainsDuplicateLabels
of
Finally
with argument
labelSet
Catch
catch
CatchParameter
Block
1.
Return
ContainsDuplicateLabels
of
Block
with argument
labelSet
FunctionStatementList
[empty]
1.
Return
false
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
hasDuplicates
be
ContainsDuplicateLabels
of
ModuleItemList
with argument
labelSet
2.
If
hasDuplicates
is
true
, return
true
3.
Return
ContainsDuplicateLabels
of
ModuleItem
with argument
labelSet
ModuleItem
ImportDeclaration
ExportDeclaration
1.
Return
false
8.2.2
Static Semantics: ContainsUndefinedBreakTarget
With parameter
labelSet
Statement
VariableStatement
EmptyStatement
ExpressionStatement
ContinueStatement
ReturnStatement
ThrowStatement
DebuggerStatement
Block
StatementListItem
Declaration
1.
Return
false
StatementList
StatementList
StatementListItem
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
StatementList
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of
StatementListItem
with argument
labelSet
IfStatement
if
Expression
Statement
else
Statement
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of the first
Statement
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of the second
Statement
with argument
labelSet
IfStatement
if
Expression
Statement
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
DoWhileStatement
do
Statement
while
Expression
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
WhileStatement
while
Expression
Statement
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
var
ForBinding
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
Note
This section is extended by Annex
B.3.6
BreakStatement
break
1.
Return
false
BreakStatement
break
LabelIdentifier
1.
If the
StringValue
of
LabelIdentifier
is not an element of
labelSet
, return
true
2.
Return
false
WithStatement
with
Expression
Statement
1.
Return
ContainsUndefinedBreakTarget
of
Statement
with argument
labelSet
SwitchStatement
switch
Expression
CaseBlock
1.
Return
ContainsUndefinedBreakTarget
of
CaseBlock
with argument
labelSet
CaseBlock
1.
Return
false
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, then
a.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of the first
CaseClauses
with argument
labelSet
b.
If
hasUndefinedLabels
is
true
, return
true
2.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
DefaultClause
with argument
labelSet
3.
If
hasUndefinedLabels
is
true
, return
true
4.
If the second
CaseClauses
is not present, return
false
5.
Return
ContainsUndefinedBreakTarget
of the second
CaseClauses
with argument
labelSet
CaseClauses
CaseClauses
CaseClause
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
CaseClauses
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of
CaseClause
with argument
labelSet
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return
ContainsUndefinedBreakTarget
of
StatementList
with argument
labelSet
2.
Return
false
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return
ContainsUndefinedBreakTarget
of
StatementList
with argument
labelSet
2.
Return
false
LabelledStatement
LabelIdentifier
LabelledItem
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
Let
newLabelSet
be a copy of
labelSet
with
label
appended.
3.
Return
ContainsUndefinedBreakTarget
of
LabelledItem
with argument
newLabelSet
LabelledItem
FunctionDeclaration
1.
Return
false
TryStatement
try
Block
Catch
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
Block
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of
Catch
with argument
labelSet
TryStatement
try
Block
Finally
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
Block
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of
Finally
with argument
labelSet
TryStatement
try
Block
Catch
Finally
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
Block
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
Catch
with argument
labelSet
4.
If
hasUndefinedLabels
is
true
, return
true
5.
Return
ContainsUndefinedBreakTarget
of
Finally
with argument
labelSet
Catch
catch
CatchParameter
Block
1.
Return
ContainsUndefinedBreakTarget
of
Block
with argument
labelSet
FunctionStatementList
[empty]
1.
Return
false
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
hasUndefinedLabels
be
ContainsUndefinedBreakTarget
of
ModuleItemList
with argument
labelSet
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedBreakTarget
of
ModuleItem
with argument
labelSet
ModuleItem
ImportDeclaration
ExportDeclaration
1.
Return
false
8.2.3
Static Semantics: ContainsUndefinedContinueTarget
With parameters
iterationSet
and
labelSet
Statement
VariableStatement
EmptyStatement
ExpressionStatement
BreakStatement
ReturnStatement
ThrowStatement
DebuggerStatement
Block
StatementListItem
Declaration
1.
Return
false
BreakableStatement
IterationStatement
1.
Let
newIterationSet
be a copy of
iterationSet
with all the elements of
labelSet
appended.
2.
Return
ContainsUndefinedContinueTarget
of
IterationStatement
with arguments
newIterationSet
and « ».
StatementList
StatementList
StatementListItem
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
StatementList
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of
StatementListItem
with arguments
iterationSet
and « ».
IfStatement
if
Expression
Statement
else
Statement
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of the first
Statement
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of the second
Statement
with arguments
iterationSet
and « ».
IfStatement
if
Expression
Statement
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
DoWhileStatement
do
Statement
while
Expression
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
WhileStatement
while
Expression
Statement
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
var
ForBinding
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
Note
This section is extended by Annex
B.3.6
ContinueStatement
continue
1.
Return
false
ContinueStatement
continue
LabelIdentifier
1.
If the
StringValue
of
LabelIdentifier
is not an element of
iterationSet
, return
true
2.
Return
false
WithStatement
with
Expression
Statement
1.
Return
ContainsUndefinedContinueTarget
of
Statement
with arguments
iterationSet
and « ».
SwitchStatement
switch
Expression
CaseBlock
1.
Return
ContainsUndefinedContinueTarget
of
CaseBlock
with arguments
iterationSet
and « ».
CaseBlock
1.
Return
false
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
If the first
CaseClauses
is present, then
a.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of the first
CaseClauses
with arguments
iterationSet
and « ».
b.
If
hasUndefinedLabels
is
true
, return
true
2.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
DefaultClause
with arguments
iterationSet
and « ».
3.
If
hasUndefinedLabels
is
true
, return
true
4.
If the second
CaseClauses
is not present, return
false
5.
Return
ContainsUndefinedContinueTarget
of the second
CaseClauses
with arguments
iterationSet
and « ».
CaseClauses
CaseClauses
CaseClause
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
CaseClauses
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of
CaseClause
with arguments
iterationSet
and « ».
CaseClause
case
Expression
StatementList
opt
1.
If the
StatementList
is present, return
ContainsUndefinedContinueTarget
of
StatementList
with arguments
iterationSet
and « ».
2.
Return
false
DefaultClause
default
StatementList
opt
1.
If the
StatementList
is present, return
ContainsUndefinedContinueTarget
of
StatementList
with arguments
iterationSet
and « ».
2.
Return
false
LabelledStatement
LabelIdentifier
LabelledItem
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
Let
newLabelSet
be a copy of
labelSet
with
label
appended.
3.
Return
ContainsUndefinedContinueTarget
of
LabelledItem
with arguments
iterationSet
and
newLabelSet
LabelledItem
FunctionDeclaration
1.
Return
false
TryStatement
try
Block
Catch
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
Block
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of
Catch
with arguments
iterationSet
and « ».
TryStatement
try
Block
Finally
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
Block
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of
Finally
with arguments
iterationSet
and « ».
TryStatement
try
Block
Catch
Finally
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
Block
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
Catch
with arguments
iterationSet
and « ».
4.
If
hasUndefinedLabels
is
true
, return
true
5.
Return
ContainsUndefinedContinueTarget
of
Finally
with arguments
iterationSet
and « ».
Catch
catch
CatchParameter
Block
1.
Return
ContainsUndefinedContinueTarget
of
Block
with arguments
iterationSet
and « ».
FunctionStatementList
[empty]
1.
Return
false
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
hasUndefinedLabels
be
ContainsUndefinedContinueTarget
of
ModuleItemList
with arguments
iterationSet
and « ».
2.
If
hasUndefinedLabels
is
true
, return
true
3.
Return
ContainsUndefinedContinueTarget
of
ModuleItem
with arguments
iterationSet
and « ».
ModuleItem
ImportDeclaration
ExportDeclaration
1.
Return
false
8.3
Function Name Inference
8.3.1
Static Semantics: HasName
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
If
IsFunctionDefinition
of
expr
is
false
, return
false
3.
Return
HasName
of
expr
FunctionExpression
function
FormalParameters
FunctionBody
GeneratorExpression
function
FormalParameters
GeneratorBody
AsyncGeneratorExpression
async
function
FormalParameters
AsyncGeneratorBody
AsyncFunctionExpression
async
function
FormalParameters
AsyncFunctionBody
ArrowFunction
ArrowParameters
=>
ConciseBody
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
ClassExpression
class
ClassTail
1.
Return
false
FunctionExpression
function
BindingIdentifier
FormalParameters
FunctionBody
GeneratorExpression
function
BindingIdentifier
FormalParameters
GeneratorBody
AsyncGeneratorExpression
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
AsyncFunctionExpression
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
ClassExpression
class
BindingIdentifier
ClassTail
1.
Return
true
8.3.2
Static Semantics: IsFunctionDefinition
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
IsFunctionDefinition
of
expr
PrimaryExpression
this
IdentifierReference
Literal
ArrayLiteral
ObjectLiteral
RegularExpressionLiteral
TemplateLiteral
MemberExpression
MemberExpression
Expression
MemberExpression
IdentifierName
MemberExpression
TemplateLiteral
SuperProperty
MetaProperty
new
MemberExpression
Arguments
NewExpression
new
NewExpression
LeftHandSideExpression
CallExpression
OptionalExpression
UpdateExpression
LeftHandSideExpression
++
LeftHandSideExpression
--
++
UnaryExpression
--
UnaryExpression
UnaryExpression
delete
UnaryExpression
void
UnaryExpression
typeof
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
AwaitExpression
ExponentiationExpression
UpdateExpression
**
ExponentiationExpression
MultiplicativeExpression
MultiplicativeExpression
MultiplicativeOperator
ExponentiationExpression
AdditiveExpression
AdditiveExpression
MultiplicativeExpression
AdditiveExpression
MultiplicativeExpression
ShiftExpression
ShiftExpression
<<
AdditiveExpression
ShiftExpression
>>
AdditiveExpression
ShiftExpression
>>>
AdditiveExpression
RelationalExpression
RelationalExpression
ShiftExpression
RelationalExpression
ShiftExpression
RelationalExpression
<=
ShiftExpression
RelationalExpression
>=
ShiftExpression
RelationalExpression
instanceof
ShiftExpression
RelationalExpression
in
ShiftExpression
EqualityExpression
EqualityExpression
==
RelationalExpression
EqualityExpression
!=
RelationalExpression
EqualityExpression
===
RelationalExpression
EqualityExpression
!==
RelationalExpression
BitwiseANDExpression
BitwiseANDExpression
EqualityExpression
BitwiseXORExpression
BitwiseXORExpression
BitwiseANDExpression
BitwiseORExpression
BitwiseORExpression
BitwiseXORExpression
LogicalANDExpression
LogicalANDExpression
&&
BitwiseORExpression
LogicalORExpression
LogicalORExpression
||
LogicalANDExpression
CoalesceExpression
CoalesceExpressionHead
??
BitwiseORExpression
ConditionalExpression
ShortCircuitExpression
AssignmentExpression
AssignmentExpression
AssignmentExpression
YieldExpression
LeftHandSideExpression
AssignmentExpression
LeftHandSideExpression
AssignmentOperator
AssignmentExpression
LeftHandSideExpression
&&=
AssignmentExpression
LeftHandSideExpression
||=
AssignmentExpression
LeftHandSideExpression
??=
AssignmentExpression
Expression
Expression
AssignmentExpression
1.
Return
false
AssignmentExpression
ArrowFunction
AsyncArrowFunction
FunctionExpression
function
BindingIdentifier
opt
FormalParameters
FunctionBody
GeneratorExpression
function
BindingIdentifier
opt
FormalParameters
GeneratorBody
AsyncGeneratorExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncGeneratorBody
AsyncFunctionExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncFunctionBody
ClassExpression
class
BindingIdentifier
opt
ClassTail
1.
Return
true
8.3.3
Static Semantics: IsAnonymousFunctionDefinition (
expr
The abstract operation IsAnonymousFunctionDefinition takes argument
expr
(a
Parse Node
for
AssignmentExpression
or a
Parse Node
for
Initializer
).
It determines if its argument is a function definition that does not
bind a name. It performs the following steps when called:
1.
If
IsFunctionDefinition
of
expr
is
false
, return
false
2.
Let
hasName
be
HasName
of
expr
3.
If
hasName
is
true
, return
false
4.
Return
true
8.3.4
Static Semantics: IsIdentifierRef
PrimaryExpression
IdentifierReference
1.
Return
true
PrimaryExpression
this
Literal
ArrayLiteral
ObjectLiteral
FunctionExpression
ClassExpression
GeneratorExpression
AsyncFunctionExpression
AsyncGeneratorExpression
RegularExpressionLiteral
TemplateLiteral
CoverParenthesizedExpressionAndArrowParameterList
MemberExpression
MemberExpression
Expression
MemberExpression
IdentifierName
MemberExpression
TemplateLiteral
SuperProperty
MetaProperty
new
MemberExpression
Arguments
NewExpression
new
NewExpression
LeftHandSideExpression
CallExpression
OptionalExpression
1.
Return
false
8.3.5
Runtime Semantics: NamedEvaluation
With parameter
name
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return the result of performing
NamedEvaluation
for
expr
with argument
name
ParenthesizedExpression
Expression
1.
Assert
IsAnonymousFunctionDefinition
Expression
) is
true
2.
Return the result of performing
NamedEvaluation
for
Expression
with argument
name
FunctionExpression
function
FormalParameters
FunctionBody
1.
Return
InstantiateOrdinaryFunctionExpression
of
FunctionExpression
with argument
name
GeneratorExpression
function
FormalParameters
GeneratorBody
1.
Return
InstantiateGeneratorFunctionExpression
of
GeneratorExpression
with argument
name
AsyncGeneratorExpression
async
function
FormalParameters
AsyncGeneratorBody
1.
Return
InstantiateAsyncGeneratorFunctionExpression
of
AsyncGeneratorExpression
with argument
name
AsyncFunctionExpression
async
function
FormalParameters
AsyncFunctionBody
1.
Return
InstantiateAsyncFunctionExpression
of
AsyncFunctionExpression
with argument
name
ArrowFunction
ArrowParameters
=>
ConciseBody
1.
Return
InstantiateArrowFunctionExpression
of
ArrowFunction
with argument
name
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
1.
Return
InstantiateAsyncArrowFunctionExpression
of
AsyncArrowFunction
with argument
name
ClassExpression
class
ClassTail
1.
Let
value
be the result of
ClassDefinitionEvaluation
of
ClassTail
with arguments
undefined
and
name
2.
ReturnIfAbrupt
value
).
3.
Set
value
.[[SourceText]] to the
source text matched by
ClassExpression
4.
Return
value
8.4
Contains
8.4.1
Static Semantics: Contains
With parameter
symbol
Every grammar production alternative in this specification
which is not listed below implicitly has the following default
definition of Contains:
1.
For each child node
child
of this
Parse Node
, do
a.
If
child
is an instance of
symbol
, return
true
b.
If
child
is an instance of a nonterminal, then
i.
Let
contained
be the result of
child
Contains
symbol
ii.
If
contained
is
true
, return
true
2.
Return
false
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
function
FormalParameters
FunctionBody
FunctionExpression
function
BindingIdentifier
opt
FormalParameters
FunctionBody
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
function
FormalParameters
GeneratorBody
GeneratorExpression
function
BindingIdentifier
opt
FormalParameters
GeneratorBody
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
async
function
FormalParameters
AsyncGeneratorBody
AsyncGeneratorExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncGeneratorBody
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
async
function
FormalParameters
AsyncFunctionBody
AsyncFunctionExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncFunctionBody
1.
Return
false
Note 1
Static semantic rules that depend upon substructure generally do not look into function definitions.
ClassTail
ClassHeritage
opt
ClassBody
1.
If
symbol
is
ClassBody
, return
true
2.
If
symbol
is
ClassHeritage
, then
a.
If
ClassHeritage
is present, return
true
; otherwise return
false
3.
Let
inHeritage
be
ClassHeritage
Contains
symbol
4.
If
inHeritage
is
true
, return
true
5.
Return the result of
ComputedPropertyContains
for
ClassBody
with argument
symbol
Note 2
Static semantic rules that depend upon substructure generally do not look into class bodies except for
PropertyName
s.
ArrowFunction
ArrowParameters
=>
ConciseBody
1.
If
symbol
is not one of
NewTarget
SuperProperty
SuperCall
super
or
this
, return
false
2.
If
ArrowParameters
Contains
symbol
is
true
, return
true
3.
Return
ConciseBody
Contains
symbol
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
formals
Contains
symbol
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
1.
If
symbol
is not one of
NewTarget
SuperProperty
SuperCall
super
, or
this
, return
false
2.
Return
AsyncConciseBody
Contains
symbol
AsyncArrowFunction
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
1.
If
symbol
is not one of
NewTarget
SuperProperty
SuperCall
super
, or
this
, return
false
2.
Let
head
be
CoveredAsyncArrowHead
of
CoverCallExpressionAndAsyncArrowHead
3.
If
head
Contains
symbol
is
true
, return
true
4.
Return
AsyncConciseBody
Contains
symbol
Note 3
Contains is used to detect
new.target
this
, and
super
usage within an
ArrowFunction
or
AsyncArrowFunction
PropertyDefinition
MethodDefinition
1.
If
symbol
is
MethodDefinition
, return
true
2.
Return the result of
ComputedPropertyContains
for
MethodDefinition
with argument
symbol
LiteralPropertyName
IdentifierName
1.
Return
false
MemberExpression
MemberExpression
IdentifierName
1.
If
MemberExpression
Contains
symbol
is
true
, return
true
2.
Return
false
SuperProperty
super
IdentifierName
1.
If
symbol
is the
ReservedWord
super
, return
true
2.
Return
false
CallExpression
CallExpression
IdentifierName
1.
If
CallExpression
Contains
symbol
is
true
, return
true
2.
Return
false
OptionalChain
?.
IdentifierName
1.
Return
false
OptionalChain
OptionalChain
IdentifierName
1.
If
OptionalChain
Contains
symbol
is
true
, return
true
2.
Return
false
8.4.2
Static Semantics: ComputedPropertyContains
With parameter
symbol
PropertyName
LiteralPropertyName
1.
Return
false
PropertyName
ComputedPropertyName
1.
Return the result of
ComputedPropertyName
Contains
symbol
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
get
PropertyName
FunctionBody
set
PropertyName
PropertySetParameterList
FunctionBody
1.
Return the result of
ComputedPropertyContains
for
PropertyName
with argument
symbol
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
1.
Return the result of
ComputedPropertyContains
for
PropertyName
with argument
symbol
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
1.
Return the result of
ComputedPropertyContains
for
PropertyName
with argument
symbol
ClassElementList
ClassElementList
ClassElement
1.
Let
inList
be
ComputedPropertyContains
of
ClassElementList
with argument
symbol
2.
If
inList
is
true
, return
true
3.
Return the result of
ComputedPropertyContains
for
ClassElement
with argument
symbol
ClassElement
1.
Return
false
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
1.
Return the result of
ComputedPropertyContains
for
PropertyName
with argument
symbol
8.5
Miscellaneous
These operations are used in multiple places throughout the specification.
8.5.1
Runtime Semantics: InstantiateFunctionObject
With parameter
scope
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
function
FormalParameters
FunctionBody
1.
Return ?
InstantiateOrdinaryFunctionObject
of
FunctionDeclaration
with argument
scope
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
function
FormalParameters
GeneratorBody
1.
Return ?
InstantiateGeneratorFunctionObject
of
GeneratorDeclaration
with argument
scope
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
async
function
FormalParameters
AsyncGeneratorBody
1.
Return ?
InstantiateAsyncGeneratorFunctionObject
of
AsyncGeneratorDeclaration
with argument
scope
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
async
function
FormalParameters
AsyncFunctionBody
1.
Return ?
InstantiateAsyncFunctionObject
of
AsyncFunctionDeclaration
with argument
scope
8.5.2
Runtime Semantics: BindingInitialization
With parameters
value
and
environment
Note
undefined
is passed for
environment
to indicate that a
PutValue
operation should be used to assign the initialization value. This is the case for
var
statements and formal parameter lists of some non-strict functions (See
10.2.10
). In those cases a lexical binding is hoisted and preinitialized prior to evaluation of its initializer.
BindingIdentifier
Identifier
1.
Let
name
be
StringValue
of
Identifier
2.
Return ?
InitializeBoundName
name
value
environment
).
BindingIdentifier
yield
1.
Return ?
InitializeBoundName
"yield"
value
environment
).
BindingIdentifier
await
1.
Return ?
InitializeBoundName
"await"
value
environment
).
BindingPattern
ObjectBindingPattern
1.
Perform ?
RequireObjectCoercible
value
).
2.
Return the result of performing
BindingInitialization
for
ObjectBindingPattern
using
value
and
environment
as arguments.
BindingPattern
ArrayBindingPattern
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
Let
result
be
IteratorBindingInitialization
of
ArrayBindingPattern
with arguments
iteratorRecord
and
environment
3.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
result
).
4.
Return
result
ObjectBindingPattern
1.
Return
NormalCompletion
empty
).
ObjectBindingPattern
BindingPropertyList
BindingPropertyList
1.
Perform ?
PropertyBindingInitialization
for
BindingPropertyList
using
value
and
environment
as the arguments.
2.
Return
NormalCompletion
empty
).
ObjectBindingPattern
BindingRestProperty
1.
Let
excludedNames
be a new empty
List
2.
Return the result of performing
RestBindingInitialization
of
BindingRestProperty
with
value
environment
, and
excludedNames
as the arguments.
ObjectBindingPattern
BindingPropertyList
BindingRestProperty
1.
Let
excludedNames
be ?
PropertyBindingInitialization
of
BindingPropertyList
with arguments
value
and
environment
2.
Return the result of performing
RestBindingInitialization
of
BindingRestProperty
with arguments
value
environment
, and
excludedNames
8.5.2.1
InitializeBoundName (
name
value
environment
The abstract operation InitializeBoundName takes arguments
name
value
, and
environment
. It performs the following steps when called:
1.
Assert
Type
name
) is String.
2.
If
environment
is not
undefined
, then
a.
Perform
environment
.InitializeBinding(
name
value
).
b.
Return
NormalCompletion
undefined
).
3.
Else,
a.
Let
lhs
be
ResolveBinding
name
).
b.
Return ?
PutValue
lhs
value
).
8.5.3
Runtime Semantics: IteratorBindingInitialization
With parameters
iteratorRecord
and
environment
Note
When
undefined
is passed for
environment
it indicates that a
PutValue
operation should be used to assign the initialization value. This is
the case for formal parameter lists of non-strict functions. In that
case the formal parameter bindings are preinitialized in order to deal
with the possibility of multiple parameters with the same name.
ArrayBindingPattern
1.
Return
NormalCompletion
empty
).
ArrayBindingPattern
Elision
1.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
ArrayBindingPattern
Elision
opt
BindingRestElement
1.
If
Elision
is present, then
a.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
2.
Return the result of performing
IteratorBindingInitialization
for
BindingRestElement
with
iteratorRecord
and
environment
as arguments.
ArrayBindingPattern
BindingElementList
Elision
1.
Perform ?
IteratorBindingInitialization
for
BindingElementList
with
iteratorRecord
and
environment
as arguments.
2.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
ArrayBindingPattern
BindingElementList
Elision
opt
BindingRestElement
1.
Perform ?
IteratorBindingInitialization
for
BindingElementList
with
iteratorRecord
and
environment
as arguments.
2.
If
Elision
is present, then
a.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
3.
Return the result of performing
IteratorBindingInitialization
for
BindingRestElement
with
iteratorRecord
and
environment
as arguments.
BindingElementList
BindingElementList
BindingElisionElement
1.
Perform ?
IteratorBindingInitialization
for
BindingElementList
with
iteratorRecord
and
environment
as arguments.
2.
Return the result of performing
IteratorBindingInitialization
for
BindingElisionElement
using
iteratorRecord
and
environment
as arguments.
BindingElisionElement
Elision
BindingElement
1.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
2.
Return the result of performing
IteratorBindingInitialization
of
BindingElement
with
iteratorRecord
and
environment
as the arguments.
SingleNameBinding
BindingIdentifier
Initializer
opt
1.
Let
bindingId
be
StringValue
of
BindingIdentifier
2.
Let
lhs
be ?
ResolveBinding
bindingId
environment
).
3.
If
iteratorRecord
.[[Done]] is
false
, then
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
e.
Else,
i.
Let
be
IteratorValue
next
).
ii.
If
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
).
4.
If
iteratorRecord
.[[Done]] is
true
, let
be
undefined
5.
If
Initializer
is present and
is
undefined
, then
a.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
, then
i.
Set
to the result of performing
NamedEvaluation
for
Initializer
with argument
bindingId
b.
Else,
i.
Let
defaultValue
be the result of evaluating
Initializer
ii.
Set
to ?
GetValue
defaultValue
).
6.
If
environment
is
undefined
, return ?
PutValue
lhs
).
7.
Return
InitializeReferencedBinding
lhs
).
BindingElement
BindingPattern
Initializer
opt
1.
If
iteratorRecord
.[[Done]] is
false
, then
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
e.
Else,
i.
Let
be
IteratorValue
next
).
ii.
If
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
).
2.
If
iteratorRecord
.[[Done]] is
true
, let
be
undefined
3.
If
Initializer
is present and
is
undefined
, then
a.
Let
defaultValue
be the result of evaluating
Initializer
b.
Set
to ?
GetValue
defaultValue
).
4.
Return the result of performing
BindingInitialization
of
BindingPattern
with
and
environment
as the arguments.
BindingRestElement
...
BindingIdentifier
1.
Let
lhs
be ?
ResolveBinding
StringValue
of
BindingIdentifier
environment
).
2.
Let
be !
ArrayCreate
(0).
3.
Let
be 0.
4.
Repeat,
a.
If
iteratorRecord
.[[Done]] is
false
, then
i.
Let
next
be
IteratorStep
iteratorRecord
).
ii.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
next
).
iv.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
b.
If
iteratorRecord
.[[Done]] is
true
, then
i.
If
environment
is
undefined
, return ?
PutValue
lhs
).
ii.
Return
InitializeReferencedBinding
lhs
).
c.
Let
nextValue
be
IteratorValue
next
).
d.
If
nextValue
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
e.
ReturnIfAbrupt
nextValue
).
f.
Perform !
CreateDataPropertyOrThrow
, !
ToString
)),
nextValue
).
g.
Set
to
+ 1.
BindingRestElement
...
BindingPattern
1.
Let
be !
ArrayCreate
(0).
2.
Let
be 0.
3.
Repeat,
a.
If
iteratorRecord
.[[Done]] is
false
, then
i.
Let
next
be
IteratorStep
iteratorRecord
).
ii.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
next
).
iv.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
b.
If
iteratorRecord
.[[Done]] is
true
, then
i.
Return the result of performing
BindingInitialization
of
BindingPattern
with
and
environment
as the arguments.
c.
Let
nextValue
be
IteratorValue
next
).
d.
If
nextValue
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
e.
ReturnIfAbrupt
nextValue
).
f.
Perform !
CreateDataPropertyOrThrow
, !
ToString
)),
nextValue
).
g.
Set
to
+ 1.
FormalParameters
[empty]
1.
Return
NormalCompletion
empty
).
FormalParameters
FormalParameterList
FunctionRestParameter
1.
Perform ?
IteratorBindingInitialization
for
FormalParameterList
using
iteratorRecord
and
environment
as the arguments.
2.
Return the result of performing
IteratorBindingInitialization
for
FunctionRestParameter
using
iteratorRecord
and
environment
as the arguments.
FormalParameterList
FormalParameterList
FormalParameter
1.
Perform ?
IteratorBindingInitialization
for
FormalParameterList
using
iteratorRecord
and
environment
as the arguments.
2.
Return the result of performing
IteratorBindingInitialization
for
FormalParameter
using
iteratorRecord
and
environment
as the arguments.
ArrowParameters
BindingIdentifier
1.
Assert
iteratorRecord
.[[Done]] is
false
2.
Let
next
be
IteratorStep
iteratorRecord
).
3.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
4.
ReturnIfAbrupt
next
).
5.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
6.
Else,
a.
Let
be
IteratorValue
next
).
b.
If
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
).
7.
If
iteratorRecord
.[[Done]] is
true
, let
be
undefined
8.
Return the result of performing
BindingInitialization
for
BindingIdentifier
using
and
environment
as the arguments.
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
IteratorBindingInitialization
of
formals
with arguments
iteratorRecord
and
environment
AsyncArrowBindingIdentifier
BindingIdentifier
1.
Assert
iteratorRecord
.[[Done]] is
false
2.
Let
next
be
IteratorStep
iteratorRecord
).
3.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
4.
ReturnIfAbrupt
next
).
5.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
6.
Else,
a.
Let
be
IteratorValue
next
).
b.
If
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
).
7.
If
iteratorRecord
.[[Done]] is
true
, let
be
undefined
8.
Return the result of performing
BindingInitialization
for
BindingIdentifier
using
and
environment
as the arguments.
8.5.4
Static Semantics: AssignmentTargetType
IdentifierReference
Identifier
1.
If this
IdentifierReference
is contained in
strict mode code
and
StringValue
of
Identifier
is
"eval"
or
"arguments"
, return
invalid
2.
Return
simple
IdentifierReference
yield
await
CallExpression
CallExpression
Expression
CallExpression
IdentifierName
MemberExpression
MemberExpression
Expression
MemberExpression
IdentifierName
SuperProperty
1.
Return
simple
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
AssignmentTargetType
of
expr
PrimaryExpression
this
Literal
ArrayLiteral
ObjectLiteral
FunctionExpression
ClassExpression
GeneratorExpression
AsyncFunctionExpression
AsyncGeneratorExpression
RegularExpressionLiteral
TemplateLiteral
CallExpression
CoverCallExpressionAndAsyncArrowHead
SuperCall
ImportCall
CallExpression
Arguments
CallExpression
TemplateLiteral
NewExpression
new
NewExpression
MemberExpression
MemberExpression
TemplateLiteral
new
MemberExpression
Arguments
NewTarget
new
target
ImportMeta
import
meta
LeftHandSideExpression
OptionalExpression
UpdateExpression
LeftHandSideExpression
++
LeftHandSideExpression
--
++
UnaryExpression
--
UnaryExpression
UnaryExpression
delete
UnaryExpression
void
UnaryExpression
typeof
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
AwaitExpression
ExponentiationExpression
UpdateExpression
**
ExponentiationExpression
MultiplicativeExpression
MultiplicativeExpression
MultiplicativeOperator
ExponentiationExpression
AdditiveExpression
AdditiveExpression
MultiplicativeExpression
AdditiveExpression
MultiplicativeExpression
ShiftExpression
ShiftExpression
<<
AdditiveExpression
ShiftExpression
>>
AdditiveExpression
ShiftExpression
>>>
AdditiveExpression
RelationalExpression
RelationalExpression
ShiftExpression
RelationalExpression
ShiftExpression
RelationalExpression
<=
ShiftExpression
RelationalExpression
>=
ShiftExpression
RelationalExpression
instanceof
ShiftExpression
RelationalExpression
in
ShiftExpression
EqualityExpression
EqualityExpression
==
RelationalExpression
EqualityExpression
!=
RelationalExpression
EqualityExpression
===
RelationalExpression
EqualityExpression
!==
RelationalExpression
BitwiseANDExpression
BitwiseANDExpression
EqualityExpression
BitwiseXORExpression
BitwiseXORExpression
BitwiseANDExpression
BitwiseORExpression
BitwiseORExpression
BitwiseXORExpression
LogicalANDExpression
LogicalANDExpression
&&
BitwiseORExpression
LogicalORExpression
LogicalORExpression
||
LogicalANDExpression
CoalesceExpression
CoalesceExpressionHead
??
BitwiseORExpression
ConditionalExpression
ShortCircuitExpression
AssignmentExpression
AssignmentExpression
AssignmentExpression
YieldExpression
ArrowFunction
AsyncArrowFunction
LeftHandSideExpression
AssignmentExpression
LeftHandSideExpression
AssignmentOperator
AssignmentExpression
LeftHandSideExpression
&&=
AssignmentExpression
LeftHandSideExpression
||=
AssignmentExpression
LeftHandSideExpression
??=
AssignmentExpression
Expression
Expression
AssignmentExpression
1.
Return
invalid
8.5.5
Static Semantics: PropName
PropertyDefinition
IdentifierReference
1.
Return
StringValue
of
IdentifierReference
PropertyDefinition
...
AssignmentExpression
1.
Return
empty
PropertyDefinition
PropertyName
AssignmentExpression
1.
Return
PropName
of
PropertyName
LiteralPropertyName
IdentifierName
1.
Return
StringValue
of
IdentifierName
LiteralPropertyName
StringLiteral
1.
Return the
SV
of
StringLiteral
LiteralPropertyName
NumericLiteral
1.
Let
nbr
be the
NumericValue
of
NumericLiteral
2.
Return !
ToString
nbr
).
ComputedPropertyName
AssignmentExpression
1.
Return
empty
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
get
PropertyName
FunctionBody
set
PropertyName
PropertySetParameterList
FunctionBody
1.
Return
PropName
of
PropertyName
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
1.
Return
PropName
of
PropertyName
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
1.
Return
PropName
of
PropertyName
ClassElement
1.
Return
empty
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
1.
Return
PropName
of
PropertyName
Executable Code and Execution Contexts
9.1
Environment Records
Environment Record
is a specification type used to define the association of
Identifier
to specific variables and functions, based upon the lexical nesting
structure of ECMAScript code. Usually an Environment Record is
associated with some specific syntactic structure of ECMAScript code
such as a
FunctionDeclaration
, a
BlockStatement
, or a
Catch
clause of a
TryStatement
Each time such code is evaluated, a new Environment Record is created
to record the identifier bindings that are created by that code.
Every Environment Record has an [[OuterEnv]] field, which is either
null
or a reference to an outer Environment Record. This is used to model
the logical nesting of Environment Record values. The outer reference of
an (inner) Environment Record is a reference to the Environment Record
that logically surrounds the inner Environment Record. An outer
Environment Record may, of course, have its own outer Environment
Record. An Environment Record may serve as the outer environment for
multiple inner Environment Records. For example, if a
FunctionDeclaration
contains two nested
FunctionDeclaration
then the Environment Records of each of the nested functions will have
as their outer Environment Record the Environment Record of the current
evaluation of the surrounding function.
Environment Records are purely specification mechanisms and need
not correspond to any specific artefact of an ECMAScript implementation.
It is impossible for an ECMAScript program to directly access or
manipulate such values.
9.1.1
The Environment Record Type Hierarchy
Environment Records can be thought of as existing in a simple object-oriented hierarchy where
Environment Record
is an abstract class with three concrete subclasses:
declarative Environment Record
object Environment Record
, and
global Environment Record
. Function Environment Records and module Environment Records are subclasses of
declarative Environment Record
Environment Record
(abstract)
declarative Environment Record
is used to define the effect of ECMAScript language syntactic elements such as
FunctionDeclaration
s,
VariableDeclaration
s, and
Catch
clauses that directly associate identifier bindings with ECMAScript language values.
function Environment Record
corresponds to the invocation of an ECMAScript
function object
, and contains bindings for the top-level declarations within that function. It may establish a new
this
binding. It also captures the state necessary to support
super
method invocations.
module Environment Record
contains the bindings for the top-level declarations of a
Module
. It also contains the bindings that are explicitly imported by the
Module
. Its [[OuterEnv]] is a
global Environment Record
An
object Environment Record
is used to define the effect of ECMAScript elements such as
WithStatement
that associate identifier bindings with the properties of some object.
global Environment Record
is used for
Script
global declarations. It does not have an outer environment; its [[OuterEnv]] is
null
. It may be prepopulated with identifier bindings and it includes an associated
global object
whose properties provide some of the
global environment
's identifier bindings. As ECMAScript code is executed, additional properties may be added to the
global object
and the initial properties may be modified.
The
Environment Record
abstract class includes the abstract specification methods defined in
Table 17
. These abstract methods have distinct concrete algorithms for each of the concrete subclasses.
Table 17: Abstract Methods of Environment Records
Method
Purpose
HasBinding(N)
Determine if an
Environment Record
has a binding for the String value
. Return
true
if it does and
false
if it does not.
CreateMutableBinding(N, D)
Create a new but uninitialized mutable binding in an
Environment Record
. The String value
is the text of the bound name. If the Boolean argument
is
true
the binding may be subsequently deleted.
CreateImmutableBinding(N, S)
Create a new but uninitialized immutable binding in an
Environment Record
. The String value
is the text of the bound name. If
is
true
then attempts to set it after it has been initialized will always throw
an exception, regardless of the strict mode setting of operations that
reference that binding.
InitializeBinding(N, V)
Set the value of an already existing but uninitialized binding in an
Environment Record
. The String value
is the text of the bound name.
is the value for the binding and is a value of any
ECMAScript language type
SetMutableBinding(N, V, S)
Set the value of an already existing mutable binding in an
Environment Record
. The String value
is the text of the bound name.
is the value for the binding and may be a value of any
ECMAScript language type
is a Boolean flag. If
is
true
and the binding cannot be set throw a
TypeError
exception.
GetBindingValue(N, S)
Returns the value of an already existing binding from an
Environment Record
. The String value
is the text of the bound name.
is used to identify references originating in
strict mode code
or that otherwise require strict mode reference semantics. If
is
true
and the binding does not exist throw a
ReferenceError
exception. If the binding exists but is uninitialized a
ReferenceError
is thrown, regardless of the value of
DeleteBinding(N)
Delete a binding from an
Environment Record
. The String value
is the text of the bound name. If a binding for
exists, remove the binding and return
true
. If the binding exists but cannot be removed return
false
. If the binding does not exist return
true
HasThisBinding()
Determine if an
Environment Record
establishes a
this
binding. Return
true
if it does and
false
if it does not.
HasSuperBinding()
Determine if an
Environment Record
establishes a
super
method binding. Return
true
if it does and
false
if it does not.
WithBaseObject()
If this
Environment Record
is associated with a
with
statement, return the with object. Otherwise, return
undefined
9.1.1.1
Declarative Environment Records
Each
declarative Environment Record
is associated
with an ECMAScript program scope containing variable, constant, let,
class, module, import, and/or function declarations. A declarative
Environment Record binds the set of identifiers defined by the
declarations contained within its scope.
The behaviour of the concrete specification methods for declarative Environment Records is defined by the following algorithms.
9.1.1.1.1
HasBinding (
The HasBinding concrete method of a
declarative Environment Record
envRec
takes argument
(a String). It determines if the argument identifier is one of the
identifiers bound by the record. It performs the following steps when
called:
1.
If
envRec
has a binding for the name that is the value of
, return
true
2.
Return
false
9.1.1.1.2
CreateMutableBinding (
The CreateMutableBinding concrete method of a
declarative Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates a new mutable binding for the name
that is uninitialized. A binding must not already exist in this
Environment Record
for
. If
has the value
true
, the new binding is marked as being subject to deletion. It performs the following steps when called:
1.
Assert
envRec
does not already have a binding for
2.
Create a mutable binding in
envRec
for
and record that it is uninitialized. If
is
true
, record that the newly created binding may be deleted by a subsequent DeleteBinding call.
3.
Return
NormalCompletion
empty
).
9.1.1.1.3
CreateImmutableBinding (
The CreateImmutableBinding concrete method of a
declarative Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates a new immutable binding for the name
that is uninitialized. A binding must not already exist in this
Environment Record
for
. If
has the value
true
, the new binding is marked as a strict binding. It performs the following steps when called:
1.
Assert
envRec
does not already have a binding for
2.
Create an immutable binding in
envRec
for
and record that it is uninitialized. If
is
true
, record that the newly created binding is a strict binding.
3.
Return
NormalCompletion
empty
).
9.1.1.1.4
InitializeBinding (
The InitializeBinding concrete method of a
declarative Environment Record
envRec
takes arguments
(a String) and
(an
ECMAScript language value
). It is used to set the bound value of the current binding of the identifier whose name is the value of the argument
to the value of argument
. An uninitialized binding for
must already exist. It performs the following steps when called:
1.
Assert
envRec
must have an uninitialized binding for
2.
Set the bound value for
in
envRec
to
3.
Record
that the binding for
in
envRec
has been initialized.
4.
Return
NormalCompletion
empty
).
9.1.1.1.5
SetMutableBinding (
The SetMutableBinding concrete method of a
declarative Environment Record
envRec
takes arguments
(a String),
(an
ECMAScript language value
), and
(a Boolean). It attempts to change the bound value of the current
binding of the identifier whose name is the value of the argument
to the value of argument
. A binding for
normally already exists, but in rare cases it may not. If the binding is an immutable binding, a
TypeError
is thrown if
is
true
. It performs the following steps when called:
1.
If
envRec
does not have a binding for
, then
a.
If
is
true
, throw a
ReferenceError
exception.
b.
Perform
envRec
.CreateMutableBinding(
true
).
c.
Perform
envRec
.InitializeBinding(
).
d.
Return
NormalCompletion
empty
).
2.
If the binding for
in
envRec
is a strict binding, set
to
true
3.
If the binding for
in
envRec
has not yet been initialized, throw a
ReferenceError
exception.
4.
Else if the binding for
in
envRec
is a mutable binding, change its bound value to
5.
Else,
a.
Assert
: This is an attempt to change the value of an immutable binding.
b.
If
is
true
, throw a
TypeError
exception.
6.
Return
NormalCompletion
empty
).
Note
An example of ECMAScript code that results in a missing binding at step
is:
function
eval
"var x; x = (delete x, 0);"
); }
9.1.1.1.6
GetBindingValue (
The GetBindingValue concrete method of a
declarative Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It returns the value of its bound identifier whose name is the value of the argument
. If the binding exists but is uninitialized a
ReferenceError
is thrown, regardless of the value of
. It performs the following steps when called:
1.
Assert
envRec
has a binding for
2.
If the binding for
in
envRec
is an uninitialized binding, throw a
ReferenceError
exception.
3.
Return the value currently bound to
in
envRec
9.1.1.1.7
DeleteBinding (
The DeleteBinding concrete method of a
declarative Environment Record
envRec
takes argument
(a String). It can only delete bindings that have been explicitly
designated as being subject to deletion. It performs the following steps
when called:
1.
Assert
envRec
has a binding for the name that is the value of
2.
If the binding for
in
envRec
cannot be deleted, return
false
3.
Remove the binding for
from
envRec
4.
Return
true
9.1.1.1.8
HasThisBinding ( )
The HasThisBinding concrete method of a
declarative Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
false
Note
A regular
declarative Environment Record
(i.e., one that is neither a
function Environment Record
nor a
module Environment Record
) does not provide a
this
binding.
9.1.1.1.9
HasSuperBinding ( )
The HasSuperBinding concrete method of a
declarative Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
false
Note
A regular
declarative Environment Record
(i.e., one that is neither a
function Environment Record
nor a
module Environment Record
) does not provide a
super
binding.
9.1.1.1.10
WithBaseObject ( )
The WithBaseObject concrete method of a
declarative Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
undefined
9.1.1.2
Object Environment Records
Each
object Environment Record
is associated with an object called its
binding object
An object Environment Record binds the set of string identifier names
that directly correspond to the property names of its binding object.
Property keys that are not strings in the form of an
IdentifierName
are not included in the set of bound identifiers. Both own and
inherited properties are included in the set regardless of the setting
of their [[Enumerable]] attribute. Because properties can be dynamically
added and deleted from objects, the set of identifiers bound by an
object Environment Record may potentially change as a side-effect of any
operation that adds or deletes properties. Any bindings that are
created as a result of such a side-effect are considered to be a mutable
binding even if the Writable attribute of the corresponding property
has the value
false
. Immutable bindings do not exist for object Environment Records.
Object Environment Records created for
with
statements (
14.11
) can provide their binding object as an implicit
this
value for use in function calls. The capability is controlled by a
withEnvironment
Boolean value that is associated with each object Environment Record. By default, the value of
withEnvironment
is
false
for any object Environment Record.
The behaviour of the concrete specification methods for object Environment Records is defined by the following algorithms.
9.1.1.2.1
HasBinding (
The HasBinding concrete method of an
object Environment Record
envRec
takes argument
(a String). It determines if its associated binding object has a property whose name is the value of the argument
. It performs the following steps when called:
1.
Let
bindings
be the binding object for
envRec
2.
Let
foundBinding
be ?
HasProperty
bindings
).
3.
If
foundBinding
is
false
, return
false
4.
If the
withEnvironment
flag of
envRec
is
false
, return
true
5.
Let
unscopables
be ?
Get
bindings
@@unscopables
).
6.
If
Type
unscopables
) is Object, then
a.
Let
blocked
be !
ToBoolean
(?
Get
unscopables
)).
b.
If
blocked
is
true
, return
false
7.
Return
true
9.1.1.2.2
CreateMutableBinding (
The CreateMutableBinding concrete method of an
object Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates in an
Environment Record
's associated binding object a property whose name is the String value and initializes it to the value
undefined
. If
has the value
true
, the new property's [[Configurable]] attribute is set to
true
; otherwise it is set to
false
. It performs the following steps when called:
1.
Let
bindings
be the binding object for
envRec
2.
Return ?
DefinePropertyOrThrow
bindings
, PropertyDescriptor { [[Value]]:
undefined
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
}).
Note
Normally
envRec
will not have a binding for
but if it does, the semantics of
DefinePropertyOrThrow
may result in an existing binding being replaced or shadowed or cause an
abrupt completion
to be returned.
9.1.1.2.3
CreateImmutableBinding (
The CreateImmutableBinding concrete method of an
object Environment Record
is never used within this specification.
9.1.1.2.4
InitializeBinding (
The InitializeBinding concrete method of an
object Environment Record
envRec
takes arguments
(a String) and
(an
ECMAScript language value
). It is used to set the bound value of the current binding of the identifier whose name is the value of the argument
to the value of argument
. It performs the following steps when called:
1.
Return ?
envRec
.SetMutableBinding(
false
).
Note
In this specification, all uses of CreateMutableBinding
for object Environment Records are immediately followed by a call to
InitializeBinding for the same name. Hence, this specification does not
explicitly track the initialization state of bindings in object
Environment Records.
9.1.1.2.5
SetMutableBinding (
The SetMutableBinding concrete method of an
object Environment Record
envRec
takes arguments
(a String),
(an
ECMAScript language value
), and
(a Boolean). It attempts to set the value of the
Environment Record
's associated binding object's property whose name is the value of the argument
to the value of argument
. A property named
normally already exists but if it does not or is not currently writable, error handling is determined by
. It performs the following steps when called:
1.
Let
bindings
be the binding object for
envRec
2.
Let
stillExists
be ?
HasProperty
bindings
).
3.
If
stillExists
is
false
and
is
true
, throw a
ReferenceError
exception.
4.
Return ?
Set
bindings
).
9.1.1.2.6
GetBindingValue (
The GetBindingValue concrete method of an
object Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It returns the value of its associated binding object's
property whose name is the String value of the argument identifier
. The property should already exist but if it does not the result depends upon
. It performs the following steps when called:
1.
Let
bindings
be the binding object for
envRec
2.
Let
value
be ?
HasProperty
bindings
).
3.
If
value
is
false
, then
a.
If
is
false
, return the value
undefined
; otherwise throw a
ReferenceError
exception.
4.
Return ?
Get
bindings
).
9.1.1.2.7
DeleteBinding (
The DeleteBinding concrete method of an
object Environment Record
envRec
takes argument
(a String). It can only delete bindings that correspond to properties
of the environment object whose [[Configurable]] attribute have the
value
true
. It performs the following steps when called:
1.
Let
bindings
be the binding object for
envRec
2.
Return ?
bindings
.[[Delete]](
).
9.1.1.2.8
HasThisBinding ( )
The HasThisBinding concrete method of an
object Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
false
Note
Object Environment Records do not provide a
this
binding.
9.1.1.2.9
HasSuperBinding ( )
The HasSuperBinding concrete method of an
object Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
false
Note
Object Environment Records do not provide a
super
binding.
9.1.1.2.10
WithBaseObject ( )
The WithBaseObject concrete method of an
object Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
If the
withEnvironment
flag of
envRec
is
true
, return the binding object for
envRec
2.
Otherwise, return
undefined
9.1.1.3
Function Environment Records
function Environment Record
is a
declarative Environment Record
that is used to represent the top-level scope of a function and, if the function is not an
ArrowFunction
, provides a
this
binding. If a function is not an
ArrowFunction
function and references
super
, its function Environment Record also contains the state that is used to perform
super
method invocations from within the function.
Function Environment Records have the additional state fields listed in
Table 18
Table 18: Additional Fields of Function Environment Records
Field Name
Value
Meaning
[[ThisValue]]
Any
This is the
this
value used for this invocation of the function.
[[ThisBindingStatus]]
lexical
initialized
uninitialized
If the value is
lexical
, this is an
ArrowFunction
and does not have a local
this
value.
[[FunctionObject]]
Object
The
function object
whose invocation caused this
Environment Record
to be created.
[[NewTarget]]
Object |
undefined
If this
Environment Record
was created by the [[Construct]] internal method, [[NewTarget]] is the value of the [[Construct]]
newTarget
parameter. Otherwise, its value is
undefined
Function Environment Records support all of the
declarative Environment Record
methods listed in
Table 17
and share the same specifications for all of those methods except for
HasThisBinding and HasSuperBinding. In addition, function Environment
Records support the methods listed in
Table 19
Table 19: Additional Methods of Function Environment Records
Method
Purpose
BindThisValue(V)
Set the [[ThisValue]] and record that it has been initialized.
GetThisBinding()
Return the value of this
Environment Record
's
this
binding. Throws a
ReferenceError
if the
this
binding has not been initialized.
GetSuperBase()
Return the object that is the base for
super
property accesses bound in this
Environment Record
. The value
undefined
indicates that
super
property accesses will produce runtime errors.
The behaviour of the additional concrete specification
methods for function Environment Records is defined by the following
algorithms:
9.1.1.3.1
BindThisValue (
The BindThisValue concrete method of a
function Environment Record
envRec
takes argument
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
envRec
.[[ThisBindingStatus]] is not
lexical
2.
If
envRec
.[[ThisBindingStatus]] is
initialized
, throw a
ReferenceError
exception.
3.
Set
envRec
.[[ThisValue]] to
4.
Set
envRec
.[[ThisBindingStatus]] to
initialized
5.
Return
9.1.1.3.2
HasThisBinding ( )
The HasThisBinding concrete method of a
function Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
If
envRec
.[[ThisBindingStatus]] is
lexical
, return
false
; otherwise, return
true
9.1.1.3.3
HasSuperBinding ( )
The HasSuperBinding concrete method of a
function Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
If
envRec
.[[ThisBindingStatus]] is
lexical
, return
false
2.
If
envRec
.[[FunctionObject]].[[HomeObject]] has the value
undefined
, return
false
; otherwise, return
true
9.1.1.3.4
GetThisBinding ( )
The GetThisBinding concrete method of a
function Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Assert
envRec
.[[ThisBindingStatus]] is not
lexical
2.
If
envRec
.[[ThisBindingStatus]] is
uninitialized
, throw a
ReferenceError
exception.
3.
Return
envRec
.[[ThisValue]].
9.1.1.3.5
GetSuperBase ( )
The GetSuperBase concrete method of a
function Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Let
be
envRec
.[[FunctionObject]].[[HomeObject]].
2.
If
has the value
undefined
, return
undefined
3.
Assert
Type
) is Object.
4.
Return ?
.[[GetPrototypeOf]]().
9.1.1.4
Global Environment Records
global Environment Record
is used to represent the outer most scope that is shared by all of the ECMAScript
Script
elements that are processed in a common
realm
. A global Environment Record provides the bindings for built-in globals (clause
19
), properties of the
global object
, and for all top-level declarations (
8.1.9
8.1.11
) that occur within a
Script
A global Environment Record is logically a single record but it is specified as a composite encapsulating an
object Environment Record
and a
declarative Environment Record
. The
object Environment Record
has as its base object the
global object
of the associated
Realm Record
. This
global object
is the value returned by the global Environment Record's GetThisBinding concrete method. The
object Environment Record
component of a global Environment Record contains the bindings for all built-in globals (clause
19
) and all bindings introduced by a
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
, or
VariableStatement
contained in global code. The bindings for all other ECMAScript declarations in global code are contained in the
declarative Environment Record
component of the global Environment Record.
Properties may be created directly on a
global object
. Hence, the
object Environment Record
component of a global Environment Record may contain both bindings created explicitly by
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
, or
VariableDeclaration
declarations and bindings created implicitly as properties of the
global object
In order to identify which bindings were explicitly created using
declarations, a global Environment Record maintains a list of the names
bound using its CreateGlobalVarBinding and CreateGlobalFunctionBinding
concrete methods.
Global Environment Records have the additional fields listed in
Table 20
and the additional methods listed in
Table 21
Table 20: Additional Fields of Global Environment Records
Field Name
Value
Meaning
[[ObjectRecord]]
Object Environment Record
Binding object is the
global object
. It contains global built-in bindings as well as
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
, and
VariableDeclaration
bindings in global code for the associated
realm
[[GlobalThisValue]]
Object
The value returned by
this
in global scope. Hosts may provide any ECMAScript Object value.
[[DeclarativeRecord]]
Declarative Environment Record
Contains
bindings for all declarations in global code for the associated
realm
code except for
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
, and
VariableDeclaration
bindings
[[VarNames]]
List
of String
The string names bound by
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
, and
VariableDeclaration
declarations in global code for the associated
realm
Table 21: Additional Methods of Global Environment Records
Method
Purpose
GetThisBinding()
Return the value of this
Environment Record
's
this
binding.
HasVarDeclaration (N)
Determines if the argument identifier has a binding in this
Environment Record
that was created using a
VariableDeclaration
FunctionDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
, or
AsyncGeneratorDeclaration
HasLexicalDeclaration (N)
Determines if the argument identifier has a binding in this
Environment Record
that was created using a lexical declaration such as a
LexicalDeclaration
or a
ClassDeclaration
HasRestrictedGlobalProperty (N)
Determines if the argument is the name of a
global object
property that may not be shadowed by a global lexical binding.
CanDeclareGlobalVar (N)
Determines if a corresponding CreateGlobalVarBinding call would succeed if called for the same argument
CanDeclareGlobalFunction (N)
Determines if a corresponding CreateGlobalFunctionBinding call would succeed if called for the same argument
CreateGlobalVarBinding(N, D)
Used to create and initialize to
undefined
a global
var
binding in the [[ObjectRecord]] component of a
global Environment Record
. The binding will be a mutable binding. The corresponding
global object
property will have attribute values appropriate for a
var
. The String value
is the bound name. If
is
true
the binding may be deleted. Logically equivalent to
CreateMutableBinding followed by a SetMutableBinding but it allows var
declarations to receive special treatment.
CreateGlobalFunctionBinding(N, V, D)
Create and initialize a global
function
binding in the [[ObjectRecord]] component of a
global Environment Record
. The binding will be a mutable binding. The corresponding
global object
property will have attribute values appropriate for a
function
. The String value
is the bound name.
is the initialization value. If the Boolean argument
is
true
the binding may be deleted. Logically equivalent to
CreateMutableBinding followed by a SetMutableBinding but it allows
function declarations to receive special treatment.
The behaviour of the concrete specification methods for global Environment Records is defined by the following algorithms.
9.1.1.4.1
HasBinding (
The HasBinding concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if the argument identifier is one of the
identifiers bound by the record. It performs the following steps when
called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, return
true
3.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
4.
Return ?
ObjRec
.HasBinding(
).
9.1.1.4.2
CreateMutableBinding (
The CreateMutableBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates a new mutable binding for the name
that is uninitialized. The binding is created in the associated DeclarativeRecord. A binding for
must not already exist in the DeclarativeRecord. If
has the value
true
, the new binding is marked as being subject to deletion. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, throw a
TypeError
exception.
3.
Return
DclRec
.CreateMutableBinding(
).
9.1.1.4.3
CreateImmutableBinding (
The CreateImmutableBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates a new immutable binding for the name
that is uninitialized. A binding must not already exist in this
Environment Record
for
. If
has the value
true
, the new binding is marked as a strict binding. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, throw a
TypeError
exception.
3.
Return
DclRec
.CreateImmutableBinding(
).
9.1.1.4.4
InitializeBinding (
The InitializeBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String) and
(an
ECMAScript language value
). It is used to set the bound value of the current binding of the identifier whose name is the value of the argument
to the value of argument
. An uninitialized binding for
must already exist. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, then
a.
Return
DclRec
.InitializeBinding(
).
3.
Assert
: If the binding exists, it must be in the
object Environment Record
4.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
5.
Return ?
ObjRec
.InitializeBinding(
).
9.1.1.4.5
SetMutableBinding (
The SetMutableBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String),
(an
ECMAScript language value
), and
(a Boolean). It attempts to change the bound value of the current
binding of the identifier whose name is the value of the argument
to the value of argument
. If the binding is an immutable binding, a
TypeError
is thrown if
is
true
. A property named
normally already exists but if it does not or is not currently writable, error handling is determined by
. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, then
a.
Return
DclRec
.SetMutableBinding(
).
3.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
4.
Return ?
ObjRec
.SetMutableBinding(
).
9.1.1.4.6
GetBindingValue (
The GetBindingValue concrete method of a
global Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It returns the value of its bound identifier whose name is the value of the argument
. If the binding is an uninitialized binding throw a
ReferenceError
exception. A property named
normally already exists but if it does not or is not currently writable, error handling is determined by
. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, then
a.
Return
DclRec
.GetBindingValue(
).
3.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
4.
Return ?
ObjRec
.GetBindingValue(
).
9.1.1.4.7
DeleteBinding (
The DeleteBinding concrete method of a
global Environment Record
envRec
takes argument
(a String). It can only delete bindings that have been explicitly
designated as being subject to deletion. It performs the following steps
when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
If
DclRec
.HasBinding(
) is
true
, then
a.
Return
DclRec
.DeleteBinding(
).
3.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
4.
Let
globalObject
be the binding object for
ObjRec
5.
Let
existingProp
be ?
HasOwnProperty
globalObject
).
6.
If
existingProp
is
true
, then
a.
Let
status
be ?
ObjRec
.DeleteBinding(
).
b.
If
status
is
true
, then
i.
Let
varNames
be
envRec
.[[VarNames]].
ii.
If
is an element of
varNames
, remove that element from the
varNames
c.
Return
status
7.
Return
true
9.1.1.4.8
HasThisBinding ( )
The HasThisBinding concrete method of a
global Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
true
Note
Global Environment Records always provide a
this
binding.
9.1.1.4.9
HasSuperBinding ( )
The HasSuperBinding concrete method of a
global Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
false
Note
Global Environment Records do not provide a
super
binding.
9.1.1.4.10
WithBaseObject ( )
The WithBaseObject concrete method of a
global Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
undefined
9.1.1.4.11
GetThisBinding ( )
The GetThisBinding concrete method of a
global Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
envRec
.[[GlobalThisValue]].
9.1.1.4.12
HasVarDeclaration (
The HasVarDeclaration concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if the argument identifier has a binding in this record that was created using a
VariableStatement
or a
FunctionDeclaration
. It performs the following steps when called:
1.
Let
varDeclaredNames
be
envRec
.[[VarNames]].
2.
If
varDeclaredNames
contains
, return
true
3.
Return
false
9.1.1.4.13
HasLexicalDeclaration (
The HasLexicalDeclaration concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if the argument identifier has a binding in
this record that was created using a lexical declaration such as a
LexicalDeclaration
or a
ClassDeclaration
. It performs the following steps when called:
1.
Let
DclRec
be
envRec
.[[DeclarativeRecord]].
2.
Return
DclRec
.HasBinding(
).
9.1.1.4.14
HasRestrictedGlobalProperty (
The HasRestrictedGlobalProperty concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if the argument identifier is the name of a property of the
global object
that must not be shadowed by a global lexical binding. It performs the following steps when called:
1.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
2.
Let
globalObject
be the binding object for
ObjRec
3.
Let
existingProp
be ?
globalObject
.[[GetOwnProperty]](
).
4.
If
existingProp
is
undefined
, return
false
5.
If
existingProp
.[[Configurable]] is
true
, return
false
6.
Return
true
Note
Properties may exist upon a
global object
that were directly created rather than being declared using a var or
function declaration. A global lexical binding may not be created that
has the same name as a non-configurable property of the
global object
. The global property
"undefined"
is an example of such a property.
9.1.1.4.15
CanDeclareGlobalVar (
The CanDeclareGlobalVar concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if a corresponding CreateGlobalVarBinding call would succeed if called for the same argument
. Redundant var declarations and var declarations for pre-existing
global object
properties are allowed. It performs the following steps when called:
1.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
2.
Let
globalObject
be the binding object for
ObjRec
3.
Let
hasProperty
be ?
HasOwnProperty
globalObject
).
4.
If
hasProperty
is
true
, return
true
5.
Return ?
IsExtensible
globalObject
).
9.1.1.4.16
CanDeclareGlobalFunction (
The CanDeclareGlobalFunction concrete method of a
global Environment Record
envRec
takes argument
(a String). It determines if a corresponding CreateGlobalFunctionBinding call would succeed if called for the same argument
. It performs the following steps when called:
1.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
2.
Let
globalObject
be the binding object for
ObjRec
3.
Let
existingProp
be ?
globalObject
.[[GetOwnProperty]](
).
4.
If
existingProp
is
undefined
, return ?
IsExtensible
globalObject
).
5.
If
existingProp
.[[Configurable]] is
true
, return
true
6.
If
IsDataDescriptor
existingProp
) is
true
and
existingProp
has attribute values { [[Writable]]:
true
, [[Enumerable]]:
true
}, return
true
7.
Return
false
9.1.1.4.17
CreateGlobalVarBinding (
The CreateGlobalVarBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It creates and initializes a mutable binding in the associated
object Environment Record
and records the bound name in the associated [[VarNames]]
List
. If a binding already exists, it is reused and assumed to be initialized. It performs the following steps when called:
1.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
2.
Let
globalObject
be the binding object for
ObjRec
3.
Let
hasProperty
be ?
HasOwnProperty
globalObject
).
4.
Let
extensible
be ?
IsExtensible
globalObject
).
5.
If
hasProperty
is
false
and
extensible
is
true
, then
a.
Perform ?
ObjRec
.CreateMutableBinding(
).
b.
Perform ?
ObjRec
.InitializeBinding(
undefined
).
6.
Let
varDeclaredNames
be
envRec
.[[VarNames]].
7.
If
varDeclaredNames
does not contain
, then
a.
Append
to
varDeclaredNames
8.
Return
NormalCompletion
empty
).
9.1.1.4.18
CreateGlobalFunctionBinding (
The CreateGlobalFunctionBinding concrete method of a
global Environment Record
envRec
takes arguments
(a String),
(an
ECMAScript language value
), and
(a Boolean). It creates and initializes a mutable binding in the associated
object Environment Record
and records the bound name in the associated [[VarNames]]
List
. If a binding already exists, it is replaced. It performs the following steps when called:
1.
Let
ObjRec
be
envRec
.[[ObjectRecord]].
2.
Let
globalObject
be the binding object for
ObjRec
3.
Let
existingProp
be ?
globalObject
.[[GetOwnProperty]](
).
4.
If
existingProp
is
undefined
or
existingProp
.[[Configurable]] is
true
, then
a.
Let
desc
be the PropertyDescriptor { [[Value]]:
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
}.
5.
Else,
a.
Let
desc
be the PropertyDescriptor { [[Value]]:
}.
6.
Perform ?
DefinePropertyOrThrow
globalObject
desc
).
7.
Perform ?
Set
globalObject
false
).
8.
Let
varDeclaredNames
be
envRec
.[[VarNames]].
9.
If
varDeclaredNames
does not contain
, then
a.
Append
to
varDeclaredNames
10.
Return
NormalCompletion
empty
).
Note
Global function declarations are always represented as own properties of the
global object
. If possible, an existing own property is reconfigured to have a standard set of attribute values. Step
is equivalent to what calling the InitializeBinding concrete method would do and if
globalObject
is a Proxy will produce the same sequence of Proxy trap calls.
9.1.1.5
Module Environment Records
module Environment Record
is a
declarative Environment Record
that is used to represent the outer scope of an ECMAScript
Module
In additional to normal mutable and immutable bindings, module
Environment Records also provide immutable import bindings which are
bindings that provide indirect access to a target binding that exists in
another
Environment Record
Module Environment Records support all of the
declarative Environment Record
methods listed in
Table 17
and share the same specifications for all of those methods except for
GetBindingValue, DeleteBinding, HasThisBinding and GetThisBinding. In
addition, module Environment Records support the methods listed in
Table 22
Table 22: Additional Methods of Module Environment Records
Method
Purpose
CreateImportBinding(N, M, N2)
Create an immutable indirect binding in a
module Environment Record
. The String value
is the text of the bound name.
is a
Module Record
, and
N2
is a binding that exists in
's
module Environment Record
GetThisBinding()
Return the value of this
Environment Record
's
this
binding.
The behaviour of the additional concrete specification
methods for module Environment Records are defined by the following
algorithms:
9.1.1.5.1
GetBindingValue (
The GetBindingValue concrete method of a
module Environment Record
envRec
takes arguments
(a String) and
(a Boolean). It returns the value of its bound identifier whose name is the value of the argument
However, if the binding is an indirect binding the value of the target
binding is returned. If the binding exists but is uninitialized a
ReferenceError
is thrown. It performs the following steps when called:
1.
Assert
is
true
2.
Assert
envRec
has a binding for
3.
If the binding for
is an indirect binding, then
a.
Let
and
N2
be the indirection values provided when this binding for
was created.
b.
Let
targetEnv
be
.[[Environment]].
c.
If
targetEnv
is
undefined
, throw a
ReferenceError
exception.
d.
Return ?
targetEnv
.GetBindingValue(
N2
true
).
4.
If the binding for
in
envRec
is an uninitialized binding, throw a
ReferenceError
exception.
5.
Return the value currently bound to
in
envRec
Note
will always be
true
because a
Module
is always
strict mode code
9.1.1.5.2
DeleteBinding (
The DeleteBinding concrete method of a
module Environment Record
is never used within this specification.
Note
Module Environment Records are only used within strict code and an
early error
rule prevents the delete operator, in strict code, from being applied to a
Reference Record
that would resolve to a
module Environment Record
binding. See
13.5.1.1
9.1.1.5.3
HasThisBinding ( )
The HasThisBinding concrete method of a
module Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
true
Note
Module Environment Records always provide a
this
binding.
9.1.1.5.4
GetThisBinding ( )
The GetThisBinding concrete method of a
module Environment Record
envRec
takes no arguments. It performs the following steps when called:
1.
Return
undefined
9.1.1.5.5
CreateImportBinding (
N2
The CreateImportBinding concrete method of a
module Environment Record
envRec
takes arguments
(a String),
(a
Module Record
), and
N2
(a String). It creates a new initialized immutable indirect binding for the name
. A binding must not already exist in this
Environment Record
for
N2
is the name of a binding that exists in
's
module Environment Record
Accesses to the value of the new binding will indirectly access the
bound value of the target binding. It performs the following steps when
called:
1.
Assert
envRec
does not already have a binding for
2.
Assert
is a
Module Record
3.
Assert
: When
.[[Environment]] is instantiated it will have a direct binding for
N2
4.
Create an immutable indirect binding in
envRec
for
that references
and
N2
as its target binding and record that the binding is initialized.
5.
Return
NormalCompletion
empty
).
9.1.2
Environment Record Operations
The following
abstract operations
are used in this specification to operate upon Environment Records:
9.1.2.1
GetIdentifierReference (
env
name
strict
The abstract operation GetIdentifierReference takes arguments
env
(an
Environment Record
or
null
),
name
(a String), and
strict
(a Boolean). It performs the following steps when called:
1.
If
env
is the value
null
, then
a.
Return the
Reference Record
{ [[Base]]:
unresolvable
, [[ReferencedName]]:
name
, [[Strict]]:
strict
, [[ThisValue]]:
empty
}.
2.
Let
exists
be ?
env
.HasBinding(
name
).
3.
If
exists
is
true
, then
a.
Return the
Reference Record
{ [[Base]]:
env
, [[ReferencedName]]:
name
, [[Strict]]:
strict
, [[ThisValue]]:
empty
}.
4.
Else,
a.
Let
outer
be
env
.[[OuterEnv]].
b.
Return ?
GetIdentifierReference
outer
name
strict
).
9.1.2.2
NewDeclarativeEnvironment (
The abstract operation NewDeclarativeEnvironment takes argument
(an
Environment Record
). It performs the following steps when called:
1.
Let
env
be a new
declarative Environment Record
containing no bindings.
2.
Set
env
.[[OuterEnv]] to
3.
Return
env
9.1.2.3
NewObjectEnvironment (
The abstract operation NewObjectEnvironment takes arguments
(an Object) and
(an
Environment Record
). It performs the following steps when called:
1.
Let
env
be a new
object Environment Record
containing
as the binding object.
2.
Set
env
.[[OuterEnv]] to
3.
Return
env
9.1.2.4
NewFunctionEnvironment (
newTarget
The abstract operation NewFunctionEnvironment takes arguments
and
newTarget
. It performs the following steps when called:
1.
Assert
is an ECMAScript function.
2.
Assert
Type
newTarget
) is Undefined or Object.
3.
Let
env
be a new
function Environment Record
containing no bindings.
4.
Set
env
.[[FunctionObject]] to
5.
If
.[[ThisMode]] is
lexical
, set
env
.[[ThisBindingStatus]] to
lexical
6.
Else, set
env
.[[ThisBindingStatus]] to
uninitialized
7.
Set
env
.[[NewTarget]] to
newTarget
8.
Set
env
.[[OuterEnv]] to
.[[Environment]].
9.
Return
env
9.1.2.5
NewGlobalEnvironment (
thisValue
The abstract operation NewGlobalEnvironment takes arguments
and
thisValue
. It performs the following steps when called:
1.
Let
objRec
be a new
object Environment Record
containing
as the binding object.
2.
Let
dclRec
be a new
declarative Environment Record
containing no bindings.
3.
Let
env
be a new
global Environment Record
4.
Set
env
.[[ObjectRecord]] to
objRec
5.
Set
env
.[[GlobalThisValue]] to
thisValue
6.
Set
env
.[[DeclarativeRecord]] to
dclRec
7.
Set
env
.[[VarNames]] to a new empty
List
8.
Set
env
.[[OuterEnv]] to
null
9.
Return
env
9.1.2.6
NewModuleEnvironment (
The abstract operation NewModuleEnvironment takes argument
(an
Environment Record
). It performs the following steps when called:
1.
Let
env
be a new
module Environment Record
containing no bindings.
2.
Set
env
.[[OuterEnv]] to
3.
Return
env
9.2
Realms
Before it is evaluated, all ECMAScript code must be associated with a
realm
. Conceptually, a
realm
consists of a set of intrinsic objects, an ECMAScript
global environment
, all of the ECMAScript code that is loaded within the scope of that
global environment
, and other associated state and resources.
realm
is represented in this specification as a
Realm Record
with the fields specified in
Table 23
Table 23:
Realm Record
Fields
Field Name
Value
Meaning
[[Intrinsics]]
Record
whose field names are intrinsic keys and whose values are objects
The intrinsic values used by code associated with this
realm
[[GlobalObject]]
Object
The
global object
for this
realm
[[GlobalEnv]]
global Environment Record
The
global environment
for this
realm
[[TemplateMap]]
List
of
Record
{ [[Site]]:
Parse Node
, [[Array]]: Object }.
Template objects are canonicalized separately for each
realm
using its
Realm Record
's [[TemplateMap]]. Each [[Site]] value is a
Parse Node
that is a
TemplateLiteral
. The associated [[Array]] value is the corresponding template object that is passed to a tag function.
Note
Once a
Parse Node
becomes unreachable, the corresponding [[Array]] is also unreachable,
and it would be unobservable if an implementation removed the pair from
the [[TemplateMap]] list.
[[HostDefined]]
Any, default value is
undefined
Field reserved for use by hosts that need to associate additional information with a
Realm Record
9.2.1
CreateRealm ( )
The abstract operation CreateRealm takes no arguments. It performs the following steps when called:
1.
Let
realmRec
be a new
Realm Record
2.
Perform
CreateIntrinsics
realmRec
).
3.
Set
realmRec
.[[GlobalObject]] to
undefined
4.
Set
realmRec
.[[GlobalEnv]] to
undefined
5.
Set
realmRec
.[[TemplateMap]] to a new empty
List
6.
Return
realmRec
9.2.2
CreateIntrinsics (
realmRec
The abstract operation CreateIntrinsics takes argument
realmRec
. It performs the following steps when called:
1.
Let
intrinsics
be a new
Record
2.
Set
realmRec
.[[Intrinsics]] to
intrinsics
3.
Set fields of
intrinsics
with the values listed in
Table 8
The field names are the names listed in column one of the table. The
value of each field is a new object value fully and recursively
populated with property values as defined by the specification of each
object in clauses
19
through
28
All object property values are newly created object values. All values
that are built-in function objects are created by performing
CreateBuiltinFunction
steps
length
name
slots
realmRec
prototype
) where
steps
is the definition of that function provided by this specification,
name
is the initial value of the function's
name
property,
length
is the initial value of the function's
length
property,
slots
is a list of the names, if any, of the function's specified internal slots, and
prototype
is the specified value of the function's [[Prototype]] internal slot.
The creation of the intrinsics and their properties must be ordered to
avoid any dependencies upon objects that have not yet been created.
4.
Perform
AddRestrictedFunctionProperties
intrinsics
.[[
%Function.prototype%
]],
realmRec
).
5.
Return
intrinsics
9.2.3
SetRealmGlobalObject (
realmRec
globalObj
thisValue
The abstract operation SetRealmGlobalObject takes arguments
realmRec
globalObj
, and
thisValue
. It performs the following steps when called:
1.
If
globalObj
is
undefined
, then
a.
Let
intrinsics
be
realmRec
.[[Intrinsics]].
b.
Set
globalObj
to !
OrdinaryObjectCreate
intrinsics
.[[
%Object.prototype%
]]).
2.
Assert
Type
globalObj
) is Object.
3.
If
thisValue
is
undefined
, set
thisValue
to
globalObj
4.
Set
realmRec
.[[GlobalObject]] to
globalObj
5.
Let
newGlobalEnv
be
NewGlobalEnvironment
globalObj
thisValue
).
6.
Set
realmRec
.[[GlobalEnv]] to
newGlobalEnv
7.
Return
realmRec
9.2.4
SetDefaultGlobalBindings (
realmRec
The abstract operation SetDefaultGlobalBindings takes argument
realmRec
. It performs the following steps when called:
1.
Let
global
be
realmRec
.[[GlobalObject]].
2.
For each property of the Global Object specified in clause
19
, do
a.
Let
name
be the String value of the
property name
b.
Let
desc
be the fully populated data
Property Descriptor
for the property, containing the specified attributes for the property. For properties listed in
19.2
19.3
, or
19.4
the value of the [[Value]] attribute is the corresponding intrinsic object from
realmRec
c.
Perform ?
DefinePropertyOrThrow
global
name
desc
).
3.
Return
global
9.3
Execution Contexts
An
execution context
is a specification device that is
used to track the runtime evaluation of code by an ECMAScript
implementation. At any point in time, there is at most one execution
context per
agent
that is actually executing code. This is known as the
agent
's
running execution context
. All references to the
running execution context
in this specification denote the
running execution context
of the
surrounding agent
The
execution context stack
is used to track execution contexts. The
running execution context
is always the top element of this stack. A new execution context is
created whenever control is transferred from the executable code
associated with the currently
running execution context
to executable code that is not associated with that execution context.
The newly created execution context is pushed onto the stack and becomes
the
running execution context
An execution context contains whatever implementation specific
state is necessary to track the execution progress of its associated
code. Each execution context has at least the state components listed in
Table 24
Table 24: State Components for All Execution Contexts
Component
Purpose
code evaluation state
Any state needed to perform, suspend, and resume evaluation of the code associated with this
execution context
Function
If this
execution context
is evaluating the code of a
function object
, then the value of this component is that
function object
. If the context is evaluating the code of a
Script
or
Module
, the value is
null
Realm
The
Realm Record
from which associated code accesses ECMAScript resources.
ScriptOrModule
The
Module Record
or
Script Record
from which associated code originates. If there is no originating script or module, as is the case for the original
execution context
created in
InitializeHostDefinedRealm
, the value is
null
Evaluation of code by the
running execution context
may be suspended at various points defined within this specification. Once the
running execution context
has been suspended a different execution context may become the
running execution context
and commence evaluating its code. At some later time a suspended execution context may again become the
running execution context
and continue evaluating its code at the point where it had previously been suspended. Transition of the
running execution context
status among execution contexts usually occurs in stack-like
last-in/first-out manner. However, some ECMAScript features require
non-LIFO transitions of the
running execution context
The value of the
Realm
component of the
running execution context
is also called
the current Realm Record
. The value of the Function component of the
running execution context
is also called the
active function object
Execution contexts for ECMAScript code have the additional state components listed in
Table 25
Table 25: Additional State Components for ECMAScript Code Execution Contexts
Component
Purpose
LexicalEnvironment
Identifies the
Environment Record
used to resolve identifier references made by code within this
execution context
VariableEnvironment
Identifies the
Environment Record
that holds bindings created by
VariableStatement
s within this
execution context
The LexicalEnvironment and VariableEnvironment components of an execution context are always Environment Records.
Execution contexts representing the evaluation of generator objects have the additional state components listed in
Table 26
Table 26: Additional State Components for Generator Execution Contexts
Component
Purpose
Generator
The generator object that this
execution context
is evaluating.
In most situations only the
running execution context
(the top of the
execution context stack
is directly manipulated by algorithms within this specification. Hence
when the terms “LexicalEnvironment”, and “VariableEnvironment” are used
without qualification they are in reference to those components of the
running execution context
An execution context is purely a specification mechanism and need
not correspond to any particular artefact of an ECMAScript
implementation. It is impossible for ECMAScript code to directly access
or observe an execution context.
9.3.1
GetActiveScriptOrModule ( )
The abstract operation GetActiveScriptOrModule takes no
arguments. It is used to determine the running script or module, based
on the
running execution context
. It performs the following steps when called:
1.
If the
execution context stack
is empty, return
null
2.
Let
ec
be the topmost
execution context
on the
execution context stack
whose ScriptOrModule component is not
null
3.
If no such
execution context
exists, return
null
. Otherwise, return
ec
's ScriptOrModule.
9.3.2
ResolveBinding (
name
[ ,
env
] )
The abstract operation ResolveBinding takes argument
name
(a String) and optional argument
env
(an
Environment Record
). It is used to determine the binding of
name
env
can be used to explicitly provide the
Environment Record
that is to be searched for the binding. It performs the following steps when called:
1.
If
env
is not present or if
env
is
undefined
, then
a.
Set
env
to the
running execution context
's LexicalEnvironment.
2.
Assert
env
is an
Environment Record
3.
If the code matching the syntactic production that is being evaluated is contained in
strict mode code
, let
strict
be
true
; else let
strict
be
false
4.
Return ?
GetIdentifierReference
env
name
strict
).
Note
The result of ResolveBinding is always a
Reference Record
whose [[ReferencedName]] field is
name
9.3.3
GetThisEnvironment ( )
The abstract operation GetThisEnvironment takes no arguments. It finds the
Environment Record
that currently supplies the binding of the
keyword
this
. It performs the following steps when called:
1.
Let
env
be the
running execution context
's LexicalEnvironment.
2.
Repeat,
a.
Let
exists
be
env
.HasThisBinding().
b.
If
exists
is
true
, return
env
c.
Let
outer
be
env
.[[OuterEnv]].
d.
Assert
outer
is not
null
e.
Set
env
to
outer
Note
The loop in step
will always terminate because the list of environments always ends with the
global environment
which has a
this
binding.
9.3.4
ResolveThisBinding ( )
The abstract operation ResolveThisBinding takes no arguments. It determines the binding of the
keyword
this
using the LexicalEnvironment of the
running execution context
. It performs the following steps when called:
1.
Let
envRec
be
GetThisEnvironment
().
2.
Return ?
envRec
.GetThisBinding().
9.3.5
GetNewTarget ( )
The abstract operation GetNewTarget takes no arguments. It determines the NewTarget value using the LexicalEnvironment of the
running execution context
. It performs the following steps when called:
1.
Let
envRec
be
GetThisEnvironment
().
2.
Assert
envRec
has a [[NewTarget]] field.
3.
Return
envRec
.[[NewTarget]].
9.3.6
GetGlobalObject ( )
The abstract operation GetGlobalObject takes no arguments. It returns the
global object
used by the currently
running execution context
. It performs the following steps when called:
1.
Let
currentRealm
be
the current Realm Record
2.
Return
currentRealm
.[[GlobalObject]].
9.4
Jobs and Host Operations to Enqueue Jobs
Job
is an
Abstract Closure
with no parameters that initiates an ECMAScript computation when no other ECMAScript computation is currently in progress.
Jobs are scheduled for execution by ECMAScript
host
environments. This specification describes the
host hook
HostEnqueuePromiseJob
to schedule one kind of job; hosts may define additional
abstract operations
which schedule jobs. Such operations accept a
Job
Abstract Closure
as the parameter and schedule it to be performed at some future time.
Their implementations must conform to the following requirements:
At some future point in time, when there is no
running execution context
and the
execution context stack
is empty, the implementation must:
Perform any
host-defined
preparation steps.
Invoke
the
Job
Abstract Closure
Perform any
host-defined
cleanup steps, after which the
execution context stack
must be empty.
Only one
Job
may be actively undergoing evaluation at any point in time.
Once evaluation of a
Job
starts, it must run to completion before evaluation of any other
Job
starts.
The
Abstract Closure
must return a normal completion, implementing its own handling of errors.
Note 1
Host
environments are not required to treat Jobs uniformly with respect to
scheduling. For example, web browsers and Node.js treat Promise-handling
Jobs as a higher priority than other work; future features may add Jobs
that are not treated at such a high priority.
At any particular time,
scriptOrModule
(a
Script Record
, a
Module Record
, or
null
) is the
active script or module
if all of the following conditions are true:
GetActiveScriptOrModule
() is
scriptOrModule
If
scriptOrModule
is a
Script Record
or
Module Record
, let
ec
be the topmost
execution context
on the
execution context stack
whose ScriptOrModule component is
scriptOrModule
. The
Realm
component of
ec
is
scriptOrModule
.[[Realm]].
At any particular time, an execution is
prepared to evaluate ECMAScript code
if all of the following conditions are true:
The
execution context stack
is not empty.
The
Realm
component of the topmost
execution context
on the
execution context stack
is a
Realm Record
Note 2
Host
environments may prepare an execution to evaluate code by pushing execution contexts onto the
execution context stack
. The specific steps are
implementation-defined
The specific choice of
Realm
is up to the
host environment
. This initial
execution context
and
Realm
is only in use before any callback function is invoked. When a callback function related to a
Job
, like a Promise handler, is invoked, the invocation pushes its own
execution context
and
Realm
Particular kinds of Jobs have additional conformance requirements.
9.4.1
JobCallback Records
JobCallback Record
is a
Record
value used to store a
function object
and a
host-defined
value. Function objects that are invoked via a
Job
enqueued by the
host
may have additional
host-defined
context. To propagate the state,
Job
Abstract Closures should not capture and call function objects directly. Instead, use
HostMakeJobCallback
and
HostCallJobCallback
Note
The WHATWG HTML specification (
), for example, uses the
host-defined
value to propagate the incumbent settings object for Promise callbacks.
JobCallback Records have the fields listed in
Table 27
Table 27:
JobCallback Record
Fields
Field Name
Value
Meaning
[[Callback]]
function object
The function to invoke when the
Job
is invoked.
[[HostDefined]]
Any, default value is
empty
Field reserved for use by hosts.
9.4.2
HostMakeJobCallback (
callback
The
host-defined
abstract operation HostMakeJobCallback takes argument
callback
(a
function object
).
The implementation of HostMakeJobCallback must conform to the following requirements:
It must always complete normally (i.e., not return an
abrupt completion
).
It must always return a
JobCallback Record
whose [[Callback]] field is
callback
The default implementation of HostMakeJobCallback performs the following steps when called:
1.
Assert
IsCallable
callback
) is
true
2.
Return the
JobCallback Record
{ [[Callback]]:
callback
, [[HostDefined]]:
empty
}.
ECMAScript hosts that are not web browsers must use the default implementation of HostMakeJobCallback.
Note
This is called at the time that the callback is passed to the
function that is responsible for its being eventually scheduled and
run. For example,
promise.then(thenAction)
calls MakeJobCallback on
thenAction
at the time of invoking
Promise.prototype.then
, not at the time of scheduling the reaction
Job
9.4.3
HostCallJobCallback (
jobCallback
argumentsList
The
host-defined
abstract operation HostCallJobCallback takes arguments
jobCallback
(a
JobCallback Record
),
(an
ECMAScript language value
), and
argumentsList
(a
List
of ECMAScript language values).
The implementation of HostCallJobCallback must conform to the following requirements:
It must always perform and return the result of
Call
jobCallback
.[[Callback]],
argumentsList
).
Note
This requirement means that hosts cannot change the [[Call]] behaviour of function objects defined in this specification.
The default implementation of HostCallJobCallback performs the following steps when called:
1.
Assert
IsCallable
jobCallback
.[[Callback]]) is
true
2.
Return ?
Call
jobCallback
.[[Callback]],
argumentsList
).
ECMAScript hosts that are not web browsers must use the default implementation of HostCallJobCallback.
9.4.4
HostEnqueuePromiseJob (
job
realm
The
host-defined
abstract operation HostEnqueuePromiseJob takes arguments
job
(a
Job
Abstract Closure
) and
realm
(a
Realm Record
or
null
). It schedules
job
to be performed at some future time. The Abstract Closures used with
this algorithm are intended to be related to the handling of Promises,
or otherwise, to be scheduled with equal priority to Promise handling
operations.
The implementation of HostEnqueuePromiseJob must conform to the requirements in
9.4
as well as the following:
If
realm
is not
null
, each time
job
is invoked the implementation must perform
implementation-defined
steps such that execution is
prepared to evaluate ECMAScript code
at the time of
job
's invocation.
Let
scriptOrModule
be
GetActiveScriptOrModule
() at the time HostEnqueuePromiseJob is invoked. If
realm
is not
null
, each time
job
is invoked the implementation must perform
implementation-defined
steps such that
scriptOrModule
is the
active script or module
at the time of
job
's invocation.
Jobs must run in the same order as the HostEnqueuePromiseJob invocations that scheduled them.
Note
The
realm
for Jobs returned by
NewPromiseResolveThenableJob
is usually the result of calling
GetFunctionRealm
on the
then
function object
. The
realm
for Jobs returned by
NewPromiseReactionJob
is usually the result of calling
GetFunctionRealm
on the handler if the handler is not
undefined
. If the handler is
undefined
realm
is
null
. For both kinds of Jobs, when
GetFunctionRealm
completes abnormally (i.e. called on a revoked Proxy),
realm
is the current
Realm
at the time of the
GetFunctionRealm
call. When the
realm
is
null
no user ECMAScript code will be evaluated and no new ECMAScript objects
(e.g. Error objects) will be created. The WHATWG HTML specification (
), for example, uses
realm
to check for the ability to run script and for the
entry
concept.
9.5
InitializeHostDefinedRealm ( )
The abstract operation InitializeHostDefinedRealm takes no arguments. It performs the following steps when called:
1.
Let
realm
be
CreateRealm
().
2.
Let
newContext
be a new
execution context
3.
Set the Function of
newContext
to
null
4.
Set the
Realm
of
newContext
to
realm
5.
Set the ScriptOrModule of
newContext
to
null
6.
Push
newContext
onto the
execution context stack
newContext
is now the
running execution context
7.
If the
host
requires use of an
exotic object
to serve as
realm
's
global object
, let
global
be such an object created in a
host-defined
manner. Otherwise, let
global
be
undefined
, indicating that an
ordinary object
should be created as the
global object
8.
If the
host
requires that the
this
binding in
realm
's global scope return an object other than the
global object
, let
thisValue
be such an object created in a
host-defined
manner. Otherwise, let
thisValue
be
undefined
, indicating that
realm
's global
this
binding should be the
global object
9.
Perform
SetRealmGlobalObject
realm
global
thisValue
).
10.
Let
globalObj
be ?
SetDefaultGlobalBindings
realm
).
11.
Create any
host-defined
global object
properties on
globalObj
12.
Return
NormalCompletion
empty
).
9.6
Agents
An
agent
comprises a set of ECMAScript execution contexts, an
execution context stack
, a
running execution context
, an
Agent Record
, and an
executing thread
. Except for the
executing thread
, the constituents of an
agent
belong exclusively to that
agent
An
agent
's
executing thread
executes a job on the
agent
's execution contexts independently of other agents, except that an
executing thread
may be used as the
executing thread
by multiple agents, provided none of the agents sharing the thread have an
Agent Record
whose [[CanBlock]] property is
true
Note 1
Some web browsers share a single
executing thread
across multiple unrelated tabs of a browser window, for example.
While an
agent
's
executing thread
executes jobs, the
agent
is the
surrounding agent
for the code in those jobs. The code uses the
surrounding agent
to access the specification level execution objects held within the
agent
: the
running execution context
, the
execution context stack
, and the
Agent Record
's fields.
Table 28:
Agent Record
Fields
Field Name
Value
Meaning
[[LittleEndian]]
Boolean
The default value computed for the
isLittleEndian
parameter when it is needed by the algorithms
GetValueFromBuffer
and
SetValueInBuffer
. The choice is
implementation-defined
and should be the alternative that is most efficient for the implementation. Once the value has been observed it cannot change.
[[CanBlock]]
Boolean
Determines whether the
agent
can block or not.
[[Signifier]]
Any globally-unique value
Uniquely identifies the
agent
within its
agent cluster
[[IsLockFree1]]
Boolean
true
if atomic operations on one-byte values are lock-free,
false
otherwise.
[[IsLockFree2]]
Boolean
true
if atomic operations on two-byte values are lock-free,
false
otherwise.
[[IsLockFree8]]
Boolean
true
if atomic operations on eight-byte values are lock-free,
false
otherwise.
[[CandidateExecution]]
candidate execution
Record
See the
memory model
[[KeptAlive]]
List
of objects
Initially a new empty
List
, representing the list of objects to be kept alive until the end of the current
Job
Once the values of [[Signifier]], [[IsLockFree1]], and [[IsLockFree2]] have been observed by any
agent
in the
agent cluster
they cannot change.
Note 2
The values of [[IsLockFree1]] and [[IsLockFree2]] are not
necessarily determined by the hardware, but may also reflect
implementation choices that can vary over time and between ECMAScript
implementations.
There is no [[IsLockFree4]] property: 4-byte atomic operations are always lock-free.
In practice, if an atomic operation is implemented with any
type of lock the operation is not lock-free. Lock-free does not imply
wait-free: there is no upper bound on how many machine steps may be
required to complete a lock-free atomic operation.
That an atomic access of size
is lock-free does not imply anything about the (perceived) atomicity of non-atomic accesses of size
, specifically, non-atomic accesses may still be performed as a sequence of several separate memory accesses. See
ReadSharedMemory
and
WriteSharedMemory
for details.
Note 3
An
agent
is a specification mechanism and need not correspond to any particular artefact of an ECMAScript implementation.
9.6.1
AgentSignifier ( )
The abstract operation AgentSignifier takes no arguments. It performs the following steps when called:
1.
Let
AR
be the
Agent Record
of the
surrounding agent
2.
Return
AR
.[[Signifier]].
9.6.2
AgentCanSuspend ( )
The abstract operation AgentCanSuspend takes no arguments. It performs the following steps when called:
1.
Let
AR
be the
Agent Record
of the
surrounding agent
2.
Return
AR
.[[CanBlock]].
Note
In some environments it may not be reasonable for a given
agent
to suspend. For example, in a web browser environment, it may be
reasonable to disallow suspending a document's main event handling
thread, while still allowing workers' event handling threads to suspend.
9.7
Agent Clusters
An
agent cluster
is a maximal set of agents that can communicate by operating on shared memory.
Note 1
Programs within different agents may share memory by
unspecified means. At a minimum, the backing memory for
SharedArrayBuffer objects can be shared among the agents in the cluster.
There may be agents that can communicate by message passing that cannot share memory; they are never in the same agent cluster.
Every
agent
belongs to exactly one agent cluster.
Note 2
The agents in a cluster need not all be alive at some particular point in time. If
agent
creates another
agent
, after which
terminates and
creates
agent
, the three agents are in the same cluster if
could share some memory with
and
could share some memory with
All agents within a cluster must have the same value for the [[LittleEndian]] property in their respective
Agent
Records.
Note 3
If different agents within an agent cluster have different
values of [[LittleEndian]] it becomes hard to use shared memory for
multi-byte data.
All agents within a cluster must have the same values for the [[IsLockFree1]] property in their respective
Agent
Records; similarly for the [[IsLockFree2]] property.
All agents within a cluster must have different values for the [[Signifier]] property in their respective
Agent
Records.
An embedding may deactivate (stop forward progress) or activate (resume forward progress) an
agent
without the
agent
's
knowledge or cooperation. If the embedding does so, it must not leave
some agents in the cluster active while other agents in the cluster are
deactivated indefinitely.
Note 4
The purpose of the preceding restriction is to avoid a situation where an
agent
deadlocks or starves because another
agent
has been deactivated. For example, if an HTML shared worker that has a
lifetime independent of documents in any windows were allowed to share
memory with the dedicated worker of such an independent document, and
the document and its dedicated worker were to be deactivated while the
dedicated worker holds a lock (say, the document is pushed into its
window's history), and the shared worker then tries to acquire the lock,
then the shared worker will be blocked until the dedicated worker is
activated again, if ever. Meanwhile other workers trying to access the
shared worker from other windows will starve.
The implication of the restriction is that it will not be
possible to share memory between agents that don't belong to the same
suspend/wake collective within the embedding.
An embedding may terminate an
agent
without any of the
agent
's cluster's other agents' prior knowledge or cooperation. If an
agent
is terminated not by programmatic action of its own or of another
agent
in the cluster but by forces external to the cluster, then the
embedding must choose one of two strategies: Either terminate all the
agents in the cluster, or provide reliable APIs that allow the agents in
the cluster to coordinate so that at least one remaining member of the
cluster will be able to detect the termination, with the termination
data containing enough information to identify the
agent
that was terminated.
Note 5
Examples of that type of termination are: operating systems or
users terminating agents that are running in separate processes; the
embedding itself terminating an
agent
that is running in-process with the other agents when per-
agent
resource accounting indicates that the
agent
is runaway.
Prior to any evaluation of any ECMAScript code by any
agent
in a cluster, the [[CandidateExecution]] field of the
Agent Record
for all agents in the cluster is set to the initial
candidate execution
. The initial
candidate execution
is an
empty candidate execution
whose [[EventsRecords]] field is a
List
containing, for each
agent
, an
Agent Events Record
whose [[AgentSignifier]] field is that
agent
's signifier, and whose [[EventList]] and [[AgentSynchronizesWith]] fields are empty Lists.
Note 6
All agents in an agent cluster share the same
candidate execution
in its
Agent Record
's [[CandidateExecution]] field. The
candidate execution
is a specification mechanism used by the
memory model
Note 7
An agent cluster is a specification mechanism and need not
correspond to any particular artefact of an ECMAScript implementation.
9.8
Forward Progress
For an
agent
to
make forward progress
is for it to perform an evaluation step according to this specification.
An
agent
becomes
blocked
when its
running execution context
waits synchronously and indefinitely for an external event. Only agents whose
Agent Record
's [[CanBlock]] property is
true
can become blocked in this sense. An
unblocked
agent
is one that is not blocked.
Implementations must ensure that:
every unblocked
agent
with a dedicated
executing thread
eventually makes forward progress
in a set of agents that share an
executing thread
, one
agent
eventually makes forward progress
an
agent
does not cause another
agent
to become blocked except via explicit APIs that provide blocking.
Note
This, along with the liveness guarantee in the
memory model
, ensures that all
SeqCst
writes eventually become observable to all agents.
9.9
Processing Model of WeakRef and FinalizationRegistry Objects
9.9.1
Objectives
This specification does not make any guarantees that any object will be garbage collected. Objects which are not
live
may be released after long periods of time, or never at all. For this
reason, this specification uses the term "may" when describing behaviour
triggered by garbage collection.
The semantics of
WeakRef
and
FinalizationRegistry
objects is based on two operations which happen at particular points in time:
When
WeakRef.prototype.deref
is called, the referent (if
undefined
is not returned) is kept alive so that subsequent, synchronous accesses
also return the object. This list is reset when synchronous work is
done using the
ClearKeptObjects
abstract operation.
When an object which is registered with a
FinalizationRegistry
becomes unreachable, a call of the
FinalizationRegistry
's cleanup callback may eventually be made, after synchronous ECMAScript execution completes. The
FinalizationRegistry
cleanup is performed with the
CleanupFinalizationRegistry
abstract operation.
Neither of these actions (
ClearKeptObjects
or
CleanupFinalizationRegistry
may interrupt synchronous ECMAScript execution. Because hosts may
assemble longer, synchronous ECMAScript execution runs, this
specification defers the scheduling of
ClearKeptObjects
and
CleanupFinalizationRegistry
to the
host environment
Some ECMAScript implementations include garbage collector
implementations which run in the background, including when ECMAScript
is idle. Letting the
host environment
schedule
CleanupFinalizationRegistry
allows it to resume ECMAScript execution in order to run finalizer
work, which may free up held values, reducing overall memory usage.
9.9.2
Liveness
For some set of objects
, a
hypothetical WeakRef-oblivious
execution with respect to
is an execution whereby the abstract operation
WeakRefDeref
of a
WeakRef
whose referent is an element of
always returns
undefined
Note 1
WeakRef
-obliviousness, together with liveness, capture two notions. One, that a
WeakRef
itself does not keep an object alive. Two, that cycles in liveness does
not imply that an object is live. To be concrete, if determining
obj
's liveness depends on determining the liveness of another
WeakRef
referent,
obj2
obj2
's liveness cannot assume
obj
's liveness, which would be circular reasoning.
Note 2
WeakRef
-obliviousness
is defined on sets of objects instead of individual objects to account
for cycles. If it were defined on individual objects, then an object in a
cycle will be considered live even though its Object value is only
observed via WeakRefs of other objects in the cycle.
Note 3
Colloquially, we say that an individual object is live if every set of objects containing it is live.
At any point during evaluation, a set of objects
is considered
live
if either of the following conditions is met:
Any element in
is included in any
agent
's [[KeptAlive]]
List
There exists a valid future hypothetical WeakRef-oblivious execution with respect to
that observes the Object value of any object in
Note 4
The intuition the second condition above intends to capture is
that an object is live if its identity is observable via non-
WeakRef
means. An object's identity may be observed by observing a strict
equality comparison between objects or observing the object being used
as key in a Map.
Note 5
Presence of an object in a field, an internal slot, or a
property does not imply that the object is live. For example if the
object in question is never passed back to the program, then it cannot
be observed.
This is the case for keys in a WeakMap, members of a WeakSet,
as well as the [[WeakRefTarget]] and [[UnregisterToken]] fields of a
FinalizationRegistry
Cell record.
The above definition implies that, if a key in a WeakMap is
not live, then its corresponding value is not necessarily live either.
Note 6
Liveness is the lower bound for guaranteeing which WeakRefs
engines must not empty. Liveness as defined here is undecidable. In
practice, engines use conservative approximations such as reachability.
There is expected to be significant implementation leeway.
9.9.3
Execution
At any time, if a set of objects
is not
live
, an ECMAScript implementation may perform the following steps atomically:
1.
For each element
obj
of
, do
a.
For each
WeakRef
ref
such that
ref
.[[WeakRefTarget]] is
obj
, do
i.
Set
ref
.[[WeakRefTarget]] to
empty
b.
For each
FinalizationRegistry
fg
such that
fg
.[[Cells]] contains a
Record
cell
such that
cell
.[[WeakRefTarget]] is
obj
, do
i.
Set
cell
.[[WeakRefTarget]] to
empty
ii.
Optionally, perform !
HostEnqueueFinalizationRegistryCleanupJob
fg
).
c.
For each WeakMap
map
such that
map
.[[WeakMapData]] contains a
Record
such that
.[[Key]] is
obj
, do
i.
Set
.[[Key]] to
empty
ii.
Set
.[[Value]] to
empty
d.
For each WeakSet
set
such that
set
.[[WeakSetData]] contains
obj
, do
i.
Replace the element of
set
.[[WeakSetData]] whose value is
obj
with an element whose value is
empty
Note 1
Together with the definition of liveness, this clause
prescribes legal optimizations that an implementation may apply
regarding WeakRefs.
It is possible to access an object without observing its
identity. Optimizations such as dead variable elimination and scalar
replacement on properties of non-escaping objects whose identity is not
observed are allowed. These optimizations are thus allowed to observably
empty WeakRefs that point to such objects.
On the other hand, if an object's identity is observable, and that object is in the [[WeakRefTarget]] internal slot of a
WeakRef
, optimizations such as rematerialization that observably empty the
WeakRef
are prohibited.
Because calling
HostEnqueueFinalizationRegistryCleanupJob
is optional, registered objects in a
FinalizationRegistry
do not necessarily hold that
FinalizationRegistry
live
. Implementations may omit
FinalizationRegistry
callbacks for any reason, e.g., if the
FinalizationRegistry
itself becomes dead, or if the application is shutting down.
Note 2
Implementations are not obligated to empty WeakRefs for maximal sets of non-
live
objects.
If an implementation chooses a non-
live
set
in which to empty WeakRefs, it must empty WeakRefs for all objects in
simultaneously. In other words, an implementation must not empty a
WeakRef
pointing to an object
obj
without emptying out other WeakRefs that, if not emptied, could result in an execution that observes the Object value of
obj
9.9.4
Host Hooks
9.9.4.1
HostEnqueueFinalizationRegistryCleanupJob (
finalizationRegistry
The abstract operation HostEnqueueFinalizationRegistryCleanupJob takes argument
finalizationRegistry
(a
FinalizationRegistry
). HostEnqueueFinalizationRegistryCleanupJob is an
implementation-defined
abstract operation that is expected to call
CleanupFinalizationRegistry
finalizationRegistry
) at some point in the future, if possible. The
host
's responsibility is to make this call at a time which does not interrupt synchronous ECMAScript code execution.
9.10
ClearKeptObjects ( )
The abstract operation ClearKeptObjects takes no arguments.
ECMAScript implementations are expected to call ClearKeptObjects when a
synchronous sequence of ECMAScript executions completes. It performs the
following steps when called:
1.
Let
agentRecord
be the
surrounding agent
's
Agent Record
2.
Set
agentRecord
.[[KeptAlive]] to a new empty
List
9.11
AddToKeptObjects (
object
The abstract operation AddToKeptObjects takes argument
object
(an Object). It performs the following steps when called:
1.
Let
agentRecord
be the
surrounding agent
's
Agent Record
2.
Append
object
to
agentRecord
.[[KeptAlive]].
Note
When the abstract operation AddToKeptObjects is called with a
target object reference, it adds the target to a list that will point
strongly at the target until
ClearKeptObjects
is called.
9.12
CleanupFinalizationRegistry (
finalizationRegistry
The abstract operation CleanupFinalizationRegistry takes argument
finalizationRegistry
(a
FinalizationRegistry
). It performs the following steps when called:
1.
Assert
finalizationRegistry
has [[Cells]] and [[CleanupCallback]] internal slots.
2.
Let
callback
be
finalizationRegistry
.[[CleanupCallback]].
3.
While
finalizationRegistry
.[[Cells]] contains a
Record
cell
such that
cell
.[[WeakRefTarget]] is
empty
, an implementation may perform the following steps:
a.
Choose any such
cell
b.
Remove
cell
from
finalizationRegistry
.[[Cells]].
c.
Perform ?
Call
callback
undefined
, «
cell
.[[HeldValue]] »).
4.
Return
NormalCompletion
undefined
).
10
Ordinary and Exotic Objects Behaviours
10.1
Ordinary Object Internal Methods and Internal Slots
All ordinary objects have an internal slot called [[Prototype]]. The value of this internal slot is either
null
or an object and is used for implementing inheritance. Data properties
of the [[Prototype]] object are inherited (and visible as properties of
the child object) for the purposes of get access, but not for set
access. Accessor properties are inherited for both get access and set
access.
Every
ordinary object
has a Boolean-valued [[Extensible]] internal slot which is used to
fulfill the extensibility-related internal method invariants specified
in
6.1.7.3
. Namely, once the value of an object's [[Extensible]] internal slot has been set to
false
it is no longer possible to add properties to the object, to modify the
value of the object's [[Prototype]] internal slot, or to subsequently
change the value of [[Extensible]] to
true
In the following algorithm descriptions, assume
is an
ordinary object
is a property key value,
is any
ECMAScript language value
, and
Desc
is a
Property Descriptor
record.
Each
ordinary object
internal method delegates to a similarly-named abstract operation. If
such an abstract operation depends on another internal method, then the
internal method is invoked on
rather than calling the
similarly-named abstract operation directly. These semantics ensure that
exotic objects have their overridden internal methods invoked when
ordinary object
internal methods are applied to them.
10.1.1
[[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of an
ordinary object
takes no arguments. It performs the following steps when called:
1.
Return !
OrdinaryGetPrototypeOf
).
10.1.1.1
OrdinaryGetPrototypeOf (
The abstract operation OrdinaryGetPrototypeOf takes argument
(an Object). It performs the following steps when called:
1.
Return
.[[Prototype]].
10.1.2
[[SetPrototypeOf]] (
The [[SetPrototypeOf]] internal method of an
ordinary object
takes argument
(an Object or
null
). It performs the following steps when called:
1.
Return !
OrdinarySetPrototypeOf
).
10.1.2.1
OrdinarySetPrototypeOf (
The abstract operation OrdinarySetPrototypeOf takes arguments
(an Object) and
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
: Either
Type
) is Object or
Type
) is Null.
2.
Let
current
be
.[[Prototype]].
3.
If
SameValue
current
) is
true
, return
true
4.
Let
extensible
be
.[[Extensible]].
5.
If
extensible
is
false
, return
false
6.
Let
be
7.
Let
done
be
false
8.
Repeat, while
done
is
false
a.
If
is
null
, set
done
to
true
b.
Else if
SameValue
) is
true
, return
false
c.
Else,
i.
If
.[[GetPrototypeOf]] is not the
ordinary object
internal method defined in
10.1.1
, set
done
to
true
ii.
Else, set
to
.[[Prototype]].
9.
Set
.[[Prototype]] to
10.
Return
true
Note
The loop in step
guarantees that there will be no circularities in any prototype chain that only includes objects that use the
ordinary object
definitions for [[GetPrototypeOf]] and [[SetPrototypeOf]].
10.1.3
[[IsExtensible]] ( )
The [[IsExtensible]] internal method of an
ordinary object
takes no arguments. It performs the following steps when called:
1.
Return !
OrdinaryIsExtensible
).
10.1.3.1
OrdinaryIsExtensible (
The abstract operation OrdinaryIsExtensible takes argument
(an Object). It performs the following steps when called:
1.
Return
.[[Extensible]].
10.1.4
[[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of an
ordinary object
takes no arguments. It performs the following steps when called:
1.
Return !
OrdinaryPreventExtensions
).
10.1.4.1
OrdinaryPreventExtensions (
The abstract operation OrdinaryPreventExtensions takes argument
(an Object). It performs the following steps when called:
1.
Set
.[[Extensible]] to
false
2.
Return
true
10.1.5
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of an
ordinary object
takes argument
(a property key). It performs the following steps when called:
1.
Return !
OrdinaryGetOwnProperty
).
10.1.5.1
OrdinaryGetOwnProperty (
The abstract operation OrdinaryGetOwnProperty takes arguments
(an Object) and
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
does not have an own property with key
, return
undefined
3.
Let
be a newly created
Property Descriptor
with no fields.
4.
Let
be
's own property whose key is
5.
If
is a
data property
, then
a.
Set
.[[Value]] to the value of
's [[Value]] attribute.
b.
Set
.[[Writable]] to the value of
's [[Writable]] attribute.
6.
Else,
a.
Assert
is an
accessor property
b.
Set
.[[Get]] to the value of
's [[Get]] attribute.
c.
Set
.[[Set]] to the value of
's [[Set]] attribute.
7.
Set
.[[Enumerable]] to the value of
's [[Enumerable]] attribute.
8.
Set
.[[Configurable]] to the value of
's [[Configurable]] attribute.
9.
Return
10.1.6
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of an
ordinary object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Return ?
OrdinaryDefineOwnProperty
Desc
).
10.1.6.1
OrdinaryDefineOwnProperty (
Desc
The abstract operation OrdinaryDefineOwnProperty takes arguments
(an Object),
(a property key), and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Let
current
be ?
.[[GetOwnProperty]](
).
2.
Let
extensible
be ?
IsExtensible
).
3.
Return
ValidateAndApplyPropertyDescriptor
extensible
Desc
current
).
10.1.6.2
IsCompatiblePropertyDescriptor (
Extensible
Desc
Current
The abstract operation IsCompatiblePropertyDescriptor takes arguments
Extensible
(a Boolean),
Desc
(a
Property Descriptor
), and
Current
(a
Property Descriptor
). It performs the following steps when called:
1.
Return
ValidateAndApplyPropertyDescriptor
undefined
undefined
Extensible
Desc
Current
).
10.1.6.3
ValidateAndApplyPropertyDescriptor (
extensible
Desc
current
The abstract operation ValidateAndApplyPropertyDescriptor takes arguments
(an Object or
undefined
),
(a property key),
extensible
(a Boolean),
Desc
(a
Property Descriptor
), and
current
(a
Property Descriptor
). It performs the following steps when called:
Note
If
undefined
is passed as
, only validation is performed and no object updates are performed.
1.
Assert
: If
is not
undefined
, then
IsPropertyKey
) is
true
2.
If
current
is
undefined
, then
a.
If
extensible
is
false
, return
false
b.
Assert
extensible
is
true
c.
If
IsGenericDescriptor
Desc
) is
true
or
IsDataDescriptor
Desc
) is
true
, then
i.
If
is not
undefined
, create an own
data property
named
of object
whose [[Value]], [[Writable]], [[Enumerable]], and [[Configurable]] attribute values are described by
Desc
. If the value of an attribute field of
Desc
is absent, the attribute of the newly created property is set to its
default value
d.
Else,
i.
Assert
: !
IsAccessorDescriptor
Desc
) is
true
ii.
If
is not
undefined
, create an own
accessor property
named
of object
whose [[Get]], [[Set]], [[Enumerable]], and [[Configurable]] attribute values are described by
Desc
. If the value of an attribute field of
Desc
is absent, the attribute of the newly created property is set to its
default value
e.
Return
true
3.
If every field in
Desc
is absent, return
true
4.
If
current
.[[Configurable]] is
false
, then
a.
If
Desc
.[[Configurable]] is present and its value is
true
, return
false
b.
If
Desc
.[[Enumerable]] is present and !
SameValue
Desc
.[[Enumerable]],
current
.[[Enumerable]]) is
false
, return
false
5.
If !
IsGenericDescriptor
Desc
) is
true
, then
a.
NOTE: No further validation is required.
6.
Else if !
SameValue
(!
IsDataDescriptor
current
), !
IsDataDescriptor
Desc
)) is
false
, then
a.
If
current
.[[Configurable]] is
false
, return
false
b.
If
IsDataDescriptor
current
) is
true
, then
i.
If
is not
undefined
, convert the property named
of object
from a
data property
to an
accessor property
Preserve the existing values of the converted property's
[[Configurable]] and [[Enumerable]] attributes and set the rest of the
property's attributes to their
default values
c.
Else,
i.
If
is not
undefined
, convert the property named
of object
from an
accessor property
to a
data property
Preserve the existing values of the converted property's
[[Configurable]] and [[Enumerable]] attributes and set the rest of the
property's attributes to their
default values
7.
Else if
IsDataDescriptor
current
) and
IsDataDescriptor
Desc
) are both
true
, then
a.
If
current
.[[Configurable]] is
false
and
current
.[[Writable]] is
false
, then
i.
If
Desc
.[[Writable]] is present and
Desc
.[[Writable]] is
true
, return
false
ii.
If
Desc
.[[Value]] is present and
SameValue
Desc
.[[Value]],
current
.[[Value]]) is
false
, return
false
iii.
Return
true
8.
Else,
a.
Assert
: !
IsAccessorDescriptor
current
) and !
IsAccessorDescriptor
Desc
) are both
true
b.
If
current
.[[Configurable]] is
false
, then
i.
If
Desc
.[[Set]] is present and
SameValue
Desc
.[[Set]],
current
.[[Set]]) is
false
, return
false
ii.
If
Desc
.[[Get]] is present and
SameValue
Desc
.[[Get]],
current
.[[Get]]) is
false
, return
false
iii.
Return
true
9.
If
is not
undefined
, then
a.
For each field of
Desc
that is present, set the corresponding attribute of the property named
of object
to the value of the field.
10.
Return
true
10.1.7
[[HasProperty]] (
The [[HasProperty]] internal method of an
ordinary object
takes argument
(a property key). It performs the following steps when called:
1.
Return ?
OrdinaryHasProperty
).
10.1.7.1
OrdinaryHasProperty (
The abstract operation OrdinaryHasProperty takes arguments
(an Object) and
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
hasOwn
be ?
.[[GetOwnProperty]](
).
3.
If
hasOwn
is not
undefined
, return
true
4.
Let
parent
be ?
.[[GetPrototypeOf]]().
5.
If
parent
is not
null
, then
a.
Return ?
parent
.[[HasProperty]](
).
6.
Return
false
10.1.8
[[Get]] (
Receiver
The [[Get]] internal method of an
ordinary object
takes arguments
(a property key) and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Return ?
OrdinaryGet
Receiver
).
10.1.8.1
OrdinaryGet (
Receiver
The abstract operation OrdinaryGet takes arguments
(an Object),
(a property key), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
desc
be ?
.[[GetOwnProperty]](
).
3.
If
desc
is
undefined
, then
a.
Let
parent
be ?
.[[GetPrototypeOf]]().
b.
If
parent
is
null
, return
undefined
c.
Return ?
parent
.[[Get]](
Receiver
).
4.
If
IsDataDescriptor
desc
) is
true
, return
desc
.[[Value]].
5.
Assert
IsAccessorDescriptor
desc
) is
true
6.
Let
getter
be
desc
.[[Get]].
7.
If
getter
is
undefined
, return
undefined
8.
Return ?
Call
getter
Receiver
).
10.1.9
[[Set]] (
Receiver
The [[Set]] internal method of an
ordinary object
takes arguments
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Return ?
OrdinarySet
Receiver
).
10.1.9.1
OrdinarySet (
Receiver
The abstract operation OrdinarySet takes arguments
(an Object),
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
ownDesc
be ?
.[[GetOwnProperty]](
).
3.
Return
OrdinarySetWithOwnDescriptor
Receiver
ownDesc
).
10.1.9.2
OrdinarySetWithOwnDescriptor (
Receiver
ownDesc
The abstract operation OrdinarySetWithOwnDescriptor takes arguments
(an Object),
(a property key),
(an
ECMAScript language value
),
Receiver
(an
ECMAScript language value
), and
ownDesc
(a
Property Descriptor
or
undefined
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
ownDesc
is
undefined
, then
a.
Let
parent
be ?
.[[GetPrototypeOf]]().
b.
If
parent
is not
null
, then
i.
Return ?
parent
.[[Set]](
Receiver
).
c.
Else,
i.
Set
ownDesc
to the PropertyDescriptor { [[Value]]:
undefined
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
true
}.
3.
If
IsDataDescriptor
ownDesc
) is
true
, then
a.
If
ownDesc
.[[Writable]] is
false
, return
false
b.
If
Type
Receiver
) is not Object, return
false
c.
Let
existingDescriptor
be ?
Receiver
.[[GetOwnProperty]](
).
d.
If
existingDescriptor
is not
undefined
, then
i.
If
IsAccessorDescriptor
existingDescriptor
) is
true
, return
false
ii.
If
existingDescriptor
.[[Writable]] is
false
, return
false
iii.
Let
valueDesc
be the PropertyDescriptor { [[Value]]:
}.
iv.
Return ?
Receiver
.[[DefineOwnProperty]](
valueDesc
).
e.
Else,
i.
Assert
Receiver
does not currently have a property
ii.
Return ?
CreateDataProperty
Receiver
).
4.
Assert
IsAccessorDescriptor
ownDesc
) is
true
5.
Let
setter
be
ownDesc
.[[Set]].
6.
If
setter
is
undefined
, return
false
7.
Perform ?
Call
setter
Receiver
, «
»).
8.
Return
true
10.1.10
[[Delete]] (
The [[Delete]] internal method of an
ordinary object
takes argument
(a property key). It performs the following steps when called:
1.
Return ?
OrdinaryDelete
).
10.1.10.1
OrdinaryDelete (
The abstract operation OrdinaryDelete takes arguments
(an Object) and
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
desc
be ?
.[[GetOwnProperty]](
).
3.
If
desc
is
undefined
, return
true
4.
If
desc
.[[Configurable]] is
true
, then
a.
Remove the own property with name
from
b.
Return
true
5.
Return
false
10.1.11
[[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of an
ordinary object
takes no arguments. It performs the following steps when called:
1.
Return !
OrdinaryOwnPropertyKeys
).
10.1.11.1
OrdinaryOwnPropertyKeys (
The abstract operation OrdinaryOwnPropertyKeys takes argument
(an Object). It performs the following steps when called:
1.
Let
keys
be a new empty
List
2.
For each own property key
of
such that
is an
array index
, in ascending numeric index order, do
a.
Add
as the last element of
keys
3.
For each own property key
of
such that
Type
) is String and
is not an
array index
, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
4.
For each own property key
of
such that
Type
) is Symbol, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
5.
Return
keys
10.1.12
OrdinaryObjectCreate (
proto
[ ,
additionalInternalSlotsList
] )
The abstract operation OrdinaryObjectCreate takes argument
proto
(an Object or
null
) and optional argument
additionalInternalSlotsList
(a
List
of names of internal slots). It is used to specify the runtime creation of new ordinary objects.
additionalInternalSlotsList
contains the names of additional internal slots that must be defined as
part of the object, beyond [[Prototype]] and [[Extensible]]. If
additionalInternalSlotsList
is not provided, a new empty
List
is used. It performs the following steps when called:
1.
Let
internalSlotsList
be « [[Prototype]], [[Extensible]] ».
2.
If
additionalInternalSlotsList
is present, append each of its elements to
internalSlotsList
3.
Let
be !
MakeBasicObject
internalSlotsList
).
4.
Set
.[[Prototype]] to
proto
5.
Return
Note
Although OrdinaryObjectCreate does little more than call
MakeBasicObject
, its use communicates the intention to create an
ordinary object
and not an exotic one. Thus, within this specification, it is not
called by any algorithm that subsequently modifies the internal methods
of the object in ways that would make the result non-ordinary.
Operations that create exotic objects invoke
MakeBasicObject
directly.
10.1.13
OrdinaryCreateFromConstructor (
constructor
intrinsicDefaultProto
[ ,
internalSlotsList
] )
The abstract operation OrdinaryCreateFromConstructor takes arguments
constructor
and
intrinsicDefaultProto
and optional argument
internalSlotsList
(a
List
of names of internal slots). It creates an
ordinary object
whose [[Prototype]] value is retrieved from a
constructor
's
"prototype"
property, if it exists. Otherwise the intrinsic named by
intrinsicDefaultProto
is used for [[Prototype]].
internalSlotsList
contains the names of additional internal slots that must be defined as part of the object. If
internalSlotsList
is not provided, a new empty
List
is used. It performs the following steps when called:
1.
Assert
intrinsicDefaultProto
is a String value that is this specification's name of an intrinsic
object. The corresponding object must be an intrinsic that is intended
to be used as the [[Prototype]] value of an object.
2.
Let
proto
be ?
GetPrototypeFromConstructor
constructor
intrinsicDefaultProto
).
3.
Return !
OrdinaryObjectCreate
proto
internalSlotsList
).
10.1.14
GetPrototypeFromConstructor (
constructor
intrinsicDefaultProto
The abstract operation GetPrototypeFromConstructor takes arguments
constructor
and
intrinsicDefaultProto
. It determines the [[Prototype]] value that should be used to create an object corresponding to a specific
constructor
. The value is retrieved from the
constructor
's
"prototype"
property, if it exists. Otherwise the intrinsic named by
intrinsicDefaultProto
is used for [[Prototype]]. It performs the following steps when called:
1.
Assert
intrinsicDefaultProto
is a String value that is this specification's name of an intrinsic
object. The corresponding object must be an intrinsic that is intended
to be used as the [[Prototype]] value of an object.
2.
Assert
IsCallable
constructor
) is
true
3.
Let
proto
be ?
Get
constructor
"prototype"
).
4.
If
Type
proto
) is not Object, then
a.
Let
realm
be ?
GetFunctionRealm
constructor
).
b.
Set
proto
to
realm
's intrinsic object named
intrinsicDefaultProto
5.
Return
proto
Note
If
constructor
does not supply a [[Prototype]] value, the default value that is used is obtained from the
realm
of the
constructor
function rather than from the
running execution context
10.1.15
RequireInternalSlot (
internalSlot
The abstract operation RequireInternalSlot takes arguments
and
internalSlot
. It throws an exception unless
is an Object and has the given internal slot. It performs the following steps when called:
1.
If
Type
) is not Object, throw a
TypeError
exception.
2.
If
does not have an
internalSlot
internal slot, throw a
TypeError
exception.
10.2
ECMAScript Function Objects
ECMAScript function objects encapsulate parameterized ECMAScript
code closed over a lexical environment and support the dynamic
evaluation of that code. An ECMAScript
function object
is an
ordinary object
and has the same internal slots and the same internal methods as other ordinary objects. The code of an ECMAScript
function object
may be either
strict mode code
11.2.2
) or
non-strict code
. An ECMAScript
function object
whose code is
strict mode code
is called a
strict function
. One whose code is not
strict mode code
is called a
non-strict function
In addition to [[Extensible]] and [[Prototype]], ECMAScript function objects also have the internal slots listed in
Table 29
Table 29: Internal Slots of ECMAScript Function Objects
Internal Slot
Type
Description
[[Environment]]
Environment Record
The
Environment Record
that the function was closed over. Used as the outer environment when evaluating the code of the function.
[[FormalParameters]]
Parse Node
The root parse node of the source text that defines the function's formal parameter list.
[[ECMAScriptCode]]
Parse Node
The root parse node of the source text that defines the function's body.
[[ConstructorKind]]
base
derived
Whether or not the function is a derived class
constructor
[[Realm]]
Realm Record
The
realm
in which the function was created and which provides any intrinsic objects that are accessed when evaluating the function.
[[ScriptOrModule]]
Script Record
or
Module Record
The script or module in which the function was created.
[[ThisMode]]
lexical
strict
global
Defines how
this
references are interpreted within the formal parameters and code body of the function.
lexical
means that
this
refers to the
this
value of a lexically enclosing function.
strict
means that the
this
value is used exactly as provided by an invocation of the function.
global
means that a
this
value of
undefined
or
null
is interpreted as a reference to the
global object
, and any other
this
value is first passed to
ToObject
[[Strict]]
Boolean
true
if this is a
strict function
false
if this is a
non-strict function
[[HomeObject]]
Object
If the function uses
super
, this is the object whose [[GetPrototypeOf]] provides the object where
super
property lookups begin.
[[SourceText]]
sequence of Unicode code points
The
source text
that defines the function.
[[IsClassConstructor]]
Boolean
Indicates whether the function is a class
constructor
. (If
true
, invoking the function's [[Call]] will immediately throw a
TypeError
exception.)
All ECMAScript function objects have the [[Call]] internal method
defined here. ECMAScript functions that are also constructors in
addition have the [[Construct]] internal method.
10.2.1
[[Call]] (
thisArgument
argumentsList
The [[Call]] internal method of an ECMAScript
function object
takes arguments
thisArgument
(an
ECMAScript language value
) and
argumentsList
(a
List
of ECMAScript language values). It performs the following steps when called:
1.
Assert
is an ECMAScript
function object
2.
Let
callerContext
be the
running execution context
3.
Let
calleeContext
be
PrepareForOrdinaryCall
undefined
).
4.
Assert
calleeContext
is now the
running execution context
5.
If
.[[IsClassConstructor]] is
true
, then
a.
Let
error
be a newly created
TypeError
object.
b.
NOTE:
error
is created in
calleeContext
with
's associated
Realm Record
c.
Remove
calleeContext
from the
execution context stack
and restore
callerContext
as the
running execution context
d.
Return
ThrowCompletion
error
).
6.
Perform
OrdinaryCallBindThis
calleeContext
thisArgument
).
7.
Let
result
be
OrdinaryCallEvaluateBody
argumentsList
).
8.
Remove
calleeContext
from the
execution context stack
and restore
callerContext
as the
running execution context
9.
If
result
.[[Type]] is
return
, return
NormalCompletion
result
.[[Value]]).
10.
ReturnIfAbrupt
result
).
11.
Return
NormalCompletion
undefined
).
Note
When
calleeContext
is removed from the
execution context stack
in step
it must not be destroyed if it is suspended and retained for later resumption by an accessible generator object.
10.2.1.1
PrepareForOrdinaryCall (
newTarget
The abstract operation PrepareForOrdinaryCall takes arguments
(a
function object
) and
newTarget
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
Type
newTarget
) is Undefined or Object.
2.
Let
callerContext
be the
running execution context
3.
Let
calleeContext
be a new ECMAScript code
execution context
4.
Set the Function of
calleeContext
to
5.
Let
calleeRealm
be
.[[Realm]].
6.
Set the
Realm
of
calleeContext
to
calleeRealm
7.
Set the ScriptOrModule of
calleeContext
to
.[[ScriptOrModule]].
8.
Let
localEnv
be
NewFunctionEnvironment
newTarget
).
9.
Set the LexicalEnvironment of
calleeContext
to
localEnv
10.
Set the VariableEnvironment of
calleeContext
to
localEnv
11.
If
callerContext
is not already suspended, suspend
callerContext
12.
Push
calleeContext
onto the
execution context stack
calleeContext
is now the
running execution context
13.
NOTE: Any exception objects produced after this point are associated with
calleeRealm
14.
Return
calleeContext
10.2.1.2
OrdinaryCallBindThis (
calleeContext
thisArgument
The abstract operation OrdinaryCallBindThis takes arguments
(a
function object
),
calleeContext
(an
execution context
), and
thisArgument
(an
ECMAScript language value
). It performs the following steps when called:
1.
Let
thisMode
be
.[[ThisMode]].
2.
If
thisMode
is
lexical
, return
NormalCompletion
undefined
).
3.
Let
calleeRealm
be
.[[Realm]].
4.
Let
localEnv
be the LexicalEnvironment of
calleeContext
5.
If
thisMode
is
strict
, let
thisValue
be
thisArgument
6.
Else,
a.
If
thisArgument
is
undefined
or
null
, then
i.
Let
globalEnv
be
calleeRealm
.[[GlobalEnv]].
ii.
Assert
globalEnv
is a
global Environment Record
iii.
Let
thisValue
be
globalEnv
.[[GlobalThisValue]].
b.
Else,
i.
Let
thisValue
be !
ToObject
thisArgument
).
ii.
NOTE:
ToObject
produces wrapper objects using
calleeRealm
7.
Assert
localEnv
is a
function Environment Record
8.
Assert
: The next step never returns an
abrupt completion
because
localEnv
.[[ThisBindingStatus]] is not
initialized
9.
Return
localEnv
.BindThisValue(
thisValue
).
10.2.1.3
Runtime Semantics: EvaluateBody
With parameters
functionObject
and
argumentsList
(a
List
).
FunctionBody
FunctionStatementList
1.
Return ?
EvaluateFunctionBody
of
FunctionBody
with arguments
functionObject
and
argumentsList
ConciseBody
ExpressionBody
1.
Return ?
EvaluateConciseBody
of
ConciseBody
with arguments
functionObject
and
argumentsList
GeneratorBody
FunctionBody
1.
Return ?
EvaluateGeneratorBody
of
GeneratorBody
with arguments
functionObject
and
argumentsList
AsyncGeneratorBody
FunctionBody
1.
Return ?
EvaluateAsyncGeneratorBody
of
AsyncGeneratorBody
with arguments
functionObject
and
argumentsList
AsyncFunctionBody
FunctionBody
1.
Return ?
EvaluateAsyncFunctionBody
of
AsyncFunctionBody
with arguments
functionObject
and
argumentsList
AsyncConciseBody
ExpressionBody
1.
Return ?
EvaluateAsyncConciseBody
of
AsyncConciseBody
with arguments
functionObject
and
argumentsList
10.2.1.4
OrdinaryCallEvaluateBody (
argumentsList
The abstract operation OrdinaryCallEvaluateBody takes arguments
(a
function object
) and
argumentsList
(a
List
). It performs the following steps when called:
1.
Return the result of
EvaluateBody
of the parsed code that is
.[[ECMAScriptCode]] passing
and
argumentsList
as the arguments.
10.2.2
[[Construct]] (
argumentsList
newTarget
The [[Construct]] internal method of an ECMAScript
function object
takes arguments
argumentsList
(a
List
of ECMAScript language values) and
newTarget
(a
constructor
). It performs the following steps when called:
1.
Assert
is an ECMAScript
function object
2.
Assert
Type
newTarget
) is Object.
3.
Let
callerContext
be the
running execution context
4.
Let
kind
be
.[[ConstructorKind]].
5.
If
kind
is
base
, then
a.
Let
thisArgument
be ?
OrdinaryCreateFromConstructor
newTarget
"%Object.prototype%"
).
6.
Let
calleeContext
be
PrepareForOrdinaryCall
newTarget
).
7.
Assert
calleeContext
is now the
running execution context
8.
If
kind
is
base
, perform
OrdinaryCallBindThis
calleeContext
thisArgument
).
9.
Let
constructorEnv
be the LexicalEnvironment of
calleeContext
10.
Let
result
be
OrdinaryCallEvaluateBody
argumentsList
).
11.
Remove
calleeContext
from the
execution context stack
and restore
callerContext
as the
running execution context
12.
If
result
.[[Type]] is
return
, then
a.
If
Type
result
.[[Value]]) is Object, return
NormalCompletion
result
.[[Value]]).
b.
If
kind
is
base
, return
NormalCompletion
thisArgument
).
c.
If
result
.[[Value]] is not
undefined
, throw a
TypeError
exception.
13.
Else,
ReturnIfAbrupt
result
).
14.
Return ?
constructorEnv
.GetThisBinding().
10.2.3
OrdinaryFunctionCreate (
functionPrototype
sourceText
ParameterList
Body
thisMode
Scope
The abstract operation OrdinaryFunctionCreate takes arguments
functionPrototype
(an Object),
sourceText
(a sequence of Unicode code points),
ParameterList
(a
Parse Node
),
Body
(a
Parse Node
),
thisMode
(either
lexical-this
or
non-lexical-this
), and
Scope
(an
Environment Record
).
sourceText
is the source text of the syntactic definition of the function to be created. It performs the following steps when called:
1.
Assert
Type
functionPrototype
) is Object.
2.
Let
internalSlotsList
be the internal slots listed in
Table 29
3.
Let
be !
OrdinaryObjectCreate
functionPrototype
internalSlotsList
).
4.
Set
.[[Call]] to the definition specified in
10.2.1
5.
Set
.[[SourceText]] to
sourceText
6.
Set
.[[FormalParameters]] to
ParameterList
7.
Set
.[[ECMAScriptCode]] to
Body
8.
If the source text matching
Body
is
strict mode code
, let
Strict
be
true
; else let
Strict
be
false
9.
Set
.[[Strict]] to
Strict
10.
If
thisMode
is
lexical-this
, set
.[[ThisMode]] to
lexical
11.
Else if
Strict
is
true
, set
.[[ThisMode]] to
strict
12.
Else, set
.[[ThisMode]] to
global
13.
Set
.[[IsClassConstructor]] to
false
14.
Set
.[[Environment]] to
Scope
15.
Set
.[[ScriptOrModule]] to
GetActiveScriptOrModule
().
16.
Set
.[[Realm]] to
the current Realm Record
17.
Set
.[[HomeObject]] to
undefined
18.
Let
len
be the
ExpectedArgumentCount
of
ParameterList
19.
Perform !
SetFunctionLength
len
).
20.
Return
10.2.4
AddRestrictedFunctionProperties (
realm
The abstract operation AddRestrictedFunctionProperties takes arguments
(a
function object
) and
realm
(a
Realm Record
). It performs the following steps when called:
1.
Assert
realm
.[[Intrinsics]].[[
%ThrowTypeError%
]] exists and has been initialized.
2.
Let
thrower
be
realm
.[[Intrinsics]].[[
%ThrowTypeError%
]].
3.
Perform !
DefinePropertyOrThrow
"caller"
, PropertyDescriptor { [[Get]]:
thrower
, [[Set]]:
thrower
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
4.
Return !
DefinePropertyOrThrow
"arguments"
, PropertyDescriptor { [[Get]]:
thrower
, [[Set]]:
thrower
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
10.2.4.1
%ThrowTypeError% ( )
The
%ThrowTypeError%
intrinsic is an anonymous built-in
function object
that is defined once for each
realm
. When %ThrowTypeError% is called it performs the following steps:
1.
Throw a
TypeError
exception.
The value of the [[Extensible]] internal slot of a %ThrowTypeError% function is
false
The
"length"
property of a %ThrowTypeError% function has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
The
"name"
property of a %ThrowTypeError% function has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
10.2.5
MakeConstructor (
[ ,
writablePrototype
[ ,
prototype
] ] )
The abstract operation MakeConstructor takes argument
(a
function object
) and optional arguments
writablePrototype
(a Boolean) and
prototype
(an Object). It converts
into a
constructor
. It performs the following steps when called:
1.
Assert
is an ECMAScript
function object
or a built-in
function object
2.
If
is an ECMAScript
function object
, then
a.
Assert
IsConstructor
) is
false
b.
Assert
is an extensible object that does not have a
"prototype"
own property.
c.
Set
.[[Construct]] to the definition specified in
10.2.2
3.
Set
.[[ConstructorKind]] to
base
4.
If
writablePrototype
is not present, set
writablePrototype
to
true
5.
If
prototype
is not present, then
a.
Set
prototype
to !
OrdinaryObjectCreate
%Object.prototype%
).
b.
Perform !
DefinePropertyOrThrow
prototype
"constructor"
, PropertyDescriptor { [[Value]]:
, [[Writable]]:
writablePrototype
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
6.
Perform !
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
writablePrototype
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
7.
Return
NormalCompletion
undefined
).
10.2.6
MakeClassConstructor (
The abstract operation MakeClassConstructor takes argument
. It performs the following steps when called:
1.
Assert
is an ECMAScript
function object
2.
Assert
.[[IsClassConstructor]] is
false
3.
Set
.[[IsClassConstructor]] to
true
4.
Return
NormalCompletion
undefined
).
10.2.7
MakeMethod (
homeObject
The abstract operation MakeMethod takes arguments
and
homeObject
. It configures
as a method. It performs the following steps when called:
1.
Assert
is an ECMAScript
function object
2.
Assert
Type
homeObject
) is Object.
3.
Set
.[[HomeObject]] to
homeObject
4.
Return
NormalCompletion
undefined
).
10.2.8
SetFunctionName (
name
[ ,
prefix
] )
The abstract operation SetFunctionName takes arguments
(a
function object
) and
name
(a property key) and optional argument
prefix
(a String). It adds a
"name"
property to
. It performs the following steps when called:
1.
Assert
is an extensible object that does not have a
"name"
own property.
2.
Assert
Type
name
) is either Symbol or String.
3.
Assert
: If
prefix
is present, then
Type
prefix
) is String.
4.
If
Type
name
) is Symbol, then
a.
Let
description
be
name
's [[Description]] value.
b.
If
description
is
undefined
, set
name
to the empty String.
c.
Else, set
name
to the
string-concatenation
of
"["
description
, and
"]"
5.
If
has an [[InitialName]] internal slot, then
a.
Set
.[[InitialName]] to
name
6.
If
prefix
is present, then
a.
Set
name
to the
string-concatenation
of
prefix
, the code unit 0x0020 (SPACE), and
name
b.
If
has an [[InitialName]] internal slot, then
i.
Optionally, set
.[[InitialName]] to
name
7.
Return !
DefinePropertyOrThrow
"name"
, PropertyDescriptor { [[Value]]:
name
, [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
10.2.9
SetFunctionLength (
length
The abstract operation SetFunctionLength takes arguments
(a
function object
) and
length
(a non-negative
integer
or +∞). It adds a
"length"
property to
. It performs the following steps when called:
1.
Assert
is an extensible object that does not have a
"length"
own property.
2.
Return !
DefinePropertyOrThrow
"length"
, PropertyDescriptor { [[Value]]:
length
), [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
10.2.10
FunctionDeclarationInstantiation (
func
argumentsList
Note 1
When an
execution context
is established for evaluating an ECMAScript function a new
function Environment Record
is created and bindings for each formal parameter are instantiated in that
Environment Record
Each declaration in the function body is also instantiated. If the
function's formal parameters do not include any default value
initializers then the body declarations are instantiated in the same
Environment Record
as the parameters. If default value parameter initializers exist, a second
Environment Record
is created for the body declarations. Formal parameters and functions
are initialized as part of FunctionDeclarationInstantiation. All other
bindings are initialized during evaluation of the function body.
The abstract operation FunctionDeclarationInstantiation takes arguments
func
(a
function object
) and
argumentsList
func
is the
function object
for which the
execution context
is being established. It performs the following steps when called:
1.
Let
calleeContext
be the
running execution context
2.
Let
code
be
func
.[[ECMAScriptCode]].
3.
Let
strict
be
func
.[[Strict]].
4.
Let
formals
be
func
.[[FormalParameters]].
5.
Let
parameterNames
be the
BoundNames
of
formals
6.
If
parameterNames
has any duplicate entries, let
hasDuplicates
be
true
. Otherwise, let
hasDuplicates
be
false
7.
Let
simpleParameterList
be
IsSimpleParameterList
of
formals
8.
Let
hasParameterExpressions
be
ContainsExpression
of
formals
9.
Let
varNames
be the
VarDeclaredNames
of
code
10.
Let
varDeclarations
be the
VarScopedDeclarations
of
code
11.
Let
lexicalNames
be the
LexicallyDeclaredNames
of
code
12.
Let
functionNames
be a new empty
List
13.
Let
functionsToInitialize
be a new empty
List
14.
For each element
of
varDeclarations
, in reverse
List
order, do
a.
If
is neither a
VariableDeclaration
nor a
ForBinding
nor a
BindingIdentifier
, then
i.
Assert
is either a
FunctionDeclaration
, a
GeneratorDeclaration
, an
AsyncFunctionDeclaration
, or an
AsyncGeneratorDeclaration
ii.
Let
fn
be the sole element of the
BoundNames
of
iii.
If
fn
is not an element of
functionNames
, then
1.
Insert
fn
as the first element of
functionNames
2.
NOTE: If there are multiple function declarations for the same name, the last declaration is used.
3.
Insert
as the first element of
functionsToInitialize
15.
Let
argumentsObjectNeeded
be
true
16.
If
func
.[[ThisMode]] is
lexical
, then
a.
NOTE: Arrow functions never have an arguments objects.
b.
Set
argumentsObjectNeeded
to
false
17.
Else if
"arguments"
is an element of
parameterNames
, then
a.
Set
argumentsObjectNeeded
to
false
18.
Else if
hasParameterExpressions
is
false
, then
a.
If
"arguments"
is an element of
functionNames
or if
"arguments"
is an element of
lexicalNames
, then
i.
Set
argumentsObjectNeeded
to
false
19.
If
strict
is
true
or if
hasParameterExpressions
is
false
, then
a.
NOTE: Only a single
Environment Record
is needed for the parameters and top-level vars.
b.
Let
env
be the LexicalEnvironment of
calleeContext
20.
Else,
a.
NOTE: A separate
Environment Record
is needed to ensure that bindings created by
direct eval
calls in the formal parameter list are outside the environment where parameters are declared.
b.
Let
calleeEnv
be the LexicalEnvironment of
calleeContext
c.
Let
env
be
NewDeclarativeEnvironment
calleeEnv
).
d.
Assert
: The VariableEnvironment of
calleeContext
is
calleeEnv
e.
Set the LexicalEnvironment of
calleeContext
to
env
21.
For each String
paramName
of
parameterNames
, do
a.
Let
alreadyDeclared
be
env
.HasBinding(
paramName
).
b.
NOTE:
Early errors ensure that duplicate parameter names can only occur in
non-strict functions that do not have parameter default values or rest
parameters.
c.
If
alreadyDeclared
is
false
, then
i.
Perform !
env
.CreateMutableBinding(
paramName
false
).
ii.
If
hasDuplicates
is
true
, then
1.
Perform !
env
.InitializeBinding(
paramName
undefined
).
22.
If
argumentsObjectNeeded
is
true
, then
a.
If
strict
is
true
or if
simpleParameterList
is
false
, then
i.
Let
ao
be
CreateUnmappedArgumentsObject
argumentsList
).
b.
Else,
i.
NOTE:
A mapped argument object is only provided for non-strict functions that
don't have a rest parameter, any parameter default value initializers,
or any destructured parameters.
ii.
Let
ao
be
CreateMappedArgumentsObject
func
formals
argumentsList
env
).
c.
If
strict
is
true
, then
i.
Perform !
env
.CreateImmutableBinding(
"arguments"
false
).
d.
Else,
i.
Perform !
env
.CreateMutableBinding(
"arguments"
false
).
e.
Call
env
.InitializeBinding(
"arguments"
ao
).
f.
Let
parameterBindings
be a
List
whose elements are the elements of
parameterNames
, followed by
"arguments"
23.
Else,
a.
Let
parameterBindings
be
parameterNames
24.
Let
iteratorRecord
be
CreateListIteratorRecord
argumentsList
).
25.
If
hasDuplicates
is
true
, then
a.
Perform ?
IteratorBindingInitialization
for
formals
with
iteratorRecord
and
undefined
as arguments.
26.
Else,
a.
Perform ?
IteratorBindingInitialization
for
formals
with
iteratorRecord
and
env
as arguments.
27.
If
hasParameterExpressions
is
false
, then
a.
NOTE: Only a single
Environment Record
is needed for the parameters and top-level vars.
b.
Let
instantiatedVarNames
be a copy of the
List
parameterBindings
c.
For each element
of
varNames
, do
i.
If
is not an element of
instantiatedVarNames
, then
1.
Append
to
instantiatedVarNames
2.
Perform !
env
.CreateMutableBinding(
false
).
3.
Call
env
.InitializeBinding(
undefined
).
d.
Let
varEnv
be
env
28.
Else,
a.
NOTE: A separate
Environment Record
is needed to ensure that closures created by expressions in the formal
parameter list do not have visibility of declarations in the function
body.
b.
Let
varEnv
be
NewDeclarativeEnvironment
env
).
c.
Set the VariableEnvironment of
calleeContext
to
varEnv
d.
Let
instantiatedVarNames
be a new empty
List
e.
For each element
of
varNames
, do
i.
If
is not an element of
instantiatedVarNames
, then
1.
Append
to
instantiatedVarNames
2.
Perform !
varEnv
.CreateMutableBinding(
false
).
3.
If
is not an element of
parameterBindings
or if
is an element of
functionNames
, let
initialValue
be
undefined
4.
Else,
a.
Let
initialValue
be !
env
.GetBindingValue(
false
).
5.
Call
varEnv
.InitializeBinding(
initialValue
).
6.
NOTE: A var with the same name as a formal parameter initially has the same value as the corresponding initialized parameter.
29.
NOTE: Annex
B.3.3.1
adds additional steps at this point.
30.
If
strict
is
false
, then
a.
Let
lexEnv
be
NewDeclarativeEnvironment
varEnv
).
b.
NOTE: Non-strict functions use a separate
Environment Record
for top-level lexical declarations so that a
direct eval
can determine whether any var scoped declarations introduced by the
eval code conflict with pre-existing top-level lexically scoped
declarations. This is not needed for strict functions because a strict
direct eval
always places all declarations into a new
Environment Record
31.
Else, let
lexEnv
be
varEnv
32.
Set the LexicalEnvironment of
calleeContext
to
lexEnv
33.
Let
lexDeclarations
be the
LexicallyScopedDeclarations
of
code
34.
For each element
of
lexDeclarations
, do
a.
NOTE:
A lexically declared name cannot be the same as a function/generator
declaration, formal parameter, or a var name. Lexically declared names
are only instantiated here but not initialized.
b.
For each element
dn
of the
BoundNames
of
, do
i.
If
IsConstantDeclaration
of
is
true
, then
1.
Perform !
lexEnv
.CreateImmutableBinding(
dn
true
).
ii.
Else,
1.
Perform !
lexEnv
.CreateMutableBinding(
dn
false
).
35.
For each
Parse Node
of
functionsToInitialize
, do
a.
Let
fn
be the sole element of the
BoundNames
of
b.
Let
fo
be
InstantiateFunctionObject
of
with argument
lexEnv
c.
Perform !
varEnv
.SetMutableBinding(
fn
fo
false
).
36.
Return
NormalCompletion
empty
).
Note 2
B.3.3
provides an extension to the above algorithm that is necessary for
backwards compatibility with web browser implementations of ECMAScript
that predate ECMAScript 2015.
Note 3
Parameter
Initializer
s may contain
direct eval
expressions. Any top level declarations of such evals are only visible to the eval code (
11.2
). The creation of the environment for such declarations is described in
8.5.3
10.3
Built-in Function Objects
The built-in function objects defined in this specification may be implemented as either ECMAScript function objects (
10.2
whose behaviour is provided using ECMAScript code or as implementation
provided function exotic objects whose behaviour is provided in some
other manner. In either case, the effect of calling such functions must
conform to their specifications. An implementation may also provide
additional built-in function objects that are not defined in this
specification.
If a built-in
function object
is implemented as an
exotic object
it must have the
ordinary object
behaviour specified in
10.1
. All such function exotic objects also have [[Prototype]], [[Extensible]], and [[Realm]] internal slots.
Unless otherwise specified every built-in
function object
has the
%Function.prototype%
object as the initial value of its [[Prototype]] internal slot.
The behaviour specified for each built-in function via algorithm
steps or other means is the specification of the function body behaviour
for both [[Call]] and [[Construct]] invocations of the function.
However, [[Construct]] invocation is not supported by all built-in
functions. For each built-in function, when invoked with [[Call]], the
[[Call]]
thisArgument
provides the
this
value, the [[Call]]
argumentsList
provides the named parameters, and the NewTarget value is
undefined
. When invoked with [[Construct]], the
this
value is uninitialized, the [[Construct]]
argumentsList
provides the named parameters, and the [[Construct]]
newTarget
parameter provides the NewTarget value. If the built-in function is implemented as an ECMAScript
function object
then this specified behaviour must be implemented by the ECMAScript
code that is the body of the function. Built-in functions that are
ECMAScript function objects must be strict functions. If a built-in
constructor
has any [[Call]] behaviour other than throwing a
TypeError
exception, an ECMAScript implementation of the function must be done in
a manner that does not cause the function's [[IsClassConstructor]]
internal slot to have the value
true
Built-in function objects that are not identified as constructors
do not implement the [[Construct]] internal method unless otherwise
specified in the description of a particular function. When a built-in
constructor
is called as part of a
new
expression the
argumentsList
parameter of the invoked [[Construct]] internal method provides the values for the built-in
constructor
's named parameters.
Built-in functions that are not constructors do not have a
"prototype"
property unless otherwise specified in the description of a particular function.
Built-in functions have an [[InitialName]] internal slot.
If a built-in
function object
is not implemented as an ECMAScript function it must provide [[Call]]
and [[Construct]] internal methods that conform to the following
definitions:
10.3.1
[[Call]] (
thisArgument
argumentsList
The [[Call]] internal method of a built-in
function object
takes arguments
thisArgument
(an
ECMAScript language value
) and
argumentsList
(a
List
of ECMAScript language values). It performs the following steps when called:
1.
Let
callerContext
be the
running execution context
2.
If
callerContext
is not already suspended, suspend
callerContext
3.
Let
calleeContext
be a new
execution context
4.
Set the Function of
calleeContext
to
5.
Let
calleeRealm
be
.[[Realm]].
6.
Set the
Realm
of
calleeContext
to
calleeRealm
7.
Set the ScriptOrModule of
calleeContext
to
null
8.
Perform any necessary
implementation-defined
initialization of
calleeContext
9.
Push
calleeContext
onto the
execution context stack
calleeContext
is now the
running execution context
10.
Let
result
be the
Completion Record
that is the result of evaluating
in a manner that conforms to the specification of
thisArgument
is the
this
value,
argumentsList
provides the named parameters, and the NewTarget value is
undefined
11.
Remove
calleeContext
from the
execution context stack
and restore
callerContext
as the
running execution context
12.
Return
result
Note
When
calleeContext
is removed from the
execution context stack
it must not be destroyed if it has been suspended and retained by an accessible generator object for later resumption.
10.3.2
[[Construct]] (
argumentsList
newTarget
The [[Construct]] internal method of a built-in
function object
takes arguments
argumentsList
(a
List
of ECMAScript language values) and
newTarget
(a
constructor
). The steps performed are the same as [[Call]] (see
10.3.1
) except that step
10
is replaced by:
1.
Let
result
be the
Completion Record
that is the result of evaluating
in a manner that conforms to the specification of
. The
this
value is uninitialized,
argumentsList
provides the named parameters, and
newTarget
provides the NewTarget value.
10.3.3
CreateBuiltinFunction (
steps
length
name
internalSlotsList
[ ,
realm
[ ,
prototype
[ ,
prefix
] ] ] )
The abstract operation CreateBuiltinFunction takes arguments
steps
length
name
, and
internalSlotsList
(a
List
of names of internal slots) and optional arguments
realm
prototype
, and
prefix
internalSlotsList
contains the names of additional internal slots that must be defined as part of the object. This operation creates a built-in
function object
. It performs the following steps when called:
1.
Assert
steps
is either a set of algorithm steps or other definition of a function's behaviour provided in this specification.
2.
If
realm
is not present or
realm
is
empty
, set
realm
to
the current Realm Record
3.
Assert
realm
is a
Realm Record
4.
If
prototype
is not present, set
prototype
to
realm
.[[Intrinsics]].[[
%Function.prototype%
]].
5.
Let
func
be a new built-in
function object
that when called performs the action described by
steps
. The new
function object
has internal slots whose names are the elements of
internalSlotsList
, and an [[InitialName]] internal slot.
6.
Set
func
.[[Realm]] to
realm
7.
Set
func
.[[Prototype]] to
prototype
8.
Set
func
.[[Extensible]] to
true
9.
Set
func
.[[InitialName]] to
null
10.
Perform !
SetFunctionLength
func
length
).
11.
If
prefix
is not present, then
a.
Perform !
SetFunctionName
func
name
).
12.
Else,
a.
Perform !
SetFunctionName
func
name
prefix
).
13.
Return
func
Each built-in function defined in this specification is created by calling the CreateBuiltinFunction abstract operation.
10.4
Built-in Exotic Object Internal Methods and Slots
This specification defines several kinds of built-in exotic
objects. These objects generally behave similar to ordinary objects
except for a few specific situations. The following exotic objects use
the
ordinary object
internal methods except where it is explicitly specified otherwise below:
10.4.1
Bound Function Exotic Objects
bound function exotic object
is an
exotic object
that wraps another
function object
. A
bound function exotic object
is callable (it has a [[Call]] internal method and may have a [[Construct]] internal method). Calling a
bound function exotic object
generally results in a call of its wrapped function.
An object is a
bound function exotic object
if its [[Call]] and (if applicable) [[Construct]] internal methods use
the following implementations, and its other essential internal methods
use the definitions found in
10.1
. These methods are installed in
BoundFunctionCreate
Bound function exotic objects do not have the internal slots of ECMAScript function objects listed in
Table 29
. Instead they have the internal slots listed in
Table 30
, in addition to [[Prototype]] and [[Extensible]].
Table 30: Internal Slots of Bound Function Exotic Objects
Internal Slot
Type
Description
[[BoundTargetFunction]]
Callable Object
The wrapped
function object
[[BoundThis]]
Any
The value that is always passed as the
this
value when calling the wrapped function.
[[BoundArguments]]
List
of Any
A list of values whose elements are used as the first arguments to any call to the wrapped function.
10.4.1.1
[[Call]] (
thisArgument
argumentsList
The [[Call]] internal method of a
bound function exotic object
takes arguments
thisArgument
(an
ECMAScript language value
) and
argumentsList
(a
List
of ECMAScript language values). It performs the following steps when called:
1.
Let
target
be
.[[BoundTargetFunction]].
2.
Let
boundThis
be
.[[BoundThis]].
3.
Let
boundArgs
be
.[[BoundArguments]].
4.
Let
args
be a
List
whose elements are the elements of
boundArgs
, followed by the elements of
argumentsList
5.
Return ?
Call
target
boundThis
args
).
10.4.1.2
[[Construct]] (
argumentsList
newTarget
The [[Construct]] internal method of a
bound function exotic object
takes arguments
argumentsList
(a
List
of ECMAScript language values) and
newTarget
(a
constructor
). It performs the following steps when called:
1.
Let
target
be
.[[BoundTargetFunction]].
2.
Assert
IsConstructor
target
) is
true
3.
Let
boundArgs
be
.[[BoundArguments]].
4.
Let
args
be a
List
whose elements are the elements of
boundArgs
, followed by the elements of
argumentsList
5.
If
SameValue
newTarget
) is
true
, set
newTarget
to
target
6.
Return ?
Construct
target
args
newTarget
).
10.4.1.3
BoundFunctionCreate (
targetFunction
boundThis
boundArgs
The abstract operation BoundFunctionCreate takes arguments
targetFunction
boundThis
, and
boundArgs
. It is used to specify the creation of new
bound function
exotic objects. It performs the following steps when called:
1.
Assert
Type
targetFunction
) is Object.
2.
Let
proto
be ?
targetFunction
.[[GetPrototypeOf]]().
3.
Let
internalSlotsList
be the internal slots listed in
Table 30
, plus [[Prototype]] and [[Extensible]].
4.
Let
obj
be !
MakeBasicObject
internalSlotsList
).
5.
Set
obj
.[[Prototype]] to
proto
6.
Set
obj
.[[Call]] as described in
10.4.1.1
7.
If
IsConstructor
targetFunction
) is
true
, then
a.
Set
obj
.[[Construct]] as described in
10.4.1.2
8.
Set
obj
.[[BoundTargetFunction]] to
targetFunction
9.
Set
obj
.[[BoundThis]] to
boundThis
10.
Set
obj
.[[BoundArguments]] to
boundArgs
11.
Return
obj
10.4.2
Array Exotic Objects
An Array object is an
exotic object
that gives special treatment to
array index
property keys (see
6.1.7
). A property whose
property name
is an
array index
is also called an
element
. Every Array object has a non-configurable
"length"
property whose value is always a non-negative
integral Number
whose
mathematical value
is less than 2
32
. The value of the
"length"
property is numerically greater than the name of every own property whose name is an
array index
whenever an own property of an Array object is created or changed,
other properties are adjusted as necessary to maintain this invariant.
Specifically, whenever an own property is added whose name is an
array index
, the value of the
"length"
property is changed, if necessary, to be one more than the numeric value of that
array index
; and whenever the value of the
"length"
property is changed, every own property whose name is an
array index
whose value is not smaller than the new length is deleted. This
constraint applies only to own properties of an Array object and is
unaffected by
"length"
or
array index
properties that may be inherited from its prototypes.
Note
A String
property name
is an
array index
if and only if
ToString
ToUint32
)) equals
and
ToUint32
) is not the same value as
32
- 1
).
An object is an
Array exotic object
(or simply, an Array object) if its [[DefineOwnProperty]] internal
method uses the following implementation, and its other essential
internal methods use the definitions found in
10.1
. These methods are installed in
ArrayCreate
10.4.2.1
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of an
Array exotic object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
is
"length"
, then
a.
Return ?
ArraySetLength
Desc
).
3.
Else if
is an
array index
, then
a.
Let
oldLenDesc
be
OrdinaryGetOwnProperty
"length"
).
b.
Assert
: !
IsDataDescriptor
oldLenDesc
) is
true
c.
Assert
oldLenDesc
.[[Configurable]] is
false
d.
Let
oldLen
be
oldLenDesc
.[[Value]].
e.
Assert
oldLen
is a non-negative
integral Number
f.
Let
index
be !
ToUint32
).
g.
If
index
oldLen
and
oldLenDesc
.[[Writable]] is
false
, return
false
h.
Let
succeeded
be !
OrdinaryDefineOwnProperty
Desc
).
i.
If
succeeded
is
false
, return
false
j.
If
index
oldLen
, then
i.
Set
oldLenDesc
.[[Value]] to
index
ii.
Let
succeeded
be
OrdinaryDefineOwnProperty
"length"
oldLenDesc
).
iii.
Assert
succeeded
is
true
k.
Return
true
4.
Return
OrdinaryDefineOwnProperty
Desc
).
10.4.2.2
ArrayCreate (
length
[ ,
proto
] )
The abstract operation ArrayCreate takes argument
length
(a non-negative
integer
) and optional argument
proto
. It is used to specify the creation of new Array exotic objects. It performs the following steps when called:
1.
If
length
> 2
32
- 1, throw a
RangeError
exception.
2.
If
proto
is not present, set
proto
to
%Array.prototype%
3.
Let
be !
MakeBasicObject
(« [[Prototype]], [[Extensible]] »).
4.
Set
.[[Prototype]] to
proto
5.
Set
.[[DefineOwnProperty]] as specified in
10.4.2.1
6.
Perform !
OrdinaryDefineOwnProperty
"length"
, PropertyDescriptor { [[Value]]:
length
), [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
7.
Return
10.4.2.3
ArraySpeciesCreate (
originalArray
length
The abstract operation ArraySpeciesCreate takes arguments
originalArray
and
length
(a non-negative
integer
). It is used to specify the creation of a new Array object using a
constructor
function that is derived from
originalArray
. It performs the following steps when called:
1.
Let
isArray
be ?
IsArray
originalArray
).
2.
If
isArray
is
false
, return ?
ArrayCreate
length
).
3.
Let
be ?
Get
originalArray
"constructor"
).
4.
If
IsConstructor
) is
true
, then
a.
Let
thisRealm
be
the current Realm Record
b.
Let
realmC
be ?
GetFunctionRealm
).
c.
If
thisRealm
and
realmC
are not the same
Realm Record
, then
i.
If
SameValue
realmC
.[[Intrinsics]].[[
%Array%
]]) is
true
, set
to
undefined
5.
If
Type
) is Object, then
a.
Set
to ?
Get
@@species
).
b.
If
is
null
, set
to
undefined
6.
If
is
undefined
, return ?
ArrayCreate
length
).
7.
If
IsConstructor
) is
false
, throw a
TypeError
exception.
8.
Return ?
Construct
, «
length
) »).
Note
If
originalArray
was created using the standard built-in Array
constructor
for a
realm
that is not the
realm
of the
running execution context
, then a new Array is created using the
realm
of the
running execution context
. This maintains compatibility with Web browsers that have historically had that behaviour for the
Array.prototype
methods that now are defined using ArraySpeciesCreate.
10.4.2.4
ArraySetLength (
Desc
The abstract operation ArraySetLength takes arguments
(an Array object) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
If
Desc
.[[Value]] is absent, then
a.
Return
OrdinaryDefineOwnProperty
"length"
Desc
).
2.
Let
newLenDesc
be a copy of
Desc
3.
Let
newLen
be ?
ToUint32
Desc
.[[Value]]).
4.
Let
numberLen
be ?
ToNumber
Desc
.[[Value]]).
5.
If
newLen
is not the same value as
numberLen
, throw a
RangeError
exception.
6.
Set
newLenDesc
.[[Value]] to
newLen
7.
Let
oldLenDesc
be
OrdinaryGetOwnProperty
"length"
).
8.
Assert
: !
IsDataDescriptor
oldLenDesc
) is
true
9.
Assert
oldLenDesc
.[[Configurable]] is
false
10.
Let
oldLen
be
oldLenDesc
.[[Value]].
11.
If
newLen
oldLen
, then
a.
Return
OrdinaryDefineOwnProperty
"length"
newLenDesc
).
12.
If
oldLenDesc
.[[Writable]] is
false
, return
false
13.
If
newLenDesc
.[[Writable]] is absent or has the value
true
, let
newWritable
be
true
14.
Else,
a.
NOTE: Setting the [[Writable]] attribute to
false
is deferred in case any elements cannot be deleted.
b.
Let
newWritable
be
false
c.
Set
newLenDesc
.[[Writable]] to
true
15.
Let
succeeded
be !
OrdinaryDefineOwnProperty
"length"
newLenDesc
).
16.
If
succeeded
is
false
, return
false
17.
For each own property key
of
that is an
array index
, whose numeric value is greater than or equal to
newLen
, in descending numeric index order, do
a.
Let
deleteSucceeded
be !
.[[Delete]](
).
b.
If
deleteSucceeded
is
false
, then
i.
Set
newLenDesc
.[[Value]] to !
ToUint32
) +
ii.
If
newWritable
is
false
, set
newLenDesc
.[[Writable]] to
false
iii.
Perform !
OrdinaryDefineOwnProperty
"length"
newLenDesc
).
iv.
Return
false
18.
If
newWritable
is
false
, then
a.
Let
succeeded
be !
OrdinaryDefineOwnProperty
"length"
, PropertyDescriptor { [[Writable]]:
false
}).
b.
Assert
succeeded
is
true
19.
Return
true
Note
In steps
and
, if
Desc
.[[Value]] is an object then its
valueOf
method is called twice. This is legacy behaviour that was specified with this effect starting with the 2
nd
Edition of this specification.
10.4.3
String Exotic Objects
A String object is an
exotic object
that encapsulates a String value and exposes virtual
integer
-indexed
data properties corresponding to the individual code unit elements of
the String value. String exotic objects always have a
data property
named
"length"
whose value is the number of code unit elements in the encapsulated String value. Both the code unit data properties and the
"length"
property are non-writable and non-configurable.
An object is a
String exotic object
(or simply, a String object) if its [[GetOwnProperty]],
[[DefineOwnProperty]], and [[OwnPropertyKeys]] internal methods use the
following implementations, and its other essential internal methods use
the definitions found in
10.1
. These methods are installed in
StringCreate
String exotic objects have the same internal slots as ordinary objects. They also have a [[StringData]] internal slot.
10.4.3.1
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of a
String exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
desc
be
OrdinaryGetOwnProperty
).
3.
If
desc
is not
undefined
, return
desc
4.
Return !
StringGetOwnProperty
).
10.4.3.2
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of a
String exotic object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
stringDesc
be !
StringGetOwnProperty
).
3.
If
stringDesc
is not
undefined
, then
a.
Let
extensible
be
.[[Extensible]].
b.
Return !
IsCompatiblePropertyDescriptor
extensible
Desc
stringDesc
).
4.
Return !
OrdinaryDefineOwnProperty
Desc
).
10.4.3.3
[[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a
String exotic object
takes no arguments. It performs the following steps when called:
1.
Let
keys
be a new empty
List
2.
Let
str
be
.[[StringData]].
3.
Assert
Type
str
) is String.
4.
Let
len
be the length of
str
5.
For each
integer
starting with 0 such that
len
, in ascending order, do
a.
Add !
ToString
)) as the last element of
keys
6.
For each own property key
of
such that
is an
array index
and !
ToIntegerOrInfinity
) ≥
len
, in ascending numeric index order, do
a.
Add
as the last element of
keys
7.
For each own property key
of
such that
Type
) is String and
is not an
array index
, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
8.
For each own property key
of
such that
Type
) is Symbol, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
9.
Return
keys
10.4.3.4
StringCreate (
value
prototype
The abstract operation StringCreate takes arguments
value
(a String) and
prototype
. It is used to specify the creation of new String exotic objects. It performs the following steps when called:
1.
Let
be !
MakeBasicObject
(« [[Prototype]], [[Extensible]], [[StringData]] »).
2.
Set
.[[Prototype]] to
prototype
3.
Set
.[[StringData]] to
value
4.
Set
.[[GetOwnProperty]] as specified in
10.4.3.1
5.
Set
.[[DefineOwnProperty]] as specified in
10.4.3.2
6.
Set
.[[OwnPropertyKeys]] as specified in
10.4.3.3
7.
Let
length
be the number of code unit elements in
value
8.
Perform !
DefinePropertyOrThrow
"length"
, PropertyDescriptor { [[Value]]:
length
), [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
9.
Return
10.4.3.5
StringGetOwnProperty (
The abstract operation StringGetOwnProperty takes arguments
and
. It performs the following steps when called:
1.
Assert
is an Object that has a [[StringData]] internal slot.
2.
Assert
IsPropertyKey
) is
true
3.
If
Type
) is not String, return
undefined
4.
Let
index
be !
CanonicalNumericIndexString
).
5.
If
index
is
undefined
, return
undefined
6.
If
IsIntegralNumber
index
) is
false
, return
undefined
7.
If
index
is
-0
, return
undefined
8.
Let
str
be
.[[StringData]].
9.
Assert
Type
str
) is String.
10.
Let
len
be the length of
str
11.
If
index
) < 0 or
len
index
), return
undefined
12.
Let
resultStr
be the String value of length 1, containing one code unit from
str
, specifically the code unit at index
index
).
13.
Return the PropertyDescriptor { [[Value]]:
resultStr
, [[Writable]]:
false
, [[Enumerable]]:
true
, [[Configurable]]:
false
}.
10.4.4
Arguments Exotic Objects
Most ECMAScript functions make an arguments object available to
their code. Depending upon the characteristics of the function
definition, its arguments object is either an
ordinary object
or an
arguments exotic object
. An
arguments exotic object
is an
exotic object
whose
array index
properties map to the formal parameters bindings of an invocation of its associated ECMAScript function.
An object is an
arguments exotic object
if its internal methods use the following implementations, with the ones not specified here using those found in
10.1
. These methods are installed in
CreateMappedArgumentsObject
Note 1
While
CreateUnmappedArgumentsObject
is grouped into this clause, it creates an
ordinary object
, not an
arguments exotic object
Arguments exotic objects have the same internal slots as
ordinary objects. They also have a [[ParameterMap]] internal slot.
Ordinary arguments objects also have a [[ParameterMap]] internal slot
whose value is always undefined. For ordinary argument objects the
[[ParameterMap]] internal slot is only used by
Object.prototype.toString
20.1.3.6
) to identify them as such.
Note 2
The
integer
-indexed data properties of an
arguments exotic object
whose numeric name values are less than the number of formal parameters of the corresponding
function object
initially share their values with the corresponding argument bindings in the function's
execution context
This means that changing the property changes the corresponding value
of the argument binding and vice-versa. This correspondence is broken if
such a property is deleted and then redefined or if the property is
changed into an
accessor property
. If the arguments object is an
ordinary object
the values of its properties are simply a copy of the arguments passed
to the function and there is no dynamic linkage between the property
values and the formal parameter values.
Note 3
The ParameterMap object and its property values are used as a
device for specifying the arguments object correspondence to argument
bindings. The ParameterMap object and the objects that are the values of
its properties are not directly observable from ECMAScript code. An
ECMAScript implementation does not need to actually create or use such
objects to implement the specified semantics.
Note 4
Ordinary arguments objects define a non-configurable
accessor property
named
"callee"
which throws a
TypeError
exception on access. The
"callee"
property has a more specific meaning for arguments exotic objects,
which are created only for some class of non-strict functions. The
definition of this property in the ordinary variant exists to ensure
that it is not defined in any other manner by conforming ECMAScript
implementations.
Note 5
ECMAScript implementations of arguments exotic objects have historically contained an
accessor property
named
"caller"
. Prior to ECMAScript 2017, this specification included the definition of a throwing
"caller"
property on ordinary arguments objects. Since implementations do not
contain this extension any longer, ECMAScript 2017 dropped the
requirement for a throwing
"caller"
accessor.
10.4.4.1
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of an
arguments exotic object
args
takes argument
(a property key). It performs the following steps when called:
1.
Let
desc
be
OrdinaryGetOwnProperty
args
).
2.
If
desc
is
undefined
, return
desc
3.
Let
map
be
args
.[[ParameterMap]].
4.
Let
isMapped
be !
HasOwnProperty
map
).
5.
If
isMapped
is
true
, then
a.
Set
desc
.[[Value]] to
Get
map
).
6.
Return
desc
10.4.4.2
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of an
arguments exotic object
args
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Let
map
be
args
.[[ParameterMap]].
2.
Let
isMapped
be
HasOwnProperty
map
).
3.
Let
newArgDesc
be
Desc
4.
If
isMapped
is
true
and
IsDataDescriptor
Desc
) is
true
, then
a.
If
Desc
.[[Value]] is not present and
Desc
.[[Writable]] is present and its value is
false
, then
i.
Set
newArgDesc
to a copy of
Desc
ii.
Set
newArgDesc
.[[Value]] to
Get
map
).
5.
Let
allowed
be ?
OrdinaryDefineOwnProperty
args
newArgDesc
).
6.
If
allowed
is
false
, return
false
7.
If
isMapped
is
true
, then
a.
If
IsAccessorDescriptor
Desc
) is
true
, then
i.
Call
map
.[[Delete]](
).
b.
Else,
i.
If
Desc
.[[Value]] is present, then
1.
Let
setStatus
be
Set
map
Desc
.[[Value]],
false
).
2.
Assert
setStatus
is
true
because formal parameters mapped by argument objects are always writable.
ii.
If
Desc
.[[Writable]] is present and its value is
false
, then
1.
Call
map
.[[Delete]](
).
8.
Return
true
10.4.4.3
[[Get]] (
Receiver
The [[Get]] internal method of an
arguments exotic object
args
takes arguments
(a property key) and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Let
map
be
args
.[[ParameterMap]].
2.
Let
isMapped
be !
HasOwnProperty
map
).
3.
If
isMapped
is
false
, then
a.
Return ?
OrdinaryGet
args
Receiver
).
4.
Else,
a.
Assert
map
contains a formal parameter mapping for
b.
Return
Get
map
).
10.4.4.4
[[Set]] (
Receiver
The [[Set]] internal method of an
arguments exotic object
args
takes arguments
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
If
SameValue
args
Receiver
) is
false
, then
a.
Let
isMapped
be
false
2.
Else,
a.
Let
map
be
args
.[[ParameterMap]].
b.
Let
isMapped
be !
HasOwnProperty
map
).
3.
If
isMapped
is
true
, then
a.
Let
setStatus
be
Set
map
false
).
b.
Assert
setStatus
is
true
because formal parameters mapped by argument objects are always writable.
4.
Return ?
OrdinarySet
args
Receiver
).
10.4.4.5
[[Delete]] (
The [[Delete]] internal method of an
arguments exotic object
args
takes argument
(a property key). It performs the following steps when called:
1.
Let
map
be
args
.[[ParameterMap]].
2.
Let
isMapped
be !
HasOwnProperty
map
).
3.
Let
result
be ?
OrdinaryDelete
args
).
4.
If
result
is
true
and
isMapped
is
true
, then
a.
Call
map
.[[Delete]](
).
5.
Return
result
10.4.4.6
CreateUnmappedArgumentsObject (
argumentsList
The abstract operation CreateUnmappedArgumentsObject takes argument
argumentsList
. It performs the following steps when called:
1.
Let
len
be the number of elements in
argumentsList
2.
Let
obj
be !
OrdinaryObjectCreate
%Object.prototype%
, « [[ParameterMap]] »).
3.
Set
obj
.[[ParameterMap]] to
undefined
4.
Perform
DefinePropertyOrThrow
obj
"length"
, PropertyDescriptor { [[Value]]:
len
), [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
5.
Let
index
be 0.
6.
Repeat, while
index
len
a.
Let
val
be
argumentsList
index
].
b.
Perform !
CreateDataPropertyOrThrow
obj
, !
ToString
index
)),
val
).
c.
Set
index
to
index
+ 1.
7.
Perform !
DefinePropertyOrThrow
obj
@@iterator
, PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
8.
Perform !
DefinePropertyOrThrow
obj
"callee"
, PropertyDescriptor { [[Get]]:
%ThrowTypeError%
, [[Set]]:
%ThrowTypeError%
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
9.
Return
obj
10.4.4.7
CreateMappedArgumentsObject (
func
formals
argumentsList
env
The abstract operation CreateMappedArgumentsObject takes arguments
func
(an Object),
formals
(a
Parse Node
),
argumentsList
(a
List
), and
env
(an
Environment Record
). It performs the following steps when called:
1.
Assert
formals
does not contain a rest parameter, any binding patterns, or any initializers. It may contain duplicate identifiers.
2.
Let
len
be the number of elements in
argumentsList
3.
Let
obj
be !
MakeBasicObject
(« [[Prototype]], [[Extensible]], [[ParameterMap]] »).
4.
Set
obj
.[[GetOwnProperty]] as specified in
10.4.4.1
5.
Set
obj
.[[DefineOwnProperty]] as specified in
10.4.4.2
6.
Set
obj
.[[Get]] as specified in
10.4.4.3
7.
Set
obj
.[[Set]] as specified in
10.4.4.4
8.
Set
obj
.[[Delete]] as specified in
10.4.4.5
9.
Set
obj
.[[Prototype]] to
%Object.prototype%
10.
Let
map
be !
OrdinaryObjectCreate
null
).
11.
Set
obj
.[[ParameterMap]] to
map
12.
Let
parameterNames
be the
BoundNames
of
formals
13.
Let
numberOfParameters
be the number of elements in
parameterNames
14.
Let
index
be 0.
15.
Repeat, while
index
len
a.
Let
val
be
argumentsList
index
].
b.
Perform !
CreateDataPropertyOrThrow
obj
, !
ToString
index
)),
val
).
c.
Set
index
to
index
+ 1.
16.
Perform !
DefinePropertyOrThrow
obj
"length"
, PropertyDescriptor { [[Value]]:
len
), [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
17.
Let
mappedNames
be a new empty
List
18.
Let
index
be
numberOfParameters
- 1.
19.
Repeat, while
index
≥ 0,
a.
Let
name
be
parameterNames
index
].
b.
If
name
is not an element of
mappedNames
, then
i.
Add
name
as an element of the list
mappedNames
ii.
If
index
len
, then
1.
Let
be
MakeArgGetter
name
env
).
2.
Let
be
MakeArgSetter
name
env
).
3.
Perform
map
.[[DefineOwnProperty]](!
ToString
index
)), PropertyDescriptor { [[Set]]:
, [[Get]]:
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
c.
Set
index
to
index
- 1.
20.
Perform !
DefinePropertyOrThrow
obj
@@iterator
, PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
21.
Perform !
DefinePropertyOrThrow
obj
"callee"
, PropertyDescriptor { [[Value]]:
func
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}).
22.
Return
obj
10.4.4.7.1
MakeArgGetter (
name
env
The abstract operation MakeArgGetter takes arguments
name
(a String) and
env
(an
Environment Record
). It creates a built-in
function object
that when executed returns the value bound for
name
in
env
. It performs the following steps when called:
1.
Let
steps
be the steps of an ArgGetter function as specified below.
2.
Let
length
be the number of non-optional parameters of an ArgGetter function as specified below.
3.
Let
getter
be !
CreateBuiltinFunction
steps
length
""
, « [[Name]], [[Env]] »).
4.
Set
getter
.[[Name]] to
name
5.
Set
getter
.[[Env]] to
env
6.
Return
getter
An ArgGetter function is an anonymous built-in function
with [[Name]] and [[Env]] internal slots. When an ArgGetter function
that expects no arguments is called it performs the following steps:
1.
Let
be the
active function object
2.
Let
name
be
.[[Name]].
3.
Let
env
be
.[[Env]].
4.
Return
env
.GetBindingValue(
name
false
).
Note
ArgGetter functions are never directly accessible to ECMAScript code.
10.4.4.7.2
MakeArgSetter (
name
env
The abstract operation MakeArgSetter takes arguments
name
(a String) and
env
(an
Environment Record
). It creates a built-in
function object
that when executed sets the value bound for
name
in
env
. It performs the following steps when called:
1.
Let
steps
be the steps of an ArgSetter function as specified below.
2.
Let
length
be the number of non-optional parameters of an ArgSetter function as specified below.
3.
Let
setter
be !
CreateBuiltinFunction
steps
length
""
, « [[Name]], [[Env]] »).
4.
Set
setter
.[[Name]] to
name
5.
Set
setter
.[[Env]] to
env
6.
Return
setter
An ArgSetter function is an anonymous built-in function
with [[Name]] and [[Env]] internal slots. When an ArgSetter function is
called with argument
value
it performs the following steps:
1.
Let
be the
active function object
2.
Let
name
be
.[[Name]].
3.
Let
env
be
.[[Env]].
4.
Return
env
.SetMutableBinding(
name
value
false
).
Note
ArgSetter functions are never directly accessible to ECMAScript code.
10.4.5
Integer-Indexed Exotic Objects
An
Integer-Indexed exotic object
is an
exotic object
that performs special handling of
integer index
property keys.
Integer-Indexed exotic objects
have the same internal slots as ordinary objects and additionally
[[ViewedArrayBuffer]], [[ArrayLength]], [[ByteOffset]], [[ContentType]],
and [[TypedArrayName]] internal slots.
An object is an
Integer-Indexed exotic object
if its [[GetOwnProperty]], [[HasProperty]], [[DefineOwnProperty]],
[[Get]], [[Set]], [[Delete]], and [[OwnPropertyKeys]] internal methods
use the definitions in this section, and its other essential internal
methods use the definitions found in
10.1
. These methods are installed by
IntegerIndexedObjectCreate
10.4.5.1
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of an
Integer-Indexed exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Assert
is an
Integer-Indexed exotic object
3.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, then
i.
Let
value
be !
IntegerIndexedElementGet
numericIndex
).
ii.
If
value
is
undefined
, return
undefined
iii.
Return the PropertyDescriptor { [[Value]]:
value
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
true
}.
4.
Return
OrdinaryGetOwnProperty
).
10.4.5.2
[[HasProperty]] (
The [[HasProperty]] internal method of an
Integer-Indexed exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Assert
is an
Integer-Indexed exotic object
3.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, return !
IsValidIntegerIndex
numericIndex
).
4.
Return ?
OrdinaryHasProperty
).
10.4.5.3
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of an
Integer-Indexed exotic object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Assert
is an
Integer-Indexed exotic object
3.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, then
i.
If !
IsValidIntegerIndex
numericIndex
) is
false
, return
false
ii.
If
Desc
has a [[Configurable]] field and if
Desc
.[[Configurable]] is
false
, return
false
iii.
If
Desc
has an [[Enumerable]] field and if
Desc
.[[Enumerable]] is
false
, return
false
iv.
If !
IsAccessorDescriptor
Desc
) is
true
, return
false
v.
If
Desc
has a [[Writable]] field and if
Desc
.[[Writable]] is
false
, return
false
vi.
If
Desc
has a [[Value]] field, perform ?
IntegerIndexedElementSet
numericIndex
Desc
.[[Value]]).
vii.
Return
true
4.
Return !
OrdinaryDefineOwnProperty
Desc
).
10.4.5.4
[[Get]] (
Receiver
The [[Get]] internal method of an
Integer-Indexed exotic object
takes arguments
(a property key) and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, then
i.
Return !
IntegerIndexedElementGet
numericIndex
).
3.
Return ?
OrdinaryGet
Receiver
).
10.4.5.5
[[Set]] (
Receiver
The [[Set]] internal method of an
Integer-Indexed exotic object
takes arguments
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, then
i.
Perform ?
IntegerIndexedElementSet
numericIndex
).
ii.
Return
true
3.
Return ?
OrdinarySet
Receiver
).
10.4.5.6
[[Delete]] (
The [[Delete]] internal method of an
Integer-Indexed exotic object
takes arguments
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Assert
is an
Integer-Indexed exotic object
3.
If
Type
) is String, then
a.
Let
numericIndex
be !
CanonicalNumericIndexString
).
b.
If
numericIndex
is not
undefined
, then
i.
If !
IsValidIntegerIndex
numericIndex
) is
false
, return
true
; else return
false
4.
Return ?
OrdinaryDelete
).
10.4.5.7
[[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of an
Integer-Indexed exotic object
takes no arguments. It performs the following steps when called:
1.
Let
keys
be a new empty
List
2.
Assert
is an
Integer-Indexed exotic object
3.
If
IsDetachedBuffer
.[[ViewedArrayBuffer]]) is
false
, then
a.
For each
integer
starting with 0 such that
.[[ArrayLength]], in ascending order, do
i.
Add !
ToString
)) as the last element of
keys
4.
For each own property key
of
such that
Type
) is String and
is not an
integer index
, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
5.
For each own property key
of
such that
Type
) is Symbol, in ascending chronological order of property creation, do
a.
Add
as the last element of
keys
6.
Return
keys
10.4.5.8
IntegerIndexedObjectCreate (
prototype
The abstract operation IntegerIndexedObjectCreate takes argument
prototype
. It is used to specify the creation of new
Integer-Indexed exotic objects
. It performs the following steps when called:
1.
Let
internalSlotsList
be « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]],
[[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]],
[[ArrayLength]] ».
2.
Let
be !
MakeBasicObject
internalSlotsList
).
3.
Set
.[[GetOwnProperty]] as specified in
10.4.5.1
4.
Set
.[[HasProperty]] as specified in
10.4.5.2
5.
Set
.[[DefineOwnProperty]] as specified in
10.4.5.3
6.
Set
.[[Get]] as specified in
10.4.5.4
7.
Set
.[[Set]] as specified in
10.4.5.5
8.
Set
.[[Delete]] as specified in
10.4.5.6
9.
Set
.[[OwnPropertyKeys]] as specified in
10.4.5.7
10.
Set
.[[Prototype]] to
prototype
11.
Return
10.4.5.9
IsValidIntegerIndex (
index
The abstract operation IsValidIntegerIndex takes arguments
and
index
(a Number). It performs the following steps when called:
1.
Assert
is an
Integer-Indexed exotic object
2.
If
IsDetachedBuffer
.[[ViewedArrayBuffer]]) is
true
, return
false
3.
If !
IsIntegralNumber
index
) is
false
, return
false
4.
If
index
is
-0
, return
false
5.
If
index
) < 0 or
index
) ≥
.[[ArrayLength]], return
false
6.
Return
true
10.4.5.10
IntegerIndexedElementGet (
index
The abstract operation IntegerIndexedElementGet takes arguments
and
index
(a Number). It performs the following steps when called:
1.
Assert
is an
Integer-Indexed exotic object
2.
If !
IsValidIntegerIndex
index
) is
false
, return
undefined
3.
Let
offset
be
.[[ByteOffset]].
4.
Let
arrayTypeName
be the String value of
.[[TypedArrayName]].
5.
Let
elementSize
be the Element Size value specified in
Table 60
for
arrayTypeName
6.
Let
indexedPosition
be (
index
) ×
elementSize
) +
offset
7.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
8.
Return
GetValueFromBuffer
.[[ViewedArrayBuffer]],
indexedPosition
elementType
true
Unordered
).
10.4.5.11
IntegerIndexedElementSet (
index
value
The abstract operation IntegerIndexedElementSet takes arguments
index
(a Number), and
value
. It performs the following steps when called:
1.
Assert
is an
Integer-Indexed exotic object
2.
If
.[[ContentType]] is
BigInt
, let
numValue
be ?
ToBigInt
value
).
3.
Otherwise, let
numValue
be ?
ToNumber
value
).
4.
If !
IsValidIntegerIndex
index
) is
true
, then
a.
Let
offset
be
.[[ByteOffset]].
b.
Let
arrayTypeName
be the String value of
.[[TypedArrayName]].
c.
Let
elementSize
be the Element Size value specified in
Table 60
for
arrayTypeName
d.
Let
indexedPosition
be (
index
) ×
elementSize
) +
offset
e.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
f.
Perform
SetValueInBuffer
.[[ViewedArrayBuffer]],
indexedPosition
elementType
numValue
true
Unordered
).
5.
Return
NormalCompletion
undefined
).
Note
This operation always appears to succeed, but it has no
effect when attempting to write past the end of a TypedArray or to a
TypedArray which is backed by a detached ArrayBuffer.
10.4.6
Module Namespace Exotic Objects
module namespace exotic object
is an
exotic object
that exposes the bindings exported from an ECMAScript
Module
(See
16.2.3
). There is a one-to-one correspondence between the String-keyed own properties of a
module namespace exotic object
and the binding names exported by the
Module
. The exported bindings include any bindings that are indirectly exported using
export *
export items. Each String-valued own property key is the
StringValue
of the corresponding exported binding name. These are the only String-keyed properties of a
module namespace exotic object
. Each such property has the attributes { [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
false
}. Module namespace exotic objects are not extensible.
An object is a
module namespace exotic object
if its [[SetPrototypeOf]], [[IsExtensible]], [[PreventExtensions]],
[[GetOwnProperty]], [[DefineOwnProperty]], [[HasProperty]], [[Get]],
[[Set]], [[Delete]], and [[OwnPropertyKeys]] internal methods use the
definitions in this section, and its other essential internal methods
use the definitions found in
10.1
. These methods are installed by
ModuleNamespaceCreate
Module namespace exotic objects have the internal slots defined in
Table 31
Table 31: Internal Slots of Module Namespace Exotic Objects
Internal Slot
Type
Description
[[Module]]
Module Record
The
Module Record
whose exports this namespace exposes.
[[Exports]]
List
of String
List
whose elements are the String values of the exported names exposed as
own properties of this object. The list is ordered as if an Array of
those String values had been sorted using %Array.prototype.sort% using
undefined
as
comparefn
[[Prototype]]
Null
This slot always contains the value
null
(see
10.4.6.1
).
Module namespace exotic objects provide alternative definitions
for all of the internal methods except [[GetPrototypeOf]], which
behaves as defined in
10.1.1
10.4.6.1
[[SetPrototypeOf]] (
The [[SetPrototypeOf]] internal method of a
module namespace exotic object
takes argument
(an Object or
null
). It performs the following steps when called:
1.
Return ?
SetImmutablePrototype
).
10.4.6.2
[[IsExtensible]] ( )
The [[IsExtensible]] internal method of a
module namespace exotic object
takes no arguments. It performs the following steps when called:
1.
Return
false
10.4.6.3
[[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a
module namespace exotic object
takes no arguments. It performs the following steps when called:
1.
Return
true
10.4.6.4
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of a
module namespace exotic object
takes argument
(a property key). It performs the following steps when called:
1.
If
Type
) is Symbol, return
OrdinaryGetOwnProperty
).
2.
Let
exports
be
.[[Exports]].
3.
If
is not an element of
exports
, return
undefined
4.
Let
value
be ?
.[[Get]](
).
5.
Return PropertyDescriptor { [[Value]]:
value
, [[Writable]]:
true
, [[Enumerable]]:
true
, [[Configurable]]:
false
}.
10.4.6.5
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of a
module namespace exotic object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
If
Type
) is Symbol, return
OrdinaryDefineOwnProperty
Desc
).
2.
Let
current
be ?
.[[GetOwnProperty]](
).
3.
If
current
is
undefined
, return
false
4.
If
Desc
.[[Configurable]] is present and has value
true
, return
false
5.
If
Desc
.[[Enumerable]] is present and has value
false
, return
false
6.
If !
IsAccessorDescriptor
Desc
) is
true
, return
false
7.
If
Desc
.[[Writable]] is present and has value
false
, return
false
8.
If
Desc
.[[Value]] is present, return
SameValue
Desc
.[[Value]],
current
.[[Value]]).
9.
Return
true
10.4.6.6
[[HasProperty]] (
The [[HasProperty]] internal method of a
module namespace exotic object
takes argument
(a property key). It performs the following steps when called:
1.
If
Type
) is Symbol, return
OrdinaryHasProperty
).
2.
Let
exports
be
.[[Exports]].
3.
If
is an element of
exports
, return
true
4.
Return
false
10.4.6.7
[[Get]] (
Receiver
The [[Get]] internal method of a
module namespace exotic object
takes arguments
(a property key) and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
Type
) is Symbol, then
a.
Return ?
OrdinaryGet
Receiver
).
3.
Let
exports
be
.[[Exports]].
4.
If
is not an element of
exports
, return
undefined
5.
Let
be
.[[Module]].
6.
Let
binding
be !
.ResolveExport(
).
7.
Assert
binding
is a
ResolvedBinding Record
8.
Let
targetModule
be
binding
.[[Module]].
9.
Assert
targetModule
is not
undefined
10.
If
binding
.[[BindingName]] is
"*namespace*"
, then
a.
Return ?
GetModuleNamespace
targetModule
).
11.
Let
targetEnv
be
targetModule
.[[Environment]].
12.
If
targetEnv
is
undefined
, throw a
ReferenceError
exception.
13.
Return ?
targetEnv
.GetBindingValue(
binding
.[[BindingName]],
true
).
Note
ResolveExport is side-effect free. Each time this operation is called with a specific
exportName
resolveSet
pair as arguments it must return the same result. An implementation
might choose to pre-compute or cache the ResolveExport results for the
[[Exports]] of each
module namespace exotic object
10.4.6.8
[[Set]] (
Receiver
The [[Set]] internal method of a
module namespace exotic object
takes arguments
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Return
false
10.4.6.9
[[Delete]] (
The [[Delete]] internal method of a
module namespace exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
If
Type
) is Symbol, then
a.
Return ?
OrdinaryDelete
).
3.
Let
exports
be
.[[Exports]].
4.
If
is an element of
exports
, return
false
5.
Return
true
10.4.6.10
[[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a
module namespace exotic object
takes no arguments. It performs the following steps when called:
1.
Let
exports
be a copy of
.[[Exports]].
2.
Let
symbolKeys
be !
OrdinaryOwnPropertyKeys
).
3.
Append all the entries of
symbolKeys
to the end of
exports
4.
Return
exports
10.4.6.11
ModuleNamespaceCreate (
module
exports
The abstract operation ModuleNamespaceCreate takes arguments
module
and
exports
. It is used to specify the creation of new module namespace exotic objects. It performs the following steps when called:
1.
Assert
module
is a
Module Record
2.
Assert
module
.[[Namespace]] is
undefined
3.
Assert
exports
is a
List
of String values.
4.
Let
internalSlotsList
be the internal slots listed in
Table 31
5.
Let
be !
MakeBasicObject
internalSlotsList
).
6.
Set
's essential internal methods to the definitions specified in
10.4.6
7.
Set
.[[Prototype]] to
null
8.
Set
.[[Module]] to
module
9.
Let
sortedExports
be a
List
whose elements are the elements of
exports
ordered as if an Array of the same values had been sorted using %Array.prototype.sort% using
undefined
as
comparefn
10.
Set
.[[Exports]] to
sortedExports
11.
Create own properties of
corresponding to the definitions in
28.3
12.
Set
module
.[[Namespace]] to
13.
Return
10.4.7
Immutable Prototype Exotic Objects
An
immutable prototype exotic object
is an
exotic object
that has a [[Prototype]] internal slot that will not change once it is initialized.
An object is an
immutable prototype exotic object
if its [[SetPrototypeOf]] internal method uses the following
implementation. (Its other essential internal methods may use any
implementation, depending on the specific
immutable prototype exotic object
in question.)
Note
Unlike other exotic objects, there is not a dedicated
creation abstract operation provided for immutable prototype exotic
objects. This is because they are only used by
%Object.prototype%
and by
host
environments, and in
host
environments, the relevant objects are potentially exotic in other ways and thus need their own dedicated creation operation.
10.4.7.1
[[SetPrototypeOf]] (
The [[SetPrototypeOf]] internal method of an
immutable prototype exotic object
takes argument
(an Object or
null
). It performs the following steps when called:
1.
Return ?
SetImmutablePrototype
).
10.4.7.2
SetImmutablePrototype (
The abstract operation SetImmutablePrototype takes arguments
and
. It performs the following steps when called:
1.
Assert
: Either
Type
) is Object or
Type
) is Null.
2.
Let
current
be ?
.[[GetPrototypeOf]]().
3.
If
SameValue
current
) is
true
, return
true
4.
Return
false
10.5
Proxy Object Internal Methods and Internal Slots
A proxy object is an
exotic object
whose essential internal methods are partially implemented using
ECMAScript code. Every proxy object has an internal slot called
[[ProxyHandler]]. The value of [[ProxyHandler]] is an object, called the
proxy's
handler object
, or
null
. Methods (see
Table 32
of a handler object may be used to augment the implementation for one
or more of the proxy object's internal methods. Every proxy object also
has an internal slot called [[ProxyTarget]] whose value is either an
object or the
null
value. This object is called the proxy's
target object
An object is a
Proxy exotic object
if its essential internal methods (including [[Call]] and
[[Construct]], if applicable) use the definitions in this section. These
internal methods are installed in
ProxyCreate
Table 32: Proxy Handler Methods
Internal Method
Handler Method
[[GetPrototypeOf]]
getPrototypeOf
[[SetPrototypeOf]]
setPrototypeOf
[[IsExtensible]]
isExtensible
[[PreventExtensions]]
preventExtensions
[[GetOwnProperty]]
getOwnPropertyDescriptor
[[DefineOwnProperty]]
defineProperty
[[HasProperty]]
has
[[Get]]
get
[[Set]]
set
[[Delete]]
deleteProperty
[[OwnPropertyKeys]]
ownKeys
[[Call]]
apply
[[Construct]]
construct
When a handler method is called to provide the implementation of a
proxy object internal method, the handler method is passed the proxy's
target object as a parameter. A proxy's handler object does not
necessarily have a method corresponding to every essential internal
method. Invoking an internal method on the proxy results in the
invocation of the corresponding internal method on the proxy's target
object if the handler object does not have a method corresponding to the
internal trap.
The [[ProxyHandler]] and [[ProxyTarget]] internal slots of a
proxy object are always initialized when the object is created and
typically may not be modified. Some proxy objects are created in a
manner that permits them to be subsequently
revoked
. When a proxy is revoked, its [[ProxyHandler]] and [[ProxyTarget]] internal slots are set to
null
causing subsequent invocations of internal methods on that proxy object to throw a
TypeError
exception.
Because proxy objects permit the implementation of internal
methods to be provided by arbitrary ECMAScript code, it is possible to
define a proxy object whose handler methods violates the invariants
defined in
6.1.7.3
. Some of the internal method invariants defined in
6.1.7.3
are essential integrity invariants. These invariants are explicitly
enforced by the proxy object internal methods specified in this section.
An ECMAScript implementation must be robust in the presence of all
possible invariant violations.
In the following algorithm descriptions, assume
is an ECMAScript proxy object,
is a property key value,
is any
ECMAScript language value
and
Desc
is a
Property Descriptor
record.
10.5.1
[[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of a
Proxy exotic object
takes no arguments. It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Let
trap
be ?
GetMethod
handler
"getPrototypeOf"
).
6.
If
trap
is
undefined
, then
a.
Return ?
target
.[[GetPrototypeOf]]().
7.
Let
handlerProto
be ?
Call
trap
handler
, «
target
»).
8.
If
Type
handlerProto
) is neither Object nor Null, throw a
TypeError
exception.
9.
Let
extensibleTarget
be ?
IsExtensible
target
).
10.
If
extensibleTarget
is
true
, return
handlerProto
11.
Let
targetProto
be ?
target
.[[GetPrototypeOf]]().
12.
If
SameValue
handlerProto
targetProto
) is
false
, throw a
TypeError
exception.
13.
Return
handlerProto
Note
[[GetPrototypeOf]] for proxy objects enforces the following invariants:
The result of [[GetPrototypeOf]] must be either an Object or
null
If the target object is not extensible, [[GetPrototypeOf]]
applied to the proxy object must return the same value as
[[GetPrototypeOf]] applied to the proxy object's target object.
10.5.2
[[SetPrototypeOf]] (
The [[SetPrototypeOf]] internal method of a
Proxy exotic object
takes argument
(an Object or
null
). It performs the following steps when called:
1.
Assert
: Either
Type
) is Object or
Type
) is Null.
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"setPrototypeOf"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[SetPrototypeOf]](
).
8.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
»)).
9.
If
booleanTrapResult
is
false
, return
false
10.
Let
extensibleTarget
be ?
IsExtensible
target
).
11.
If
extensibleTarget
is
true
, return
true
12.
Let
targetProto
be ?
target
.[[GetPrototypeOf]]().
13.
If
SameValue
targetProto
) is
false
, throw a
TypeError
exception.
14.
Return
true
Note
[[SetPrototypeOf]] for proxy objects enforces the following invariants:
The result of [[SetPrototypeOf]] is a Boolean value.
If the target object is not extensible, the argument value
must be the same as the result of [[GetPrototypeOf]] applied to target
object.
10.5.3
[[IsExtensible]] ( )
The [[IsExtensible]] internal method of a
Proxy exotic object
takes no arguments. It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Let
trap
be ?
GetMethod
handler
"isExtensible"
).
6.
If
trap
is
undefined
, then
a.
Return ?
IsExtensible
target
).
7.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
»)).
8.
Let
targetResult
be ?
IsExtensible
target
).
9.
If
SameValue
booleanTrapResult
targetResult
) is
false
, throw a
TypeError
exception.
10.
Return
booleanTrapResult
Note
[[IsExtensible]] for proxy objects enforces the following invariants:
The result of [[IsExtensible]] is a Boolean value.
[[IsExtensible]] applied to the proxy object must return the
same value as [[IsExtensible]] applied to the proxy object's target
object with the same argument.
10.5.4
[[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a
Proxy exotic object
takes no arguments. It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Let
trap
be ?
GetMethod
handler
"preventExtensions"
).
6.
If
trap
is
undefined
, then
a.
Return ?
target
.[[PreventExtensions]]().
7.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
»)).
8.
If
booleanTrapResult
is
true
, then
a.
Let
extensibleTarget
be ?
IsExtensible
target
).
b.
If
extensibleTarget
is
true
, throw a
TypeError
exception.
9.
Return
booleanTrapResult
Note
[[PreventExtensions]] for proxy objects enforces the following invariants:
The result of [[PreventExtensions]] is a Boolean value.
[[PreventExtensions]] applied to the proxy object only returns
true
if [[IsExtensible]] applied to the proxy object's target object is
false
10.5.5
[[GetOwnProperty]] (
The [[GetOwnProperty]] internal method of a
Proxy exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"getOwnPropertyDescriptor"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[GetOwnProperty]](
).
8.
Let
trapResultObj
be ?
Call
trap
handler
, «
target
»).
9.
If
Type
trapResultObj
) is neither Object nor Undefined, throw a
TypeError
exception.
10.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
11.
If
trapResultObj
is
undefined
, then
a.
If
targetDesc
is
undefined
, return
undefined
b.
If
targetDesc
.[[Configurable]] is
false
, throw a
TypeError
exception.
c.
Let
extensibleTarget
be ?
IsExtensible
target
).
d.
If
extensibleTarget
is
false
, throw a
TypeError
exception.
e.
Return
undefined
12.
Let
extensibleTarget
be ?
IsExtensible
target
).
13.
Let
resultDesc
be ?
ToPropertyDescriptor
trapResultObj
).
14.
Call
CompletePropertyDescriptor
resultDesc
).
15.
Let
valid
be
IsCompatiblePropertyDescriptor
extensibleTarget
resultDesc
targetDesc
).
16.
If
valid
is
false
, throw a
TypeError
exception.
17.
If
resultDesc
.[[Configurable]] is
false
, then
a.
If
targetDesc
is
undefined
or
targetDesc
.[[Configurable]] is
true
, then
i.
Throw a
TypeError
exception.
b.
If
resultDesc
has a [[Writable]] field and
resultDesc
.[[Writable]] is
false
, then
i.
If
targetDesc
.[[Writable]] is
true
, throw a
TypeError
exception.
18.
Return
resultDesc
Note
[[GetOwnProperty]] for proxy objects enforces the following invariants:
The result of [[GetOwnProperty]] must be either an Object or
undefined
A property cannot be reported as non-existent, if it exists as a non-configurable own property of the target object.
A property cannot be reported as non-existent, if the target
object is not extensible, unless it does not exist as an own property
of the target object.
A property cannot be reported as existent, if the target
object is not extensible, unless it exists as an own property of the
target object.
A property cannot be reported as non-configurable, unless it
exists as a non-configurable own property of the target object.
A property cannot be reported as both non-configurable and
non-writable, unless it exists as a non-configurable, non-writable own
property of the target object.
10.5.6
[[DefineOwnProperty]] (
Desc
The [[DefineOwnProperty]] internal method of a
Proxy exotic object
takes arguments
(a property key) and
Desc
(a
Property Descriptor
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"defineProperty"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[DefineOwnProperty]](
Desc
).
8.
Let
descObj
be
FromPropertyDescriptor
Desc
).
9.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
descObj
»)).
10.
If
booleanTrapResult
is
false
, return
false
11.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
12.
Let
extensibleTarget
be ?
IsExtensible
target
).
13.
If
Desc
has a [[Configurable]] field and if
Desc
.[[Configurable]] is
false
, then
a.
Let
settingConfigFalse
be
true
14.
Else, let
settingConfigFalse
be
false
15.
If
targetDesc
is
undefined
, then
a.
If
extensibleTarget
is
false
, throw a
TypeError
exception.
b.
If
settingConfigFalse
is
true
, throw a
TypeError
exception.
16.
Else,
a.
If
IsCompatiblePropertyDescriptor
extensibleTarget
Desc
targetDesc
) is
false
, throw a
TypeError
exception.
b.
If
settingConfigFalse
is
true
and
targetDesc
.[[Configurable]] is
true
, throw a
TypeError
exception.
c.
If
IsDataDescriptor
targetDesc
) is
true
targetDesc
.[[Configurable]] is
false
, and
targetDesc
.[[Writable]] is
true
, then
i.
If
Desc
has a [[Writable]] field and
Desc
.[[Writable]] is
false
, throw a
TypeError
exception.
17.
Return
true
Note
[[DefineOwnProperty]] for proxy objects enforces the following invariants:
The result of [[DefineOwnProperty]] is a Boolean value.
A property cannot be added, if the target object is not extensible.
A property cannot be non-configurable, unless there exists a
corresponding non-configurable own property of the target object.
A non-configurable property cannot be non-writable, unless
there exists a corresponding non-configurable, non-writable own property
of the target object.
If a property has a corresponding target object property then applying the
Property Descriptor
of the property to the target object using [[DefineOwnProperty]] will not throw an exception.
10.5.7
[[HasProperty]] (
The [[HasProperty]] internal method of a
Proxy exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"has"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[HasProperty]](
).
8.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
»)).
9.
If
booleanTrapResult
is
false
, then
a.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
b.
If
targetDesc
is not
undefined
, then
i.
If
targetDesc
.[[Configurable]] is
false
, throw a
TypeError
exception.
ii.
Let
extensibleTarget
be ?
IsExtensible
target
).
iii.
If
extensibleTarget
is
false
, throw a
TypeError
exception.
10.
Return
booleanTrapResult
Note
[[HasProperty]] for proxy objects enforces the following invariants:
The result of [[HasProperty]] is a Boolean value.
A property cannot be reported as non-existent, if it exists as a non-configurable own property of the target object.
A property cannot be reported as non-existent, if it exists
as an own property of the target object and the target object is not
extensible.
10.5.8
[[Get]] (
Receiver
The [[Get]] internal method of a
Proxy exotic object
takes arguments
(a property key) and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"get"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[Get]](
Receiver
).
8.
Let
trapResult
be ?
Call
trap
handler
, «
target
Receiver
»).
9.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
10.
If
targetDesc
is not
undefined
and
targetDesc
.[[Configurable]] is
false
, then
a.
If
IsDataDescriptor
targetDesc
) is
true
and
targetDesc
.[[Writable]] is
false
, then
i.
If
SameValue
trapResult
targetDesc
.[[Value]]) is
false
, throw a
TypeError
exception.
b.
If
IsAccessorDescriptor
targetDesc
) is
true
and
targetDesc
.[[Get]] is
undefined
, then
i.
If
trapResult
is not
undefined
, throw a
TypeError
exception.
11.
Return
trapResult
Note
[[Get]] for proxy objects enforces the following invariants:
The value reported for a property must be the same as the
value of the corresponding target object property if the target object
property is a non-writable, non-configurable own
data property
The value reported for a property must be
undefined
if the corresponding target object property is a non-configurable own
accessor property
that has
undefined
as its [[Get]] attribute.
10.5.9
[[Set]] (
Receiver
The [[Set]] internal method of a
Proxy exotic object
takes arguments
(a property key),
(an
ECMAScript language value
), and
Receiver
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"set"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[Set]](
Receiver
).
8.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
Receiver
»)).
9.
If
booleanTrapResult
is
false
, return
false
10.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
11.
If
targetDesc
is not
undefined
and
targetDesc
.[[Configurable]] is
false
, then
a.
If
IsDataDescriptor
targetDesc
) is
true
and
targetDesc
.[[Writable]] is
false
, then
i.
If
SameValue
targetDesc
.[[Value]]) is
false
, throw a
TypeError
exception.
b.
If
IsAccessorDescriptor
targetDesc
) is
true
, then
i.
If
targetDesc
.[[Set]] is
undefined
, throw a
TypeError
exception.
12.
Return
true
Note
[[Set]] for proxy objects enforces the following invariants:
The result of [[Set]] is a Boolean value.
Cannot change the value of a property to be different from
the value of the corresponding target object property if the
corresponding target object property is a non-writable, non-configurable
own
data property
Cannot set the value of a property if the corresponding target object property is a non-configurable own
accessor property
that has
undefined
as its [[Set]] attribute.
10.5.10
[[Delete]] (
The [[Delete]] internal method of a
Proxy exotic object
takes argument
(a property key). It performs the following steps when called:
1.
Assert
IsPropertyKey
) is
true
2.
Let
handler
be
.[[ProxyHandler]].
3.
If
handler
is
null
, throw a
TypeError
exception.
4.
Assert
Type
handler
) is Object.
5.
Let
target
be
.[[ProxyTarget]].
6.
Let
trap
be ?
GetMethod
handler
"deleteProperty"
).
7.
If
trap
is
undefined
, then
a.
Return ?
target
.[[Delete]](
).
8.
Let
booleanTrapResult
be !
ToBoolean
(?
Call
trap
handler
, «
target
»)).
9.
If
booleanTrapResult
is
false
, return
false
10.
Let
targetDesc
be ?
target
.[[GetOwnProperty]](
).
11.
If
targetDesc
is
undefined
, return
true
12.
If
targetDesc
.[[Configurable]] is
false
, throw a
TypeError
exception.
13.
Let
extensibleTarget
be ?
IsExtensible
target
).
14.
If
extensibleTarget
is
false
, throw a
TypeError
exception.
15.
Return
true
Note
[[Delete]] for proxy objects enforces the following invariants:
The result of [[Delete]] is a Boolean value.
A property cannot be reported as deleted, if it exists as a non-configurable own property of the target object.
A property cannot be reported as deleted, if it exists as an
own property of the target object and the target object is
non-extensible.
10.5.11
[[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a
Proxy exotic object
takes no arguments. It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Let
trap
be ?
GetMethod
handler
"ownKeys"
).
6.
If
trap
is
undefined
, then
a.
Return ?
target
.[[OwnPropertyKeys]]().
7.
Let
trapResultArray
be ?
Call
trap
handler
, «
target
»).
8.
Let
trapResult
be ?
CreateListFromArrayLike
trapResultArray
, « String, Symbol »).
9.
If
trapResult
contains any duplicate entries, throw a
TypeError
exception.
10.
Let
extensibleTarget
be ?
IsExtensible
target
).
11.
Let
targetKeys
be ?
target
.[[OwnPropertyKeys]]().
12.
Assert
targetKeys
is a
List
whose elements are only String and Symbol values.
13.
Assert
targetKeys
contains no duplicate entries.
14.
Let
targetConfigurableKeys
be a new empty
List
15.
Let
targetNonconfigurableKeys
be a new empty
List
16.
For each element
key
of
targetKeys
, do
a.
Let
desc
be ?
target
.[[GetOwnProperty]](
key
).
b.
If
desc
is not
undefined
and
desc
.[[Configurable]] is
false
, then
i.
Append
key
as an element of
targetNonconfigurableKeys
c.
Else,
i.
Append
key
as an element of
targetConfigurableKeys
17.
If
extensibleTarget
is
true
and
targetNonconfigurableKeys
is empty, then
a.
Return
trapResult
18.
Let
uncheckedResultKeys
be a
List
whose elements are the elements of
trapResult
19.
For each element
key
of
targetNonconfigurableKeys
, do
a.
If
key
is not an element of
uncheckedResultKeys
, throw a
TypeError
exception.
b.
Remove
key
from
uncheckedResultKeys
20.
If
extensibleTarget
is
true
, return
trapResult
21.
For each element
key
of
targetConfigurableKeys
, do
a.
If
key
is not an element of
uncheckedResultKeys
, throw a
TypeError
exception.
b.
Remove
key
from
uncheckedResultKeys
22.
If
uncheckedResultKeys
is not empty, throw a
TypeError
exception.
23.
Return
trapResult
Note
[[OwnPropertyKeys]] for proxy objects enforces the following invariants:
The result of [[OwnPropertyKeys]] is a
List
The returned
List
contains no duplicate entries.
The Type of each result
List
element is either String or Symbol.
The result
List
must contain the keys of all non-configurable own properties of the target object.
If the target object is not extensible, then the result
List
must contain all the keys of the own properties of the target object and no other values.
10.5.12
[[Call]] (
thisArgument
argumentsList
The [[Call]] internal method of a
Proxy exotic object
takes arguments
thisArgument
(an
ECMAScript language value
) and
argumentsList
(a
List
of ECMAScript language values). It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Let
trap
be ?
GetMethod
handler
"apply"
).
6.
If
trap
is
undefined
, then
a.
Return ?
Call
target
thisArgument
argumentsList
).
7.
Let
argArray
be !
CreateArrayFromList
argumentsList
).
8.
Return ?
Call
trap
handler
, «
target
thisArgument
argArray
»).
Note
Proxy exotic object
only has a [[Call]] internal method if the initial value of its
[[ProxyTarget]] internal slot is an object that has a [[Call]] internal
method.
10.5.13
[[Construct]] (
argumentsList
newTarget
The [[Construct]] internal method of a
Proxy exotic object
takes arguments
argumentsList
(a
List
of ECMAScript language values) and
newTarget
(a
constructor
). It performs the following steps when called:
1.
Let
handler
be
.[[ProxyHandler]].
2.
If
handler
is
null
, throw a
TypeError
exception.
3.
Assert
Type
handler
) is Object.
4.
Let
target
be
.[[ProxyTarget]].
5.
Assert
IsConstructor
target
) is
true
6.
Let
trap
be ?
GetMethod
handler
"construct"
).
7.
If
trap
is
undefined
, then
a.
Return ?
Construct
target
argumentsList
newTarget
).
8.
Let
argArray
be !
CreateArrayFromList
argumentsList
).
9.
Let
newObj
be ?
Call
trap
handler
, «
target
argArray
newTarget
»).
10.
If
Type
newObj
) is not Object, throw a
TypeError
exception.
11.
Return
newObj
Note 1
Proxy exotic object
only has a [[Construct]] internal method if the initial value of its
[[ProxyTarget]] internal slot is an object that has a [[Construct]]
internal method.
Note 2
[[Construct]] for proxy objects enforces the following invariants:
The result of [[Construct]] must be an Object.
10.5.14
ProxyCreate (
target
handler
The abstract operation ProxyCreate takes arguments
target
and
handler
. It is used to specify the creation of new Proxy exotic objects. It performs the following steps when called:
1.
If
Type
target
) is not Object, throw a
TypeError
exception.
2.
If
Type
handler
) is not Object, throw a
TypeError
exception.
3.
Let
be !
MakeBasicObject
(« [[ProxyHandler]], [[ProxyTarget]] »).
4.
Set
's essential internal methods, except for [[Call]] and [[Construct]], to the definitions specified in
10.5
5.
If
IsCallable
target
) is
true
, then
a.
Set
.[[Call]] as specified in
10.5.12
b.
If
IsConstructor
target
) is
true
, then
i.
Set
.[[Construct]] as specified in
10.5.13
6.
Set
.[[ProxyTarget]] to
target
7.
Set
.[[ProxyHandler]] to
handler
8.
Return
11
ECMAScript Language: Source Code
11.1
Source Text
Syntax
SourceCharacter
::
any Unicode code point
ECMAScript code is expressed using Unicode. ECMAScript source
text is a sequence of code points. All Unicode code point values from
U+0000 to U+10FFFF, including surrogate code points, may occur in source
text where permitted by the ECMAScript grammars. The actual encodings
used to store and interchange ECMAScript source text is not relevant to
this specification. Regardless of the external source text encoding, a
conforming ECMAScript implementation processes the source text as if it
was an equivalent sequence of
SourceCharacter
values, each
SourceCharacter
being a Unicode code point. Conforming ECMAScript implementations are
not required to perform any normalization of source text, or behave as
though they were performing normalization of source text.
The components of a combining character sequence are treated as
individual Unicode code points even though a user might think of the
whole sequence as a single character.
Note
In string literals, regular expression literals, template
literals and identifiers, any Unicode code point may also be expressed
using Unicode escape sequences that explicitly express a code point's
numeric value. Within a comment, such an escape sequence is effectively
ignored as part of the comment.
ECMAScript differs from the Java programming language in the
behaviour of Unicode escape sequences. In a Java program, if the Unicode
escape sequence
\u000A
, for example, occurs within a
single-line comment, it is interpreted as a line terminator (Unicode
code point U+000A is LINE FEED (LF)) and therefore the next code point
is not part of the comment. Similarly, if the Unicode escape sequence
\u000A
occurs within a string literal in a Java program, it is likewise
interpreted as a line terminator, which is not allowed within a string
literal—one must write
\n
instead of
\u000A
to
cause a LINE FEED (LF) to be part of the String value of a string
literal. In an ECMAScript program, a Unicode escape sequence occurring
within a comment is never interpreted and therefore cannot contribute to
termination of the comment. Similarly, a Unicode escape sequence
occurring within a string literal in an ECMAScript program always
contributes to the literal and is never interpreted as a line terminator
or as a code point that might terminate the string literal.
11.1.1
Static Semantics: UTF16EncodeCodePoint (
cp
The abstract operation UTF16EncodeCodePoint takes argument
cp
(a Unicode code point). It performs the following steps when called:
1.
Assert
: 0 ≤
cp
≤ 0x10FFFF.
2.
If
cp
≤ 0xFFFF, return the String value consisting of the code unit whose value is
cp
3.
Let
cu1
be the code unit whose value is
floor
((
cp
- 0x10000) / 0x400) + 0xD800.
4.
Let
cu2
be the code unit whose value is ((
cp
- 0x10000)
modulo
0x400) + 0xDC00.
5.
Return the
string-concatenation
of
cu1
and
cu2
11.1.2
Static Semantics: CodePointsToString (
text
The abstract operation CodePointsToString takes argument
text
(a sequence of Unicode code points). It converts
text
into a String value, as described in
6.1.4
. It performs the following steps when called:
1.
Let
result
be the empty String.
2.
For each code point
cp
of
text
, do
a.
Set
result
to the
string-concatenation
of
result
and !
UTF16EncodeCodePoint
cp
).
3.
Return
result
11.1.3
Static Semantics: UTF16SurrogatePairToCodePoint (
lead
trail
The abstract operation UTF16SurrogatePairToCodePoint takes arguments
lead
(a code unit) and
trail
(a code unit). Two code units that form a UTF-16
surrogate pair
are converted to a code point. It performs the following steps when called:
1.
Assert
lead
is a
leading surrogate
and
trail
is a
trailing surrogate
2.
Let
cp
be (
lead
- 0xD800) × 0x400 + (
trail
- 0xDC00) + 0x10000.
3.
Return the code point
cp
11.1.4
Static Semantics: CodePointAt (
string
position
The abstract operation CodePointAt takes arguments
string
(a String) and
position
(a non-negative
integer
). It interprets
string
as a sequence of UTF-16 encoded code points, as described in
6.1.4
, and reads from it a single code point starting with the code unit at index
position
. It performs the following steps when called:
1.
Let
size
be the length of
string
2.
Assert
position
≥ 0 and
position
size
3.
Let
first
be the code unit at index
position
within
string
4.
Let
cp
be the code point whose numeric value is that of
first
5.
If
first
is not a
leading surrogate
or
trailing surrogate
, then
a.
Return the
Record
{ [[CodePoint]]:
cp
, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:
false
}.
6.
If
first
is a
trailing surrogate
or
position
+ 1 =
size
, then
a.
Return the
Record
{ [[CodePoint]]:
cp
, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:
true
}.
7.
Let
second
be the code unit at index
position
+ 1 within
string
8.
If
second
is not a
trailing surrogate
, then
a.
Return the
Record
{ [[CodePoint]]:
cp
, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:
true
}.
9.
Set
cp
to !
UTF16SurrogatePairToCodePoint
first
second
).
10.
Return the
Record
{ [[CodePoint]]:
cp
, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:
false
}.
11.1.5
Static Semantics: StringToCodePoints (
string
The abstract operation StringToCodePoints takes argument
string
(a String). It returns the sequence of Unicode code points that results from interpreting
string
as UTF-16 encoded Unicode text as described in
6.1.4
. It performs the following steps when called:
1.
Let
codePoints
be a new empty
List
2.
Let
size
be the length of
string
3.
Let
position
be 0.
4.
Repeat, while
position
size
a.
Let
cp
be !
CodePointAt
string
position
).
b.
Append
cp
.[[CodePoint]] to
codePoints
c.
Set
position
to
position
cp
.[[CodeUnitCount]].
5.
Return
codePoints
11.1.6
Static Semantics: ParseText (
sourceText
goalSymbol
The abstract operation ParseText takes arguments
sourceText
(a sequence of Unicode code points) and
goalSymbol
(a nonterminal in one of the ECMAScript grammars). It performs the following steps when called:
1.
Attempt to parse
sourceText
using
goalSymbol
as the
goal symbol
, and analyse the parse result for any
early error
conditions. Parsing and
early error
detection may be interleaved in an
implementation-defined
manner.
2.
If the parse succeeded and no early errors were found, return the
Parse Node
(an instance of
goalSymbol
) at the root of the parse tree resulting from the parse.
3.
Otherwise, return a
List
of one or more
SyntaxError
objects representing the parsing errors and/or early errors. If more than one parsing error or
early error
is present, the number and ordering of error objects in the list is
implementation-defined
, but at least one must be present.
Note 1
Consider a text that has an
early error
at a particular point, and also a syntax error at a later point. An
implementation that does a parse pass followed by an early errors pass
might report the syntax error and not proceed to the early errors pass.
An implementation that interleaves the two activities might report the
early error
and not proceed to find the syntax error. A third implementation might
report both errors. All of these behaviours are conformant.
Note 2
See also clause
17
11.2
Types of Source Code
There are four types of ECMAScript code:
Global code
is source text that is treated as an ECMAScript
Script
. The global code of a particular
Script
does not include any source text that is parsed as part of a
FunctionDeclaration
FunctionExpression
GeneratorDeclaration
GeneratorExpression
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
AsyncGeneratorExpression
MethodDefinition
ArrowFunction
AsyncArrowFunction
ClassDeclaration
, or
ClassExpression
Eval code
is the source text supplied to the built-in
eval
function. More precisely, if the parameter to the built-in
eval
function is a String, it is treated as an ECMAScript
Script
. The eval code for a particular invocation of
eval
is the global code portion of that
Script
Function code
is source text that is parsed to supply the value of the [[ECMAScriptCode]] and [[FormalParameters]] internal slots (see
10.2
) of an ECMAScript
function object
The function code of a particular ECMAScript function does not include
any source text that is parsed as the function code of a nested
FunctionDeclaration
FunctionExpression
GeneratorDeclaration
GeneratorExpression
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
AsyncGeneratorExpression
MethodDefinition
ArrowFunction
AsyncArrowFunction
ClassDeclaration
, or
ClassExpression
In addition, if the source text referred to above is parsed as:
the
FormalParameters
and
FunctionBody
of a
FunctionDeclaration
or
FunctionExpression
the
FormalParameters
and
GeneratorBody
of a
GeneratorDeclaration
or
GeneratorExpression
the
FormalParameters
and
AsyncFunctionBody
of an
AsyncFunctionDeclaration
or
AsyncFunctionExpression
, or
the
FormalParameters
and
AsyncGeneratorBody
of an
AsyncGeneratorDeclaration
or
AsyncGeneratorExpression
then the source text matching the
BindingIdentifier
(if any) of that declaration or expression is also included in the function code of the corresponding function.
Module code
is source text that is code that is provided as a
ModuleBody
It is the code that is directly evaluated when a module is initialized.
The module code of a particular module does not include any source text
that is parsed as part of a nested
FunctionDeclaration
FunctionExpression
GeneratorDeclaration
GeneratorExpression
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
AsyncGeneratorExpression
MethodDefinition
ArrowFunction
AsyncArrowFunction
ClassDeclaration
, or
ClassExpression
Note 1
Function code is generally provided as the bodies of Function Definitions (
15.2
), Arrow Function Definitions (
15.3
), Method Definitions (
15.4
), Generator Function Definitions (
15.5
), Async Function Definitions (
15.8
), Async Generator Function Definitions (
15.6
), and Async Arrow Functions (
15.9
). Function code is also derived from the arguments to the Function
constructor
20.2.1.1
), the GeneratorFunction
constructor
27.3.1.1
), and the AsyncFunction
constructor
27.7.1.1
).
Note 2
The practical effect of including the
BindingIdentifier
in function code is that the Early Errors for
strict mode code
are applied to a
BindingIdentifier
that is the name of a function whose body contains a "use strict" directive, even if the surrounding code is not
strict mode code
11.2.1
Directive Prologues and the Use Strict Directive
Directive Prologue
is the longest sequence of
ExpressionStatement
s occurring as the initial
StatementListItem
s or
ModuleItem
s of a
FunctionBody
, a
ScriptBody
, or a
ModuleBody
and where each
ExpressionStatement
in the sequence consists entirely of a
StringLiteral
token followed by a semicolon. The semicolon may appear explicitly or may be inserted by automatic semicolon insertion (
12.9
). A
Directive Prologue
may be an empty sequence.
Use Strict Directive
is an
ExpressionStatement
in a
Directive Prologue
whose
StringLiteral
is either of the exact code point sequences
"use strict"
or
'use strict'
. A
Use Strict Directive
may not contain an
EscapeSequence
or
LineContinuation
Directive Prologue
may contain more than one
Use Strict Directive
. However, an implementation may issue a warning if this occurs.
Note
The
ExpressionStatement
s of a
Directive Prologue
are evaluated normally during evaluation of the containing production.
Implementations may define implementation specific meanings for
ExpressionStatement
s which are not a
Use Strict Directive
and which occur in a
Directive Prologue
. If an appropriate notification mechanism exists, an implementation should issue a warning if it encounters in a
Directive Prologue
an
ExpressionStatement
that is not a
Use Strict Directive
and which does not have a meaning defined by the implementation.
11.2.2
Strict Mode Code
An ECMAScript syntactic unit may be processed using either unrestricted or strict mode syntax and semantics (
4.3.2
). Code is interpreted as
strict mode code
in the following situations:
Global code is strict mode code if it begins with a
Directive Prologue
that contains a
Use Strict Directive
Module code is always strict mode code.
All parts of a
ClassDeclaration
or a
ClassExpression
are strict mode code.
Eval code is strict mode code if it begins with a
Directive Prologue
that contains a
Use Strict Directive
or if the call to
eval
is a
direct eval
that is contained in strict mode code.
Function code is strict mode code if the associated
FunctionDeclaration
FunctionExpression
GeneratorDeclaration
GeneratorExpression
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
AsyncGeneratorExpression
MethodDefinition
ArrowFunction
, or
AsyncArrowFunction
is contained in strict mode code or if the code that produces the value
of the function's [[ECMAScriptCode]] internal slot begins with a
Directive Prologue
that contains a
Use Strict Directive
Function code that is supplied as the arguments to the
built-in Function, Generator, AsyncFunction, and AsyncGenerator
constructors is strict mode code if the last argument is a String that
when processed is a
FunctionBody
that begins with a
Directive Prologue
that contains a
Use Strict Directive
ECMAScript code that is not strict mode code is called
non-strict code
11.2.3
Non-ECMAScript Functions
An ECMAScript implementation may support the evaluation of
function exotic objects whose evaluative behaviour is expressed in some
host-defined
form of executable code other than via ECMAScript code. Whether a
function object
is an ECMAScript code function or a non-ECMAScript function is not
semantically observable from the perspective of an ECMAScript code
function that calls or is called by such a non-ECMAScript function.
12
ECMAScript Language: Lexical Grammar
The source text of an ECMAScript
Script
or
Module
is first converted into a sequence of input elements, which are tokens,
line terminators, comments, or white space. The source text is scanned
from left to right, repeatedly taking the longest possible sequence of
code points as the next input element.
There are several situations where the identification of lexical
input elements is sensitive to the syntactic grammar context that is
consuming the input elements. This requires multiple goal symbols for
the lexical grammar. The
InputElementRegExpOrTemplateTail
goal is used in syntactic grammar contexts where a
RegularExpressionLiteral
, a
TemplateMiddle
, or a
TemplateTail
is permitted. The
InputElementRegExp
goal symbol
is used in all syntactic grammar contexts where a
RegularExpressionLiteral
is permitted but neither a
TemplateMiddle
, nor a
TemplateTail
is permitted. The
InputElementTemplateTail
goal is used in all syntactic grammar contexts where a
TemplateMiddle
or a
TemplateTail
is permitted but a
RegularExpressionLiteral
is not permitted. In all other contexts,
InputElementDiv
is used as the lexical
goal symbol
Note
The use of multiple lexical goals ensures that there are no
lexical ambiguities that would affect automatic semicolon insertion. For
example, there are no syntactic grammar contexts where both a leading
division or division-assignment, and a leading
RegularExpressionLiteral
are permitted. This is not affected by semicolon insertion (see
12.9
); in examples such as the following:
a = b
/hi/g.exec(c).map(d);
where the first non-whitespace, non-comment code point after a
LineTerminator
is U+002F (SOLIDUS) and the syntactic context allows division or division-assignment, no semicolon is inserted at the
LineTerminator
. That is, the above example is interpreted in the same way as:
a = b / hi / g.exec(c).map(d);
Syntax
InputElementDiv
::
WhiteSpace
LineTerminator
Comment
CommonToken
DivPunctuator
RightBracePunctuator
InputElementRegExp
::
WhiteSpace
LineTerminator
Comment
CommonToken
RightBracePunctuator
RegularExpressionLiteral
InputElementRegExpOrTemplateTail
::
WhiteSpace
LineTerminator
Comment
CommonToken
RegularExpressionLiteral
TemplateSubstitutionTail
InputElementTemplateTail
::
WhiteSpace
LineTerminator
Comment
CommonToken
DivPunctuator
TemplateSubstitutionTail
12.1
Unicode Format-Control Characters
The Unicode format-control characters (i.e., the characters in
category “Cf” in the Unicode Character Database such as LEFT-TO-RIGHT
MARK or RIGHT-TO-LEFT MARK) are control codes used to control the
formatting of a range of text in the absence of higher-level protocols
for this (such as mark-up languages).
It is useful to allow format-control characters in source text to
facilitate editing and display. All format control characters may be
used within comments, and within string literals, template literals, and
regular expression literals.
U+200C (ZERO WIDTH NON-JOINER) and U+200D (ZERO WIDTH JOINER) are
format-control characters that are used to make necessary distinctions
when forming words or phrases in certain languages. In ECMAScript source
text these code points may also be used in an
IdentifierName
after the first character.
U+FEFF (ZERO WIDTH NO-BREAK SPACE) is a format-control character
used primarily at the start of a text to mark it as Unicode and to allow
detection of the text's encoding and byte order.
characters intended for this purpose can sometimes also appear after the
start of a text, for example as a result of concatenating files. In
ECMAScript source text code points are treated as white
space characters (see
12.2
).
The special treatment of certain format-control characters
outside of comments, string literals, and regular expression literals is
summarized in
Table 33
Table 33: Format-Control Code Point Usage
Code Point
Name
Abbreviation
Usage
U+200C
ZERO WIDTH NON-JOINER

IdentifierPart
U+200D
ZERO WIDTH JOINER

IdentifierPart
U+FEFF
ZERO WIDTH NO-BREAK SPACE

WhiteSpace
12.2
White Space
White space code points are used to improve source text
readability and to separate tokens (indivisible lexical units) from each
other, but are otherwise insignificant. White space code points may
occur between any two tokens and at the start or end of input. White
space code points may occur within a
StringLiteral
, a
RegularExpressionLiteral
, a
Template
, or a
TemplateSubstitutionTail
where they are considered significant code points forming part of a literal value. They may also occur within a
Comment
, but cannot appear within any other kind of token.
The ECMAScript white space code points are listed in
Table 34
Table 34: White Space Code Points
Code Point
Name
Abbreviation
U+0009
CHARACTER TABULATION

U+000B
LINE TABULATION

U+000C
FORM FEED (FF)

U+0020
SPACE

U+00A0
NO-BREAK SPACE

U+FEFF
ZERO WIDTH NO-BREAK SPACE

Other category “Zs”
Any other Unicode “Space_Separator” code point

ECMAScript implementations must recognize as
WhiteSpace
code points listed in the “Space_Separator” (“Zs”) category.
Note
Other than for the code points listed in
Table 34
, ECMAScript
WhiteSpace
intentionally excludes all code points that have the Unicode
“White_Space” property but which are not classified in category
“Space_Separator” (“Zs”).
Syntax
WhiteSpace
::







12.3
Line Terminators
Like white space code points, line terminator code points are
used to improve source text readability and to separate tokens
(indivisible lexical units) from each other. However, unlike white space
code points, line terminators have some influence over the behaviour of
the syntactic grammar. In general, line terminators may occur between
any two tokens, but there are a few places where they are forbidden by
the syntactic grammar. Line terminators also affect the process of
automatic semicolon insertion (
12.9
). A line terminator cannot occur within any token except a
StringLiteral
Template
, or
TemplateSubstitutionTail
. and line terminators cannot occur within a
StringLiteral
token except as part of a
LineContinuation
A line terminator can occur within a
MultiLineComment
but cannot occur within a
SingleLineComment
Line terminators are included in the set of white space code points that are matched by the
\s
class in regular expressions.
The ECMAScript line terminator code points are listed in
Table 35
Table 35: Line Terminator Code Points
Code Point
Unicode Name
Abbreviation
U+000A
LINE FEED (LF)

U+000D
CARRIAGE RETURN (CR)

U+2028
LINE SEPARATOR

U+2029
PARAGRAPH SEPARATOR

Only the Unicode code points in
Table 35
are treated as line terminators. Other new line or line breaking
Unicode code points are not treated as line terminators but are treated
as white space if they meet the requirements listed in
Table 34
. The sequence is commonly used as a line terminator. It should be considered a single
SourceCharacter
for the purpose of reporting line numbers.
Syntax
LineTerminator
::




LineTerminatorSequence
::


[lookahead ≠





12.4
Comments
Comments can be either single or multi-line. Multi-line comments cannot nest.
Because a single-line comment can contain any Unicode code point except a
LineTerminator
code point, and because of the general rule that a token is always as
long as possible, a single-line comment always consists of all code
points from the
//
marker to the end of the line. However, the
LineTerminator
at the end of the line is not considered to be part of the single-line
comment; it is recognized separately by the lexical grammar and becomes
part of the stream of input elements for the syntactic grammar. This
point is very important, because it implies that the presence or absence
of single-line comments does not affect the process of automatic
semicolon insertion (see
12.9
).
Comments behave like white space and are discarded except that, if a
MultiLineComment
contains a line terminator code point, then the entire comment is considered to be a
LineTerminator
for purposes of parsing by the syntactic grammar.
Syntax
Comment
::
MultiLineComment
SingleLineComment
MultiLineComment
::
/*
MultiLineCommentChars
opt
*/
MultiLineCommentChars
::
MultiLineNotAsteriskChar
MultiLineCommentChars
opt
PostAsteriskCommentChars
opt
PostAsteriskCommentChars
::
MultiLineNotForwardSlashOrAsteriskChar
MultiLineCommentChars
opt
PostAsteriskCommentChars
opt
MultiLineNotAsteriskChar
::
SourceCharacter
but not
MultiLineNotForwardSlashOrAsteriskChar
::
SourceCharacter
but not one of
or
SingleLineComment
::
//
SingleLineCommentChars
opt
SingleLineCommentChars
::
SingleLineCommentChar
SingleLineCommentChars
opt
SingleLineCommentChar
::
SourceCharacter
but not
LineTerminator
A number of productions in this section are given alternative definitions in section
B.1.3
12.5
Tokens
Syntax
CommonToken
::
IdentifierName
Punctuator
NumericLiteral
StringLiteral
Template
Note
The
DivPunctuator
RegularExpressionLiteral
RightBracePunctuator
, and
TemplateSubstitutionTail
productions derive additional tokens that are not included in the
CommonToken
production.
12.6
Names and Keywords
IdentifierName
and
ReservedWord
are tokens that are interpreted according to the Default Identifier
Syntax given in Unicode Standard Annex #31, Identifier and Pattern
Syntax, with some small modifications.
ReservedWord
is an enumerated subset of
IdentifierName
. The syntactic grammar defines
Identifier
as an
IdentifierName
that is not a
ReservedWord
The Unicode identifier grammar is based on character properties
specified by the Unicode Standard. The Unicode code points in the
specified categories in the latest version of the Unicode standard must
be treated as in those categories by all conforming ECMAScript
implementations. ECMAScript implementations may recognize identifier
code points defined in later editions of the Unicode Standard.
Note 1
This standard specifies specific code point additions: U+0024 (DOLLAR SIGN) and U+005F (LOW LINE) are permitted anywhere in an
IdentifierName
and the code points U+200C (ZERO WIDTH NON-JOINER) and U+200D (ZERO
WIDTH JOINER) are permitted anywhere after the first code point of an
IdentifierName
Unicode escape sequences are permitted in an
IdentifierName
, where they contribute a single Unicode code point to the
IdentifierName
. The code point is expressed by the
CodePoint
of the
UnicodeEscapeSequence
(see
12.8.4
). The
preceding the
UnicodeEscapeSequence
and the
and
{ }
code units, if they appear, do not contribute code points to the
IdentifierName
. A
UnicodeEscapeSequence
cannot be used to put a code point into an
IdentifierName
that would otherwise be illegal. In other words, if a
UnicodeEscapeSequence
sequence were replaced by the
SourceCharacter
it contributes, the result must still be a valid
IdentifierName
that has the exact same sequence of
SourceCharacter
elements as the original
IdentifierName
. All interpretations of
IdentifierName
within this specification are based upon their actual code points
regardless of whether or not an escape sequence was used to contribute
any particular code point.
Two
IdentifierName
s that are canonically equivalent according to the Unicode standard are
not
equal unless, after replacement of each
UnicodeEscapeSequence
, they are represented by the exact same sequence of code points.
Syntax
IdentifierName
::
IdentifierStart
IdentifierName
IdentifierPart
IdentifierStart
::
UnicodeIDStart
UnicodeEscapeSequence
IdentifierPart
::
UnicodeIDContinue
UnicodeEscapeSequence


UnicodeIDStart
::
any Unicode code point with the Unicode property “ID_Start”
UnicodeIDContinue
::
any Unicode code point with the Unicode property “ID_Continue”
The definitions of the nonterminal
UnicodeEscapeSequence
is given in
12.8.4
Note 2
The nonterminal
IdentifierPart
derives
via
UnicodeIDContinue
Note 3
The sets of code points with Unicode properties “ID_Start” and
“ID_Continue” include, respectively, the code points with Unicode
properties “Other_ID_Start” and “Other_ID_Continue”.
12.6.1
Identifier Names
12.6.1.1
Static Semantics: Early Errors
IdentifierStart
::
UnicodeEscapeSequence
It is a Syntax Error if the
SV
of
UnicodeEscapeSequence
is none of
"$"
, or
"_"
, or !
UTF16EncodeCodePoint
cp
) for some Unicode code point
cp
matched by the
UnicodeIDStart
lexical grammar production.
IdentifierPart
::
UnicodeEscapeSequence
It is a Syntax Error if the
SV
of
UnicodeEscapeSequence
is none of
"$"
"_"
, !
UTF16EncodeCodePoint
(), !
UTF16EncodeCodePoint
(), or !
UTF16EncodeCodePoint
cp
) for some Unicode code point
cp
that would be matched by the
UnicodeIDContinue
lexical grammar production.
12.6.2
Keywords and Reserved Words
keyword
is a token that matches
IdentifierName
, but also has a syntactic use; that is, it appears literally, in a
fixed width
font, in some syntactic production. The keywords of ECMAScript include
if
while
async
await
, and many others.
reserved word
is an
IdentifierName
that cannot be used as an identifier. Many keywords are reserved words,
but some are not, and some are reserved only in certain contexts.
if
and
while
are reserved words.
await
is reserved only inside async functions and modules.
async
is not reserved; it can be used as a variable name or statement label without restriction.
This specification uses a combination of grammatical productions and
early error
rules to specify which names are valid identifiers and which are reserved words. All tokens in the
ReservedWord
list below, except for
await
and
yield
, are unconditionally reserved. Exceptions for
await
and
yield
are specified in
13.1
, using parameterized syntactic productions. Lastly, several
early error
rules restrict the set of valid identifiers. See
13.1.1
14.3.1.1
14.7.5.1
, and
15.7.1
. In summary, there are five categories of identifier names:
Those that are always allowed as identifiers, and are not keywords, such as
Math
window
toString
, and
Those that are never allowed as identifiers, namely the
ReservedWord
s listed below except
await
and
yield
Those that are contextually allowed as identifiers, namely
await
and
yield
Those that are contextually disallowed as identifiers, in
strict mode code
let
static
implements
interface
package
private
protected
, and
public
Those that are always allowed as identifiers, but also appear as keywords within certain syntactic productions, at places where
Identifier
is not allowed:
as
async
from
get
of
set
, and
target
The term
conditional keyword
, or
contextual keyword
is sometimes used to refer to the keywords that fall in the last three
categories, and thus can be used as identifiers in some contexts and as
keywords in others.
Syntax
ReservedWord
::
one of
await
break
case
catch
class
const
continue
debugger
default
delete
do
else
enum
export
extends
false
finally
for
function
if
import
in
instanceof
new
null
return
super
switch
this
throw
true
try
typeof
var
void
while
with
yield
Note 1
Per
5.1.5
, keywords in the grammar match literal sequences of specific
SourceCharacter
elements. A code point in a keyword cannot be expressed by a
UnicodeEscapeSequence
An
IdentifierName
can contain
UnicodeEscapeSequence
s, but it is not possible to declare a variable named "else" by spelling it
els\u{65}
. The
early error
rules in
13.1.1
rule out identifiers with the same
StringValue
as a reserved word.
Note 2
enum
is not currently used as a keyword in this specification. It is a
future reserved word
, set aside for use as a keyword in future language extensions.
Similarly,
implements
interface
package
private
protected
, and
public
are future reserved words in
strict mode code
Note 3
The names
arguments
and
eval
are not keywords, but they are subject to some restrictions in
strict mode code
. See
13.1.1
8.5.4
15.2.1
15.5.1
15.6.1
, and
15.8.1
12.7
Punctuators
Syntax
Punctuator
::
OptionalChainingPunctuator
OtherPunctuator
OptionalChainingPunctuator
::
?.
[lookahead ∉
DecimalDigit
OtherPunctuator
::
one of
...
<=
>=
==
!=
===
!==
**
++
--
<<
>>
>>>
&&
||
??
+=
-=
*=
%=
**=
<<=
>>=
>>>=
&=
|=
^=
&&=
||=
??=
=>
DivPunctuator
::
/=
RightBracePunctuator
::
12.8
Literals
12.8.1
Null Literals
Syntax
NullLiteral
::
null
12.8.2
Boolean Literals
Syntax
BooleanLiteral
::
true
false
12.8.3
Numeric Literals
Syntax
NumericLiteralSeparator
::
NumericLiteral
::
DecimalLiteral
DecimalBigIntegerLiteral
NonDecimalIntegerLiteral
[+Sep]
NonDecimalIntegerLiteral
[+Sep]
BigIntLiteralSuffix
DecimalBigIntegerLiteral
::
BigIntLiteralSuffix
NonZeroDigit
DecimalDigits
[+Sep]
opt
BigIntLiteralSuffix
NonZeroDigit
NumericLiteralSeparator
DecimalDigits
[+Sep]
BigIntLiteralSuffix
NonDecimalIntegerLiteral
[Sep]
::
BinaryIntegerLiteral
[?Sep]
OctalIntegerLiteral
[?Sep]
HexIntegerLiteral
[?Sep]
BigIntLiteralSuffix
::
DecimalLiteral
::
DecimalIntegerLiteral
DecimalDigits
[+Sep]
opt
ExponentPart
[+Sep]
opt
DecimalDigits
[+Sep]
ExponentPart
[+Sep]
opt
DecimalIntegerLiteral
ExponentPart
[+Sep]
opt
DecimalIntegerLiteral
::
NonZeroDigit
NonZeroDigit
NumericLiteralSeparator
opt
DecimalDigits
[+Sep]
DecimalDigits
[Sep]
::
DecimalDigit
DecimalDigits
[?Sep]
DecimalDigit
[+Sep]
DecimalDigits
[+Sep]
NumericLiteralSeparator
DecimalDigit
DecimalDigit
::
one of
NonZeroDigit
::
one of
ExponentPart
[Sep]
::
ExponentIndicator
SignedInteger
[?Sep]
ExponentIndicator
::
one of
SignedInteger
[Sep]
::
DecimalDigits
[?Sep]
DecimalDigits
[?Sep]
DecimalDigits
[?Sep]
BinaryIntegerLiteral
[Sep]
::
0b
BinaryDigits
[?Sep]
0B
BinaryDigits
[?Sep]
BinaryDigits
[Sep]
::
BinaryDigit
BinaryDigits
[?Sep]
BinaryDigit
[+Sep]
BinaryDigits
[+Sep]
NumericLiteralSeparator
BinaryDigit
BinaryDigit
::
one of
OctalIntegerLiteral
[Sep]
::
0o
OctalDigits
[?Sep]
0O
OctalDigits
[?Sep]
OctalDigits
[Sep]
::
OctalDigit
OctalDigits
[?Sep]
OctalDigit
[+Sep]
OctalDigits
[+Sep]
NumericLiteralSeparator
OctalDigit
OctalDigit
::
one of
HexIntegerLiteral
[Sep]
::
0x
HexDigits
[?Sep]
0X
HexDigits
[?Sep]
HexDigits
[Sep]
::
HexDigit
HexDigits
[?Sep]
HexDigit
[+Sep]
HexDigits
[+Sep]
NumericLiteralSeparator
HexDigit
HexDigit
::
one of
The
SourceCharacter
immediately following a
NumericLiteral
must not be an
IdentifierStart
or
DecimalDigit
Note
For example:
3in
is an error and not the two input elements
and
in
A conforming implementation, when processing
strict mode code
, must not extend, as described in
B.1.1
, the syntax of
NumericLiteral
to include
LegacyOctalIntegerLiteral
, nor extend the syntax of
DecimalIntegerLiteral
to include
NonOctalDecimalIntegerLiteral
12.8.3.1
Static Semantics: MV
A numeric literal stands for a value of the Number type or the BigInt type.
The MV of
NumericLiteral
::
DecimalLiteral
is the MV of
DecimalLiteral
The MV of
NonDecimalIntegerLiteral
::
BinaryIntegerLiteral
is the MV of
BinaryIntegerLiteral
The MV of
NonDecimalIntegerLiteral
::
OctalIntegerLiteral
is the MV of
OctalIntegerLiteral
The MV of
NonDecimalIntegerLiteral
::
HexIntegerLiteral
is the MV of
HexIntegerLiteral
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
is the MV of
DecimalIntegerLiteral
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
DecimalDigits
is the MV of
DecimalIntegerLiteral
plus (the MV of
DecimalDigits
× 10
), where
is the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
ExponentPart
is the MV of
DecimalIntegerLiteral
× 10
, where
is the MV of
ExponentPart
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
DecimalDigits
ExponentPart
is (the MV of
DecimalIntegerLiteral
plus (the MV of
DecimalDigits
× 10
)) × 10
, where
is the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
and
is the MV of
ExponentPart
The MV of
DecimalLiteral
::
DecimalDigits
is the MV of
DecimalDigits
× 10
, where
is the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
The MV of
DecimalLiteral
::
DecimalDigits
ExponentPart
is the MV of
DecimalDigits
× 10
, where
is the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
, and
is the MV of
ExponentPart
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
is the MV of
DecimalIntegerLiteral
The MV of
DecimalLiteral
::
DecimalIntegerLiteral
ExponentPart
is the MV of
DecimalIntegerLiteral
× 10
, where
is the MV of
ExponentPart
The MV of
DecimalIntegerLiteral
::
is 0.
The MV of
DecimalIntegerLiteral
::
NonZeroDigit
is the MV of
NonZeroDigit
The MV of
DecimalIntegerLiteral
::
NonZeroDigit
NumericLiteralSeparator
opt
DecimalDigits
is (the MV of
NonZeroDigit
× 10
) plus the MV of
DecimalDigits
, where
is the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
The MV of
DecimalDigits
::
DecimalDigit
is the MV of
DecimalDigit
The MV of
DecimalDigits
::
DecimalDigits
DecimalDigit
is (the MV of
DecimalDigits
× 10) plus the MV of
DecimalDigit
The MV of
DecimalDigits
::
DecimalDigits
NumericLiteralSeparator
DecimalDigit
is (the MV of
DecimalDigits
× 10) plus the MV of
DecimalDigit
The MV of
ExponentPart
::
ExponentIndicator
SignedInteger
is the MV of
SignedInteger
The MV of
SignedInteger
::
DecimalDigits
is the MV of
DecimalDigits
The MV of
SignedInteger
::
DecimalDigits
is the MV of
DecimalDigits
The MV of
SignedInteger
::
DecimalDigits
is the negative of the MV of
DecimalDigits
The MV of
DecimalDigit
::
or of
HexDigit
::
or of
OctalDigit
::
or of
BinaryDigit
::
is 0.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
or of
BinaryDigit
::
is 1.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 2.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 3.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 4.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 5.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 6.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
or of
OctalDigit
::
is 7.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
is 8.
The MV of
DecimalDigit
::
or of
NonZeroDigit
::
or of
HexDigit
::
is 9.
The MV of
HexDigit
::
or of
HexDigit
::
is 10.
The MV of
HexDigit
::
or of
HexDigit
::
is 11.
The MV of
HexDigit
::
or of
HexDigit
::
is 12.
The MV of
HexDigit
::
or of
HexDigit
::
is 13.
The MV of
HexDigit
::
or of
HexDigit
::
is 14.
The MV of
HexDigit
::
or of
HexDigit
::
is 15.
The MV of
BinaryIntegerLiteral
::
0b
BinaryDigits
is the MV of
BinaryDigits
The MV of
BinaryIntegerLiteral
::
0B
BinaryDigits
is the MV of
BinaryDigits
The MV of
BinaryDigits
::
BinaryDigit
is the MV of
BinaryDigit
The MV of
BinaryDigits
::
BinaryDigits
BinaryDigit
is (the MV of
BinaryDigits
× 2) plus the MV of
BinaryDigit
The MV of
BinaryDigits
::
BinaryDigits
NumericLiteralSeparator
BinaryDigit
is (the MV of
BinaryDigits
× 2) plus the MV of
BinaryDigit
The MV of
OctalIntegerLiteral
::
0o
OctalDigits
is the MV of
OctalDigits
The MV of
OctalIntegerLiteral
::
0O
OctalDigits
is the MV of
OctalDigits
The MV of
OctalDigits
::
OctalDigit
is the MV of
OctalDigit
The MV of
OctalDigits
::
OctalDigits
OctalDigit
is (the MV of
OctalDigits
× 8) plus the MV of
OctalDigit
The MV of
OctalDigits
::
OctalDigits
NumericLiteralSeparator
OctalDigit
is (the MV of
OctalDigits
× 8) plus the MV of
OctalDigit
The MV of
HexIntegerLiteral
::
0x
HexDigits
is the MV of
HexDigits
The MV of
HexIntegerLiteral
::
0X
HexDigits
is the MV of
HexDigits
The MV of
HexDigits
::
HexDigit
is the MV of
HexDigit
The MV of
HexDigits
::
HexDigits
HexDigit
is (the MV of
HexDigits
× 16) plus the MV of
HexDigit
The MV of
HexDigits
::
HexDigits
NumericLiteralSeparator
HexDigit
is (the MV of
HexDigits
× 16) plus the MV of
HexDigit
12.8.3.2
Static Semantics: NumericValue
NumericLiteral
::
DecimalLiteral
1.
Return the
Number value
that results from rounding the MV of
DecimalLiteral
as described below.
NumericLiteral
::
NonDecimalIntegerLiteral
1.
Return the
Number value
that results from rounding the MV of
NonDecimalIntegerLiteral
as described below.
Once the exact MV for a numeric literal has been determined,
it is then rounded to a value of the Number type. If the MV is 0, then
the rounded value is
+0
; otherwise, the rounded value must be the
Number value
for the MV (as specified in
6.1.6.1
), unless the literal is a
DecimalLiteral
and the literal has more than 20 significant digits, in which case the
Number value
may be either the
Number value
for the MV of a literal produced by replacing each significant digit after the 20th with a
digit or the
Number value
for the MV of a literal produced by replacing each significant digit after the 20th with a
digit and then incrementing the literal at the 20th significant digit position. A digit is
significant
if it is not part of an
ExponentPart
and
it is not
; or
there is a non-zero digit to its left and there is a non-zero digit, not in the
ExponentPart
, to its right.
NumericLiteral
::
NonDecimalIntegerLiteral
BigIntLiteralSuffix
1.
Return the BigInt value that represents the MV of
NonDecimalIntegerLiteral
DecimalBigIntegerLiteral
::
BigIntLiteralSuffix
1.
Return
DecimalBigIntegerLiteral
::
NonZeroDigit
BigIntLiteralSuffix
1.
Return the BigInt value that represents the MV of
NonZeroDigit
DecimalBigIntegerLiteral
::
NonZeroDigit
DecimalDigits
BigIntLiteralSuffix
NonZeroDigit
NumericLiteralSeparator
DecimalDigits
BigIntLiteralSuffix
1.
Let
be the number of code points in
DecimalDigits
, excluding all occurrences of
NumericLiteralSeparator
2.
Let
mv
be (the MV of
NonZeroDigit
× 10) plus the MV of
DecimalDigits
3.
Return
mv
).
12.8.4
String Literals
Note 1
A string literal is 0 or more Unicode code points enclosed in
single or double quotes. Unicode code points may also be represented by
an escape sequence. All code points may appear literally in a string
literal except for the closing quote code points, U+005C (REVERSE
SOLIDUS), U+000D (CARRIAGE RETURN), and U+000A (LINE FEED). Any code
points may appear in the form of an escape sequence. String literals
evaluate to ECMAScript String values. When generating these String
values Unicode code points are UTF-16 encoded as defined in
11.1.1
Code points belonging to the Basic Multilingual Plane are encoded as a
single code unit element of the string. All other code points are
encoded as two code unit elements of the string.
Syntax
StringLiteral
::
DoubleStringCharacters
opt
SingleStringCharacters
opt
DoubleStringCharacters
::
DoubleStringCharacter
DoubleStringCharacters
opt
SingleStringCharacters
::
SingleStringCharacter
SingleStringCharacters
opt
DoubleStringCharacter
::
SourceCharacter
but not one of
or
or
LineTerminator


EscapeSequence
LineContinuation
SingleStringCharacter
::
SourceCharacter
but not one of
or
or
LineTerminator


EscapeSequence
LineContinuation
LineContinuation
::
LineTerminatorSequence
EscapeSequence
::
CharacterEscapeSequence
[lookahead ∉
DecimalDigit
HexEscapeSequence
UnicodeEscapeSequence
A conforming implementation, when processing
strict mode code
, must not extend the syntax of
EscapeSequence
to include
LegacyOctalEscapeSequence
or
NonOctalDecimalEscapeSequence
as described in
B.1.2
CharacterEscapeSequence
::
SingleEscapeCharacter
NonEscapeCharacter
SingleEscapeCharacter
::
one of
NonEscapeCharacter
::
SourceCharacter
but not one of
EscapeCharacter
or
LineTerminator
EscapeCharacter
::
SingleEscapeCharacter
DecimalDigit
HexEscapeSequence
::
HexDigit
HexDigit
UnicodeEscapeSequence
::
Hex4Digits
u{
CodePoint
Hex4Digits
::
HexDigit
HexDigit
HexDigit
HexDigit
The definition of the nonterminal
HexDigit
is given in
12.8.3
SourceCharacter
is defined in
11.1
Note 2
and cannot appear in a string literal, except as part of a
LineContinuation
to produce the empty code points sequence. The proper way to include
either in the String value of a string literal is to use an escape
sequence such as
\n
or
\u000A
12.8.4.1
Static Semantics: SV
A string literal stands for a value of the String type. The
String value (SV) of the literal is described in terms of String values
contributed by the various parts of the string literal. As part of this
process, some Unicode code points within the string literal are
interpreted as having a
mathematical value
(MV), as described below or in
12.8.3
The SV of
StringLiteral
::
is the empty String.
The SV of
StringLiteral
::
is the empty String.
The SV of
DoubleStringCharacters
::
DoubleStringCharacter
DoubleStringCharacters
is the
string-concatenation
of the SV of
DoubleStringCharacter
and the SV of
DoubleStringCharacters
The SV of
SingleStringCharacters
::
SingleStringCharacter
SingleStringCharacters
is the
string-concatenation
of the SV of
SingleStringCharacter
and the SV of
SingleStringCharacters
The SV of
DoubleStringCharacter
::
SourceCharacter
but not one of
or
or
LineTerminator
is the result of performing
UTF16EncodeCodePoint
on the code point value of
SourceCharacter
The SV of
DoubleStringCharacter
::

is the String value consisting of the code unit 0x2028 (LINE SEPARATOR).
The SV of
DoubleStringCharacter
::

is the String value consisting of the code unit 0x2029 (PARAGRAPH SEPARATOR).
The SV of
DoubleStringCharacter
::
LineContinuation
is the empty String.
The SV of
SingleStringCharacter
::
SourceCharacter
but not one of
or
or
LineTerminator
is the result of performing
UTF16EncodeCodePoint
on the code point value of
SourceCharacter
The SV of
SingleStringCharacter
::

is the String value consisting of the code unit 0x2028 (LINE SEPARATOR).
The SV of
SingleStringCharacter
::

is the String value consisting of the code unit 0x2029 (PARAGRAPH SEPARATOR).
The SV of
SingleStringCharacter
::
LineContinuation
is the empty String.
The SV of
EscapeSequence
::
is the String value consisting of the code unit 0x0000 (NULL).
The SV of
CharacterEscapeSequence
::
SingleEscapeCharacter
is the String value consisting of the code unit whose value is determined by the
SingleEscapeCharacter
according to
Table 36
Table 36: String Single Character Escape Sequences
Escape Sequence
Code Unit Value
Unicode Character Name
Symbol
\b
0x0008
BACKSPACE

\t
0x0009
CHARACTER TABULATION

\n
0x000A
LINE FEED (LF)

\v
0x000B
LINE TABULATION

\f
0x000C
FORM FEED (FF)

\r
0x000D
CARRIAGE RETURN (CR)

\"
0x0022
QUOTATION MARK
\'
0x0027
APOSTROPHE
\\
0x005C
REVERSE SOLIDUS
The SV of
NonEscapeCharacter
::
SourceCharacter
but not one of
EscapeCharacter
or
LineTerminator
is the result of performing
UTF16EncodeCodePoint
on the code point value of
SourceCharacter
The SV of
HexEscapeSequence
::
HexDigit
HexDigit
is the String value consisting of the code unit whose value is the MV of
HexEscapeSequence
The SV of
Hex4Digits
::
HexDigit
HexDigit
HexDigit
HexDigit
is the String value consisting of the code unit whose value is the MV of
Hex4Digits
The SV of
UnicodeEscapeSequence
::
u{
CodePoint
is the result of performing
UTF16EncodeCodePoint
on the MV of
CodePoint
12.8.4.2
Static Semantics: MV
The MV of
HexEscapeSequence
::
HexDigit
HexDigit
is (16 times the MV of the first
HexDigit
) plus the MV of the second
HexDigit
The MV of
Hex4Digits
::
HexDigit
HexDigit
HexDigit
HexDigit
is (0x1000 × the MV of the first
HexDigit
) plus (0x100 × the MV of the second
HexDigit
) plus (0x10 × the MV of the third
HexDigit
) plus the MV of the fourth
HexDigit
12.8.5
Regular Expression Literals
Note 1
A regular expression literal is an input element that is converted to a RegExp object (see
22.2
each time the literal is evaluated. Two regular expression literals in a
program evaluate to regular expression objects that never compare as
===
to each other even if the two literals' contents are identical. A RegExp object may also be created at runtime by
new RegExp
or calling the RegExp
constructor
as a function (see
22.2.3
).
The productions below describe the syntax for a regular
expression literal and are used by the input element scanner to find the
end of the regular expression literal. The source text comprising the
RegularExpressionBody
and the
RegularExpressionFlags
are subsequently parsed again using the more stringent ECMAScript Regular Expression grammar (
22.2.1
).
An implementation may extend the ECMAScript Regular Expression grammar defined in
22.2.1
, but it must not extend the
RegularExpressionBody
and
RegularExpressionFlags
productions defined below or the productions used by these productions.
Syntax
RegularExpressionLiteral
::
RegularExpressionBody
RegularExpressionFlags
RegularExpressionBody
::
RegularExpressionFirstChar
RegularExpressionChars
RegularExpressionChars
::
[empty]
RegularExpressionChars
RegularExpressionChar
RegularExpressionFirstChar
::
RegularExpressionNonTerminator
but not one of
or
or
or
RegularExpressionBackslashSequence
RegularExpressionClass
RegularExpressionChar
::
RegularExpressionNonTerminator
but not one of
or
or
RegularExpressionBackslashSequence
RegularExpressionClass
RegularExpressionBackslashSequence
::
RegularExpressionNonTerminator
RegularExpressionNonTerminator
::
SourceCharacter
but not
LineTerminator
RegularExpressionClass
::
RegularExpressionClassChars
RegularExpressionClassChars
::
[empty]
RegularExpressionClassChars
RegularExpressionClassChar
RegularExpressionClassChar
::
RegularExpressionNonTerminator
but not one of
or
RegularExpressionBackslashSequence
RegularExpressionFlags
::
[empty]
RegularExpressionFlags
IdentifierPart
Note 2
Regular expression literals may not be empty; instead of
representing an empty regular expression literal, the code unit sequence
//
starts a single-line comment. To specify an empty regular expression, use:
/(?:)/
12.8.5.1
Static Semantics: Early Errors
RegularExpressionFlags
::
RegularExpressionFlags
IdentifierPart
It is a Syntax Error if
IdentifierPart
contains a Unicode escape sequence.
12.8.5.2
Static Semantics: BodyText
RegularExpressionLiteral
::
RegularExpressionBody
RegularExpressionFlags
1.
Return the source text that was recognized as
RegularExpressionBody
12.8.5.3
Static Semantics: FlagText
RegularExpressionLiteral
::
RegularExpressionBody
RegularExpressionFlags
1.
Return the source text that was recognized as
RegularExpressionFlags
12.8.6
Template Literal Lexical Components
Syntax
Template
::
NoSubstitutionTemplate
TemplateHead
NoSubstitutionTemplate
::
TemplateCharacters
opt
TemplateHead
::
TemplateCharacters
opt
${
TemplateSubstitutionTail
::
TemplateMiddle
TemplateTail
TemplateMiddle
::
TemplateCharacters
opt
${
TemplateTail
::
TemplateCharacters
opt
TemplateCharacters
::
TemplateCharacter
TemplateCharacters
opt
TemplateCharacter
::
[lookahead ≠
EscapeSequence
NotEscapeSequence
LineContinuation
LineTerminatorSequence
SourceCharacter
but not one of
or
or
or
LineTerminator
NotEscapeSequence
::
DecimalDigit
DecimalDigit
but not
[lookahead ∉
HexDigit
HexDigit
[lookahead ∉
HexDigit
[lookahead ∉
HexDigit
[lookahead ≠
HexDigit
[lookahead ∉
HexDigit
HexDigit
HexDigit
[lookahead ∉
HexDigit
HexDigit
HexDigit
HexDigit
[lookahead ∉
HexDigit
[lookahead ∉
HexDigit
NotCodePoint
[lookahead ∉
HexDigit
CodePoint
[lookahead ∉
HexDigit
[lookahead ≠
NotCodePoint
::
HexDigits
[~Sep]
but only if MV of
HexDigits
> 0x10FFFF
CodePoint
::
HexDigits
[~Sep]
but only if MV of
HexDigits
≤ 0x10FFFF
A conforming implementation must not use the extended definition of
EscapeSequence
described in
B.1.2
when parsing a
TemplateCharacter
Note
TemplateSubstitutionTail
is used by the
InputElementTemplateTail
alternative lexical goal.
12.8.6.1
Static Semantics: TV and TRV
A template literal component is interpreted as a sequence of
Unicode code points. The Template Value (TV) of a literal component is
described in terms of String values (
SV
12.8.4
contributed by the various parts of the template literal component. As
part of this process, some Unicode code points within the template
component are interpreted as having a
mathematical value
(MV,
12.8.3
).
In determining a TV, escape sequences are replaced by the UTF-16 code
unit(s) of the Unicode code point represented by the escape sequence.
The Template Raw Value (TRV) is similar to a Template Value with the
difference that in TRVs escape sequences are interpreted literally.
The TV and TRV of
NoSubstitutionTemplate
::
is the empty String.
The TV and TRV of
TemplateHead
::
${
is the empty String.
The TV and TRV of
TemplateMiddle
::
${
is the empty String.
The TV and TRV of
TemplateTail
::
is the empty String.
The TV of
TemplateCharacters
::
TemplateCharacter
TemplateCharacters
is
undefined
if either the TV of
TemplateCharacter
is
undefined
or the TV of
TemplateCharacters
is
undefined
. Otherwise, it is the
string-concatenation
of the TV of
TemplateCharacter
and the TV of
TemplateCharacters
The TV of
TemplateCharacter
::
SourceCharacter
but not one of
or
or
or
LineTerminator
is the result of performing
UTF16EncodeCodePoint
on the code point value of
SourceCharacter
The TV of
TemplateCharacter
::
is the String value consisting of the code unit 0x0024 (DOLLAR SIGN).
The TV of
TemplateCharacter
::
EscapeSequence
is the
SV
of
EscapeSequence
The TV of
TemplateCharacter
::
NotEscapeSequence
is
undefined
The TV of
TemplateCharacter
::
LineTerminatorSequence
is the TRV of
LineTerminatorSequence
The TV of
LineContinuation
::
LineTerminatorSequence
is the empty String.
The TRV of
TemplateCharacters
::
TemplateCharacter
TemplateCharacters
is the
string-concatenation
of the TRV of
TemplateCharacter
and the TRV of
TemplateCharacters
The TRV of
TemplateCharacter
::
SourceCharacter
but not one of
or
or
or
LineTerminator
is the result of performing
UTF16EncodeCodePoint
on the code point value of
SourceCharacter
The TRV of
TemplateCharacter
::
is the String value consisting of the code unit 0x0024 (DOLLAR SIGN).
The TRV of
TemplateCharacter
::
EscapeSequence
is the
string-concatenation
of the code unit 0x005C (REVERSE SOLIDUS) and the TRV of
EscapeSequence
The TRV of
TemplateCharacter
::
NotEscapeSequence
is the
string-concatenation
of the code unit 0x005C (REVERSE SOLIDUS) and the TRV of
NotEscapeSequence
The TRV of
EscapeSequence
::
is the String value consisting of the code unit 0x0030 (DIGIT ZERO).
The TRV of
NotEscapeSequence
::
DecimalDigit
is the
string-concatenation
of the code unit 0x0030 (DIGIT ZERO) and the TRV of
DecimalDigit
The TRV of
NotEscapeSequence
::
[lookahead ∉
HexDigit
is the String value consisting of the code unit 0x0078 (LATIN SMALL LETTER X).
The TRV of
NotEscapeSequence
::
HexDigit
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0078 (LATIN SMALL LETTER X) and the TRV of
HexDigit
The TRV of
NotEscapeSequence
::
[lookahead ∉
HexDigit
[lookahead ≠
is the String value consisting of the code unit 0x0075 (LATIN SMALL LETTER U).
The TRV of
NotEscapeSequence
::
HexDigit
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U) and the TRV of
HexDigit
The TRV of
NotEscapeSequence
::
HexDigit
HexDigit
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U), the TRV of the first
HexDigit
, and the TRV of the second
HexDigit
The TRV of
NotEscapeSequence
::
HexDigit
HexDigit
HexDigit
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U), the TRV of the first
HexDigit
, the TRV of the second
HexDigit
, and the TRV of the third
HexDigit
The TRV of
NotEscapeSequence
::
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U) and the code unit 0x007B (LEFT CURLY BRACKET).
The TRV of
NotEscapeSequence
::
NotCodePoint
[lookahead ∉
HexDigit
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U), the code unit 0x007B (LEFT CURLY BRACKET), and the TRV of
NotCodePoint
The TRV of
NotEscapeSequence
::
CodePoint
[lookahead ∉
HexDigit
[lookahead ≠
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U), the code unit 0x007B (LEFT CURLY BRACKET), and the TRV of
CodePoint
The TRV of
DecimalDigit
::
one of
is the result of performing
UTF16EncodeCodePoint
on the single code point matched by this production.
The TRV of
CharacterEscapeSequence
::
NonEscapeCharacter
is the
SV
of
NonEscapeCharacter
The TRV of
SingleEscapeCharacter
::
one of
is the result of performing
UTF16EncodeCodePoint
on the single code point matched by this production.
The TRV of
HexEscapeSequence
::
HexDigit
HexDigit
is the
string-concatenation
of the code unit 0x0078 (LATIN SMALL LETTER X), the TRV of the first
HexDigit
, and the TRV of the second
HexDigit
The TRV of
UnicodeEscapeSequence
::
Hex4Digits
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U) and the TRV of
Hex4Digits
The TRV of
UnicodeEscapeSequence
::
u{
CodePoint
is the
string-concatenation
of the code unit 0x0075 (LATIN SMALL LETTER U), the code unit 0x007B (LEFT CURLY BRACKET), the TRV of
CodePoint
, and the code unit 0x007D (RIGHT CURLY BRACKET).
The TRV of
Hex4Digits
::
HexDigit
HexDigit
HexDigit
HexDigit
is the
string-concatenation
of the TRV of the first
HexDigit
, the TRV of the second
HexDigit
, the TRV of the third
HexDigit
, and the TRV of the fourth
HexDigit
The TRV of
HexDigits
::
HexDigits
HexDigit
is the
string-concatenation
of the TRV of
HexDigits
and the TRV of
HexDigit
The TRV of
HexDigit
::
one of
is the result of performing
UTF16EncodeCodePoint
on the single code point matched by this production.
The TRV of
LineContinuation
::
LineTerminatorSequence
is the
string-concatenation
of the code unit 0x005C (REVERSE SOLIDUS) and the TRV of
LineTerminatorSequence
The TRV of
LineTerminatorSequence
::

is the String value consisting of the code unit 0x000A (LINE FEED).
The TRV of
LineTerminatorSequence
::

is the String value consisting of the code unit 0x000A (LINE FEED).
The TRV of
LineTerminatorSequence
::

is the String value consisting of the code unit 0x2028 (LINE SEPARATOR).
The TRV of
LineTerminatorSequence
::

is the String value consisting of the code unit 0x2029 (PARAGRAPH SEPARATOR).
The TRV of
LineTerminatorSequence
::


is the String value consisting of the code unit 0x000A (LINE FEED).
Note
TV excludes the code units of
LineContinuation
while TRV includes them. and
LineTerminatorSequence
s are normalized to for both TV and TRV. An explicit
EscapeSequence
is needed to include a or sequence.
12.9
Automatic Semicolon Insertion
Most ECMAScript statements and declarations must be terminated
with a semicolon. Such semicolons may always appear explicitly in the
source text. For convenience, however, such semicolons may be omitted
from the source text in certain situations. These situations are
described by saying that semicolons are automatically inserted into the
source code token stream in those situations.
12.9.1
Rules of Automatic Semicolon Insertion
In the following rules, “token” means the actual recognized lexical token determined using the current lexical
goal symbol
as described in clause
12
There are three basic rules of semicolon insertion:
When, as the source text is parsed from left to right, a token (called the
offending token
is encountered that is not allowed by any production of the grammar,
then a semicolon is automatically inserted before the offending token if
one or more of the following conditions is true:
The offending token is separated from the previous token by at least one
LineTerminator
The offending token is
The previous token is
and the inserted semicolon would then be parsed as the terminating semicolon of a do-while statement (
14.7.2
).
When, as the source text is parsed from left to right, the end
of the input stream of tokens is encountered and the parser is unable
to parse the input token stream as a single instance of the goal
nonterminal, then a semicolon is automatically inserted at the end of
the input stream.
When, as the source text is parsed from left to right, a token
is encountered that is allowed by some production of the grammar, but
the production is a
restricted production
and the token would be the first token for a terminal or nonterminal immediately following the annotation “[no
LineTerminator
here]” within the restricted production (and therefore such a token is
called a restricted token), and the restricted token is separated from
the previous token by at least one
LineTerminator
, then a semicolon is automatically inserted before the restricted token.
However, there is an additional overriding condition on the
preceding rules: a semicolon is never inserted automatically if the
semicolon would then be parsed as an empty statement or if that
semicolon would become one of the two semicolons in the header of a
for
statement (see
14.7.4
).
Note
The following are the only restricted productions in the grammar:
UpdateExpression
[Yield, Await]
LeftHandSideExpression
[?Yield, ?Await]
[no
LineTerminator
here]
++
LeftHandSideExpression
[?Yield, ?Await]
[no
LineTerminator
here]
--
ContinueStatement
[Yield, Await]
continue
continue
[no
LineTerminator
here]
LabelIdentifier
[?Yield, ?Await]
BreakStatement
[Yield, Await]
break
break
[no
LineTerminator
here]
LabelIdentifier
[?Yield, ?Await]
ReturnStatement
[Yield, Await]
return
return
[no
LineTerminator
here]
Expression
[+In, ?Yield, ?Await]
ThrowStatement
[Yield, Await]
throw
[no
LineTerminator
here]
Expression
[+In, ?Yield, ?Await]
ArrowFunction
[In, Yield, Await]
ArrowParameters
[?Yield, ?Await]
[no
LineTerminator
here]
=>
ConciseBody
[?In]
YieldExpression
[In, Await]
yield
yield
[no
LineTerminator
here]
AssignmentExpression
[?In, +Yield, ?Await]
yield
[no
LineTerminator
here]
AssignmentExpression
[?In, +Yield, ?Await]
The practical effect of these restricted productions is as follows:
When a
++
or
--
token is encountered where the parser would treat it as a postfix operator, and at least one
LineTerminator
occurred between the preceding token and the
++
or
--
token, then a semicolon is automatically inserted before the
++
or
--
token.
When a
continue
break
return
throw
, or
yield
token is encountered and a
LineTerminator
is encountered before the next token, a semicolon is automatically inserted after the
continue
break
return
throw
, or
yield
token.
The resulting practical advice to ECMAScript programmers is:
A postfix
++
or
--
operator should appear on the same line as its operand.
An
Expression
in a
return
or
throw
statement or an
AssignmentExpression
in a
yield
expression should start on the same line as the
return
throw
, or
yield
token.
LabelIdentifier
in a
break
or
continue
statement should be on the same line as the
break
or
continue
token.
12.9.2
Examples of Automatic Semicolon Insertion
This section is non-normative.
The source
is not a valid sentence in the ECMAScript grammar, even with the automatic semicolon insertion rules. In contrast, the source
is also not a valid ECMAScript sentence, but is transformed by automatic semicolon insertion into the following:
;}
which is a valid ECMAScript sentence.
The source
for
(a; b
is not a valid ECMAScript sentence and is not altered by
automatic semicolon insertion because the semicolon is needed for the
header of a
for
statement. Automatic semicolon insertion never inserts one of the two semicolons in the header of a
for
statement.
The source
return
a + b
is transformed by automatic semicolon insertion into the following:
return
a + b;
Note 1
The expression
a + b
is not treated as a value to be returned by the
return
statement, because a
LineTerminator
separates it from the token
return
The source
a = b
++c
is transformed by automatic semicolon insertion into the following:
a = b;
++c;
Note 2
The token
++
is not treated as a postfix operator applying to the variable
, because a
LineTerminator
occurs between
and
++
The source
if
(a > b)
else
c = d
is not a valid ECMAScript sentence and is not altered by automatic semicolon insertion before the
else
token, even though no production of the grammar applies at that point,
because an automatically inserted semicolon would then be parsed as an
empty statement.
The source
a = b + c
(d + e).print()
is
not
transformed by automatic semicolon insertion,
because the parenthesized expression that begins the second line can be
interpreted as an argument list for a function call:
a = b + c(d + e).print()
In the circumstance that an assignment statement must begin
with a left parenthesis, it is a good idea for the programmer to provide
an explicit semicolon at the end of the preceding statement rather than
to rely on automatic semicolon insertion.
12.9.3
Interesting Cases of Automatic Semicolon Insertion
This section is non-normative.
ECMAScript programs can be written in a style with very few
semicolons by relying on automatic semicolon insertion. As described
above, semicolons are not inserted at every newline, and automatic
semicolon insertion can depend on multiple tokens across line
terminators.
As new syntactic features are added to ECMAScript, additional
grammar productions could be added that cause lines relying on automatic
semicolon insertion preceding them to change grammar productions when
parsed.
For the purposes of this section, a case of automatic semicolon
insertion is considered interesting if it is a place where a semicolon
may or may not be inserted, depending on the source text which precedes
it. The rest of this section describes a number of interesting cases of
automatic semicolon insertion in this version of ECMAScript.
12.9.3.1
Interesting Cases of Automatic Semicolon Insertion in Statement Lists
In a
StatementList
, many
StatementListItem
end in semicolons, which may be omitted using automatic semicolon
insertion. As a consequence of the rules above, at the end of a line
ending an expression, a semicolon is required if the following line
begins with any of the following:
An opening parenthesis (
. Without a semicolon, the two lines together are treated as a
CallExpression
An opening square bracket (
. Without a semicolon, the two lines together are treated as property access, rather than an
ArrayLiteral
or
ArrayAssignmentPattern
A template literal (
. Without a semicolon, the two lines together are interpreted as a tagged Template (
13.3.11
), with the previous expression as the
MemberExpression
Unary
or
. Without a semicolon, the two lines together are interpreted as a usage of the corresponding binary operator.
A RegExp literal
. Without a semicolon, the two lines together may be parsed instead as the
MultiplicativeOperator
, for example if the RegExp has flags.
12.9.3.2
Cases of Automatic Semicolon Insertion and “[no
LineTerminator
here]”
This section is non-normative.
ECMAScript contains grammar productions which include “[no
LineTerminator
here]”. These productions are sometimes a means to have optional operands in the grammar. Introducing a
LineTerminator
in these locations would change the grammar production of a source text
by using the grammar production without the optional operand.
The rest of this section describes a number of productions using “[no
LineTerminator
here]” in this version of ECMAScript.
12.9.3.2.1
List of Grammar Productions with Optional Operands and “[no
LineTerminator
here]”
UpdateExpression
ContinueStatement
BreakStatement
ReturnStatement
YieldExpression
Async Function Definitions (
15.8
) with relation to Function Definitions (
15.2
13
ECMAScript Language: Expressions
13.1
Identifiers
Syntax
IdentifierReference
[Yield, Await]
Identifier
[~Yield]
yield
[~Await]
await
BindingIdentifier
[Yield, Await]
Identifier
yield
await
LabelIdentifier
[Yield, Await]
Identifier
[~Yield]
yield
[~Await]
await
Identifier
IdentifierName
but not
ReservedWord
Note
yield
and
await
are permitted as
BindingIdentifier
in the grammar, and prohibited with
static semantics
below, to prohibit automatic semicolon insertion in cases such as
let
await
13.1.1
Static Semantics: Early Errors
BindingIdentifier
Identifier
It is a Syntax Error if the code matched by this production is contained in
strict mode code
and the
StringValue
of
Identifier
is
"arguments"
or
"eval"
IdentifierReference
yield
BindingIdentifier
yield
LabelIdentifier
yield
It is a Syntax Error if the code matched by this production is contained in
strict mode code
IdentifierReference
await
BindingIdentifier
await
LabelIdentifier
await
It is a Syntax Error if the
goal symbol
of the syntactic grammar is
Module
BindingIdentifier
[Yield, Await]
yield
It is a Syntax Error if this production has a
[Yield]
parameter.
BindingIdentifier
[Yield, Await]
await
It is a Syntax Error if this production has an
[Await]
parameter.
IdentifierReference
[Yield, Await]
Identifier
BindingIdentifier
[Yield, Await]
Identifier
LabelIdentifier
[Yield, Await]
Identifier
It is a Syntax Error if this production has a
[Yield]
parameter and
StringValue
of
Identifier
is
"yield"
It is a Syntax Error if this production has an
[Await]
parameter and
StringValue
of
Identifier
is
"await"
Identifier
IdentifierName
but not
ReservedWord
It is a Syntax Error if this phrase is contained in
strict mode code
and the
StringValue
of
IdentifierName
is:
"implements"
"interface"
"let"
"package"
"private"
"protected"
"public"
"static"
, or
"yield"
It is a Syntax Error if the
goal symbol
of the syntactic grammar is
Module
and the
StringValue
of
IdentifierName
is
"await"
It is a Syntax Error if
StringValue
of
IdentifierName
is the same String value as the
StringValue
of any
ReservedWord
except for
yield
or
await
Note
StringValue
of
IdentifierName
normalizes any Unicode escape sequences in
IdentifierName
hence such escapes cannot be used to write an
Identifier
whose code point sequence is the same as a
ReservedWord
13.1.2
Static Semantics: StringValue
IdentifierName
::
IdentifierStart
IdentifierName
IdentifierPart
1.
Let
idText
be the
source text matched by
IdentifierName
2.
Let
idTextUnescaped
be the result of replacing any occurrences of
UnicodeEscapeSequence
in
idText
with the code point represented by the
UnicodeEscapeSequence
3.
Return !
CodePointsToString
idTextUnescaped
).
IdentifierReference
yield
BindingIdentifier
yield
LabelIdentifier
yield
1.
Return
"yield"
IdentifierReference
await
BindingIdentifier
await
LabelIdentifier
await
1.
Return
"await"
Identifier
IdentifierName
but not
ReservedWord
1.
Return the
StringValue
of
IdentifierName
13.1.3
Runtime Semantics: Evaluation
IdentifierReference
Identifier
1.
Return ?
ResolveBinding
StringValue
of
Identifier
).
IdentifierReference
yield
1.
Return ?
ResolveBinding
"yield"
).
IdentifierReference
await
1.
Return ?
ResolveBinding
"await"
).
Note 1
The result of evaluating an
IdentifierReference
is always a value of type
Reference
Note 2
In
non-strict code
, the
keyword
yield
may be used as an identifier. Evaluating the
IdentifierReference
resolves the binding of
yield
as if it was an
Identifier
. Early Error restriction ensures that such an evaluation only can occur for
non-strict code
13.2
Primary Expression
Syntax
PrimaryExpression
[Yield, Await]
this
IdentifierReference
[?Yield, ?Await]
Literal
ArrayLiteral
[?Yield, ?Await]
ObjectLiteral
[?Yield, ?Await]
FunctionExpression
ClassExpression
[?Yield, ?Await]
GeneratorExpression
AsyncFunctionExpression
AsyncGeneratorExpression
RegularExpressionLiteral
TemplateLiteral
[?Yield, ?Await, ~Tagged]
CoverParenthesizedExpressionAndArrowParameterList
[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList
[Yield, Await]
Expression
[+In, ?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
...
BindingIdentifier
[?Yield, ?Await]
...
BindingPattern
[?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
...
BindingIdentifier
[?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
...
BindingPattern
[?Yield, ?Await]
Supplemental Syntax
When processing an instance of the production
PrimaryExpression
[Yield, Await]
CoverParenthesizedExpressionAndArrowParameterList
[?Yield, ?Await]
the interpretation of
CoverParenthesizedExpressionAndArrowParameterList
is refined using the following grammar:
ParenthesizedExpression
[Yield, Await]
Expression
[+In, ?Yield, ?Await]
13.2.1
Semantics
13.2.1.1
Static Semantics: CoveredParenthesizedExpression
CoverParenthesizedExpressionAndArrowParameterList
Expression
1.
Return the
ParenthesizedExpression
that is
covered
by
CoverParenthesizedExpressionAndArrowParameterList
13.2.2
The
this
Keyword
13.2.2.1
Runtime Semantics: Evaluation
PrimaryExpression
this
1.
Return ?
ResolveThisBinding
().
13.2.3
Identifier Reference
See
13.1
for
IdentifierReference
13.2.4
Literals
Syntax
Literal
NullLiteral
BooleanLiteral
NumericLiteral
StringLiteral
13.2.4.1
Runtime Semantics: Evaluation
Literal
NullLiteral
1.
Return
null
Literal
BooleanLiteral
1.
If
BooleanLiteral
is the token
false
, return
false
2.
If
BooleanLiteral
is the token
true
, return
true
Literal
NumericLiteral
1.
Return the
NumericValue
of
NumericLiteral
as defined in
12.8.3
Literal
StringLiteral
1.
Return the
SV
of
StringLiteral
as defined in
12.8.4.1
13.2.5
Array Initializer
Note
An
ArrayLiteral
is an expression describing the initialization of an Array object,
using a list, of zero or more expressions each of which represents an
array element, enclosed in square brackets. The elements need not be
literals; they are evaluated each time the array initializer is
evaluated.
Array elements may be elided at the beginning, middle or end of
the element list. Whenever a comma in the element list is not preceded
by an
AssignmentExpression
(i.e., a comma at the beginning or after another comma), the missing
array element contributes to the length of the Array and increases the
index of subsequent elements. Elided array elements are not defined. If
an element is elided at the end of an array, that element does not
contribute to the length of the Array.
Syntax
ArrayLiteral
[Yield, Await]
Elision
opt
ElementList
[?Yield, ?Await]
ElementList
[?Yield, ?Await]
Elision
opt
ElementList
[Yield, Await]
Elision
opt
AssignmentExpression
[+In, ?Yield, ?Await]
Elision
opt
SpreadElement
[?Yield, ?Await]
ElementList
[?Yield, ?Await]
Elision
opt
AssignmentExpression
[+In, ?Yield, ?Await]
ElementList
[?Yield, ?Await]
Elision
opt
SpreadElement
[?Yield, ?Await]
Elision
Elision
SpreadElement
[Yield, Await]
...
AssignmentExpression
[+In, ?Yield, ?Await]
13.2.5.1
Runtime Semantics: ArrayAccumulation
With parameters
array
and
nextIndex
Elision
1.
Let
len
be
nextIndex
+ 1.
2.
Perform ?
Set
array
"length"
len
),
true
).
3.
NOTE: The above Set throws if
len
exceeds 2
32
-1.
4.
Return
len
Elision
Elision
1.
Return the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
+ 1.
ElementList
Elision
opt
AssignmentExpression
1.
If
Elision
is present, then
a.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
b.
ReturnIfAbrupt
nextIndex
).
2.
Let
initResult
be the result of evaluating
AssignmentExpression
3.
Let
initValue
be ?
GetValue
initResult
).
4.
Let
created
be !
CreateDataPropertyOrThrow
array
, !
ToString
nextIndex
)),
initValue
).
5.
Return
nextIndex
+ 1.
ElementList
Elision
opt
SpreadElement
1.
If
Elision
is present, then
a.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
b.
ReturnIfAbrupt
nextIndex
).
2.
Return the result of performing
ArrayAccumulation
for
SpreadElement
with arguments
array
and
nextIndex
ElementList
ElementList
Elision
opt
AssignmentExpression
1.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
ElementList
with arguments
array
and
nextIndex
2.
ReturnIfAbrupt
nextIndex
).
3.
If
Elision
is present, then
a.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
b.
ReturnIfAbrupt
nextIndex
).
4.
Let
initResult
be the result of evaluating
AssignmentExpression
5.
Let
initValue
be ?
GetValue
initResult
).
6.
Let
created
be !
CreateDataPropertyOrThrow
array
, !
ToString
nextIndex
)),
initValue
).
7.
Return
nextIndex
+ 1.
ElementList
ElementList
Elision
opt
SpreadElement
1.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
ElementList
with arguments
array
and
nextIndex
2.
ReturnIfAbrupt
nextIndex
).
3.
If
Elision
is present, then
a.
Set
nextIndex
to the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
b.
ReturnIfAbrupt
nextIndex
).
4.
Return the result of performing
ArrayAccumulation
for
SpreadElement
with arguments
array
and
nextIndex
SpreadElement
...
AssignmentExpression
1.
Let
spreadRef
be the result of evaluating
AssignmentExpression
2.
Let
spreadObj
be ?
GetValue
spreadRef
).
3.
Let
iteratorRecord
be ?
GetIterator
spreadObj
).
4.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
nextIndex
c.
Let
nextValue
be ?
IteratorValue
next
).
d.
Perform !
CreateDataPropertyOrThrow
array
, !
ToString
nextIndex
)),
nextValue
).
e.
Set
nextIndex
to
nextIndex
+ 1.
Note
CreateDataPropertyOrThrow
is used to ensure that own properties are defined for the array even if the standard built-in
Array prototype object
has been modified in a manner that would preclude the creation of new own properties using [[Set]].
13.2.5.2
Runtime Semantics: Evaluation
ArrayLiteral
Elision
opt
1.
Let
array
be !
ArrayCreate
(0).
2.
If
Elision
is present, then
a.
Let
len
be the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and 0.
b.
ReturnIfAbrupt
len
).
3.
Return
array
ArrayLiteral
ElementList
1.
Let
array
be !
ArrayCreate
(0).
2.
Let
len
be the result of performing
ArrayAccumulation
for
ElementList
with arguments
array
and 0.
3.
ReturnIfAbrupt
len
).
4.
Return
array
ArrayLiteral
ElementList
Elision
opt
1.
Let
array
be !
ArrayCreate
(0).
2.
Let
nextIndex
be the result of performing
ArrayAccumulation
for
ElementList
with arguments
array
and 0.
3.
ReturnIfAbrupt
nextIndex
).
4.
If
Elision
is present, then
a.
Let
len
be the result of performing
ArrayAccumulation
for
Elision
with arguments
array
and
nextIndex
b.
ReturnIfAbrupt
len
).
5.
Return
array
13.2.6
Object Initializer
Note 1
An object initializer is an expression describing the
initialization of an Object, written in a form resembling a literal. It
is a list of zero or more pairs of property keys and associated values,
enclosed in curly brackets. The values need not be literals; they are
evaluated each time the object initializer is evaluated.
Syntax
ObjectLiteral
[Yield, Await]
PropertyDefinitionList
[?Yield, ?Await]
PropertyDefinitionList
[?Yield, ?Await]
PropertyDefinitionList
[Yield, Await]
PropertyDefinition
[?Yield, ?Await]
PropertyDefinitionList
[?Yield, ?Await]
PropertyDefinition
[?Yield, ?Await]
PropertyDefinition
[Yield, Await]
IdentifierReference
[?Yield, ?Await]
CoverInitializedName
[?Yield, ?Await]
PropertyName
[?Yield, ?Await]
AssignmentExpression
[+In, ?Yield, ?Await]
MethodDefinition
[?Yield, ?Await]
...
AssignmentExpression
[+In, ?Yield, ?Await]
PropertyName
[Yield, Await]
LiteralPropertyName
ComputedPropertyName
[?Yield, ?Await]
LiteralPropertyName
IdentifierName
StringLiteral
NumericLiteral
ComputedPropertyName
[Yield, Await]
AssignmentExpression
[+In, ?Yield, ?Await]
CoverInitializedName
[Yield, Await]
IdentifierReference
[?Yield, ?Await]
Initializer
[+In, ?Yield, ?Await]
Initializer
[In, Yield, Await]
AssignmentExpression
[?In, ?Yield, ?Await]
Note 2
MethodDefinition
is defined in
15.4
Note 3
In certain contexts,
ObjectLiteral
is used as a cover grammar for a more restricted secondary grammar. The
CoverInitializedName
production is necessary to fully cover these secondary grammars.
However, use of this production results in an early Syntax Error in
normal contexts where an actual
ObjectLiteral
is expected.
13.2.6.1
Static Semantics: Early Errors
PropertyDefinition
MethodDefinition
It is a Syntax Error if
HasDirectSuper
of
MethodDefinition
is
true
In addition to describing an actual object initializer the
ObjectLiteral
productions are also used as a cover grammar for
ObjectAssignmentPattern
and may be recognized as part of a
CoverParenthesizedExpressionAndArrowParameterList
. When
ObjectLiteral
appears in a context where
ObjectAssignmentPattern
is required the following Early Error rules are
not
applied. In addition, they are not applied when initially parsing a
CoverParenthesizedExpressionAndArrowParameterList
or
CoverCallExpressionAndAsyncArrowHead
PropertyDefinition
CoverInitializedName
Always throw a Syntax Error if code matches this production.
Note
This production exists so that
ObjectLiteral
can serve as a cover grammar for
ObjectAssignmentPattern
. It cannot occur in an actual object initializer.
13.2.6.2
Static Semantics: IsComputedPropertyKey
PropertyName
LiteralPropertyName
1.
Return
false
PropertyName
ComputedPropertyName
1.
Return
true
13.2.6.3
Static Semantics: PropertyNameList
PropertyDefinitionList
PropertyDefinition
1.
If
PropName
of
PropertyDefinition
is
empty
, return a new empty
List
2.
Return a
List
whose sole element is
PropName
of
PropertyDefinition
PropertyDefinitionList
PropertyDefinitionList
PropertyDefinition
1.
Let
list
be
PropertyNameList
of
PropertyDefinitionList
2.
If
PropName
of
PropertyDefinition
is
empty
, return
list
3.
Append
PropName
of
PropertyDefinition
to the end of
list
4.
Return
list
13.2.6.4
Runtime Semantics: Evaluation
ObjectLiteral
1.
Return !
OrdinaryObjectCreate
%Object.prototype%
).
ObjectLiteral
PropertyDefinitionList
PropertyDefinitionList
1.
Let
obj
be !
OrdinaryObjectCreate
%Object.prototype%
).
2.
Perform ?
PropertyDefinitionEvaluation
of
PropertyDefinitionList
with arguments
obj
and
true
3.
Return
obj
LiteralPropertyName
IdentifierName
1.
Return
StringValue
of
IdentifierName
LiteralPropertyName
StringLiteral
1.
Return the
SV
of
StringLiteral
LiteralPropertyName
NumericLiteral
1.
Let
nbr
be the
NumericValue
of
NumericLiteral
2.
Return !
ToString
nbr
).
ComputedPropertyName
AssignmentExpression
1.
Let
exprValue
be the result of evaluating
AssignmentExpression
2.
Let
propName
be ?
GetValue
exprValue
).
3.
Return ?
ToPropertyKey
propName
).
13.2.6.5
Runtime Semantics: PropertyDefinitionEvaluation
With parameters
object
and
enumerable
PropertyDefinitionList
PropertyDefinitionList
PropertyDefinition
1.
Perform ?
PropertyDefinitionEvaluation
of
PropertyDefinitionList
with arguments
object
and
enumerable
2.
Return the result of performing
PropertyDefinitionEvaluation
of
PropertyDefinition
with arguments
object
and
enumerable
PropertyDefinition
...
AssignmentExpression
1.
Let
exprValue
be the result of evaluating
AssignmentExpression
2.
Let
fromValue
be ?
GetValue
exprValue
).
3.
Let
excludedNames
be a new empty
List
4.
Return ?
CopyDataProperties
object
fromValue
excludedNames
).
PropertyDefinition
IdentifierReference
1.
Let
propName
be
StringValue
of
IdentifierReference
2.
Let
exprValue
be the result of evaluating
IdentifierReference
3.
Let
propValue
be ?
GetValue
exprValue
).
4.
Assert
enumerable
is
true
5.
Assert
object
is an ordinary, extensible object with no non-configurable properties.
6.
Return !
CreateDataPropertyOrThrow
object
propName
propValue
).
PropertyDefinition
PropertyName
AssignmentExpression
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) is
true
, then
a.
Let
propValue
be ?
NamedEvaluation
of
AssignmentExpression
with argument
propKey
4.
Else,
a.
Let
exprValueRef
be the result of evaluating
AssignmentExpression
b.
Let
propValue
be ?
GetValue
exprValueRef
).
5.
Assert
enumerable
is
true
6.
Assert
object
is an ordinary, extensible object with no non-configurable properties.
7.
Return !
CreateDataPropertyOrThrow
object
propKey
propValue
).
Note
An alternative semantics for this production is given in
B.3.1
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
get
PropertyName
FunctionBody
set
PropertyName
PropertySetParameterList
FunctionBody
1.
Return ?
MethodDefinitionEvaluation
of
MethodDefinition
with arguments
object
and
enumerable
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
1.
Return ?
MethodDefinitionEvaluation
of
GeneratorMethod
with arguments
object
and
enumerable
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
1.
Return ?
MethodDefinitionEvaluation
of
AsyncGeneratorMethod
with arguments
object
and
enumerable
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
1.
Return ?
MethodDefinitionEvaluation
of
AsyncMethod
with arguments
object
and
enumerable
13.2.7
Function Defining Expressions
See
15.2
for
PrimaryExpression
FunctionExpression
See
15.5
for
PrimaryExpression
GeneratorExpression
See
15.7
for
PrimaryExpression
ClassExpression
See
15.8
for
PrimaryExpression
AsyncFunctionExpression
See
15.6
for
PrimaryExpression
AsyncGeneratorExpression
13.2.8
Regular Expression Literals
Syntax
See
12.8.5
13.2.8.1
Static Semantics: Early Errors
PrimaryExpression
RegularExpressionLiteral
It is a Syntax Error if
IsValidRegularExpressionLiteral
RegularExpressionLiteral
) is
false
13.2.8.2
Static Semantics: IsValidRegularExpressionLiteral (
literal
The abstract operation IsValidRegularExpressionLiteral takes argument
literal
. It determines if its argument is a valid regular expression literal. It performs the following steps when called:
1.
Assert
literal
is a
RegularExpressionLiteral
2.
If
FlagText
of
literal
contains any code points other than
, or
, or if it contains the same code point more than once, return
false
3.
Let
patternText
be
BodyText
of
literal
4.
If
FlagText
of
literal
contains
, let
be
true
; else let
be
false
5.
If
is
false
, then
a.
Let
stringValue
be
CodePointsToString
patternText
).
b.
Set
patternText
to the sequence of code points resulting from interpreting each of the 16-bit elements of
stringValue
as a Unicode BMP code point. UTF-16 decoding is not applied to the elements.
6.
Let
parseResult
be
ParsePattern
patternText
).
7.
If
parseResult
is a
Parse Node
, return
true
; else return
false
13.2.8.3
Runtime Semantics: Evaluation
PrimaryExpression
RegularExpressionLiteral
1.
Let
pattern
be !
CodePointsToString
BodyText
of
RegularExpressionLiteral
).
2.
Let
flags
be !
CodePointsToString
FlagText
of
RegularExpressionLiteral
).
3.
Return
RegExpCreate
pattern
flags
).
13.2.9
Template Literals
Syntax
TemplateLiteral
[Yield, Await, Tagged]
NoSubstitutionTemplate
SubstitutionTemplate
[?Yield, ?Await, ?Tagged]
SubstitutionTemplate
[Yield, Await, Tagged]
TemplateHead
Expression
[+In, ?Yield, ?Await]
TemplateSpans
[?Yield, ?Await, ?Tagged]
TemplateSpans
[Yield, Await, Tagged]
TemplateTail
TemplateMiddleList
[?Yield, ?Await, ?Tagged]
TemplateTail
TemplateMiddleList
[Yield, Await, Tagged]
TemplateMiddle
Expression
[+In, ?Yield, ?Await]
TemplateMiddleList
[?Yield, ?Await, ?Tagged]
TemplateMiddle
Expression
[+In, ?Yield, ?Await]
13.2.9.1
Static Semantics: Early Errors
TemplateLiteral
[Yield, Await, Tagged]
NoSubstitutionTemplate
It is a Syntax Error if the
[Tagged]
parameter was not set and
NoSubstitutionTemplate
Contains
NotEscapeSequence
TemplateLiteral
[Yield, Await, Tagged]
SubstitutionTemplate
[?Yield, ?Await, ?Tagged]
It is a Syntax Error if the number of elements in the result of
TemplateStrings
of
TemplateLiteral
with argument
false
is greater than 2
32
- 1.
SubstitutionTemplate
[Yield, Await, Tagged]
TemplateHead
Expression
[+In, ?Yield, ?Await]
TemplateSpans
[?Yield, ?Await, ?Tagged]
It is a Syntax Error if the
[Tagged]
parameter was not set and
TemplateHead
Contains
NotEscapeSequence
TemplateSpans
[Yield, Await, Tagged]
TemplateTail
It is a Syntax Error if the
[Tagged]
parameter was not set and
TemplateTail
Contains
NotEscapeSequence
TemplateMiddleList
[Yield, Await, Tagged]
TemplateMiddle
Expression
[+In, ?Yield, ?Await]
TemplateMiddleList
[?Yield, ?Await, ?Tagged]
TemplateMiddle
Expression
[+In, ?Yield, ?Await]
It is a Syntax Error if the
[Tagged]
parameter was not set and
TemplateMiddle
Contains
NotEscapeSequence
13.2.9.2
Static Semantics: TemplateStrings
With parameter
raw
TemplateLiteral
NoSubstitutionTemplate
1.
If
raw
is
false
, then
a.
Let
string
be the TV of
NoSubstitutionTemplate
2.
Else,
a.
Let
string
be the TRV of
NoSubstitutionTemplate
3.
Return a
List
whose sole element is
string
SubstitutionTemplate
TemplateHead
Expression
TemplateSpans
1.
If
raw
is
false
, then
a.
Let
head
be the TV of
TemplateHead
2.
Else,
a.
Let
head
be the TRV of
TemplateHead
3.
Let
tail
be
TemplateStrings
of
TemplateSpans
with argument
raw
4.
Return a
List
whose elements are
head
followed by the elements of
tail
TemplateSpans
TemplateTail
1.
If
raw
is
false
, then
a.
Let
tail
be the TV of
TemplateTail
2.
Else,
a.
Let
tail
be the TRV of
TemplateTail
3.
Return a
List
whose sole element is
tail
TemplateSpans
TemplateMiddleList
TemplateTail
1.
Let
middle
be
TemplateStrings
of
TemplateMiddleList
with argument
raw
2.
If
raw
is
false
, then
a.
Let
tail
be the TV of
TemplateTail
3.
Else,
a.
Let
tail
be the TRV of
TemplateTail
4.
Return a
List
whose elements are the elements of
middle
followed by
tail
TemplateMiddleList
TemplateMiddle
Expression
1.
If
raw
is
false
, then
a.
Let
string
be the TV of
TemplateMiddle
2.
Else,
a.
Let
string
be the TRV of
TemplateMiddle
3.
Return a
List
whose sole element is
string
TemplateMiddleList
TemplateMiddleList
TemplateMiddle
Expression
1.
Let
front
be
TemplateStrings
of
TemplateMiddleList
with argument
raw
2.
If
raw
is
false
, then
a.
Let
last
be the TV of
TemplateMiddle
3.
Else,
a.
Let
last
be the TRV of
TemplateMiddle
4.
Append
last
as the last element of the
List
front
5.
Return
front
13.2.9.3
GetTemplateObject (
templateLiteral
The abstract operation GetTemplateObject takes argument
templateLiteral
(a
Parse Node
). It performs the following steps when called:
1.
Let
realm
be
the current Realm Record
2.
Let
templateRegistry
be
realm
.[[TemplateMap]].
3.
For each element
of
templateRegistry
, do
a.
If
.[[Site]] is
the same Parse Node
as
templateLiteral
, then
i.
Return
.[[Array]].
4.
Let
rawStrings
be
TemplateStrings
of
templateLiteral
with argument
true
5.
Let
cookedStrings
be
TemplateStrings
of
templateLiteral
with argument
false
6.
Let
count
be the number of elements in the
List
cookedStrings
7.
Assert
count
≤ 2
32
- 1.
8.
Let
template
be !
ArrayCreate
count
).
9.
Let
rawObj
be !
ArrayCreate
count
).
10.
Let
index
be 0.
11.
Repeat, while
index
count
a.
Let
prop
be !
ToString
index
)).
b.
Let
cookedValue
be
cookedStrings
index
].
c.
Perform !
DefinePropertyOrThrow
template
prop
, PropertyDescriptor { [[Value]]:
cookedValue
, [[Writable]]:
false
, [[Enumerable]]:
true
, [[Configurable]]:
false
}).
d.
Let
rawValue
be the String value
rawStrings
index
].
e.
Perform !
DefinePropertyOrThrow
rawObj
prop
, PropertyDescriptor { [[Value]]:
rawValue
, [[Writable]]:
false
, [[Enumerable]]:
true
, [[Configurable]]:
false
}).
f.
Set
index
to
index
+ 1.
12.
Perform !
SetIntegrityLevel
rawObj
frozen
).
13.
Perform !
DefinePropertyOrThrow
template
"raw"
, PropertyDescriptor { [[Value]]:
rawObj
, [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
14.
Perform !
SetIntegrityLevel
template
frozen
).
15.
Append the
Record
{ [[Site]]:
templateLiteral
, [[Array]]:
template
} to
templateRegistry
16.
Return
template
Note 1
The creation of a template object cannot result in an
abrupt completion
Note 2
Each
TemplateLiteral
in the program code of a
realm
is associated with a unique template object that is used in the evaluation of tagged Templates (
13.2.9.5
).
The template objects are frozen and the same template object is used
each time a specific tagged Template is evaluated. Whether template
objects are created lazily upon first evaluation of the
TemplateLiteral
or eagerly prior to first evaluation is an implementation choice that is not observable to ECMAScript code.
Note 3
Future editions of this specification may define additional non-enumerable properties of template objects.
13.2.9.4
Runtime Semantics: SubstitutionEvaluation
TemplateSpans
TemplateTail
1.
Return a new empty
List
TemplateSpans
TemplateMiddleList
TemplateTail
1.
Return the result of
SubstitutionEvaluation
of
TemplateMiddleList
TemplateMiddleList
TemplateMiddle
Expression
1.
Let
subRef
be the result of evaluating
Expression
2.
Let
sub
be ?
GetValue
subRef
).
3.
Return a
List
whose sole element is
sub
TemplateMiddleList
TemplateMiddleList
TemplateMiddle
Expression
1.
Let
preceding
be ?
SubstitutionEvaluation
of
TemplateMiddleList
2.
Let
nextRef
be the result of evaluating
Expression
3.
Let
next
be ?
GetValue
nextRef
).
4.
Append
next
as the last element of the
List
preceding
5.
Return
preceding
13.2.9.5
Runtime Semantics: Evaluation
TemplateLiteral
NoSubstitutionTemplate
1.
Return the TV of
NoSubstitutionTemplate
as defined in
12.8.6
SubstitutionTemplate
TemplateHead
Expression
TemplateSpans
1.
Let
head
be the TV of
TemplateHead
as defined in
12.8.6
2.
Let
subRef
be the result of evaluating
Expression
3.
Let
sub
be ?
GetValue
subRef
).
4.
Let
middle
be ?
ToString
sub
).
5.
Let
tail
be the result of evaluating
TemplateSpans
6.
ReturnIfAbrupt
tail
).
7.
Return the
string-concatenation
of
head
middle
, and
tail
Note 1
The string conversion semantics applied to the
Expression
value are like
String.prototype.concat
rather than the
operator.
TemplateSpans
TemplateTail
1.
Return the TV of
TemplateTail
as defined in
12.8.6
TemplateSpans
TemplateMiddleList
TemplateTail
1.
Let
head
be the result of evaluating
TemplateMiddleList
2.
ReturnIfAbrupt
head
).
3.
Let
tail
be the TV of
TemplateTail
as defined in
12.8.6
4.
Return the
string-concatenation
of
head
and
tail
TemplateMiddleList
TemplateMiddle
Expression
1.
Let
head
be the TV of
TemplateMiddle
as defined in
12.8.6
2.
Let
subRef
be the result of evaluating
Expression
3.
Let
sub
be ?
GetValue
subRef
).
4.
Let
middle
be ?
ToString
sub
).
5.
Return the
string-concatenation
of
head
and
middle
Note 2
The string conversion semantics applied to the
Expression
value are like
String.prototype.concat
rather than the
operator.
TemplateMiddleList
TemplateMiddleList
TemplateMiddle
Expression
1.
Let
rest
be the result of evaluating
TemplateMiddleList
2.
ReturnIfAbrupt
rest
).
3.
Let
middle
be the TV of
TemplateMiddle
as defined in
12.8.6
4.
Let
subRef
be the result of evaluating
Expression
5.
Let
sub
be ?
GetValue
subRef
).
6.
Let
last
be ?
ToString
sub
).
7.
Return the
string-concatenation
of
rest
middle
, and
last
Note 3
The string conversion semantics applied to the
Expression
value are like
String.prototype.concat
rather than the
operator.
13.2.10
The Grouping Operator
13.2.10.1
Static Semantics: Early Errors
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
It is a Syntax Error if
CoverParenthesizedExpressionAndArrowParameterList
is not
covering
ParenthesizedExpression
All Early Error rules for
ParenthesizedExpression
and its derived productions also apply to
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
13.2.10.2
Runtime Semantics: Evaluation
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return the result of evaluating
expr
ParenthesizedExpression
Expression
1.
Return the result of evaluating
Expression
. This may be of type
Reference
Note
This algorithm does not apply
GetValue
to the result of evaluating
Expression
. The principal motivation for this is so that operators such as
delete
and
typeof
may be applied to parenthesized expressions.
13.3
Left-Hand-Side Expressions
Syntax
MemberExpression
[Yield, Await]
PrimaryExpression
[?Yield, ?Await]
MemberExpression
[?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
MemberExpression
[?Yield, ?Await]
IdentifierName
MemberExpression
[?Yield, ?Await]
TemplateLiteral
[?Yield, ?Await, +Tagged]
SuperProperty
[?Yield, ?Await]
MetaProperty
new
MemberExpression
[?Yield, ?Await]
Arguments
[?Yield, ?Await]
SuperProperty
[Yield, Await]
super
Expression
[+In, ?Yield, ?Await]
super
IdentifierName
MetaProperty
NewTarget
ImportMeta
NewTarget
new
target
ImportMeta
import
meta
NewExpression
[Yield, Await]
MemberExpression
[?Yield, ?Await]
new
NewExpression
[?Yield, ?Await]
CallExpression
[Yield, Await]
CoverCallExpressionAndAsyncArrowHead
[?Yield, ?Await]
SuperCall
[?Yield, ?Await]
ImportCall
[?Yield, ?Await]
CallExpression
[?Yield, ?Await]
Arguments
[?Yield, ?Await]
CallExpression
[?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
CallExpression
[?Yield, ?Await]
IdentifierName
CallExpression
[?Yield, ?Await]
TemplateLiteral
[?Yield, ?Await, +Tagged]
SuperCall
[Yield, Await]
super
Arguments
[?Yield, ?Await]
ImportCall
[Yield, Await]
import
AssignmentExpression
[+In, ?Yield, ?Await]
Arguments
[Yield, Await]
ArgumentList
[?Yield, ?Await]
ArgumentList
[?Yield, ?Await]
ArgumentList
[Yield, Await]
AssignmentExpression
[+In, ?Yield, ?Await]
...
AssignmentExpression
[+In, ?Yield, ?Await]
ArgumentList
[?Yield, ?Await]
AssignmentExpression
[+In, ?Yield, ?Await]
ArgumentList
[?Yield, ?Await]
...
AssignmentExpression
[+In, ?Yield, ?Await]
OptionalExpression
[Yield, Await]
MemberExpression
[?Yield, ?Await]
OptionalChain
[?Yield, ?Await]
CallExpression
[?Yield, ?Await]
OptionalChain
[?Yield, ?Await]
OptionalExpression
[?Yield, ?Await]
OptionalChain
[?Yield, ?Await]
OptionalChain
[Yield, Await]
?.
Arguments
[?Yield, ?Await]
?.
Expression
[+In, ?Yield, ?Await]
?.
IdentifierName
?.
TemplateLiteral
[?Yield, ?Await, +Tagged]
OptionalChain
[?Yield, ?Await]
Arguments
[?Yield, ?Await]
OptionalChain
[?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
OptionalChain
[?Yield, ?Await]
IdentifierName
OptionalChain
[?Yield, ?Await]
TemplateLiteral
[?Yield, ?Await, +Tagged]
LeftHandSideExpression
[Yield, Await]
NewExpression
[?Yield, ?Await]
CallExpression
[?Yield, ?Await]
OptionalExpression
[?Yield, ?Await]
Supplemental Syntax
When processing an instance of the production
CallExpression
CoverCallExpressionAndAsyncArrowHead
the interpretation of
CoverCallExpressionAndAsyncArrowHead
is refined using the following grammar:
CallMemberExpression
[Yield, Await]
MemberExpression
[?Yield, ?Await]
Arguments
[?Yield, ?Await]
13.3.1
Static Semantics
13.3.1.1
Static Semantics: Early Errors
OptionalChain
?.
TemplateLiteral
OptionalChain
TemplateLiteral
It is a Syntax Error if any code matches this production.
Note
This production exists in order to prevent automatic semicolon insertion rules (
12.9
) from being applied to the following code:
a?.b
`c`
so that it would be interpreted as two valid statements.
The purpose is to maintain consistency with similar code without
optional chaining:
a.b
`c`
which is a valid statement and where automatic semicolon insertion does not apply.
ImportMeta
import
meta
It is a Syntax Error if the syntactic
goal symbol
is not
Module
13.3.1.2
Static Semantics: CoveredCallExpression
CoverCallExpressionAndAsyncArrowHead
MemberExpression
Arguments
1.
Return the
CallMemberExpression
that is
covered
by
CoverCallExpressionAndAsyncArrowHead
13.3.2
Property Accessors
Note
Properties are accessed by name, using either the dot notation:
MemberExpression
IdentifierName
CallExpression
IdentifierName
or the bracket notation:
MemberExpression
Expression
CallExpression
Expression
The dot notation is explained by the following syntactic conversion:
MemberExpression
IdentifierName
is identical in its behaviour to
MemberExpression
identifier-name-string
and similarly
CallExpression
IdentifierName
is identical in its behaviour to
CallExpression
identifier-name-string
where <
identifier-name-string
> is the result of evaluating
StringValue
of
IdentifierName
13.3.2.1
Runtime Semantics: Evaluation
MemberExpression
MemberExpression
Expression
1.
Let
baseReference
be the result of evaluating
MemberExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If the code matched by this
MemberExpression
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
4.
Return ?
EvaluatePropertyAccessWithExpressionKey
baseValue
Expression
strict
).
MemberExpression
MemberExpression
IdentifierName
1.
Let
baseReference
be the result of evaluating
MemberExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If the code matched by this
MemberExpression
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
4.
Return ?
EvaluatePropertyAccessWithIdentifierKey
baseValue
IdentifierName
strict
).
CallExpression
CallExpression
Expression
1.
Let
baseReference
be the result of evaluating
CallExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If the code matched by this
CallExpression
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
4.
Return ?
EvaluatePropertyAccessWithExpressionKey
baseValue
Expression
strict
).
CallExpression
CallExpression
IdentifierName
1.
Let
baseReference
be the result of evaluating
CallExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If the code matched by this
CallExpression
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
4.
Return ?
EvaluatePropertyAccessWithIdentifierKey
baseValue
IdentifierName
strict
).
13.3.3
EvaluatePropertyAccessWithExpressionKey (
baseValue
expression
strict
The abstract operation EvaluatePropertyAccessWithExpressionKey takes arguments
baseValue
(an
ECMAScript language value
),
expression
(a
Parse Node
), and
strict
(a Boolean). It performs the following steps when called:
1.
Let
propertyNameReference
be the result of evaluating
expression
2.
Let
propertyNameValue
be ?
GetValue
propertyNameReference
).
3.
Let
bv
be ?
RequireObjectCoercible
baseValue
).
4.
Let
propertyKey
be ?
ToPropertyKey
propertyNameValue
).
5.
Return the
Reference Record
{ [[Base]]:
bv
, [[ReferencedName]]:
propertyKey
, [[Strict]]:
strict
, [[ThisValue]]:
empty
}.
13.3.4
EvaluatePropertyAccessWithIdentifierKey (
baseValue
identifierName
strict
The abstract operation EvaluatePropertyAccessWithIdentifierKey takes arguments
baseValue
(an
ECMAScript language value
),
identifierName
(a
Parse Node
), and
strict
(a Boolean). It performs the following steps when called:
1.
Assert
identifierName
is an
IdentifierName
2.
Let
bv
be ?
RequireObjectCoercible
baseValue
).
3.
Let
propertyNameString
be
StringValue
of
identifierName
4.
Return the
Reference Record
{ [[Base]]:
bv
, [[ReferencedName]]:
propertyNameString
, [[Strict]]:
strict
, [[ThisValue]]:
empty
}.
13.3.5
The
new
Operator
13.3.5.1
Runtime Semantics: Evaluation
NewExpression
new
NewExpression
1.
Return ?
EvaluateNew
NewExpression
empty
).
MemberExpression
new
MemberExpression
Arguments
1.
Return ?
EvaluateNew
MemberExpression
Arguments
).
13.3.5.1.1
EvaluateNew (
constructExpr
arguments
The abstract operation EvaluateNew takes arguments
constructExpr
and
arguments
. It performs the following steps when called:
1.
Assert
constructExpr
is either a
NewExpression
or a
MemberExpression
2.
Assert
arguments
is either
empty
or an
Arguments
3.
Let
ref
be the result of evaluating
constructExpr
4.
Let
constructor
be ?
GetValue
ref
).
5.
If
arguments
is
empty
, let
argList
be a new empty
List
6.
Else,
a.
Let
argList
be ?
ArgumentListEvaluation
of
arguments
7.
If
IsConstructor
constructor
) is
false
, throw a
TypeError
exception.
8.
Return ?
Construct
constructor
argList
).
13.3.6
Function Calls
13.3.6.1
Runtime Semantics: Evaluation
CallExpression
CoverCallExpressionAndAsyncArrowHead
1.
Let
expr
be
CoveredCallExpression
of
CoverCallExpressionAndAsyncArrowHead
2.
Let
memberExpr
be the
MemberExpression
of
expr
3.
Let
arguments
be the
Arguments
of
expr
4.
Let
ref
be the result of evaluating
memberExpr
5.
Let
func
be ?
GetValue
ref
).
6.
If
ref
is a
Reference Record
IsPropertyReference
ref
) is
false
, and
ref
.[[ReferencedName]] is
"eval"
, then
a.
If
SameValue
func
%eval%
) is
true
, then
i.
Let
argList
be ?
ArgumentListEvaluation
of
arguments
ii.
If
argList
has no elements, return
undefined
iii.
Let
evalArg
be the first element of
argList
iv.
If the source code matching this
CallExpression
is
strict mode code
, let
strictCaller
be
true
. Otherwise let
strictCaller
be
false
v.
Let
evalRealm
be
the current Realm Record
vi.
Return ?
PerformEval
evalArg
evalRealm
strictCaller
true
).
7.
Let
thisCall
be this
CallExpression
8.
Let
tailCall
be
IsInTailPosition
thisCall
).
9.
Return ?
EvaluateCall
func
ref
arguments
tailCall
).
CallExpression
evaluation that executes step
6.a.vi
is a
direct eval
CallExpression
CallExpression
Arguments
1.
Let
ref
be the result of evaluating
CallExpression
2.
Let
func
be ?
GetValue
ref
).
3.
Let
thisCall
be this
CallExpression
4.
Let
tailCall
be
IsInTailPosition
thisCall
).
5.
Return ?
EvaluateCall
func
ref
Arguments
tailCall
).
13.3.6.2
EvaluateCall (
func
ref
arguments
tailPosition
The abstract operation EvaluateCall takes arguments
func
(an
ECMAScript language value
),
ref
(an
ECMAScript language value
or a
Reference Record
),
arguments
(a
Parse Node
), and
tailPosition
(a Boolean). It performs the following steps when called:
1.
If
ref
is a
Reference Record
, then
a.
If
IsPropertyReference
ref
) is
true
, then
i.
Let
thisValue
be
GetThisValue
ref
).
b.
Else,
i.
Let
refEnv
be
ref
.[[Base]].
ii.
Assert
refEnv
is an
Environment Record
iii.
Let
thisValue
be
refEnv
.WithBaseObject().
2.
Else,
a.
Let
thisValue
be
undefined
3.
Let
argList
be ?
ArgumentListEvaluation
of
arguments
4.
If
Type
func
) is not Object, throw a
TypeError
exception.
5.
If
IsCallable
func
) is
false
, throw a
TypeError
exception.
6.
If
tailPosition
is
true
, perform
PrepareForTailCall
().
7.
Let
result
be
Call
func
thisValue
argList
).
8.
Assert
: If
tailPosition
is
true
, the above call will not return here, but instead evaluation will continue as if the following return has already occurred.
9.
Assert
: If
result
is not an
abrupt completion
, then
Type
result
) is an
ECMAScript language type
10.
Return
result
13.3.7
The
super
Keyword
13.3.7.1
Runtime Semantics: Evaluation
SuperProperty
super
Expression
1.
Let
env
be
GetThisEnvironment
().
2.
Let
actualThis
be ?
env
.GetThisBinding().
3.
Let
propertyNameReference
be the result of evaluating
Expression
4.
Let
propertyNameValue
be ?
GetValue
propertyNameReference
).
5.
Let
propertyKey
be ?
ToPropertyKey
propertyNameValue
).
6.
If the code matched by this
SuperProperty
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
7.
Return ?
MakeSuperPropertyReference
actualThis
propertyKey
strict
).
SuperProperty
super
IdentifierName
1.
Let
env
be
GetThisEnvironment
().
2.
Let
actualThis
be ?
env
.GetThisBinding().
3.
Let
propertyKey
be
StringValue
of
IdentifierName
4.
If the code matched by this
SuperProperty
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
5.
Return ?
MakeSuperPropertyReference
actualThis
propertyKey
strict
).
SuperCall
super
Arguments
1.
Let
newTarget
be
GetNewTarget
().
2.
Assert
Type
newTarget
) is Object.
3.
Let
func
be !
GetSuperConstructor
().
4.
Let
argList
be ?
ArgumentListEvaluation
of
Arguments
5.
If
IsConstructor
func
) is
false
, throw a
TypeError
exception.
6.
Let
result
be ?
Construct
func
argList
newTarget
).
7.
Let
thisER
be
GetThisEnvironment
().
8.
Return ?
thisER
.BindThisValue(
result
).
13.3.7.2
GetSuperConstructor ( )
The abstract operation GetSuperConstructor takes no arguments. It performs the following steps when called:
1.
Let
envRec
be
GetThisEnvironment
().
2.
Assert
envRec
is a
function Environment Record
3.
Let
activeFunction
be
envRec
.[[FunctionObject]].
4.
Assert
activeFunction
is an ECMAScript
function object
5.
Let
superConstructor
be !
activeFunction
.[[GetPrototypeOf]]().
6.
Return
superConstructor
13.3.7.3
MakeSuperPropertyReference (
actualThis
propertyKey
strict
The abstract operation MakeSuperPropertyReference takes arguments
actualThis
propertyKey
, and
strict
. It performs the following steps when called:
1.
Let
env
be
GetThisEnvironment
().
2.
Assert
env
.HasSuperBinding() is
true
3.
Let
baseValue
be ?
env
.GetSuperBase().
4.
Let
bv
be ?
RequireObjectCoercible
baseValue
).
5.
Return the
Reference Record
{ [[Base]]:
bv
, [[ReferencedName]]:
propertyKey
, [[Strict]]:
strict
, [[ThisValue]]:
actualThis
}.
6.
NOTE: This returns a
Super Reference Record
13.3.8
Argument Lists
Note
The evaluation of an argument list produces a
List
of values.
13.3.8.1
Runtime Semantics: ArgumentListEvaluation
Arguments
1.
Return a new empty
List
ArgumentList
AssignmentExpression
1.
Let
ref
be the result of evaluating
AssignmentExpression
2.
Let
arg
be ?
GetValue
ref
).
3.
Return a
List
whose sole element is
arg
ArgumentList
...
AssignmentExpression
1.
Let
list
be a new empty
List
2.
Let
spreadRef
be the result of evaluating
AssignmentExpression
3.
Let
spreadObj
be ?
GetValue
spreadRef
).
4.
Let
iteratorRecord
be ?
GetIterator
spreadObj
).
5.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
list
c.
Let
nextArg
be ?
IteratorValue
next
).
d.
Append
nextArg
as the last element of
list
ArgumentList
ArgumentList
AssignmentExpression
1.
Let
precedingArgs
be ?
ArgumentListEvaluation
of
ArgumentList
2.
Let
ref
be the result of evaluating
AssignmentExpression
3.
Let
arg
be ?
GetValue
ref
).
4.
Append
arg
to the end of
precedingArgs
5.
Return
precedingArgs
ArgumentList
ArgumentList
...
AssignmentExpression
1.
Let
precedingArgs
be ?
ArgumentListEvaluation
of
ArgumentList
2.
Let
spreadRef
be the result of evaluating
AssignmentExpression
3.
Let
iteratorRecord
be ?
GetIterator
(?
GetValue
spreadRef
)).
4.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
precedingArgs
c.
Let
nextArg
be ?
IteratorValue
next
).
d.
Append
nextArg
as the last element of
precedingArgs
TemplateLiteral
NoSubstitutionTemplate
1.
Let
templateLiteral
be this
TemplateLiteral
2.
Let
siteObj
be
GetTemplateObject
templateLiteral
).
3.
Return a
List
whose sole element is
siteObj
TemplateLiteral
SubstitutionTemplate
1.
Let
templateLiteral
be this
TemplateLiteral
2.
Let
siteObj
be
GetTemplateObject
templateLiteral
).
3.
Let
remaining
be ?
ArgumentListEvaluation
of
SubstitutionTemplate
4.
Return a
List
whose first element is
siteObj
and whose subsequent elements are the elements of
remaining
SubstitutionTemplate
TemplateHead
Expression
TemplateSpans
1.
Let
firstSubRef
be the result of evaluating
Expression
2.
Let
firstSub
be ?
GetValue
firstSubRef
).
3.
Let
restSub
be ?
SubstitutionEvaluation
of
TemplateSpans
4.
Assert
restSub
is a
List
5.
Return a
List
whose first element is
firstSub
and whose subsequent elements are the elements of
restSub
restSub
may contain no elements.
13.3.9
Optional Chains
Note
An optional chain is a chain of one or more property accesses and function calls, the first of which begins with the token
?.
13.3.9.1
Runtime Semantics: Evaluation
OptionalExpression
MemberExpression
OptionalChain
1.
Let
baseReference
be the result of evaluating
MemberExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If
baseValue
is
undefined
or
null
, then
a.
Return
undefined
4.
Return the result of performing
ChainEvaluation
of
OptionalChain
with arguments
baseValue
and
baseReference
OptionalExpression
CallExpression
OptionalChain
1.
Let
baseReference
be the result of evaluating
CallExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If
baseValue
is
undefined
or
null
, then
a.
Return
undefined
4.
Return the result of performing
ChainEvaluation
of
OptionalChain
with arguments
baseValue
and
baseReference
OptionalExpression
OptionalExpression
OptionalChain
1.
Let
baseReference
be the result of evaluating
OptionalExpression
2.
Let
baseValue
be ?
GetValue
baseReference
).
3.
If
baseValue
is
undefined
or
null
, then
a.
Return
undefined
4.
Return the result of performing
ChainEvaluation
of
OptionalChain
with arguments
baseValue
and
baseReference
13.3.9.2
Runtime Semantics: ChainEvaluation
With parameters
baseValue
and
baseReference
OptionalChain
?.
Arguments
1.
Let
thisChain
be this
OptionalChain
2.
Let
tailCall
be
IsInTailPosition
thisChain
).
3.
Return ?
EvaluateCall
baseValue
baseReference
Arguments
tailCall
).
OptionalChain
?.
Expression
1.
If the code matched by this
OptionalChain
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
2.
Return ?
EvaluatePropertyAccessWithExpressionKey
baseValue
Expression
strict
).
OptionalChain
?.
IdentifierName
1.
If the code matched by this
OptionalChain
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
2.
Return ?
EvaluatePropertyAccessWithIdentifierKey
baseValue
IdentifierName
strict
).
OptionalChain
OptionalChain
Arguments
1.
Let
optionalChain
be
OptionalChain
2.
Let
newReference
be ?
ChainEvaluation
of
optionalChain
with arguments
baseValue
and
baseReference
3.
Let
newValue
be ?
GetValue
newReference
).
4.
Let
thisChain
be this
OptionalChain
5.
Let
tailCall
be
IsInTailPosition
thisChain
).
6.
Return ?
EvaluateCall
newValue
newReference
Arguments
tailCall
).
OptionalChain
OptionalChain
Expression
1.
Let
optionalChain
be
OptionalChain
2.
Let
newReference
be ?
ChainEvaluation
of
optionalChain
with arguments
baseValue
and
baseReference
3.
Let
newValue
be ?
GetValue
newReference
).
4.
If the code matched by this
OptionalChain
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
5.
Return ?
EvaluatePropertyAccessWithExpressionKey
newValue
Expression
strict
).
OptionalChain
OptionalChain
IdentifierName
1.
Let
optionalChain
be
OptionalChain
2.
Let
newReference
be ?
ChainEvaluation
of
optionalChain
with arguments
baseValue
and
baseReference
3.
Let
newValue
be ?
GetValue
newReference
).
4.
If the code matched by this
OptionalChain
is
strict mode code
, let
strict
be
true
; else let
strict
be
false
5.
Return ?
EvaluatePropertyAccessWithIdentifierKey
newValue
IdentifierName
strict
).
13.3.10
Import Calls
13.3.10.1
Runtime Semantics: Evaluation
ImportCall
import
AssignmentExpression
1.
Let
referencingScriptOrModule
be !
GetActiveScriptOrModule
().
2.
Let
argRef
be the result of evaluating
AssignmentExpression
3.
Let
specifier
be ?
GetValue
argRef
).
4.
Let
promiseCapability
be !
NewPromiseCapability
%Promise%
).
5.
Let
specifierString
be
ToString
specifier
).
6.
IfAbruptRejectPromise
specifierString
promiseCapability
).
7.
Perform !
HostImportModuleDynamically
referencingScriptOrModule
specifierString
promiseCapability
).
8.
Return
promiseCapability
.[[Promise]].
13.3.11
Tagged Templates
Note
A tagged template is a function call where the arguments of the call are derived from a
TemplateLiteral
13.2.9
). The actual arguments include a template object (
13.2.9.3
) and the values produced by evaluating the expressions embedded within the
TemplateLiteral
13.3.11.1
Runtime Semantics: Evaluation
MemberExpression
MemberExpression
TemplateLiteral
1.
Let
tagRef
be the result of evaluating
MemberExpression
2.
Let
tagFunc
be ?
GetValue
tagRef
).
3.
Let
thisCall
be this
MemberExpression
4.
Let
tailCall
be
IsInTailPosition
thisCall
).
5.
Return ?
EvaluateCall
tagFunc
tagRef
TemplateLiteral
tailCall
).
CallExpression
CallExpression
TemplateLiteral
1.
Let
tagRef
be the result of evaluating
CallExpression
2.
Let
tagFunc
be ?
GetValue
tagRef
).
3.
Let
thisCall
be this
CallExpression
4.
Let
tailCall
be
IsInTailPosition
thisCall
).
5.
Return ?
EvaluateCall
tagFunc
tagRef
TemplateLiteral
tailCall
).
13.3.12
Meta Properties
13.3.12.1
Runtime Semantics: Evaluation
NewTarget
new
target
1.
Return
GetNewTarget
().
ImportMeta
import
meta
1.
Let
module
be !
GetActiveScriptOrModule
().
2.
Assert
module
is a
Source Text Module Record
3.
Let
importMeta
be
module
.[[ImportMeta]].
4.
If
importMeta
is
empty
, then
a.
Set
importMeta
to !
OrdinaryObjectCreate
null
).
b.
Let
importMetaValues
be !
HostGetImportMetaProperties
module
).
c.
For each
Record
{ [[Key]], [[Value]] }
of
importMetaValues
, do
i.
Perform !
CreateDataPropertyOrThrow
importMeta
.[[Key]],
.[[Value]]).
d.
Perform !
HostFinalizeImportMeta
importMeta
module
).
e.
Set
module
.[[ImportMeta]] to
importMeta
f.
Return
importMeta
5.
Else,
a.
Assert
Type
importMeta
) is Object.
b.
Return
importMeta
13.3.12.1.1
HostGetImportMetaProperties (
moduleRecord
The
host-defined
abstract operation HostGetImportMetaProperties takes argument
moduleRecord
(a
Module Record
). It allows hosts to provide property keys and values for the object returned from
import.meta
The implementation of HostGetImportMetaProperties must conform to the following requirements:
It must return a
List
, whose values are all Records with two fields, [[Key]] and [[Value]].
Each such
Record
's [[Key]] field must be a property key, i.e.,
IsPropertyKey
must return
true
when applied to it.
Each such
Record
's [[Value]] field must be an ECMAScript value.
It must always complete normally (i.e., not return an
abrupt completion
).
The default implementation of HostGetImportMetaProperties is to return a new empty
List
13.3.12.1.2
HostFinalizeImportMeta (
importMeta
moduleRecord
The
host-defined
abstract operation HostFinalizeImportMeta takes arguments
importMeta
(an Object) and
moduleRecord
(a
Module Record
). It allows hosts to perform any extraordinary operations to prepare the object returned from
import.meta
Most hosts will be able to simply define
HostGetImportMetaProperties
and leave HostFinalizeImportMeta with its default behaviour. However,
HostFinalizeImportMeta provides an "escape hatch" for hosts which need
to directly manipulate the object before it is exposed to ECMAScript
code.
The implementation of HostFinalizeImportMeta must conform to the following requirements:
It must always complete normally (i.e., not return an
abrupt completion
).
The default implementation of HostFinalizeImportMeta is to return
NormalCompletion
empty
).
13.4
Update Expressions
Syntax
UpdateExpression
[Yield, Await]
LeftHandSideExpression
[?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
[no
LineTerminator
here]
++
LeftHandSideExpression
[?Yield, ?Await]
[no
LineTerminator
here]
--
++
UnaryExpression
[?Yield, ?Await]
--
UnaryExpression
[?Yield, ?Await]
13.4.1
Static Semantics: Early Errors
UpdateExpression
LeftHandSideExpression
++
LeftHandSideExpression
--
It is an early Syntax Error if
AssignmentTargetType
of
LeftHandSideExpression
is not
simple
UpdateExpression
++
UnaryExpression
--
UnaryExpression
It is an early Syntax Error if
AssignmentTargetType
of
UnaryExpression
is not
simple
13.4.2
Postfix Increment Operator
13.4.2.1
Runtime Semantics: Evaluation
UpdateExpression
LeftHandSideExpression
++
1.
Let
lhs
be the result of evaluating
LeftHandSideExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
lhs
)).
3.
Let
newValue
be !
Type
oldValue
)::add(
oldValue
Type
oldValue
)::unit).
4.
Perform ?
PutValue
lhs
newValue
).
5.
Return
oldValue
13.4.3
Postfix Decrement Operator
13.4.3.1
Runtime Semantics: Evaluation
UpdateExpression
LeftHandSideExpression
--
1.
Let
lhs
be the result of evaluating
LeftHandSideExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
lhs
)).
3.
Let
newValue
be !
Type
oldValue
)::subtract(
oldValue
Type
oldValue
)::unit).
4.
Perform ?
PutValue
lhs
newValue
).
5.
Return
oldValue
13.4.4
Prefix Increment Operator
13.4.4.1
Runtime Semantics: Evaluation
UpdateExpression
++
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
expr
)).
3.
Let
newValue
be !
Type
oldValue
)::add(
oldValue
Type
oldValue
)::unit).
4.
Perform ?
PutValue
expr
newValue
).
5.
Return
newValue
13.4.5
Prefix Decrement Operator
13.4.5.1
Runtime Semantics: Evaluation
UpdateExpression
--
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
expr
)).
3.
Let
newValue
be !
Type
oldValue
)::subtract(
oldValue
Type
oldValue
)::unit).
4.
Perform ?
PutValue
expr
newValue
).
5.
Return
newValue
13.5
Unary Operators
Syntax
UnaryExpression
[Yield, Await]
UpdateExpression
[?Yield, ?Await]
delete
UnaryExpression
[?Yield, ?Await]
void
UnaryExpression
[?Yield, ?Await]
typeof
UnaryExpression
[?Yield, ?Await]
UnaryExpression
[?Yield, ?Await]
UnaryExpression
[?Yield, ?Await]
UnaryExpression
[?Yield, ?Await]
UnaryExpression
[?Yield, ?Await]
[+Await]
AwaitExpression
[?Yield]
13.5.1
The
delete
Operator
13.5.1.1
Static Semantics: Early Errors
UnaryExpression
delete
UnaryExpression
It is a Syntax Error if the
UnaryExpression
is contained in
strict mode code
and the derived
UnaryExpression
is
PrimaryExpression
IdentifierReference
It is a Syntax Error if the derived
UnaryExpression
is
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
and
CoverParenthesizedExpressionAndArrowParameterList
ultimately derives a phrase that, if used in place of
UnaryExpression
, would produce a Syntax Error according to these rules. This rule is recursively applied.
Note
The last rule means that expressions such as
delete (((foo)))
produce early errors because of recursive application of the first rule.
13.5.1.2
Runtime Semantics: Evaluation
UnaryExpression
delete
UnaryExpression
1.
Let
ref
be the result of evaluating
UnaryExpression
2.
ReturnIfAbrupt
ref
).
3.
If
ref
is not a
Reference Record
, return
true
4.
If
IsUnresolvableReference
ref
) is
true
, then
a.
Assert
ref
.[[Strict]] is
false
b.
Return
true
5.
If
IsPropertyReference
ref
) is
true
, then
a.
If
IsSuperReference
ref
) is
true
, throw a
ReferenceError
exception.
b.
Let
baseObj
be !
ToObject
ref
.[[Base]]).
c.
Let
deleteStatus
be ?
baseObj
.[[Delete]](
ref
.[[ReferencedName]]).
d.
If
deleteStatus
is
false
and
ref
.[[Strict]] is
true
, throw a
TypeError
exception.
e.
Return
deleteStatus
6.
Else,
a.
Let
base
be
ref
.[[Base]].
b.
Assert
base
is an
Environment Record
c.
Return ?
base
.DeleteBinding(
ref
.[[ReferencedName]]).
Note 1
When a
delete
operator occurs within
strict mode code
, a
SyntaxError
exception is thrown if its
UnaryExpression
is a direct reference to a variable, function argument, or function name. In addition, if a
delete
operator occurs within
strict mode code
and the property to be deleted has the attribute { [[Configurable]]:
false
} (or otherwise cannot be deleted), a
TypeError
exception is thrown.
Note 2
The object that may be created in step
5.b
is not accessible outside of the above abstract operation and the
ordinary object
[[Delete]] internal method. An implementation might choose to avoid the actual creation of that object.
13.5.2
The
void
Operator
13.5.2.1
Runtime Semantics: Evaluation
UnaryExpression
void
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Perform ?
GetValue
expr
).
3.
Return
undefined
Note
GetValue
must be called even though its value is not used because it may have observable side-effects.
13.5.3
The
typeof
Operator
13.5.3.1
Runtime Semantics: Evaluation
UnaryExpression
typeof
UnaryExpression
1.
Let
val
be the result of evaluating
UnaryExpression
2.
If
val
is a
Reference Record
, then
a.
If
IsUnresolvableReference
val
) is
true
, return
"undefined"
3.
Set
val
to ?
GetValue
val
).
4.
Return a String according to
Table 37
Table 37: typeof Operator Results
Type of
val
Result
Undefined
"undefined"
Null
"object"
Boolean
"boolean"
Number
"number"
String
"string"
Symbol
"symbol"
BigInt
"bigint"
Object (does not implement [[Call]])
"object"
Object (implements [[Call]])
"function"
Note
An additional entry related to [[IsHTMLDDA]] Internal Slot can be found in
B.3.7.3
13.5.4
Unary
Operator
Note
The unary + operator converts its operand to Number type.
13.5.4.1
Runtime Semantics: Evaluation
UnaryExpression
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Return ?
ToNumber
(?
GetValue
expr
)).
13.5.5
Unary
Operator
Note
The unary
operator converts its operand to Number type and then negates it. Negating
+0
produces
-0
, and negating
-0
produces
+0
13.5.5.1
Runtime Semantics: Evaluation
UnaryExpression
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
expr
)).
3.
Let
be
Type
oldValue
).
4.
Return !
::unaryMinus(
oldValue
).
13.5.6
Bitwise NOT Operator (
13.5.6.1
Runtime Semantics: Evaluation
UnaryExpression
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Let
oldValue
be ?
ToNumeric
(?
GetValue
expr
)).
3.
Let
be
Type
oldValue
).
4.
Return !
::bitwiseNOT(
oldValue
).
13.5.7
Logical NOT Operator (
13.5.7.1
Runtime Semantics: Evaluation
UnaryExpression
UnaryExpression
1.
Let
expr
be the result of evaluating
UnaryExpression
2.
Let
oldValue
be !
ToBoolean
(?
GetValue
expr
)).
3.
If
oldValue
is
true
, return
false
4.
Return
true
13.6
Exponentiation Operator
Syntax
ExponentiationExpression
[Yield, Await]
UnaryExpression
[?Yield, ?Await]
UpdateExpression
[?Yield, ?Await]
**
ExponentiationExpression
[?Yield, ?Await]
13.6.1
Runtime Semantics: Evaluation
ExponentiationExpression
UpdateExpression
**
ExponentiationExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
UpdateExpression
**
ExponentiationExpression
).
13.7
Multiplicative Operators
Syntax
MultiplicativeExpression
[Yield, Await]
ExponentiationExpression
[?Yield, ?Await]
MultiplicativeExpression
[?Yield, ?Await]
MultiplicativeOperator
ExponentiationExpression
[?Yield, ?Await]
MultiplicativeOperator
one of
Note
The
operator performs multiplication, producing the product of its operands.
The
operator performs division, producing the quotient of its operands.
The
operator yields the remainder of its operands from an implied division.
13.7.1
Runtime Semantics: Evaluation
MultiplicativeExpression
MultiplicativeExpression
MultiplicativeOperator
ExponentiationExpression
1.
Let
opText
be the
source text matched by
MultiplicativeOperator
2.
Return ?
EvaluateStringOrNumericBinaryExpression
MultiplicativeExpression
opText
ExponentiationExpression
).
13.8
Additive Operators
Syntax
AdditiveExpression
[Yield, Await]
MultiplicativeExpression
[?Yield, ?Await]
AdditiveExpression
[?Yield, ?Await]
MultiplicativeExpression
[?Yield, ?Await]
AdditiveExpression
[?Yield, ?Await]
MultiplicativeExpression
[?Yield, ?Await]
13.8.1
The Addition Operator (
Note
The addition operator either performs string concatenation or numeric addition.
13.8.1.1
Runtime Semantics: Evaluation
AdditiveExpression
AdditiveExpression
MultiplicativeExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
AdditiveExpression
MultiplicativeExpression
).
13.8.2
The Subtraction Operator (
Note
The
operator performs subtraction, producing the difference of its operands.
13.8.2.1
Runtime Semantics: Evaluation
AdditiveExpression
AdditiveExpression
MultiplicativeExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
AdditiveExpression
MultiplicativeExpression
).
13.9
Bitwise Shift Operators
Syntax
ShiftExpression
[Yield, Await]
AdditiveExpression
[?Yield, ?Await]
ShiftExpression
[?Yield, ?Await]
<<
AdditiveExpression
[?Yield, ?Await]
ShiftExpression
[?Yield, ?Await]
>>
AdditiveExpression
[?Yield, ?Await]
ShiftExpression
[?Yield, ?Await]
>>>
AdditiveExpression
[?Yield, ?Await]
13.9.1
The Left Shift Operator (
<<
Note
Performs a bitwise left shift operation on the left operand by the amount specified by the right operand.
13.9.1.1
Runtime Semantics: Evaluation
ShiftExpression
ShiftExpression
<<
AdditiveExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
ShiftExpression
<<
AdditiveExpression
).
13.9.2
The Signed Right Shift Operator (
>>
Note
Performs a sign-filling bitwise right shift operation on the left operand by the amount specified by the right operand.
13.9.2.1
Runtime Semantics: Evaluation
ShiftExpression
ShiftExpression
>>
AdditiveExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
ShiftExpression
>>
AdditiveExpression
).
13.9.3
The Unsigned Right Shift Operator (
>>>
Note
Performs a zero-filling bitwise right shift operation on the left operand by the amount specified by the right operand.
13.9.3.1
Runtime Semantics: Evaluation
ShiftExpression
ShiftExpression
>>>
AdditiveExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
ShiftExpression
>>>
AdditiveExpression
).
13.10
Relational Operators
Note 1
The result of evaluating a relational operator is always of
type Boolean, reflecting whether the relationship named by the operator
holds between its two operands.
Syntax
RelationalExpression
[In, Yield, Await]
ShiftExpression
[?Yield, ?Await]
RelationalExpression
[?In, ?Yield, ?Await]
ShiftExpression
[?Yield, ?Await]
RelationalExpression
[?In, ?Yield, ?Await]
ShiftExpression
[?Yield, ?Await]
RelationalExpression
[?In, ?Yield, ?Await]
<=
ShiftExpression
[?Yield, ?Await]
RelationalExpression
[?In, ?Yield, ?Await]
>=
ShiftExpression
[?Yield, ?Await]
RelationalExpression
[?In, ?Yield, ?Await]
instanceof
ShiftExpression
[?Yield, ?Await]
[+In]
RelationalExpression
[+In, ?Yield, ?Await]
in
ShiftExpression
[?Yield, ?Await]
Note 2
The
[In]
grammar parameter is needed to avoid confusing the
in
operator in a relational expression with the
in
operator in a
for
statement.
13.10.1
Runtime Semantics: Evaluation
RelationalExpression
RelationalExpression
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Abstract Relational Comparison
lval
rval
6.
ReturnIfAbrupt
).
7.
If
is
undefined
, return
false
. Otherwise, return
RelationalExpression
RelationalExpression
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Abstract Relational Comparison
rval
lval
with
LeftFirst
equal to
false
6.
ReturnIfAbrupt
).
7.
If
is
undefined
, return
false
. Otherwise, return
RelationalExpression
RelationalExpression
<=
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Abstract Relational Comparison
rval
lval
with
LeftFirst
equal to
false
6.
ReturnIfAbrupt
).
7.
If
is
true
or
undefined
, return
false
. Otherwise, return
true
RelationalExpression
RelationalExpression
>=
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Abstract Relational Comparison
lval
rval
6.
ReturnIfAbrupt
).
7.
If
is
true
or
undefined
, return
false
. Otherwise, return
true
RelationalExpression
RelationalExpression
instanceof
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Return ?
InstanceofOperator
lval
rval
).
RelationalExpression
RelationalExpression
in
ShiftExpression
1.
Let
lref
be the result of evaluating
RelationalExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
ShiftExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
If
Type
rval
) is not Object, throw a
TypeError
exception.
6.
Return ?
HasProperty
rval
, ?
ToPropertyKey
lval
)).
13.10.2
InstanceofOperator (
target
The abstract operation InstanceofOperator takes arguments
(an
ECMAScript language value
) and
target
(an
ECMAScript language value
). It implements the generic algorithm for determining if
is an instance of
target
either by consulting
target
's
@@hasInstance
method or, if absent, determining whether the value of
target
's
"prototype"
property is present in
's prototype chain. It performs the following steps when called:
1.
If
Type
target
) is not Object, throw a
TypeError
exception.
2.
Let
instOfHandler
be ?
GetMethod
target
@@hasInstance
).
3.
If
instOfHandler
is not
undefined
, then
a.
Return !
ToBoolean
(?
Call
instOfHandler
target
, «
»)).
4.
If
IsCallable
target
) is
false
, throw a
TypeError
exception.
5.
Return ?
OrdinaryHasInstance
target
).
Note
Steps
and
provide compatibility with previous editions of ECMAScript that did not use a
@@hasInstance
method to define the
instanceof
operator semantics. If an object does not define or inherit
@@hasInstance
it uses the default
instanceof
semantics.
13.11
Equality Operators
Note
The result of evaluating an equality operator is always of type
Boolean, reflecting whether the relationship named by the operator
holds between its two operands.
Syntax
EqualityExpression
[In, Yield, Await]
RelationalExpression
[?In, ?Yield, ?Await]
EqualityExpression
[?In, ?Yield, ?Await]
==
RelationalExpression
[?In, ?Yield, ?Await]
EqualityExpression
[?In, ?Yield, ?Await]
!=
RelationalExpression
[?In, ?Yield, ?Await]
EqualityExpression
[?In, ?Yield, ?Await]
===
RelationalExpression
[?In, ?Yield, ?Await]
EqualityExpression
[?In, ?Yield, ?Await]
!==
RelationalExpression
[?In, ?Yield, ?Await]
13.11.1
Runtime Semantics: Evaluation
EqualityExpression
EqualityExpression
==
RelationalExpression
1.
Let
lref
be the result of evaluating
EqualityExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
RelationalExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Return the result of performing
Abstract Equality Comparison
rval
==
lval
EqualityExpression
EqualityExpression
!=
RelationalExpression
1.
Let
lref
be the result of evaluating
EqualityExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
RelationalExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Abstract Equality Comparison
rval
==
lval
6.
ReturnIfAbrupt
).
7.
If
is
true
, return
false
. Otherwise, return
true
EqualityExpression
EqualityExpression
===
RelationalExpression
1.
Let
lref
be the result of evaluating
EqualityExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
RelationalExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Return the result of performing
Strict Equality Comparison
rval
===
lval
EqualityExpression
EqualityExpression
!==
RelationalExpression
1.
Let
lref
be the result of evaluating
EqualityExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
RelationalExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
be the result of performing
Strict Equality Comparison
rval
===
lval
6.
Assert
is a normal completion.
7.
If
.[[Value]] is
true
, return
false
. Otherwise, return
true
Note 1
Given the above definition of equality:
String comparison can be forced by:
`${a}` == `${b}`
Numeric comparison can be forced by:
+a == +b
Boolean comparison can be forced by:
!a == !b
Note 2
The equality operators maintain the following invariants:
A != B
is equivalent to
!(A == B)
A == B
is equivalent to
B == A
, except in the order of evaluation of
and
Note 3
The equality operator is not always transitive. For example,
there might be two distinct String objects, each representing the same
String value; each String object would be considered equal to the String
value by the
==
operator, but the two String objects would not be equal to each other. For example:
new String("a") == "a"
and
"a" == new String("a")
are both
true
new String("a") == new String("a")
is
false
Note 4
Comparison of Strings uses a simple equality test on
sequences of code unit values. There is no attempt to use the more
complex, semantically oriented definitions of character or string
equality and collating order defined in the Unicode specification.
Therefore Strings values that are canonically equal according to the
Unicode standard could test as unequal. In effect this algorithm assumes
that both Strings are already in normalized form.
13.12
Binary Bitwise Operators
Syntax
BitwiseANDExpression
[In, Yield, Await]
EqualityExpression
[?In, ?Yield, ?Await]
BitwiseANDExpression
[?In, ?Yield, ?Await]
EqualityExpression
[?In, ?Yield, ?Await]
BitwiseXORExpression
[In, Yield, Await]
BitwiseANDExpression
[?In, ?Yield, ?Await]
BitwiseXORExpression
[?In, ?Yield, ?Await]
BitwiseANDExpression
[?In, ?Yield, ?Await]
BitwiseORExpression
[In, Yield, Await]
BitwiseXORExpression
[?In, ?Yield, ?Await]
BitwiseORExpression
[?In, ?Yield, ?Await]
BitwiseXORExpression
[?In, ?Yield, ?Await]
13.12.1
Runtime Semantics: Evaluation
BitwiseANDExpression
BitwiseANDExpression
EqualityExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
BitwiseANDExpression
EqualityExpression
).
BitwiseXORExpression
BitwiseXORExpression
BitwiseANDExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
BitwiseXORExpression
BitwiseANDExpression
).
BitwiseORExpression
BitwiseORExpression
BitwiseXORExpression
1.
Return ?
EvaluateStringOrNumericBinaryExpression
BitwiseORExpression
BitwiseXORExpression
).
13.13
Binary Logical Operators
Syntax
LogicalANDExpression
[In, Yield, Await]
BitwiseORExpression
[?In, ?Yield, ?Await]
LogicalANDExpression
[?In, ?Yield, ?Await]
&&
BitwiseORExpression
[?In, ?Yield, ?Await]
LogicalORExpression
[In, Yield, Await]
LogicalANDExpression
[?In, ?Yield, ?Await]
LogicalORExpression
[?In, ?Yield, ?Await]
||
LogicalANDExpression
[?In, ?Yield, ?Await]
CoalesceExpression
[In, Yield, Await]
CoalesceExpressionHead
[?In, ?Yield, ?Await]
??
BitwiseORExpression
[?In, ?Yield, ?Await]
CoalesceExpressionHead
[In, Yield, Await]
CoalesceExpression
[?In, ?Yield, ?Await]
BitwiseORExpression
[?In, ?Yield, ?Await]
ShortCircuitExpression
[In, Yield, Await]
LogicalORExpression
[?In, ?Yield, ?Await]
CoalesceExpression
[?In, ?Yield, ?Await]
Note
The value produced by a
&&
or
||
operator is not necessarily of type Boolean. The value produced will always be the value of one of the two operand expressions.
13.13.1
Runtime Semantics: Evaluation
LogicalANDExpression
LogicalANDExpression
&&
BitwiseORExpression
1.
Let
lref
be the result of evaluating
LogicalANDExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
lbool
be !
ToBoolean
lval
).
4.
If
lbool
is
false
, return
lval
5.
Let
rref
be the result of evaluating
BitwiseORExpression
6.
Return ?
GetValue
rref
).
LogicalORExpression
LogicalORExpression
||
LogicalANDExpression
1.
Let
lref
be the result of evaluating
LogicalORExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
lbool
be !
ToBoolean
lval
).
4.
If
lbool
is
true
, return
lval
5.
Let
rref
be the result of evaluating
LogicalANDExpression
6.
Return ?
GetValue
rref
).
CoalesceExpression
CoalesceExpressionHead
??
BitwiseORExpression
1.
Let
lref
be the result of evaluating
CoalesceExpressionHead
2.
Let
lval
be ?
GetValue
lref
).
3.
If
lval
is
undefined
or
null
, then
a.
Let
rref
be the result of evaluating
BitwiseORExpression
b.
Return ?
GetValue
rref
).
4.
Otherwise, return
lval
13.14
Conditional Operator (
? :
Syntax
ConditionalExpression
[In, Yield, Await]
ShortCircuitExpression
[?In, ?Yield, ?Await]
ShortCircuitExpression
[?In, ?Yield, ?Await]
AssignmentExpression
[+In, ?Yield, ?Await]
AssignmentExpression
[?In, ?Yield, ?Await]
Note
The grammar for a
ConditionalExpression
in ECMAScript is slightly different from that in C and Java, which each allow the second subexpression to be an
Expression
but restrict the third expression to be a
ConditionalExpression
The motivation for this difference in ECMAScript is to allow an
assignment expression to be governed by either arm of a conditional and
to eliminate the confusing and fairly useless case of a comma expression
as the centre expression.
13.14.1
Runtime Semantics: Evaluation
ConditionalExpression
ShortCircuitExpression
AssignmentExpression
AssignmentExpression
1.
Let
lref
be the result of evaluating
ShortCircuitExpression
2.
Let
lval
be !
ToBoolean
(?
GetValue
lref
)).
3.
If
lval
is
true
, then
a.
Let
trueRef
be the result of evaluating the first
AssignmentExpression
b.
Return ?
GetValue
trueRef
).
4.
Else,
a.
Let
falseRef
be the result of evaluating the second
AssignmentExpression
b.
Return ?
GetValue
falseRef
).
13.15
Assignment Operators
Syntax
AssignmentExpression
[In, Yield, Await]
ConditionalExpression
[?In, ?Yield, ?Await]
[+Yield]
YieldExpression
[?In, ?Await]
ArrowFunction
[?In, ?Yield, ?Await]
AsyncArrowFunction
[?In, ?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
AssignmentExpression
[?In, ?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
AssignmentOperator
AssignmentExpression
[?In, ?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
&&=
AssignmentExpression
[?In, ?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
||=
AssignmentExpression
[?In, ?Yield, ?Await]
LeftHandSideExpression
[?Yield, ?Await]
??=
AssignmentExpression
[?In, ?Yield, ?Await]
AssignmentOperator
one of
*=
/=
%=
+=
-=
<<=
>>=
>>>=
&=
^=
|=
**=
13.15.1
Static Semantics: Early Errors
AssignmentExpression
LeftHandSideExpression
AssignmentExpression
If
LeftHandSideExpression
is an
ObjectLiteral
or an
ArrayLiteral
, the following Early Error rules are applied:
It is a Syntax Error if
LeftHandSideExpression
is not
covering
an
AssignmentPattern
All Early Error rules for
AssignmentPattern
and its derived productions also apply to the
AssignmentPattern
that is
covered
by
LeftHandSideExpression
If
LeftHandSideExpression
is neither an
ObjectLiteral
nor an
ArrayLiteral
, the following Early Error rule is applied:
It is a Syntax Error if
AssignmentTargetType
of
LeftHandSideExpression
is not
simple
AssignmentExpression
LeftHandSideExpression
AssignmentOperator
AssignmentExpression
LeftHandSideExpression
&&=
AssignmentExpression
LeftHandSideExpression
||=
AssignmentExpression
LeftHandSideExpression
??=
AssignmentExpression
It is a Syntax Error if
AssignmentTargetType
of
LeftHandSideExpression
is not
simple
13.15.2
Runtime Semantics: Evaluation
AssignmentExpression
LeftHandSideExpression
AssignmentExpression
1.
If
LeftHandSideExpression
is neither an
ObjectLiteral
nor an
ArrayLiteral
, then
a.
Let
lref
be the result of evaluating
LeftHandSideExpression
b.
ReturnIfAbrupt
lref
).
c.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) and
IsIdentifierRef
of
LeftHandSideExpression
are both
true
, then
i.
Let
rval
be
NamedEvaluation
of
AssignmentExpression
with argument
lref
.[[ReferencedName]].
d.
Else,
i.
Let
rref
be the result of evaluating
AssignmentExpression
ii.
Let
rval
be ?
GetValue
rref
).
e.
Perform ?
PutValue
lref
rval
).
f.
Return
rval
2.
Let
assignmentPattern
be the
AssignmentPattern
that is
covered
by
LeftHandSideExpression
3.
Let
rref
be the result of evaluating
AssignmentExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Perform ?
DestructuringAssignmentEvaluation
of
assignmentPattern
using
rval
as the argument.
6.
Return
rval
AssignmentExpression
LeftHandSideExpression
AssignmentOperator
AssignmentExpression
1.
Let
lref
be the result of evaluating
LeftHandSideExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
AssignmentExpression
4.
Let
rval
be ?
GetValue
rref
).
5.
Let
assignmentOpText
be the
source text matched by
AssignmentOperator
6.
Let
opText
be the sequence of Unicode code points associated with
assignmentOpText
in the following table:
assignmentOpText
opText
**=
**
*=
/=
%=
+=
-=
<<=
<<
>>=
>>
>>>=
>>>
&=
^=
|=
7.
Let
be
ApplyStringOrNumericBinaryOperator
lval
opText
rval
).
8.
Perform ?
PutValue
lref
).
9.
Return
AssignmentExpression
LeftHandSideExpression
&&=
AssignmentExpression
1.
Let
lref
be the result of evaluating
LeftHandSideExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
lbool
be !
ToBoolean
lval
).
4.
If
lbool
is
false
, return
lval
5.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) is
true
and
IsIdentifierRef
of
LeftHandSideExpression
is
true
, then
a.
Let
rval
be
NamedEvaluation
of
AssignmentExpression
with argument
lref
.[[ReferencedName]].
6.
Else,
a.
Let
rref
be the result of evaluating
AssignmentExpression
b.
Let
rval
be ?
GetValue
rref
).
7.
Perform ?
PutValue
lref
rval
).
8.
Return
rval
AssignmentExpression
LeftHandSideExpression
||=
AssignmentExpression
1.
Let
lref
be the result of evaluating
LeftHandSideExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
lbool
be !
ToBoolean
lval
).
4.
If
lbool
is
true
, return
lval
5.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) is
true
and
IsIdentifierRef
of
LeftHandSideExpression
is
true
, then
a.
Let
rval
be
NamedEvaluation
of
AssignmentExpression
with argument
lref
.[[ReferencedName]].
6.
Else,
a.
Let
rref
be the result of evaluating
AssignmentExpression
b.
Let
rval
be ?
GetValue
rref
).
7.
Perform ?
PutValue
lref
rval
).
8.
Return
rval
AssignmentExpression
LeftHandSideExpression
??=
AssignmentExpression
1.
Let
lref
be the result of evaluating
LeftHandSideExpression
2.
Let
lval
be ?
GetValue
lref
).
3.
If
lval
is neither
undefined
nor
null
, return
lval
4.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) is
true
and
IsIdentifierRef
of
LeftHandSideExpression
is
true
, then
a.
Let
rval
be
NamedEvaluation
of
AssignmentExpression
with argument
lref
.[[ReferencedName]].
5.
Else,
a.
Let
rref
be the result of evaluating
AssignmentExpression
b.
Let
rval
be ?
GetValue
rref
).
6.
Perform ?
PutValue
lref
rval
).
7.
Return
rval
Note
When this expression occurs within
strict mode code
, it is a runtime error if
lref
in step
1.e
is an unresolvable reference. If it is, a
ReferenceError
exception is thrown. Additionally, it is a runtime error if the
lref
in step
is a reference to a
data property
with the attribute value { [[Writable]]:
false
}, to an
accessor property
with the attribute value { [[Set]]:
undefined
}, or to a non-existent property of an object for which the
IsExtensible
predicate returns the value
false
. In these cases a
TypeError
exception is thrown.
13.15.3
ApplyStringOrNumericBinaryOperator (
lval
opText
rval
The abstract operation ApplyStringOrNumericBinaryOperator takes arguments
lval
(an
ECMAScript language value
),
opText
(a sequence of Unicode code points), and
rval
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
opText
is present in the table in step
2.
If
opText
is
, then
a.
Let
lprim
be ?
ToPrimitive
lval
).
b.
Let
rprim
be ?
ToPrimitive
rval
).
c.
If
Type
lprim
) is String or
Type
rprim
) is String, then
i.
Let
lstr
be ?
ToString
lprim
).
ii.
Let
rstr
be ?
ToString
rprim
).
iii.
Return the
string-concatenation
of
lstr
and
rstr
d.
Set
lval
to
lprim
e.
Set
rval
to
rprim
3.
NOTE: At this point, it must be a numeric operation.
4.
Let
lnum
be ?
ToNumeric
lval
).
5.
Let
rnum
be ?
ToNumeric
rval
).
6.
If
Type
lnum
) is different from
Type
rnum
), throw a
TypeError
exception.
7.
Let
be
Type
lnum
).
8.
Let
operation
be the abstract operation associated with
opText
in the following table:
opText
operation
**
::exponentiate
::multiply
::divide
::remainder
::add
::subtract
<<
::leftShift
>>
::signedRightShift
>>>
::unsignedRightShift
::bitwiseAND
::bitwiseXOR
::bitwiseOR
9.
Return ?
operation
lnum
rnum
).
Note 1
No hint is provided in the calls to
ToPrimitive
in steps
2.a
and
2.b
. All standard objects except Date objects handle the absence of a hint as if
number
were given; Date objects handle the absence of a hint as if
string
were given. Exotic objects may handle the absence of a hint in some other manner.
Note 2
Step
2.c
differs from step
of the
Abstract Relational Comparison
algorithm, by using the logical-or operation instead of the logical-and operation.
13.15.4
EvaluateStringOrNumericBinaryExpression (
leftOperand
opText
rightOperand
The abstract operation EvaluateStringOrNumericBinaryExpression takes arguments
leftOperand
(a
Parse Node
),
opText
(a sequence of Unicode code points), and
rightOperand
(a
Parse Node
). It performs the following steps when called:
1.
Let
lref
be the result of evaluating
leftOperand
2.
Let
lval
be ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
rightOperand
4.
Let
rval
be ?
GetValue
rref
).
5.
Return ?
ApplyStringOrNumericBinaryOperator
lval
opText
rval
).
13.15.5
Destructuring Assignment
Supplemental Syntax
In certain circumstances when processing an instance of the production
AssignmentExpression
LeftHandSideExpression
AssignmentExpression
the interpretation of
LeftHandSideExpression
is refined using the following grammar:
AssignmentPattern
[Yield, Await]
ObjectAssignmentPattern
[?Yield, ?Await]
ArrayAssignmentPattern
[?Yield, ?Await]
ObjectAssignmentPattern
[Yield, Await]
AssignmentRestProperty
[?Yield, ?Await]
AssignmentPropertyList
[?Yield, ?Await]
AssignmentPropertyList
[?Yield, ?Await]
AssignmentRestProperty
[?Yield, ?Await]
opt
ArrayAssignmentPattern
[Yield, Await]
Elision
opt
AssignmentRestElement
[?Yield, ?Await]
opt
AssignmentElementList
[?Yield, ?Await]
AssignmentElementList
[?Yield, ?Await]
Elision
opt
AssignmentRestElement
[?Yield, ?Await]
opt
AssignmentRestProperty
[Yield, Await]
...
DestructuringAssignmentTarget
[?Yield, ?Await]
AssignmentPropertyList
[Yield, Await]
AssignmentProperty
[?Yield, ?Await]
AssignmentPropertyList
[?Yield, ?Await]
AssignmentProperty
[?Yield, ?Await]
AssignmentElementList
[Yield, Await]
AssignmentElisionElement
[?Yield, ?Await]
AssignmentElementList
[?Yield, ?Await]
AssignmentElisionElement
[?Yield, ?Await]
AssignmentElisionElement
[Yield, Await]
Elision
opt
AssignmentElement
[?Yield, ?Await]
AssignmentProperty
[Yield, Await]
IdentifierReference
[?Yield, ?Await]
Initializer
[+In, ?Yield, ?Await]
opt
PropertyName
[?Yield, ?Await]
AssignmentElement
[?Yield, ?Await]
AssignmentElement
[Yield, Await]
DestructuringAssignmentTarget
[?Yield, ?Await]
Initializer
[+In, ?Yield, ?Await]
opt
AssignmentRestElement
[Yield, Await]
...
DestructuringAssignmentTarget
[?Yield, ?Await]
DestructuringAssignmentTarget
[Yield, Await]
LeftHandSideExpression
[?Yield, ?Await]
13.15.5.1
Static Semantics: Early Errors
AssignmentProperty
IdentifierReference
Initializer
opt
It is a Syntax Error if
AssignmentTargetType
of
IdentifierReference
is not
simple
AssignmentRestProperty
...
DestructuringAssignmentTarget
It is a Syntax Error if
DestructuringAssignmentTarget
is an
ArrayLiteral
or an
ObjectLiteral
DestructuringAssignmentTarget
LeftHandSideExpression
If
LeftHandSideExpression
is an
ObjectLiteral
or an
ArrayLiteral
, the following Early Error rules are applied:
It is a Syntax Error if
LeftHandSideExpression
is not
covering
an
AssignmentPattern
All Early Error rules for
AssignmentPattern
and its derived productions also apply to the
AssignmentPattern
that is
covered
by
LeftHandSideExpression
If
LeftHandSideExpression
is neither an
ObjectLiteral
nor an
ArrayLiteral
, the following Early Error rule is applied:
It is a Syntax Error if
AssignmentTargetType
of
LeftHandSideExpression
is not
simple
13.15.5.2
Runtime Semantics: DestructuringAssignmentEvaluation
With parameter
value
ObjectAssignmentPattern
1.
Perform ?
RequireObjectCoercible
value
).
2.
Return
NormalCompletion
empty
).
ObjectAssignmentPattern
AssignmentPropertyList
AssignmentPropertyList
1.
Perform ?
RequireObjectCoercible
value
).
2.
Perform ?
PropertyDestructuringAssignmentEvaluation
for
AssignmentPropertyList
using
value
as the argument.
3.
Return
NormalCompletion
empty
).
ArrayAssignmentPattern
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
Return ?
IteratorClose
iteratorRecord
NormalCompletion
empty
)).
ArrayAssignmentPattern
Elision
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
Let
result
be
IteratorDestructuringAssignmentEvaluation
of
Elision
with argument
iteratorRecord
3.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
result
).
4.
Return
result
ArrayAssignmentPattern
Elision
opt
AssignmentRestElement
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
If
Elision
is present, then
a.
Let
status
be
IteratorDestructuringAssignmentEvaluation
of
Elision
with argument
iteratorRecord
b.
If
status
is an
abrupt completion
, then
i.
Assert
iteratorRecord
.[[Done]] is
true
ii.
Return
Completion
status
).
3.
Let
result
be
IteratorDestructuringAssignmentEvaluation
of
AssignmentRestElement
with argument
iteratorRecord
4.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
result
).
5.
Return
result
ArrayAssignmentPattern
AssignmentElementList
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
Let
result
be
IteratorDestructuringAssignmentEvaluation
of
AssignmentElementList
with argument
iteratorRecord
3.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
result
).
4.
Return
result
ArrayAssignmentPattern
AssignmentElementList
Elision
opt
AssignmentRestElement
opt
1.
Let
iteratorRecord
be ?
GetIterator
value
).
2.
Let
status
be
IteratorDestructuringAssignmentEvaluation
of
AssignmentElementList
with argument
iteratorRecord
3.
If
status
is an
abrupt completion
, then
a.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
status
).
b.
Return
Completion
status
).
4.
If
Elision
is present, then
a.
Set
status
to the result of performing
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
b.
If
status
is an
abrupt completion
, then
i.
Assert
iteratorRecord
.[[Done]] is
true
ii.
Return
Completion
status
).
5.
If
AssignmentRestElement
is present, then
a.
Set
status
to the result of performing
IteratorDestructuringAssignmentEvaluation
of
AssignmentRestElement
with
iteratorRecord
as the argument.
6.
If
iteratorRecord
.[[Done]] is
false
, return ?
IteratorClose
iteratorRecord
status
).
7.
Return
Completion
status
).
ObjectAssignmentPattern
AssignmentRestProperty
1.
Perform ?
RequireObjectCoercible
value
).
2.
Let
excludedNames
be a new empty
List
3.
Return the result of performing
RestDestructuringAssignmentEvaluation
of
AssignmentRestProperty
with
value
and
excludedNames
as the arguments.
ObjectAssignmentPattern
AssignmentPropertyList
AssignmentRestProperty
1.
Perform ?
RequireObjectCoercible
value
).
2.
Let
excludedNames
be ?
PropertyDestructuringAssignmentEvaluation
of
AssignmentPropertyList
with argument
value
3.
Return the result of performing
RestDestructuringAssignmentEvaluation
of
AssignmentRestProperty
with arguments
value
and
excludedNames
13.15.5.3
Runtime Semantics: PropertyDestructuringAssignmentEvaluation
With parameter
value
Note
The following operations collect a list of all destructured property names.
AssignmentPropertyList
AssignmentPropertyList
AssignmentProperty
1.
Let
propertyNames
be ?
PropertyDestructuringAssignmentEvaluation
of
AssignmentPropertyList
with argument
value
2.
Let
nextNames
be ?
PropertyDestructuringAssignmentEvaluation
of
AssignmentProperty
with argument
value
3.
Append each item in
nextNames
to the end of
propertyNames
4.
Return
propertyNames
AssignmentProperty
IdentifierReference
Initializer
opt
1.
Let
be
StringValue
of
IdentifierReference
2.
Let
lref
be ?
ResolveBinding
).
3.
Let
be ?
GetV
value
).
4.
If
Initializer
opt
is present and
is
undefined
, then
a.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
, then
i.
Set
to the result of performing
NamedEvaluation
for
Initializer
with argument
b.
Else,
i.
Let
defaultValue
be the result of evaluating
Initializer
ii.
Set
to ?
GetValue
defaultValue
).
5.
Perform ?
PutValue
lref
).
6.
Return a
List
whose sole element is
AssignmentProperty
PropertyName
AssignmentElement
1.
Let
name
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
name
).
3.
Perform ?
KeyedDestructuringAssignmentEvaluation
of
AssignmentElement
with
value
and
name
as the arguments.
4.
Return a
List
whose sole element is
name
13.15.5.4
Runtime Semantics: RestDestructuringAssignmentEvaluation
With parameters
value
and
excludedNames
AssignmentRestProperty
...
DestructuringAssignmentTarget
1.
Let
lref
be the result of evaluating
DestructuringAssignmentTarget
2.
ReturnIfAbrupt
lref
).
3.
Let
restObj
be !
OrdinaryObjectCreate
%Object.prototype%
).
4.
Perform ?
CopyDataProperties
restObj
value
excludedNames
).
5.
Return
PutValue
lref
restObj
).
13.15.5.5
Runtime Semantics: IteratorDestructuringAssignmentEvaluation
With parameter
iteratorRecord
AssignmentElementList
AssignmentElisionElement
1.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
AssignmentElisionElement
using
iteratorRecord
as the argument.
AssignmentElementList
AssignmentElementList
AssignmentElisionElement
1.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
AssignmentElementList
using
iteratorRecord
as the argument.
2.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
AssignmentElisionElement
using
iteratorRecord
as the argument.
AssignmentElisionElement
AssignmentElement
1.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
AssignmentElement
with
iteratorRecord
as the argument.
AssignmentElisionElement
Elision
AssignmentElement
1.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
2.
Return the result of performing
IteratorDestructuringAssignmentEvaluation
of
AssignmentElement
with
iteratorRecord
as the argument.
Elision
1.
If
iteratorRecord
.[[Done]] is
false
, then
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
2.
Return
NormalCompletion
empty
).
Elision
Elision
1.
Perform ?
IteratorDestructuringAssignmentEvaluation
of
Elision
with
iteratorRecord
as the argument.
2.
If
iteratorRecord
.[[Done]] is
false
, then
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
3.
Return
NormalCompletion
empty
).
AssignmentElement
DestructuringAssignmentTarget
Initializer
opt
1.
If
DestructuringAssignmentTarget
is neither an
ObjectLiteral
nor an
ArrayLiteral
, then
a.
Let
lref
be the result of evaluating
DestructuringAssignmentTarget
b.
ReturnIfAbrupt
lref
).
2.
If
iteratorRecord
.[[Done]] is
false
, then
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
e.
Else,
i.
Let
value
be
IteratorValue
next
).
ii.
If
value
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
value
).
3.
If
iteratorRecord
.[[Done]] is
true
, let
value
be
undefined
4.
If
Initializer
is present and
value
is
undefined
, then
a.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
and
IsIdentifierRef
of
DestructuringAssignmentTarget
is
true
, then
i.
Let
be ?
NamedEvaluation
of
Initializer
with argument
lref
.[[ReferencedName]].
b.
Else,
i.
Let
defaultValue
be the result of evaluating
Initializer
ii.
Let
be ?
GetValue
defaultValue
).
5.
Else, let
be
value
6.
If
DestructuringAssignmentTarget
is an
ObjectLiteral
or an
ArrayLiteral
, then
a.
Let
nestedAssignmentPattern
be the
AssignmentPattern
that is
covered
by
DestructuringAssignmentTarget
b.
Return the result of performing
DestructuringAssignmentEvaluation
of
nestedAssignmentPattern
with
as the argument.
7.
Return ?
PutValue
lref
).
Note
Left to right evaluation order is maintained by evaluating a
DestructuringAssignmentTarget
that is not a destructuring pattern prior to accessing the iterator or evaluating the
Initializer
AssignmentRestElement
...
DestructuringAssignmentTarget
1.
If
DestructuringAssignmentTarget
is neither an
ObjectLiteral
nor an
ArrayLiteral
, then
a.
Let
lref
be the result of evaluating
DestructuringAssignmentTarget
b.
ReturnIfAbrupt
lref
).
2.
Let
be !
ArrayCreate
(0).
3.
Let
be 0.
4.
Repeat, while
iteratorRecord
.[[Done]] is
false
a.
Let
next
be
IteratorStep
iteratorRecord
).
b.
If
next
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
c.
ReturnIfAbrupt
next
).
d.
If
next
is
false
, set
iteratorRecord
.[[Done]] to
true
e.
Else,
i.
Let
nextValue
be
IteratorValue
next
).
ii.
If
nextValue
is an
abrupt completion
, set
iteratorRecord
.[[Done]] to
true
iii.
ReturnIfAbrupt
nextValue
).
iv.
Perform !
CreateDataPropertyOrThrow
, !
ToString
)),
nextValue
).
v.
Set
to
+ 1.
5.
If
DestructuringAssignmentTarget
is neither an
ObjectLiteral
nor an
ArrayLiteral
, then
a.
Return ?
PutValue
lref
).
6.
Let
nestedAssignmentPattern
be the
AssignmentPattern
that is
covered
by
DestructuringAssignmentTarget
7.
Return the result of performing
DestructuringAssignmentEvaluation
of
nestedAssignmentPattern
with
as the argument.
13.15.5.6
Runtime Semantics: KeyedDestructuringAssignmentEvaluation
With parameters
value
and
propertyName
AssignmentElement
DestructuringAssignmentTarget
Initializer
opt
1.
If
DestructuringAssignmentTarget
is neither an
ObjectLiteral
nor an
ArrayLiteral
, then
a.
Let
lref
be the result of evaluating
DestructuringAssignmentTarget
b.
ReturnIfAbrupt
lref
).
2.
Let
be ?
GetV
value
propertyName
).
3.
If
Initializer
is present and
is
undefined
, then
a.
If
IsAnonymousFunctionDefinition
Initializer
) and
IsIdentifierRef
of
DestructuringAssignmentTarget
are both
true
, then
i.
Let
rhsValue
be ?
NamedEvaluation
of
Initializer
with argument
lref
.[[ReferencedName]].
b.
Else,
i.
Let
defaultValue
be the result of evaluating
Initializer
ii.
Let
rhsValue
be ?
GetValue
defaultValue
).
4.
Else, let
rhsValue
be
5.
If
DestructuringAssignmentTarget
is an
ObjectLiteral
or an
ArrayLiteral
, then
a.
Let
assignmentPattern
be the
AssignmentPattern
that is
covered
by
DestructuringAssignmentTarget
b.
Return the result of performing
DestructuringAssignmentEvaluation
of
assignmentPattern
with
rhsValue
as the argument.
6.
Return ?
PutValue
lref
rhsValue
).
13.16
Comma Operator (
Syntax
Expression
[In, Yield, Await]
AssignmentExpression
[?In, ?Yield, ?Await]
Expression
[?In, ?Yield, ?Await]
AssignmentExpression
[?In, ?Yield, ?Await]
13.16.1
Runtime Semantics: Evaluation
Expression
Expression
AssignmentExpression
1.
Let
lref
be the result of evaluating
Expression
2.
Perform ?
GetValue
lref
).
3.
Let
rref
be the result of evaluating
AssignmentExpression
4.
Return ?
GetValue
rref
).
Note
GetValue
must be called even though its value is not used because it may have observable side-effects.
14
ECMAScript Language: Statements and Declarations
Syntax
Statement
[Yield, Await, Return]
BlockStatement
[?Yield, ?Await, ?Return]
VariableStatement
[?Yield, ?Await]
EmptyStatement
ExpressionStatement
[?Yield, ?Await]
IfStatement
[?Yield, ?Await, ?Return]
BreakableStatement
[?Yield, ?Await, ?Return]
ContinueStatement
[?Yield, ?Await]
BreakStatement
[?Yield, ?Await]
[+Return]
ReturnStatement
[?Yield, ?Await]
WithStatement
[?Yield, ?Await, ?Return]
LabelledStatement
[?Yield, ?Await, ?Return]
ThrowStatement
[?Yield, ?Await]
TryStatement
[?Yield, ?Await, ?Return]
DebuggerStatement
Declaration
[Yield, Await]
HoistableDeclaration
[?Yield, ?Await, ~Default]
ClassDeclaration
[?Yield, ?Await, ~Default]
LexicalDeclaration
[+In, ?Yield, ?Await]
HoistableDeclaration
[Yield, Await, Default]
FunctionDeclaration
[?Yield, ?Await, ?Default]
GeneratorDeclaration
[?Yield, ?Await, ?Default]
AsyncFunctionDeclaration
[?Yield, ?Await, ?Default]
AsyncGeneratorDeclaration
[?Yield, ?Await, ?Default]
BreakableStatement
[Yield, Await, Return]
IterationStatement
[?Yield, ?Await, ?Return]
SwitchStatement
[?Yield, ?Await, ?Return]
14.1
Statement Semantics
14.1.1
Runtime Semantics: Evaluation
HoistableDeclaration
GeneratorDeclaration
AsyncFunctionDeclaration
AsyncGeneratorDeclaration
1.
Return
NormalCompletion
empty
).
HoistableDeclaration
FunctionDeclaration
1.
Return the result of evaluating
FunctionDeclaration
BreakableStatement
IterationStatement
SwitchStatement
1.
Let
newLabelSet
be a new empty
List
2.
Return the result of performing
LabelledEvaluation
of this
BreakableStatement
with argument
newLabelSet
14.2
Block
Syntax
BlockStatement
[Yield, Await, Return]
Block
[?Yield, ?Await, ?Return]
Block
[Yield, Await, Return]
StatementList
[?Yield, ?Await, ?Return]
opt
StatementList
[Yield, Await, Return]
StatementListItem
[?Yield, ?Await, ?Return]
StatementList
[?Yield, ?Await, ?Return]
StatementListItem
[?Yield, ?Await, ?Return]
StatementListItem
[Yield, Await, Return]
Statement
[?Yield, ?Await, ?Return]
Declaration
[?Yield, ?Await]
14.2.1
Static Semantics: Early Errors
Block
StatementList
It is a Syntax Error if the
LexicallyDeclaredNames
of
StatementList
contains any duplicate entries.
It is a Syntax Error if any element of the
LexicallyDeclaredNames
of
StatementList
also occurs in the
VarDeclaredNames
of
StatementList
14.2.2
Runtime Semantics: Evaluation
Block
1.
Return
NormalCompletion
empty
).
Block
StatementList
1.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
2.
Let
blockEnv
be
NewDeclarativeEnvironment
oldEnv
).
3.
Perform
BlockDeclarationInstantiation
StatementList
blockEnv
).
4.
Set the
running execution context
's LexicalEnvironment to
blockEnv
5.
Let
blockValue
be the result of evaluating
StatementList
6.
Set the
running execution context
's LexicalEnvironment to
oldEnv
7.
Return
blockValue
Note 1
No matter how control leaves the
Block
the LexicalEnvironment is always restored to its former state.
StatementList
StatementList
StatementListItem
1.
Let
sl
be the result of evaluating
StatementList
2.
ReturnIfAbrupt
sl
).
3.
Let
be the result of evaluating
StatementListItem
4.
Return
Completion
UpdateEmpty
sl
)).
Note 2
The value of a
StatementList
is the value of the last value-producing item in the
StatementList
. For example, the following calls to the
eval
function all return the value 1:
eval
"1;;;;;"
eval
"1;{}"
eval
"1;var a;"
14.2.3
BlockDeclarationInstantiation (
code
env
Note
When a
Block
or
CaseBlock
is evaluated a new
declarative Environment Record
is created and bindings for each block scoped variable, constant,
function, or class declared in the block are instantiated in the
Environment Record
The abstract operation BlockDeclarationInstantiation takes arguments
code
(a
Parse Node
) and
env
(an
Environment Record
).
code
is the
Parse Node
corresponding to the body of the block.
env
is the
Environment Record
in which bindings are to be created. It performs the following steps when called:
1.
Assert
env
is a
declarative Environment Record
2.
Let
declarations
be the
LexicallyScopedDeclarations
of
code
3.
For each element
of
declarations
, do
a.
For each element
dn
of the
BoundNames
of
, do
i.
If
IsConstantDeclaration
of
is
true
, then
1.
Perform !
env
.CreateImmutableBinding(
dn
true
).
ii.
Else,
1.
Perform !
env
.CreateMutableBinding(
dn
false
). NOTE: This step is replaced in section
B.3.3.6
b.
If
is a
FunctionDeclaration
, a
GeneratorDeclaration
, an
AsyncFunctionDeclaration
, or an
AsyncGeneratorDeclaration
, then
i.
Let
fn
be the sole element of the
BoundNames
of
ii.
Let
fo
be
InstantiateFunctionObject
of
with argument
env
iii.
Perform
env
.InitializeBinding(
fn
fo
). NOTE: This step is replaced in section
B.3.3.6
14.3
Declarations and the Variable Statement
14.3.1
Let and Const Declarations
Note
let
and
const
declarations define variables that are scoped to the
running execution context
's LexicalEnvironment. The variables are created when their containing
Environment Record
is instantiated but may not be accessed in any way until the variable's
LexicalBinding
is evaluated. A variable defined by a
LexicalBinding
with an
Initializer
is assigned the value of its
Initializer
's
AssignmentExpression
when the
LexicalBinding
is evaluated, not when the variable is created. If a
LexicalBinding
in a
let
declaration does not have an
Initializer
the variable is assigned the value
undefined
when the
LexicalBinding
is evaluated.
Syntax
LexicalDeclaration
[In, Yield, Await]
LetOrConst
BindingList
[?In, ?Yield, ?Await]
LetOrConst
let
const
BindingList
[In, Yield, Await]
LexicalBinding
[?In, ?Yield, ?Await]
BindingList
[?In, ?Yield, ?Await]
LexicalBinding
[?In, ?Yield, ?Await]
LexicalBinding
[In, Yield, Await]
BindingIdentifier
[?Yield, ?Await]
Initializer
[?In, ?Yield, ?Await]
opt
BindingPattern
[?Yield, ?Await]
Initializer
[?In, ?Yield, ?Await]
14.3.1.1
Static Semantics: Early Errors
LexicalDeclaration
LetOrConst
BindingList
It is a Syntax Error if the
BoundNames
of
BindingList
contains
"let"
It is a Syntax Error if the
BoundNames
of
BindingList
contains any duplicate entries.
LexicalBinding
BindingIdentifier
Initializer
opt
It is a Syntax Error if
Initializer
is not present and
IsConstantDeclaration
of the
LexicalDeclaration
containing this
LexicalBinding
is
true
14.3.1.2
Runtime Semantics: Evaluation
LexicalDeclaration
LetOrConst
BindingList
1.
Let
next
be the result of evaluating
BindingList
2.
ReturnIfAbrupt
next
).
3.
Return
NormalCompletion
empty
).
BindingList
BindingList
LexicalBinding
1.
Let
next
be the result of evaluating
BindingList
2.
ReturnIfAbrupt
next
).
3.
Return the result of evaluating
LexicalBinding
LexicalBinding
BindingIdentifier
1.
Let
lhs
be
ResolveBinding
StringValue
of
BindingIdentifier
).
2.
Return
InitializeReferencedBinding
lhs
undefined
).
Note
static semantics
rule ensures that this form of
LexicalBinding
never occurs in a
const
declaration.
LexicalBinding
BindingIdentifier
Initializer
1.
Let
bindingId
be
StringValue
of
BindingIdentifier
2.
Let
lhs
be
ResolveBinding
bindingId
).
3.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
, then
a.
Let
value
be
NamedEvaluation
of
Initializer
with argument
bindingId
4.
Else,
a.
Let
rhs
be the result of evaluating
Initializer
b.
Let
value
be ?
GetValue
rhs
).
5.
Return
InitializeReferencedBinding
lhs
value
).
LexicalBinding
BindingPattern
Initializer
1.
Let
rhs
be the result of evaluating
Initializer
2.
Let
value
be ?
GetValue
rhs
).
3.
Let
env
be the
running execution context
's LexicalEnvironment.
4.
Return the result of performing
BindingInitialization
for
BindingPattern
using
value
and
env
as the arguments.
14.3.2
Variable Statement
Note
var
statement declares variables that are scoped to the
running execution context
's VariableEnvironment. Var variables are created when their containing
Environment Record
is instantiated and are initialized to
undefined
when created. Within the scope of any VariableEnvironment a common
BindingIdentifier
may appear in more than one
VariableDeclaration
but those declarations collectively define only one variable. A variable defined by a
VariableDeclaration
with an
Initializer
is assigned the value of its
Initializer
's
AssignmentExpression
when the
VariableDeclaration
is executed, not when the variable is created.
Syntax
VariableStatement
[Yield, Await]
var
VariableDeclarationList
[+In, ?Yield, ?Await]
VariableDeclarationList
[In, Yield, Await]
VariableDeclaration
[?In, ?Yield, ?Await]
VariableDeclarationList
[?In, ?Yield, ?Await]
VariableDeclaration
[?In, ?Yield, ?Await]
VariableDeclaration
[In, Yield, Await]
BindingIdentifier
[?Yield, ?Await]
Initializer
[?In, ?Yield, ?Await]
opt
BindingPattern
[?Yield, ?Await]
Initializer
[?In, ?Yield, ?Await]
14.3.2.1
Runtime Semantics: Evaluation
VariableStatement
var
VariableDeclarationList
1.
Let
next
be the result of evaluating
VariableDeclarationList
2.
ReturnIfAbrupt
next
).
3.
Return
NormalCompletion
empty
).
VariableDeclarationList
VariableDeclarationList
VariableDeclaration
1.
Let
next
be the result of evaluating
VariableDeclarationList
2.
ReturnIfAbrupt
next
).
3.
Return the result of evaluating
VariableDeclaration
VariableDeclaration
BindingIdentifier
1.
Return
NormalCompletion
empty
).
VariableDeclaration
BindingIdentifier
Initializer
1.
Let
bindingId
be
StringValue
of
BindingIdentifier
2.
Let
lhs
be ?
ResolveBinding
bindingId
).
3.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
, then
a.
Let
value
be
NamedEvaluation
of
Initializer
with argument
bindingId
4.
Else,
a.
Let
rhs
be the result of evaluating
Initializer
b.
Let
value
be ?
GetValue
rhs
).
5.
Return ?
PutValue
lhs
value
).
Note
If a
VariableDeclaration
is nested within a with statement and the
BindingIdentifier
in the
VariableDeclaration
is the same as a
property name
of the binding object of the with statement's
object Environment Record
, then step
will assign
value
to the property instead of assigning to the VariableEnvironment binding of the
Identifier
VariableDeclaration
BindingPattern
Initializer
1.
Let
rhs
be the result of evaluating
Initializer
2.
Let
rval
be ?
GetValue
rhs
).
3.
Return the result of performing
BindingInitialization
for
BindingPattern
passing
rval
and
undefined
as arguments.
14.3.3
Destructuring Binding Patterns
Syntax
BindingPattern
[Yield, Await]
ObjectBindingPattern
[?Yield, ?Await]
ArrayBindingPattern
[?Yield, ?Await]
ObjectBindingPattern
[Yield, Await]
BindingRestProperty
[?Yield, ?Await]
BindingPropertyList
[?Yield, ?Await]
BindingPropertyList
[?Yield, ?Await]
BindingRestProperty
[?Yield, ?Await]
opt
ArrayBindingPattern
[Yield, Await]
Elision
opt
BindingRestElement
[?Yield, ?Await]
opt
BindingElementList
[?Yield, ?Await]
BindingElementList
[?Yield, ?Await]
Elision
opt
BindingRestElement
[?Yield, ?Await]
opt
BindingRestProperty
[Yield, Await]
...
BindingIdentifier
[?Yield, ?Await]
BindingPropertyList
[Yield, Await]
BindingProperty
[?Yield, ?Await]
BindingPropertyList
[?Yield, ?Await]
BindingProperty
[?Yield, ?Await]
BindingElementList
[Yield, Await]
BindingElisionElement
[?Yield, ?Await]
BindingElementList
[?Yield, ?Await]
BindingElisionElement
[?Yield, ?Await]
BindingElisionElement
[Yield, Await]
Elision
opt
BindingElement
[?Yield, ?Await]
BindingProperty
[Yield, Await]
SingleNameBinding
[?Yield, ?Await]
PropertyName
[?Yield, ?Await]
BindingElement
[?Yield, ?Await]
BindingElement
[Yield, Await]
SingleNameBinding
[?Yield, ?Await]
BindingPattern
[?Yield, ?Await]
Initializer
[+In, ?Yield, ?Await]
opt
SingleNameBinding
[Yield, Await]
BindingIdentifier
[?Yield, ?Await]
Initializer
[+In, ?Yield, ?Await]
opt
BindingRestElement
[Yield, Await]
...
BindingIdentifier
[?Yield, ?Await]
...
BindingPattern
[?Yield, ?Await]
14.3.3.1
Runtime Semantics: PropertyBindingInitialization
With parameters
value
and
environment
Note
These collect a list of all bound property names rather than just empty completion.
BindingPropertyList
BindingPropertyList
BindingProperty
1.
Let
boundNames
be ?
PropertyBindingInitialization
of
BindingPropertyList
with arguments
value
and
environment
2.
Let
nextNames
be ?
PropertyBindingInitialization
of
BindingProperty
with arguments
value
and
environment
3.
Append each item in
nextNames
to the end of
boundNames
4.
Return
boundNames
BindingProperty
SingleNameBinding
1.
Let
name
be the string that is the only element of
BoundNames
of
SingleNameBinding
2.
Perform ?
KeyedBindingInitialization
for
SingleNameBinding
using
value
environment
, and
name
as the arguments.
3.
Return a
List
whose sole element is
name
BindingProperty
PropertyName
BindingElement
1.
Let
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
).
3.
Perform ?
KeyedBindingInitialization
of
BindingElement
with
value
environment
, and
as the arguments.
4.
Return a
List
whose sole element is
14.3.3.2
Runtime Semantics: RestBindingInitialization
With parameters
value
environment
, and
excludedNames
BindingRestProperty
...
BindingIdentifier
1.
Let
lhs
be ?
ResolveBinding
StringValue
of
BindingIdentifier
environment
).
2.
Let
restObj
be !
OrdinaryObjectCreate
%Object.prototype%
).
3.
Perform ?
CopyDataProperties
restObj
value
excludedNames
).
4.
If
environment
is
undefined
, return
PutValue
lhs
restObj
).
5.
Return
InitializeReferencedBinding
lhs
restObj
).
14.3.3.3
Runtime Semantics: KeyedBindingInitialization
With parameters
value
environment
, and
propertyName
Note
When
undefined
is passed for
environment
it indicates that a
PutValue
operation should be used to assign the initialization value. This is
the case for formal parameter lists of non-strict functions. In that
case the formal parameter bindings are preinitialized in order to deal
with the possibility of multiple parameters with the same name.
BindingElement
BindingPattern
Initializer
opt
1.
Let
be ?
GetV
value
propertyName
).
2.
If
Initializer
is present and
is
undefined
, then
a.
Let
defaultValue
be the result of evaluating
Initializer
b.
Set
to ?
GetValue
defaultValue
).
3.
Return the result of performing
BindingInitialization
for
BindingPattern
passing
and
environment
as arguments.
SingleNameBinding
BindingIdentifier
Initializer
opt
1.
Let
bindingId
be
StringValue
of
BindingIdentifier
2.
Let
lhs
be ?
ResolveBinding
bindingId
environment
).
3.
Let
be ?
GetV
value
propertyName
).
4.
If
Initializer
is present and
is
undefined
, then
a.
If
IsAnonymousFunctionDefinition
Initializer
) is
true
, then
i.
Set
to the result of performing
NamedEvaluation
for
Initializer
with argument
bindingId
b.
Else,
i.
Let
defaultValue
be the result of evaluating
Initializer
ii.
Set
to ?
GetValue
defaultValue
).
5.
If
environment
is
undefined
, return ?
PutValue
lhs
).
6.
Return
InitializeReferencedBinding
lhs
).
14.4
Empty Statement
Syntax
EmptyStatement
14.4.1
Runtime Semantics: Evaluation
EmptyStatement
1.
Return
NormalCompletion
empty
).
14.5
Expression Statement
Syntax
ExpressionStatement
[Yield, Await]
[lookahead ∉ {
function
async
[no
LineTerminator
here]
function
class
let
}]
Expression
[+In, ?Yield, ?Await]
Note
An
ExpressionStatement
cannot start with a U+007B (LEFT CURLY BRACKET) because that might make it ambiguous with a
Block
. An
ExpressionStatement
cannot start with the
function
or
class
keywords because that would make it ambiguous with a
FunctionDeclaration
, a
GeneratorDeclaration
, or a
ClassDeclaration
. An
ExpressionStatement
cannot start with
async function
because that would make it ambiguous with an
AsyncFunctionDeclaration
or a
AsyncGeneratorDeclaration
. An
ExpressionStatement
cannot start with the two token sequence
let [
because that would make it ambiguous with a
let
LexicalDeclaration
whose first
LexicalBinding
was an
ArrayBindingPattern
14.5.1
Runtime Semantics: Evaluation
ExpressionStatement
Expression
1.
Let
exprRef
be the result of evaluating
Expression
2.
Return ?
GetValue
exprRef
).
14.6
The
if
Statement
Syntax
IfStatement
[Yield, Await, Return]
if
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
else
Statement
[?Yield, ?Await, ?Return]
if
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
[lookahead ≠
else
Note
The lookahead-restriction [lookahead ≠
else
] resolves the classic "dangling else" problem in the usual way. That is, when the choice of associated
if
is otherwise ambiguous, the
else
is associated with the nearest (innermost) of the candidate
if
14.6.1
Static Semantics: Early Errors
IfStatement
if
Expression
Statement
else
Statement
if
Expression
Statement
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
Note
It is only necessary to apply this rule if the extension specified in
B.3.2
is implemented.
14.6.2
Runtime Semantics: Evaluation
IfStatement
if
Expression
Statement
else
Statement
1.
Let
exprRef
be the result of evaluating
Expression
2.
Let
exprValue
be !
ToBoolean
(?
GetValue
exprRef
)).
3.
If
exprValue
is
true
, then
a.
Let
stmtCompletion
be the result of evaluating the first
Statement
4.
Else,
a.
Let
stmtCompletion
be the result of evaluating the second
Statement
5.
Return
Completion
UpdateEmpty
stmtCompletion
undefined
)).
IfStatement
if
Expression
Statement
1.
Let
exprRef
be the result of evaluating
Expression
2.
Let
exprValue
be !
ToBoolean
(?
GetValue
exprRef
)).
3.
If
exprValue
is
false
, then
a.
Return
NormalCompletion
undefined
).
4.
Else,
a.
Let
stmtCompletion
be the result of evaluating
Statement
b.
Return
Completion
UpdateEmpty
stmtCompletion
undefined
)).
14.7
Iteration Statements
Syntax
IterationStatement
[Yield, Await, Return]
DoWhileStatement
[?Yield, ?Await, ?Return]
WhileStatement
[?Yield, ?Await, ?Return]
ForStatement
[?Yield, ?Await, ?Return]
ForInOfStatement
[?Yield, ?Await, ?Return]
14.7.1
Semantics
14.7.1.1
LoopContinues (
completion
labelSet
The abstract operation LoopContinues takes arguments
completion
and
labelSet
. It performs the following steps when called:
1.
If
completion
.[[Type]] is
normal
, return
true
2.
If
completion
.[[Type]] is not
continue
, return
false
3.
If
completion
.[[Target]] is
empty
, return
true
4.
If
completion
.[[Target]] is an element of
labelSet
, return
true
5.
Return
false
Note
Within the
Statement
part of an
IterationStatement
ContinueStatement
may be used to begin a new iteration.
14.7.1.2
Runtime Semantics: LoopEvaluation
With parameter
labelSet
IterationStatement
DoWhileStatement
1.
Return ?
DoWhileLoopEvaluation
of
DoWhileStatement
with argument
labelSet
IterationStatement
WhileStatement
1.
Return ?
WhileLoopEvaluation
of
WhileStatement
with argument
labelSet
IterationStatement
ForStatement
1.
Return ?
ForLoopEvaluation
of
ForStatement
with argument
labelSet
IterationStatement
ForInOfStatement
1.
Return ?
ForInOfLoopEvaluation
of
ForInOfStatement
with argument
labelSet
14.7.2
The
do
while
Statement
Syntax
DoWhileStatement
[Yield, Await, Return]
do
Statement
[?Yield, ?Await, ?Return]
while
Expression
[+In, ?Yield, ?Await]
14.7.2.1
Static Semantics: Early Errors
DoWhileStatement
do
Statement
while
Expression
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
Note
It is only necessary to apply this rule if the extension specified in
B.3.2
is implemented.
14.7.2.2
Runtime Semantics: DoWhileLoopEvaluation
With parameter
labelSet
DoWhileStatement
do
Statement
while
Expression
1.
Let
be
undefined
2.
Repeat,
a.
Let
stmtResult
be the result of evaluating
Statement
b.
If
LoopContinues
stmtResult
labelSet
) is
false
, return
Completion
UpdateEmpty
stmtResult
)).
c.
If
stmtResult
.[[Value]] is not
empty
, set
to
stmtResult
.[[Value]].
d.
Let
exprRef
be the result of evaluating
Expression
e.
Let
exprValue
be ?
GetValue
exprRef
).
f.
If !
ToBoolean
exprValue
) is
false
, return
NormalCompletion
).
14.7.3
The
while
Statement
Syntax
WhileStatement
[Yield, Await, Return]
while
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
14.7.3.1
Static Semantics: Early Errors
WhileStatement
while
Expression
Statement
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
Note
It is only necessary to apply this rule if the extension specified in
B.3.2
is implemented.
14.7.3.2
Runtime Semantics: WhileLoopEvaluation
With parameter
labelSet
WhileStatement
while
Expression
Statement
1.
Let
be
undefined
2.
Repeat,
a.
Let
exprRef
be the result of evaluating
Expression
b.
Let
exprValue
be ?
GetValue
exprRef
).
c.
If !
ToBoolean
exprValue
) is
false
, return
NormalCompletion
).
d.
Let
stmtResult
be the result of evaluating
Statement
e.
If
LoopContinues
stmtResult
labelSet
) is
false
, return
Completion
UpdateEmpty
stmtResult
)).
f.
If
stmtResult
.[[Value]] is not
empty
, set
to
stmtResult
.[[Value]].
14.7.4
The
for
Statement
Syntax
ForStatement
[Yield, Await, Return]
for
[lookahead ≠
let
Expression
[~In, ?Yield, ?Await]
opt
Expression
[+In, ?Yield, ?Await]
opt
Expression
[+In, ?Yield, ?Await]
opt
Statement
[?Yield, ?Await, ?Return]
for
var
VariableDeclarationList
[~In, ?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
opt
Expression
[+In, ?Yield, ?Await]
opt
Statement
[?Yield, ?Await, ?Return]
for
LexicalDeclaration
[~In, ?Yield, ?Await]
Expression
[+In, ?Yield, ?Await]
opt
Expression
[+In, ?Yield, ?Await]
opt
Statement
[?Yield, ?Await, ?Return]
14.7.4.1
Static Semantics: Early Errors
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
Note
It is only necessary to apply this rule if the extension specified in
B.3.2
is implemented.
ForStatement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
It is a Syntax Error if any element of the
BoundNames
of
LexicalDeclaration
also occurs in the
VarDeclaredNames
of
Statement
14.7.4.2
Runtime Semantics: ForLoopEvaluation
With parameter
labelSet
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
1.
If the first
Expression
is present, then
a.
Let
exprRef
be the result of evaluating the first
Expression
b.
Perform ?
GetValue
exprRef
).
2.
Return ?
ForBodyEvaluation
(the second
Expression
, the third
Expression
Statement
, « »,
labelSet
).
ForStatement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
1.
Let
varDcl
be the result of evaluating
VariableDeclarationList
2.
ReturnIfAbrupt
varDcl
).
3.
Return ?
ForBodyEvaluation
(the first
Expression
, the second
Expression
Statement
, « »,
labelSet
).
ForStatement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
1.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
2.
Let
loopEnv
be
NewDeclarativeEnvironment
oldEnv
).
3.
Let
isConst
be
IsConstantDeclaration
of
LexicalDeclaration
4.
Let
boundNames
be the
BoundNames
of
LexicalDeclaration
5.
For each element
dn
of
boundNames
, do
a.
If
isConst
is
true
, then
i.
Perform !
loopEnv
.CreateImmutableBinding(
dn
true
).
b.
Else,
i.
Perform !
loopEnv
.CreateMutableBinding(
dn
false
).
6.
Set the
running execution context
's LexicalEnvironment to
loopEnv
7.
Let
forDcl
be the result of evaluating
LexicalDeclaration
8.
If
forDcl
is an
abrupt completion
, then
a.
Set the
running execution context
's LexicalEnvironment to
oldEnv
b.
Return
Completion
forDcl
).
9.
If
isConst
is
false
, let
perIterationLets
be
boundNames
; otherwise let
perIterationLets
be « ».
10.
Let
bodyResult
be
ForBodyEvaluation
(the first
Expression
, the second
Expression
Statement
perIterationLets
labelSet
).
11.
Set the
running execution context
's LexicalEnvironment to
oldEnv
12.
Return
Completion
bodyResult
).
14.7.4.3
ForBodyEvaluation (
test
increment
stmt
perIterationBindings
labelSet
The abstract operation ForBodyEvaluation takes arguments
test
increment
stmt
perIterationBindings
, and
labelSet
. It performs the following steps when called:
1.
Let
be
undefined
2.
Perform ?
CreatePerIterationEnvironment
perIterationBindings
).
3.
Repeat,
a.
If
test
is not
[empty]
, then
i.
Let
testRef
be the result of evaluating
test
ii.
Let
testValue
be ?
GetValue
testRef
).
iii.
If !
ToBoolean
testValue
) is
false
, return
NormalCompletion
).
b.
Let
result
be the result of evaluating
stmt
c.
If
LoopContinues
result
labelSet
) is
false
, return
Completion
UpdateEmpty
result
)).
d.
If
result
.[[Value]] is not
empty
, set
to
result
.[[Value]].
e.
Perform ?
CreatePerIterationEnvironment
perIterationBindings
).
f.
If
increment
is not
[empty]
, then
i.
Let
incRef
be the result of evaluating
increment
ii.
Perform ?
GetValue
incRef
).
14.7.4.4
CreatePerIterationEnvironment (
perIterationBindings
The abstract operation CreatePerIterationEnvironment takes argument
perIterationBindings
. It performs the following steps when called:
1.
If
perIterationBindings
has any elements, then
a.
Let
lastIterationEnv
be the
running execution context
's LexicalEnvironment.
b.
Let
outer
be
lastIterationEnv
.[[OuterEnv]].
c.
Assert
outer
is not
null
d.
Let
thisIterationEnv
be
NewDeclarativeEnvironment
outer
).
e.
For each element
bn
of
perIterationBindings
, do
i.
Perform !
thisIterationEnv
.CreateMutableBinding(
bn
false
).
ii.
Let
lastValue
be ?
lastIterationEnv
.GetBindingValue(
bn
true
).
iii.
Perform
thisIterationEnv
.InitializeBinding(
bn
lastValue
).
f.
Set the
running execution context
's LexicalEnvironment to
thisIterationEnv
2.
Return
undefined
14.7.5
The
for
in
for
of
, and
for
await
of
Statements
Syntax
ForInOfStatement
[Yield, Await, Return]
for
[lookahead ≠
let
LeftHandSideExpression
[?Yield, ?Await]
in
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
for
var
ForBinding
[?Yield, ?Await]
in
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
for
ForDeclaration
[?Yield, ?Await]
in
Expression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
for
[lookahead ∉ {
let
async
of
}]
LeftHandSideExpression
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
for
var
ForBinding
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
for
ForDeclaration
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
[+Await]
for
await
[lookahead ≠
let
LeftHandSideExpression
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
[+Await]
for
await
var
ForBinding
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
[+Await]
for
await
ForDeclaration
[?Yield, ?Await]
of
AssignmentExpression
[+In, ?Yield, ?Await]
Statement
[?Yield, ?Await, ?Return]
ForDeclaration
[Yield, Await]
LetOrConst
ForBinding
[?Yield, ?Await]
ForBinding
[Yield, Await]
BindingIdentifier
[?Yield, ?Await]
BindingPattern
[?Yield, ?Await]
Note
This section is extended by Annex
B.3.6
14.7.5.1
Static Semantics: Early Errors
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
var
ForBinding
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
Note
It is only necessary to apply this rule if the extension specified in
B.3.2
is implemented.
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
If
LeftHandSideExpression
is either an
ObjectLiteral
or an
ArrayLiteral
, the following Early Error rules are applied:
It is a Syntax Error if
LeftHandSideExpression
is not
covering
an
AssignmentPattern
All Early Error rules for
AssignmentPattern
and its derived productions also apply to the
AssignmentPattern
that is
covered
by
LeftHandSideExpression
If
LeftHandSideExpression
is neither an
ObjectLiteral
nor an
ArrayLiteral
, the following Early Error rule is applied:
It is a Syntax Error if
AssignmentTargetType
of
LeftHandSideExpression
is not
simple
ForInOfStatement
for
ForDeclaration
in
Expression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
It is a Syntax Error if the
BoundNames
of
ForDeclaration
contains
"let"
It is a Syntax Error if any element of the
BoundNames
of
ForDeclaration
also occurs in the
VarDeclaredNames
of
Statement
It is a Syntax Error if the
BoundNames
of
ForDeclaration
contains any duplicate entries.
14.7.5.2
Static Semantics: IsDestructuring
MemberExpression
PrimaryExpression
1.
If
PrimaryExpression
is either an
ObjectLiteral
or an
ArrayLiteral
, return
true
2.
Return
false
MemberExpression
MemberExpression
Expression
MemberExpression
IdentifierName
MemberExpression
TemplateLiteral
SuperProperty
MetaProperty
new
MemberExpression
Arguments
NewExpression
new
NewExpression
LeftHandSideExpression
CallExpression
OptionalExpression
1.
Return
false
ForDeclaration
LetOrConst
ForBinding
1.
Return
IsDestructuring
of
ForBinding
ForBinding
BindingIdentifier
1.
Return
false
ForBinding
BindingPattern
1.
Return
true
Note
This section is extended by Annex
B.3.6
14.7.5.3
Runtime Semantics: ForDeclarationBindingInitialization
With parameters
value
and
environment
Note
undefined
is passed for
environment
to indicate that a
PutValue
operation should be used to assign the initialization value. This is the case for
var
statements and the formal parameter lists of some non-strict functions (see
10.2.10
). In those cases a lexical binding is hoisted and preinitialized prior to evaluation of its initializer.
ForDeclaration
LetOrConst
ForBinding
1.
Return the result of performing
BindingInitialization
for
ForBinding
passing
value
and
environment
as the arguments.
14.7.5.4
Runtime Semantics: ForDeclarationBindingInstantiation
With parameter
environment
ForDeclaration
LetOrConst
ForBinding
1.
Assert
environment
is a
declarative Environment Record
2.
For each element
name
of the
BoundNames
of
ForBinding
, do
a.
If
IsConstantDeclaration
of
LetOrConst
is
true
, then
i.
Perform !
environment
.CreateImmutableBinding(
name
true
).
b.
Else,
i.
Perform !
environment
.CreateMutableBinding(
name
false
).
14.7.5.5
Runtime Semantics: ForInOfLoopEvaluation
With parameter
labelSet
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
Expression
enumerate
).
2.
Return ?
ForIn/OfBodyEvaluation
LeftHandSideExpression
Statement
keyResult
enumerate
assignment
labelSet
).
ForInOfStatement
for
var
ForBinding
in
Expression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
Expression
enumerate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForBinding
Statement
keyResult
enumerate
varBinding
labelSet
).
ForInOfStatement
for
ForDeclaration
in
Expression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
BoundNames
of
ForDeclaration
Expression
enumerate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForDeclaration
Statement
keyResult
enumerate
lexicalBinding
labelSet
).
ForInOfStatement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
AssignmentExpression
iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
LeftHandSideExpression
Statement
keyResult
iterate
assignment
labelSet
).
ForInOfStatement
for
var
ForBinding
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
AssignmentExpression
iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForBinding
Statement
keyResult
iterate
varBinding
labelSet
).
ForInOfStatement
for
ForDeclaration
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
BoundNames
of
ForDeclaration
AssignmentExpression
iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForDeclaration
Statement
keyResult
iterate
lexicalBinding
labelSet
).
ForInOfStatement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
AssignmentExpression
async-iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
LeftHandSideExpression
Statement
keyResult
iterate
assignment
labelSet
async
).
ForInOfStatement
for
await
var
ForBinding
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
(« »,
AssignmentExpression
async-iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForBinding
Statement
keyResult
iterate
varBinding
labelSet
async
).
ForInOfStatement
for
await
ForDeclaration
of
AssignmentExpression
Statement
1.
Let
keyResult
be ?
ForIn/OfHeadEvaluation
BoundNames
of
ForDeclaration
AssignmentExpression
async-iterate
).
2.
Return ?
ForIn/OfBodyEvaluation
ForDeclaration
Statement
keyResult
iterate
lexicalBinding
labelSet
async
).
Note
This section is extended by Annex
B.3.6
14.7.5.6
ForIn/OfHeadEvaluation (
uninitializedBoundNames
expr
iterationKind
The abstract operation ForIn/OfHeadEvaluation takes arguments
uninitializedBoundNames
expr
, and
iterationKind
(either
enumerate
iterate
, or
async-iterate
). It performs the following steps when called:
1.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
2.
If
uninitializedBoundNames
is not an empty
List
, then
a.
Assert
uninitializedBoundNames
has no duplicate entries.
b.
Let
newEnv
be
NewDeclarativeEnvironment
oldEnv
).
c.
For each String
name
of
uninitializedBoundNames
, do
i.
Perform !
newEnv
.CreateMutableBinding(
name
false
).
d.
Set the
running execution context
's LexicalEnvironment to
newEnv
3.
Let
exprRef
be the result of evaluating
expr
4.
Set the
running execution context
's LexicalEnvironment to
oldEnv
5.
Let
exprValue
be ?
GetValue
exprRef
).
6.
If
iterationKind
is
enumerate
, then
a.
If
exprValue
is
undefined
or
null
, then
i.
Return
Completion
{ [[Type]]:
break
, [[Value]]:
empty
, [[Target]]:
empty
}.
b.
Let
obj
be !
ToObject
exprValue
).
c.
Let
iterator
be ?
EnumerateObjectProperties
obj
).
d.
Let
nextMethod
be !
GetV
iterator
"next"
).
e.
Return the
Record
{ [[Iterator]]:
iterator
, [[NextMethod]]:
nextMethod
, [[Done]]:
false
}.
7.
Else,
a.
Assert
iterationKind
is
iterate
or
async-iterate
b.
If
iterationKind
is
async-iterate
, let
iteratorHint
be
async
c.
Else, let
iteratorHint
be
sync
d.
Return ?
GetIterator
exprValue
iteratorHint
).
14.7.5.7
ForIn/OfBodyEvaluation (
lhs
stmt
iteratorRecord
iterationKind
lhsKind
labelSet
[ ,
iteratorKind
] )
The abstract operation ForIn/OfBodyEvaluation takes arguments
lhs
stmt
iteratorRecord
iterationKind
lhsKind
(either
assignment
varBinding
or
lexicalBinding
), and
labelSet
and optional argument
iteratorKind
(either
sync
or
async
). It performs the following steps when called:
1.
If
iteratorKind
is not present, set
iteratorKind
to
sync
2.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
3.
Let
be
undefined
4.
Let
destructuring
be
IsDestructuring
of
lhs
5.
If
destructuring
is
true
and if
lhsKind
is
assignment
, then
a.
Assert
lhs
is a
LeftHandSideExpression
b.
Let
assignmentPattern
be the
AssignmentPattern
that is
covered
by
lhs
6.
Repeat,
a.
Let
nextResult
be ?
Call
iteratorRecord
.[[NextMethod]],
iteratorRecord
.[[Iterator]]).
b.
If
iteratorKind
is
async
, set
nextResult
to ?
Await
nextResult
).
c.
If
Type
nextResult
) is not Object, throw a
TypeError
exception.
d.
Let
done
be ?
IteratorComplete
nextResult
).
e.
If
done
is
true
, return
NormalCompletion
).
f.
Let
nextValue
be ?
IteratorValue
nextResult
).
g.
If
lhsKind
is either
assignment
or
varBinding
, then
i.
If
destructuring
is
false
, then
1.
Let
lhsRef
be the result of evaluating
lhs
. (It may be evaluated repeatedly.)
h.
Else,
i.
Assert
lhsKind
is
lexicalBinding
ii.
Assert
lhs
is a
ForDeclaration
iii.
Let
iterationEnv
be
NewDeclarativeEnvironment
oldEnv
).
iv.
Perform
ForDeclarationBindingInstantiation
for
lhs
passing
iterationEnv
as the argument.
v.
Set the
running execution context
's LexicalEnvironment to
iterationEnv
vi.
If
destructuring
is
false
, then
1.
Assert
lhs
binds a single name.
2.
Let
lhsName
be the sole element of
BoundNames
of
lhs
3.
Let
lhsRef
be !
ResolveBinding
lhsName
).
i.
If
destructuring
is
false
, then
i.
If
lhsRef
is an
abrupt completion
, then
1.
Let
status
be
lhsRef
ii.
Else if
lhsKind
is
lexicalBinding
, then
1.
Let
status
be
InitializeReferencedBinding
lhsRef
nextValue
).
iii.
Else,
1.
Let
status
be
PutValue
lhsRef
nextValue
).
j.
Else,
i.
If
lhsKind
is
assignment
, then
1.
Let
status
be
DestructuringAssignmentEvaluation
of
assignmentPattern
with argument
nextValue
ii.
Else if
lhsKind
is
varBinding
, then
1.
Assert
lhs
is a
ForBinding
2.
Let
status
be
BindingInitialization
of
lhs
with arguments
nextValue
and
undefined
iii.
Else,
1.
Assert
lhsKind
is
lexicalBinding
2.
Assert
lhs
is a
ForDeclaration
3.
Let
status
be
ForDeclarationBindingInitialization
of
lhs
with arguments
nextValue
and
iterationEnv
k.
If
status
is an
abrupt completion
, then
i.
Set the
running execution context
's LexicalEnvironment to
oldEnv
ii.
If
iteratorKind
is
async
, return ?
AsyncIteratorClose
iteratorRecord
status
).
iii.
If
iterationKind
is
enumerate
, then
1.
Return
status
iv.
Else,
1.
Assert
iterationKind
is
iterate
2.
Return ?
IteratorClose
iteratorRecord
status
).
l.
Let
result
be the result of evaluating
stmt
m.
Set the
running execution context
's LexicalEnvironment to
oldEnv
n.
If
LoopContinues
result
labelSet
) is
false
, then
i.
If
iterationKind
is
enumerate
, then
1.
Return
Completion
UpdateEmpty
result
)).
ii.
Else,
1.
Assert
iterationKind
is
iterate
2.
Set
status
to
UpdateEmpty
result
).
3.
If
iteratorKind
is
async
, return ?
AsyncIteratorClose
iteratorRecord
status
).
4.
Return ?
IteratorClose
iteratorRecord
status
).
o.
If
result
.[[Value]] is not
empty
, set
to
result
.[[Value]].
14.7.5.8
Runtime Semantics: Evaluation
ForBinding
BindingIdentifier
1.
Let
bindingId
be
StringValue
of
BindingIdentifier
2.
Return ?
ResolveBinding
bindingId
).
14.7.5.9
EnumerateObjectProperties (
The abstract operation EnumerateObjectProperties takes argument
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Return an Iterator object (
27.1.1.2
) whose
next
method iterates over all the String-valued keys of enumerable properties of
The iterator object is never directly accessible to ECMAScript code.
The mechanics and order of enumerating the properties is not specified
but must conform to the rules specified below.
The iterator's
throw
and
return
methods are
null
and are never invoked. The iterator's
next
method processes object properties to determine whether the property
key should be returned as an iterator value. Returned property keys do
not include keys that are Symbols. Properties of the target object may
be deleted during enumeration. A property that is deleted before it is
processed by the iterator's
next
method is ignored. If new
properties are added to the target object during enumeration, the newly
added properties are not guaranteed to be processed in the active
enumeration. A
property name
will be returned by the iterator's
next
method at most once in any enumeration.
Enumerating the properties of the target object includes
enumerating properties of its prototype, and the prototype of the
prototype, and so on, recursively; but a property of a prototype is not
processed if it has the same name as a property that has already been
processed by the iterator's
next
method. The values of
[[Enumerable]] attributes are not considered when determining if a
property of a prototype object has already been processed. The
enumerable property names of prototype objects must be obtained by
invoking EnumerateObjectProperties passing the prototype object as the
argument. EnumerateObjectProperties must obtain the own property keys of
the target object by calling its [[OwnPropertyKeys]] internal method.
Property attributes of the target object must be obtained by calling its
[[GetOwnProperty]] internal method.
In addition, if neither
nor any object in its prototype chain is a
Proxy exotic object
Integer-Indexed exotic object
module namespace exotic object
, or implementation provided
exotic object
, then the iterator must behave as would the iterator given by
CreateForInIterator
) until one of the following occurs:
the value of the [[Prototype]] internal slot of
or an object in its prototype chain changes,
a property is removed from
or an object in its prototype chain,
a property is added to an object in
's prototype chain, or
the value of the [[Enumerable]] attribute of a property of
or an object in its prototype chain changes.
Note 1
ECMAScript implementations are not required to implement the algorithm in
14.7.5.10.2.1
directly. They may choose any implementation whose behaviour will not
deviate from that algorithm unless one of the constraints in the
previous paragraph is violated.
The following is an informative definition of an ECMAScript generator function that conforms to these rules:
function
EnumerateObjectProperties
obj
const
visited =
new
Set
();
for
const
key
of
Reflect
.ownKeys(obj)) {
if
typeof
key ===
"symbol"
continue
const
desc =
Reflect
.getOwnPropertyDescriptor(obj, key);
if
(desc) {
visited.add(key);
if
(desc.enumerable)
yield
key;
const
proto =
Reflect
.getPrototypeOf(obj);
if
(proto ===
null
return
for
const
protoKey
of
EnumerateObjectProperties(proto)) {
if
(!visited.has(protoKey))
yield
protoKey;
Note 2
The list of exotic objects for which implementations are not required to match
CreateForInIterator
was chosen because implementations historically differed in behaviour for those cases, and agreed in all others.
14.7.5.10
For-In Iterator Objects
A For-In Iterator is an object that represents a specific
iteration over some specific object. For-In Iterator objects are never
directly accessible to ECMAScript code; they exist solely to illustrate
the behaviour of
EnumerateObjectProperties
14.7.5.10.1
CreateForInIterator (
object
The abstract operation CreateForInIterator takes argument
object
. It is used to create a For-In Iterator object which iterates over the own and inherited enumerable string properties of
object
in a specific order. It performs the following steps when called:
1.
Assert
Type
object
) is Object.
2.
Let
iterator
be !
OrdinaryObjectCreate
%ForInIteratorPrototype%
, « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »).
3.
Set
iterator
.[[Object]] to
object
4.
Set
iterator
.[[ObjectWasVisited]] to
false
5.
Set
iterator
.[[VisitedKeys]] to a new empty
List
6.
Set
iterator
.[[RemainingKeys]] to a new empty
List
7.
Return
iterator
14.7.5.10.2
The %ForInIteratorPrototype% Object
The
%ForInIteratorPrototype%
object:
has properties that are inherited by all For-In Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
is never directly accessible to ECMAScript code.
has the following properties:
14.7.5.10.2.1
%ForInIteratorPrototype%.next ( )
1.
Let
be the
this
value.
2.
Assert
Type
) is Object.
3.
Assert
has all of the internal slots of a For-In Iterator Instance (
14.7.5.10.3
).
4.
Let
object
be
.[[Object]].
5.
Let
visited
be
.[[VisitedKeys]].
6.
Let
remaining
be
.[[RemainingKeys]].
7.
Repeat,
a.
If
.[[ObjectWasVisited]] is
false
, then
i.
Let
keys
be ?
object
.[[OwnPropertyKeys]]().
ii.
For each element
key
of
keys
, do
1.
If
Type
key
) is String, then
a.
Append
key
to
remaining
iii.
Set
.[[ObjectWasVisited]] to
true
b.
Repeat, while
remaining
is not empty,
i.
Let
be the first element of
remaining
ii.
Remove the first element from
remaining
iii.
If there does not exist an element
of
visited
such that
SameValue
) is
true
, then
1.
Let
desc
be ?
object
.[[GetOwnProperty]](
).
2.
If
desc
is not
undefined
, then
a.
Append
to
visited
b.
If
desc
.[[Enumerable]] is
true
, return
CreateIterResultObject
false
).
c.
Set
object
to ?
object
.[[GetPrototypeOf]]().
d.
Set
.[[Object]] to
object
e.
Set
.[[ObjectWasVisited]] to
false
f.
If
object
is
null
, return
CreateIterResultObject
undefined
true
).
14.7.5.10.3
Properties of For-In Iterator Instances
For-In Iterator instances are ordinary objects that inherit properties from the
%ForInIteratorPrototype%
intrinsic object. For-In Iterator instances are initially created with the internal slots listed in
Table 38
Table 38: Internal Slots of For-In Iterator Instances
Internal Slot
Description
[[Object]]
The Object value whose properties are being iterated.
[[ObjectWasVisited]]
true
if the iterator has invoked [[OwnPropertyKeys]] on [[Object]],
false
otherwise.
[[VisitedKeys]]
A list of String values which have been emitted by this iterator thus far.
[[RemainingKeys]]
A list of String values remaining to be emitted for
the current object, before iterating the properties of its prototype (if
its prototype is not
null
).
14.8
The
continue
Statement
Syntax
ContinueStatement
[Yield, Await]
continue
continue
[no
LineTerminator
here]
LabelIdentifier
[?Yield, ?Await]
14.8.1
Static Semantics: Early Errors
ContinueStatement
continue
continue
LabelIdentifier
It is a Syntax Error if this
ContinueStatement
is not nested, directly or indirectly (but not crossing function boundaries), within an
IterationStatement
14.8.2
Runtime Semantics: Evaluation
ContinueStatement
continue
1.
Return
Completion
{ [[Type]]:
continue
, [[Value]]:
empty
, [[Target]]:
empty
}.
ContinueStatement
continue
LabelIdentifier
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
Return
Completion
{ [[Type]]:
continue
, [[Value]]:
empty
, [[Target]]:
label
}.
14.9
The
break
Statement
Syntax
BreakStatement
[Yield, Await]
break
break
[no
LineTerminator
here]
LabelIdentifier
[?Yield, ?Await]
14.9.1
Static Semantics: Early Errors
BreakStatement
break
It is a Syntax Error if this
BreakStatement
is not nested, directly or indirectly (but not crossing function boundaries), within an
IterationStatement
or a
SwitchStatement
14.9.2
Runtime Semantics: Evaluation
BreakStatement
break
1.
Return
Completion
{ [[Type]]:
break
, [[Value]]:
empty
, [[Target]]:
empty
}.
BreakStatement
break
LabelIdentifier
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
Return
Completion
{ [[Type]]:
break
, [[Value]]:
empty
, [[Target]]:
label
}.
14.10
The
return
Statement
Syntax
ReturnStatement
[Yield, Await]
return
return
[no
LineTerminator
here]
Expression
[+In, ?Yield, ?Await]
Note
return
statement causes a function to cease execution and, in most cases, returns a value to the caller. If
Expression
is omitted, the return value is
undefined
. Otherwise, the return value is the value of
Expression
. A
return
statement may not actually return a value to the caller depending on surrounding context. For example, in a
try
block, a
return
statement's completion record may be replaced with another completion record during evaluation of the
finally
block.
14.10.1
Runtime Semantics: Evaluation
ReturnStatement
return
1.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
undefined
, [[Target]]:
empty
}.
ReturnStatement
return
Expression
1.
Let
exprRef
be the result of evaluating
Expression
2.
Let
exprValue
be ?
GetValue
exprRef
).
3.
If !
GetGeneratorKind
() is
async
, set
exprValue
to ?
Await
exprValue
).
4.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
exprValue
, [[Target]]:
empty
}.
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
It is a Syntax Error if the code that matches this production is contained in
strict mode code
It is a Syntax Error if
IsLabelledFunction
Statement
) is
true
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
be the result of evaluating
Statement
8.
Set the
running execution context
's LexicalEnvironment to
oldEnv
9.
Return
Completion
UpdateEmpty
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.
14.12
The
switch
Statement
Syntax
SwitchStatement
[Yield, Await, Return]
switch
Expression
[+In, ?Yield, ?Await]
CaseBlock
[?Yield, ?Await, ?Return]
CaseBlock
[Yield, Await, Return]
CaseClauses
[?Yield, ?Await, ?Return]
opt
CaseClauses
[?Yield, ?Await, ?Return]
opt
DefaultClause
[?Yield, ?Await, ?Return]
CaseClauses
[?Yield, ?Await, ?Return]
opt
CaseClauses
[Yield, Await, Return]
CaseClause
[?Yield, ?Await, ?Return]
CaseClauses
[?Yield, ?Await, ?Return]
CaseClause
[?Yield, ?Await, ?Return]
CaseClause
[Yield, Await, Return]
case
Expression
[+In, ?Yield, ?Await]
StatementList
[?Yield, ?Await, ?Return]
opt
DefaultClause
[Yield, Await, Return]
default
StatementList
[?Yield, ?Await, ?Return]
opt
14.12.1
Static Semantics: Early Errors
SwitchStatement
switch
Expression
CaseBlock
It is a Syntax Error if the
LexicallyDeclaredNames
of
CaseBlock
contains any duplicate entries.
It is a Syntax Error if any element of the
LexicallyDeclaredNames
of
CaseBlock
also occurs in the
VarDeclaredNames
of
CaseBlock
14.12.2
Runtime Semantics: CaseBlockEvaluation
With parameter
input
CaseBlock
1.
Return
NormalCompletion
undefined
).
CaseBlock
CaseClauses
1.
Let
be
undefined
2.
Let
be the
List
of
CaseClause
items in
CaseClauses
, in source text order.
3.
Let
found
be
false
4.
For each
CaseClause
of
, do
a.
If
found
is
false
, then
i.
Set
found
to ?
CaseClauseIsSelected
input
).
b.
If
found
is
true
, then
i.
Let
be the result of evaluating
ii.
If
.[[Value]] is not
empty
, set
to
.[[Value]].
iii.
If
is an
abrupt completion
, return
Completion
UpdateEmpty
)).
5.
Return
NormalCompletion
).
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
Let
be
undefined
2.
If the first
CaseClauses
is present, then
a.
Let
be the
List
of
CaseClause
items in the first
CaseClauses
, in source text order.
3.
Else,
a.
Let
be « ».
4.
Let
found
be
false
5.
For each
CaseClause
of
, do
a.
If
found
is
false
, then
i.
Set
found
to ?
CaseClauseIsSelected
input
).
b.
If
found
is
true
, then
i.
Let
be the result of evaluating
ii.
If
.[[Value]] is not
empty
, set
to
.[[Value]].
iii.
If
is an
abrupt completion
, return
Completion
UpdateEmpty
)).
6.
Let
foundInB
be
false
7.
If the second
CaseClauses
is present, then
a.
Let
be the
List
of
CaseClause
items in the second
CaseClauses
, in source text order.
8.
Else,
a.
Let
be « ».
9.
If
found
is
false
, then
a.
For each
CaseClause
of
, do
i.
If
foundInB
is
false
, then
1.
Set
foundInB
to ?
CaseClauseIsSelected
input
).
ii.
If
foundInB
is
true
, then
1.
Let
be the result of evaluating
CaseClause
2.
If
.[[Value]] is not
empty
, set
to
.[[Value]].
3.
If
is an
abrupt completion
, return
Completion
UpdateEmpty
)).
10.
If
foundInB
is
true
, return
NormalCompletion
).
11.
Let
be the result of evaluating
DefaultClause
12.
If
.[[Value]] is not
empty
, set
to
.[[Value]].
13.
If
is an
abrupt completion
, return
Completion
UpdateEmpty
)).
14.
NOTE: The following is another complete iteration of the second
CaseClauses
15.
For each
CaseClause
of
, do
a.
Let
be the result of evaluating
CaseClause
b.
If
.[[Value]] is not
empty
, set
to
.[[Value]].
c.
If
is an
abrupt completion
, return
Completion
UpdateEmpty
)).
16.
Return
NormalCompletion
).
14.12.3
CaseClauseIsSelected (
input
The abstract operation CaseClauseIsSelected takes arguments
(a
Parse Node
for
CaseClause
) and
input
(an
ECMAScript language value
). It determines whether
matches
input
. It performs the following steps when called:
1.
Assert
is an instance of the production
CaseClause
case
Expression
StatementList
opt
2.
Let
exprRef
be the result of evaluating the
Expression
of
3.
Let
clauseSelector
be ?
GetValue
exprRef
).
4.
Return the result of performing
Strict Equality Comparison
input
===
clauseSelector
Note
This operation does not execute
's
StatementList
(if any). The
CaseBlock
algorithm uses its return value to determine which
StatementList
to start executing.
14.12.4
Runtime Semantics: Evaluation
SwitchStatement
switch
Expression
CaseBlock
1.
Let
exprRef
be the result of evaluating
Expression
2.
Let
switchValue
be ?
GetValue
exprRef
).
3.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
4.
Let
blockEnv
be
NewDeclarativeEnvironment
oldEnv
).
5.
Perform
BlockDeclarationInstantiation
CaseBlock
blockEnv
).
6.
Set the
running execution context
's LexicalEnvironment to
blockEnv
7.
Let
be
CaseBlockEvaluation
of
CaseBlock
with argument
switchValue
8.
Set the
running execution context
's LexicalEnvironment to
oldEnv
9.
Return
Note
No matter how control leaves the
SwitchStatement
the LexicalEnvironment is always restored to its former state.
CaseClause
case
Expression
1.
Return
NormalCompletion
empty
).
CaseClause
case
Expression
StatementList
1.
Return the result of evaluating
StatementList
DefaultClause
default
1.
Return
NormalCompletion
empty
).
DefaultClause
default
StatementList
1.
Return the result of evaluating
StatementList
14.13
Labelled Statements
Syntax
LabelledStatement
[Yield, Await, Return]
LabelIdentifier
[?Yield, ?Await]
LabelledItem
[?Yield, ?Await, ?Return]
LabelledItem
[Yield, Await, Return]
Statement
[?Yield, ?Await, ?Return]
FunctionDeclaration
[?Yield, ?Await, ~Default]
Note
Statement
may be prefixed by a label. Labelled statements are only used in conjunction with labelled
break
and
continue
statements. ECMAScript has no
goto
statement. A
Statement
can be part of a
LabelledStatement
, which itself can be part of a
LabelledStatement
and so on. The labels introduced this way are collectively referred to
as the “current label set” when describing the semantics of individual
statements.
14.13.1
Static Semantics: Early Errors
LabelledItem
FunctionDeclaration
It is a Syntax Error if any source text matches this rule.
Note
An alternative definition for this rule is provided in
B.3.2
14.13.2
Static Semantics: IsLabelledFunction (
stmt
The abstract operation IsLabelledFunction takes argument
stmt
. It performs the following steps when called:
1.
If
stmt
is not a
LabelledStatement
, return
false
2.
Let
item
be the
LabelledItem
of
stmt
3.
If
item
is
LabelledItem
FunctionDeclaration
, return
true
4.
Let
subStmt
be the
Statement
of
item
5.
Return
IsLabelledFunction
subStmt
).
14.13.3
Runtime Semantics: Evaluation
LabelledStatement
LabelIdentifier
LabelledItem
1.
Let
newLabelSet
be a new empty
List
2.
Return
LabelledEvaluation
of this
LabelledStatement
with argument
newLabelSet
14.13.4
Runtime Semantics: LabelledEvaluation
With parameter
labelSet
BreakableStatement
IterationStatement
1.
Let
stmtResult
be
LoopEvaluation
of
IterationStatement
with argument
labelSet
2.
If
stmtResult
.[[Type]] is
break
, then
a.
If
stmtResult
.[[Target]] is
empty
, then
i.
If
stmtResult
.[[Value]] is
empty
, set
stmtResult
to
NormalCompletion
undefined
).
ii.
Else, set
stmtResult
to
NormalCompletion
stmtResult
.[[Value]]).
3.
Return
Completion
stmtResult
).
BreakableStatement
SwitchStatement
1.
Let
stmtResult
be the result of evaluating
SwitchStatement
2.
If
stmtResult
.[[Type]] is
break
, then
a.
If
stmtResult
.[[Target]] is
empty
, then
i.
If
stmtResult
.[[Value]] is
empty
, set
stmtResult
to
NormalCompletion
undefined
).
ii.
Else, set
stmtResult
to
NormalCompletion
stmtResult
.[[Value]]).
3.
Return
Completion
stmtResult
).
Note 1
BreakableStatement
is one that can be exited via an unlabelled
BreakStatement
LabelledStatement
LabelIdentifier
LabelledItem
1.
Let
label
be the
StringValue
of
LabelIdentifier
2.
Append
label
as an element of
labelSet
3.
Let
stmtResult
be
LabelledEvaluation
of
LabelledItem
with argument
labelSet
4.
If
stmtResult
.[[Type]] is
break
and
SameValue
stmtResult
.[[Target]],
label
) is
true
, then
a.
Set
stmtResult
to
NormalCompletion
stmtResult
.[[Value]]).
5.
Return
Completion
stmtResult
).
LabelledItem
FunctionDeclaration
1.
Return the result of evaluating
FunctionDeclaration
Statement
BlockStatement
VariableStatement
EmptyStatement
ExpressionStatement
IfStatement
ContinueStatement
BreakStatement
ReturnStatement
WithStatement
ThrowStatement
TryStatement
DebuggerStatement
1.
Return the result of evaluating
Statement
Note 2
The only two productions of
Statement
which have special semantics for LabelledEvaluation are
BreakableStatement
and
LabelledStatement
14.14
The
throw
Statement
Syntax
ThrowStatement
[Yield, Await]
throw
[no
LineTerminator
here]
Expression
[+In, ?Yield, ?Await]
14.14.1
Runtime Semantics: Evaluation
ThrowStatement
throw
Expression
1.
Let
exprRef
be the result of evaluating
Expression
2.
Let
exprValue
be ?
GetValue
exprRef
).
3.
Return
ThrowCompletion
exprValue
).
14.15
The
try
Statement
Syntax
TryStatement
[Yield, Await, Return]
try
Block
[?Yield, ?Await, ?Return]
Catch
[?Yield, ?Await, ?Return]
try
Block
[?Yield, ?Await, ?Return]
Finally
[?Yield, ?Await, ?Return]
try
Block
[?Yield, ?Await, ?Return]
Catch
[?Yield, ?Await, ?Return]
Finally
[?Yield, ?Await, ?Return]
Catch
[Yield, Await, Return]
catch
CatchParameter
[?Yield, ?Await]
Block
[?Yield, ?Await, ?Return]
catch
Block
[?Yield, ?Await, ?Return]
Finally
[Yield, Await, Return]
finally
Block
[?Yield, ?Await, ?Return]
CatchParameter
[Yield, Await]
BindingIdentifier
[?Yield, ?Await]
BindingPattern
[?Yield, ?Await]
Note
The
try
statement encloses a block of code in which an exceptional condition can occur, such as a runtime error or a
throw
statement. The
catch
clause provides the exception-handling code. When a catch clause catches an exception, its
CatchParameter
is bound to that exception.
14.15.1
Static Semantics: Early Errors
Catch
catch
CatchParameter
Block
It is a Syntax Error if
BoundNames
of
CatchParameter
contains any duplicate elements.
It is a Syntax Error if any element of the
BoundNames
of
CatchParameter
also occurs in the
LexicallyDeclaredNames
of
Block
It is a Syntax Error if any element of the
BoundNames
of
CatchParameter
also occurs in the
VarDeclaredNames
of
Block
Note
An alternative
static semantics
for this production is given in
B.3.5
14.15.2
Runtime Semantics: CatchClauseEvaluation
With parameter
thrownValue
Catch
catch
CatchParameter
Block
1.
Let
oldEnv
be the
running execution context
's LexicalEnvironment.
2.
Let
catchEnv
be
NewDeclarativeEnvironment
oldEnv
).
3.
For each element
argName
of the
BoundNames
of
CatchParameter
, do
a.
Perform !
catchEnv
.CreateMutableBinding(
argName
false
).
4.
Set the
running execution context
's LexicalEnvironment to
catchEnv
5.
Let
status
be
BindingInitialization
of
CatchParameter
with arguments
thrownValue
and
catchEnv
6.
If
status
is an
abrupt completion
, then
a.
Set the
running execution context
's LexicalEnvironment to
oldEnv
b.
Return
Completion
status
).
7.
Let
be the result of evaluating
Block
8.
Set the
running execution context
's LexicalEnvironment to
oldEnv
9.
Return
Completion
).
Catch
catch
Block
1.
Return the result of evaluating
Block
Note
No matter how control leaves the
Block
the LexicalEnvironment is always restored to its former state.
14.15.3
Runtime Semantics: Evaluation
TryStatement
try
Block
Catch
1.
Let
be the result of evaluating
Block
2.
If
.[[Type]] is
throw
, let
be
CatchClauseEvaluation
of
Catch
with argument
.[[Value]].
3.
Else, let
be
4.
Return
Completion
UpdateEmpty
undefined
)).
TryStatement
try
Block
Finally
1.
Let
be the result of evaluating
Block
2.
Let
be the result of evaluating
Finally
3.
If
.[[Type]] is
normal
, set
to
4.
Return
Completion
UpdateEmpty
undefined
)).
TryStatement
try
Block
Catch
Finally
1.
Let
be the result of evaluating
Block
2.
If
.[[Type]] is
throw
, let
be
CatchClauseEvaluation
of
Catch
with argument
.[[Value]].
3.
Else, let
be
4.
Let
be the result of evaluating
Finally
5.
If
.[[Type]] is
normal
, set
to
6.
Return
Completion
UpdateEmpty
undefined
)).
14.16
The
debugger
Statement
Syntax
DebuggerStatement
debugger
14.16.1
Runtime Semantics: Evaluation
Note
Evaluating a
DebuggerStatement
may allow an implementation to cause a breakpoint when run under a
debugger. If a debugger is not present or active this statement has no
observable effect.
DebuggerStatement
debugger
1.
If an
implementation-defined
debugging facility is available and enabled, then
a.
Perform an
implementation-defined
debugging action.
b.
Let
result
be an
implementation-defined
Completion
value.
2.
Else,
a.
Let
result
be
NormalCompletion
empty
).
3.
Return
result
15
ECMAScript Language: Functions and Classes
Note
Various ECMAScript language elements cause the creation of ECMAScript function objects (
10.2
). Evaluation of such functions starts with the execution of their [[Call]] internal method (
10.2.1
).
15.1
Parameter Lists
Syntax
UniqueFormalParameters
[Yield, Await]
FormalParameters
[?Yield, ?Await]
FormalParameters
[Yield, Await]
[empty]
FunctionRestParameter
[?Yield, ?Await]
FormalParameterList
[?Yield, ?Await]
FormalParameterList
[?Yield, ?Await]
FormalParameterList
[?Yield, ?Await]
FunctionRestParameter
[?Yield, ?Await]
FormalParameterList
[Yield, Await]
FormalParameter
[?Yield, ?Await]
FormalParameterList
[?Yield, ?Await]
FormalParameter
[?Yield, ?Await]
FunctionRestParameter
[Yield, Await]
BindingRestElement
[?Yield, ?Await]
FormalParameter
[Yield, Await]
BindingElement
[?Yield, ?Await]
15.1.1
Static Semantics: Early Errors
UniqueFormalParameters
FormalParameters
It is a Syntax Error if
BoundNames
of
FormalParameters
contains any duplicate elements.
FormalParameters
FormalParameterList
It is a Syntax Error if
IsSimpleParameterList
of
FormalParameterList
is
false
and
BoundNames
of
FormalParameterList
contains any duplicate elements.
Note
Multiple occurrences of the same
BindingIdentifier
in a
FormalParameterList
is only allowed for functions which have simple parameter lists and which are not defined in
strict mode code
15.1.2
Static Semantics: ContainsExpression
ObjectBindingPattern
BindingRestProperty
1.
Return
false
ObjectBindingPattern
BindingPropertyList
BindingRestProperty
1.
Return
ContainsExpression
of
BindingPropertyList
ArrayBindingPattern
Elision
opt
1.
Return
false
ArrayBindingPattern
Elision
opt
BindingRestElement
1.
Return
ContainsExpression
of
BindingRestElement
ArrayBindingPattern
BindingElementList
Elision
opt
1.
Return
ContainsExpression
of
BindingElementList
ArrayBindingPattern
BindingElementList
Elision
opt
BindingRestElement
1.
Let
has
be
ContainsExpression
of
BindingElementList
2.
If
has
is
true
, return
true
3.
Return
ContainsExpression
of
BindingRestElement
BindingPropertyList
BindingPropertyList
BindingProperty
1.
Let
has
be
ContainsExpression
of
BindingPropertyList
2.
If
has
is
true
, return
true
3.
Return
ContainsExpression
of
BindingProperty
BindingElementList
BindingElementList
BindingElisionElement
1.
Let
has
be
ContainsExpression
of
BindingElementList
2.
If
has
is
true
, return
true
3.
Return
ContainsExpression
of
BindingElisionElement
BindingElisionElement
Elision
opt
BindingElement
1.
Return
ContainsExpression
of
BindingElement
BindingProperty
PropertyName
BindingElement
1.
Let
has
be
IsComputedPropertyKey
of
PropertyName
2.
If
has
is
true
, return
true
3.
Return
ContainsExpression
of
BindingElement
BindingElement
BindingPattern
Initializer
1.
Return
true
SingleNameBinding
BindingIdentifier
1.
Return
false
SingleNameBinding
BindingIdentifier
Initializer
1.
Return
true
BindingRestElement
...
BindingIdentifier
1.
Return
false
BindingRestElement
...
BindingPattern
1.
Return
ContainsExpression
of
BindingPattern
FormalParameters
[empty]
1.
Return
false
FormalParameters
FormalParameterList
FunctionRestParameter
1.
If
ContainsExpression
of
FormalParameterList
is
true
, return
true
2.
Return
ContainsExpression
of
FunctionRestParameter
FormalParameterList
FormalParameterList
FormalParameter
1.
If
ContainsExpression
of
FormalParameterList
is
true
, return
true
2.
Return
ContainsExpression
of
FormalParameter
ArrowParameters
BindingIdentifier
1.
Return
false
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
ContainsExpression
of
formals
AsyncArrowBindingIdentifier
BindingIdentifier
1.
Return
false
15.1.3
Static Semantics: IsSimpleParameterList
BindingElement
BindingPattern
1.
Return
false
BindingElement
BindingPattern
Initializer
1.
Return
false
SingleNameBinding
BindingIdentifier
1.
Return
true
SingleNameBinding
BindingIdentifier
Initializer
1.
Return
false
FormalParameters
[empty]
1.
Return
true
FormalParameters
FunctionRestParameter
1.
Return
false
FormalParameters
FormalParameterList
FunctionRestParameter
1.
Return
false
FormalParameterList
FormalParameterList
FormalParameter
1.
If
IsSimpleParameterList
of
FormalParameterList
is
false
, return
false
2.
Return
IsSimpleParameterList
of
FormalParameter
FormalParameter
BindingElement
1.
Return
IsSimpleParameterList
of
BindingElement
ArrowParameters
BindingIdentifier
1.
Return
true
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
IsSimpleParameterList
of
formals
AsyncArrowBindingIdentifier
[Yield]
BindingIdentifier
[?Yield, +Await]
1.
Return
true
CoverCallExpressionAndAsyncArrowHead
MemberExpression
Arguments
1.
Let
head
be
CoveredAsyncArrowHead
of
CoverCallExpressionAndAsyncArrowHead
2.
Return
IsSimpleParameterList
of
head
15.1.4
Static Semantics: HasInitializer
BindingElement
BindingPattern
1.
Return
false
BindingElement
BindingPattern
Initializer
1.
Return
true
SingleNameBinding
BindingIdentifier
1.
Return
false
SingleNameBinding
BindingIdentifier
Initializer
1.
Return
true
FormalParameterList
FormalParameterList
FormalParameter
1.
If
HasInitializer
of
FormalParameterList
is
true
, return
true
2.
Return
HasInitializer
of
FormalParameter
15.1.5
Static Semantics: ExpectedArgumentCount
FormalParameters
[empty]
FunctionRestParameter
1.
Return 0.
FormalParameters
FormalParameterList
FunctionRestParameter
1.
Return
ExpectedArgumentCount
of
FormalParameterList
Note
The ExpectedArgumentCount of a
FormalParameterList
is the number of
FormalParameters
to the left of either the rest parameter or the first
FormalParameter
with an Initializer. A
FormalParameter
without an initializer is allowed after the first parameter with an
initializer but such parameters are considered to be optional with
undefined
as their default value.
FormalParameterList
FormalParameter
1.
If
HasInitializer
of
FormalParameter
is
true
, return 0.
2.
Return 1.
FormalParameterList
FormalParameterList
FormalParameter
1.
Let
count
be
ExpectedArgumentCount
of
FormalParameterList
2.
If
HasInitializer
of
FormalParameterList
is
true
or
HasInitializer
of
FormalParameter
is
true
, return
count
3.
Return
count
+ 1.
ArrowParameters
BindingIdentifier
1.
Return 1.
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
formals
be
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
ExpectedArgumentCount
of
formals
PropertySetParameterList
FormalParameter
1.
If
HasInitializer
of
FormalParameter
is
true
, return 0.
2.
Return 1.
AsyncArrowBindingIdentifier
BindingIdentifier
1.
Return 1.
15.2
Function Definitions
Syntax
FunctionDeclaration
[Yield, Await, Default]
function
BindingIdentifier
[?Yield, ?Await]
FormalParameters
[~Yield, ~Await]
FunctionBody
[~Yield, ~Await]
[+Default]
function
FormalParameters
[~Yield, ~Await]
FunctionBody
[~Yield, ~Await]
FunctionExpression
function
BindingIdentifier
[~Yield, ~Await]
opt
FormalParameters
[~Yield, ~Await]
FunctionBody
[~Yield, ~Await]
FunctionBody
[Yield, Await]
FunctionStatementList
[?Yield, ?Await]
FunctionStatementList
[Yield, Await]
StatementList
[?Yield, ?Await, +Return]
opt
15.2.1
Static Semantics: Early Errors
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
function
FormalParameters
FunctionBody
FunctionExpression
function
BindingIdentifier
opt
FormalParameters
FunctionBody
If the source code matching
FormalParameters
is
strict mode code
, the Early Error rules for
UniqueFormalParameters
FormalParameters
are applied.
If
BindingIdentifier
is present and the source code matching
BindingIdentifier
is
strict mode code
, it is a Syntax Error if the
StringValue
of
BindingIdentifier
is
"eval"
or
"arguments"
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
FunctionBody
is
true
and
IsSimpleParameterList
of
FormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
FormalParameters
also occurs in the
LexicallyDeclaredNames
of
FunctionBody
It is a Syntax Error if
FormalParameters
Contains
SuperProperty
is
true
It is a Syntax Error if
FunctionBody
Contains
SuperProperty
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperCall
is
true
It is a Syntax Error if
FunctionBody
Contains
SuperCall
is
true
Note
The
LexicallyDeclaredNames
of a
FunctionBody
does not include identifiers bound using var or function declarations.
FunctionBody
FunctionStatementList
It is a Syntax Error if the
LexicallyDeclaredNames
of
FunctionStatementList
contains any duplicate entries.
It is a Syntax Error if any element of the
LexicallyDeclaredNames
of
FunctionStatementList
also occurs in the
VarDeclaredNames
of
FunctionStatementList
It is a Syntax Error if
ContainsDuplicateLabels
of
FunctionStatementList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedBreakTarget
of
FunctionStatementList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedContinueTarget
of
FunctionStatementList
with arguments « » and « » is
true
15.2.2
Static Semantics: FunctionBodyContainsUseStrict
FunctionBody
FunctionStatementList
1.
If the
Directive Prologue
of
FunctionBody
contains a
Use Strict Directive
, return
true
; otherwise, return
false
15.2.3
Runtime Semantics: EvaluateFunctionBody
With parameters
functionObject
and
argumentsList
(a
List
).
FunctionBody
FunctionStatementList
1.
Perform ?
FunctionDeclarationInstantiation
functionObject
argumentsList
).
2.
Return the result of evaluating
FunctionStatementList
15.2.4
Runtime Semantics: InstantiateOrdinaryFunctionObject
With parameter
scope
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
1.
Let
name
be
StringValue
of
BindingIdentifier
2.
Let
sourceText
be the
source text matched by
FunctionDeclaration
3.
Let
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
FormalParameters
FunctionBody
non-lexical-this
scope
).
4.
Perform
SetFunctionName
name
).
5.
Perform
MakeConstructor
).
6.
Return
FunctionDeclaration
function
FormalParameters
FunctionBody
1.
Let
sourceText
be the
source text matched by
FunctionDeclaration
2.
Let
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
FormalParameters
FunctionBody
non-lexical-this
scope
).
3.
Perform
SetFunctionName
"default"
).
4.
Perform
MakeConstructor
).
5.
Return
Note
An anonymous
FunctionDeclaration
can only occur as part of an
export default
declaration, and its function code is therefore always
strict mode code
15.2.5
Runtime Semantics: InstantiateOrdinaryFunctionExpression
With optional parameter
name
FunctionExpression
function
FormalParameters
FunctionBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
FunctionExpression
4.
Let
closure
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
FormalParameters
FunctionBody
non-lexical-this
scope
).
5.
Perform
SetFunctionName
closure
name
).
6.
Perform
MakeConstructor
closure
).
7.
Return
closure
FunctionExpression
function
BindingIdentifier
FormalParameters
FunctionBody
1.
Assert
name
is not present.
2.
Set
name
to
StringValue
of
BindingIdentifier
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
funcEnv
be
NewDeclarativeEnvironment
scope
).
5.
Perform
funcEnv
.CreateImmutableBinding(
name
false
).
6.
Let
sourceText
be the
source text matched by
FunctionExpression
7.
Let
closure
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
FormalParameters
FunctionBody
non-lexical-this
funcEnv
).
8.
Perform
SetFunctionName
closure
name
).
9.
Perform
MakeConstructor
closure
).
10.
Perform
funcEnv
.InitializeBinding(
name
closure
).
11.
Return
closure
Note
The
BindingIdentifier
in a
FunctionExpression
can be referenced from inside the
FunctionExpression
's
FunctionBody
to allow the function to call itself recursively. However, unlike in a
FunctionDeclaration
, the
BindingIdentifier
in a
FunctionExpression
cannot be referenced from and does not affect the scope enclosing the
FunctionExpression
15.2.6
Runtime Semantics: Evaluation
FunctionDeclaration
function
BindingIdentifier
FormalParameters
FunctionBody
1.
Return
NormalCompletion
empty
).
Note 1
An alternative semantics is provided in
B.3.3
FunctionDeclaration
function
FormalParameters
FunctionBody
1.
Return
NormalCompletion
empty
).
FunctionExpression
function
BindingIdentifier
opt
FormalParameters
FunctionBody
1.
Return
InstantiateOrdinaryFunctionExpression
of
FunctionExpression
Note 2
"prototype"
property is automatically created for every function defined using a
FunctionDeclaration
or
FunctionExpression
, to allow for the possibility that the function will be used as a
constructor
FunctionStatementList
[empty]
1.
Return
NormalCompletion
undefined
).
15.3
Arrow Function Definitions
Syntax
ArrowFunction
[In, Yield, Await]
ArrowParameters
[?Yield, ?Await]
[no
LineTerminator
here]
=>
ConciseBody
[?In]
ArrowParameters
[Yield, Await]
BindingIdentifier
[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList
[?Yield, ?Await]
ConciseBody
[In]
[lookahead ≠
ExpressionBody
[?In, ~Await]
FunctionBody
[~Yield, ~Await]
ExpressionBody
[In, Await]
AssignmentExpression
[?In, ~Yield, ?Await]
Supplemental Syntax
When processing an instance of the production
ArrowParameters
[Yield, Await]
CoverParenthesizedExpressionAndArrowParameterList
[?Yield, ?Await]
the interpretation of
CoverParenthesizedExpressionAndArrowParameterList
is refined using the following grammar:
ArrowFormalParameters
[Yield, Await]
UniqueFormalParameters
[?Yield, ?Await]
15.3.1
Static Semantics: Early Errors
ArrowFunction
ArrowParameters
=>
ConciseBody
It is a Syntax Error if
ArrowParameters
Contains
YieldExpression
is
true
It is a Syntax Error if
ArrowParameters
Contains
AwaitExpression
is
true
It is a Syntax Error if
ConciseBodyContainsUseStrict
of
ConciseBody
is
true
and
IsSimpleParameterList
of
ArrowParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
ArrowParameters
also occurs in the
LexicallyDeclaredNames
of
ConciseBody
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
It is a Syntax Error if
CoverParenthesizedExpressionAndArrowParameterList
is not
covering
an
ArrowFormalParameters
All
early error
rules for
ArrowFormalParameters
and its derived productions also apply to
CoveredFormalsList
of
CoverParenthesizedExpressionAndArrowParameterList
15.3.2
Static Semantics: ConciseBodyContainsUseStrict
ConciseBody
ExpressionBody
1.
Return
false
ConciseBody
FunctionBody
1.
Return
FunctionBodyContainsUseStrict
of
FunctionBody
15.3.3
Static Semantics: CoveredFormalsList
ArrowParameters
BindingIdentifier
1.
Return this
ArrowParameters
CoverParenthesizedExpressionAndArrowParameterList
Expression
Expression
...
BindingIdentifier
...
BindingPattern
Expression
...
BindingIdentifier
Expression
...
BindingPattern
1.
Return the
ArrowFormalParameters
that is
covered
by
CoverParenthesizedExpressionAndArrowParameterList
15.3.4
Runtime Semantics: EvaluateConciseBody
With parameters
functionObject
and
argumentsList
(a
List
).
ConciseBody
ExpressionBody
1.
Perform ?
FunctionDeclarationInstantiation
functionObject
argumentsList
).
2.
Return the result of evaluating
ExpressionBody
15.3.5
Runtime Semantics: InstantiateArrowFunctionExpression
With optional parameter
name
ArrowFunction
ArrowParameters
=>
ConciseBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
ArrowFunction
4.
Let
parameters
be
CoveredFormalsList
of
ArrowParameters
5.
Let
closure
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
parameters
ConciseBody
lexical-this
scope
).
6.
Perform
SetFunctionName
closure
name
).
7.
Return
closure
Note
An
ArrowFunction
does not define local bindings for
arguments
super
this
, or
new.target
. Any reference to
arguments
super
this
, or
new.target
within an
ArrowFunction
must resolve to a binding in a lexically enclosing environment.
Typically this will be the Function Environment of an immediately
enclosing function. Even though an
ArrowFunction
may contain references to
super
, the
function object
created in step
is not made into a method by performing
MakeMethod
. An
ArrowFunction
that references
super
is always contained within a non-
ArrowFunction
and the necessary state to implement
super
is accessible via the
scope
that is captured by the
function object
of the
ArrowFunction
15.3.6
Runtime Semantics: Evaluation
ArrowFunction
ArrowParameters
=>
ConciseBody
1.
Return
InstantiateArrowFunctionExpression
of
ArrowFunction
ExpressionBody
AssignmentExpression
1.
Let
exprRef
be the result of evaluating
AssignmentExpression
2.
Let
exprValue
be ?
GetValue
exprRef
).
3.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
exprValue
, [[Target]]:
empty
}.
15.4
Method Definitions
Syntax
MethodDefinition
[Yield, Await]
PropertyName
[?Yield, ?Await]
UniqueFormalParameters
[~Yield, ~Await]
FunctionBody
[~Yield, ~Await]
GeneratorMethod
[?Yield, ?Await]
AsyncMethod
[?Yield, ?Await]
AsyncGeneratorMethod
[?Yield, ?Await]
get
PropertyName
[?Yield, ?Await]
FunctionBody
[~Yield, ~Await]
set
PropertyName
[?Yield, ?Await]
PropertySetParameterList
FunctionBody
[~Yield, ~Await]
PropertySetParameterList
FormalParameter
[~Yield, ~Await]
15.4.1
Static Semantics: Early Errors
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
FunctionBody
is
true
and
IsSimpleParameterList
of
UniqueFormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
UniqueFormalParameters
also occurs in the
LexicallyDeclaredNames
of
FunctionBody
MethodDefinition
set
PropertyName
PropertySetParameterList
FunctionBody
It is a Syntax Error if
BoundNames
of
PropertySetParameterList
contains any duplicate elements.
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
FunctionBody
is
true
and
IsSimpleParameterList
of
PropertySetParameterList
is
false
It is a Syntax Error if any element of the
BoundNames
of
PropertySetParameterList
also occurs in the
LexicallyDeclaredNames
of
FunctionBody
15.4.2
Static Semantics: HasDirectSuper
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
1.
If
UniqueFormalParameters
Contains
SuperCall
is
true
, return
true
2.
Return
FunctionBody
Contains
SuperCall
MethodDefinition
get
PropertyName
FunctionBody
1.
Return
FunctionBody
Contains
SuperCall
MethodDefinition
set
PropertyName
PropertySetParameterList
FunctionBody
1.
If
PropertySetParameterList
Contains
SuperCall
is
true
, return
true
2.
Return
FunctionBody
Contains
SuperCall
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
1.
If
UniqueFormalParameters
Contains
SuperCall
is
true
, return
true
2.
Return
GeneratorBody
Contains
SuperCall
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
1.
If
UniqueFormalParameters
Contains
SuperCall
is
true
, return
true
2.
Return
AsyncGeneratorBody
Contains
SuperCall
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
1.
If
UniqueFormalParameters
Contains
SuperCall
is
true
, return
true
2.
Return
AsyncFunctionBody
Contains
SuperCall
15.4.3
Static Semantics: SpecialMethod
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
1.
Return
false
MethodDefinition
GeneratorMethod
AsyncMethod
AsyncGeneratorMethod
get
PropertyName
FunctionBody
set
PropertyName
PropertySetParameterList
FunctionBody
1.
Return
true
15.4.4
Runtime Semantics: DefineMethod
With parameter
object
and optional parameter
functionPrototype
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
If
functionPrototype
is present, then
a.
Let
prototype
be
functionPrototype
5.
Else,
a.
Let
prototype
be
%Function.prototype%
6.
Let
sourceText
be the
source text matched by
MethodDefinition
7.
Let
closure
be
OrdinaryFunctionCreate
prototype
sourceText
UniqueFormalParameters
FunctionBody
non-lexical-this
scope
).
8.
Perform
MakeMethod
closure
object
).
9.
Return the
Record
{ [[Key]]:
propKey
, [[Closure]]:
closure
}.
15.4.5
Runtime Semantics: MethodDefinitionEvaluation
With parameters
object
and
enumerable
MethodDefinition
PropertyName
UniqueFormalParameters
FunctionBody
1.
Let
methodDef
be ?
DefineMethod
of
MethodDefinition
with argument
object
2.
Perform
SetFunctionName
methodDef
.[[Closure]],
methodDef
.[[Key]]).
3.
Let
desc
be the PropertyDescriptor { [[Value]]:
methodDef
.[[Closure]], [[Writable]]:
true
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
4.
Return ?
DefinePropertyOrThrow
object
methodDef
.[[Key]],
desc
).
MethodDefinition
get
PropertyName
FunctionBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
sourceText
be the
source text matched by
MethodDefinition
5.
Let
formalParameterList
be an instance of the production
FormalParameters
[empty]
6.
Let
closure
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
formalParameterList
FunctionBody
non-lexical-this
scope
).
7.
Perform
MakeMethod
closure
object
).
8.
Perform
SetFunctionName
closure
propKey
"get"
).
9.
Let
desc
be the PropertyDescriptor { [[Get]]:
closure
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
10.
Return ?
DefinePropertyOrThrow
object
propKey
desc
).
MethodDefinition
set
PropertyName
PropertySetParameterList
FunctionBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
sourceText
be the
source text matched by
MethodDefinition
5.
Let
closure
be
OrdinaryFunctionCreate
%Function.prototype%
sourceText
PropertySetParameterList
FunctionBody
non-lexical-this
scope
).
6.
Perform
MakeMethod
closure
object
).
7.
Perform
SetFunctionName
closure
propKey
"set"
).
8.
Let
desc
be the PropertyDescriptor { [[Set]]:
closure
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
9.
Return ?
DefinePropertyOrThrow
object
propKey
desc
).
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
sourceText
be the
source text matched by
GeneratorMethod
5.
Let
closure
be
OrdinaryFunctionCreate
%GeneratorFunction.prototype%
sourceText
UniqueFormalParameters
GeneratorBody
non-lexical-this
scope
).
6.
Perform
MakeMethod
closure
object
).
7.
Perform
SetFunctionName
closure
propKey
).
8.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
9.
Perform
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
10.
Let
desc
be the PropertyDescriptor { [[Value]]:
closure
, [[Writable]]:
true
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
11.
Return ?
DefinePropertyOrThrow
object
propKey
desc
).
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
sourceText
be the
source text matched by
AsyncGeneratorMethod
5.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncGeneratorFunction.prototype%
sourceText
UniqueFormalParameters
AsyncGeneratorBody
non-lexical-this
scope
).
6.
Perform !
MakeMethod
closure
object
).
7.
Perform !
SetFunctionName
closure
propKey
).
8.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
9.
Perform !
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
10.
Let
desc
be PropertyDescriptor { [[Value]]:
closure
, [[Writable]]:
true
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
11.
Return ?
DefinePropertyOrThrow
object
propKey
desc
).
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
1.
Let
propKey
be the result of evaluating
PropertyName
2.
ReturnIfAbrupt
propKey
).
3.
Let
scope
be the LexicalEnvironment of the
running execution context
4.
Let
sourceText
be the
source text matched by
AsyncMethod
5.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
UniqueFormalParameters
AsyncFunctionBody
non-lexical-this
scope
).
6.
Perform !
MakeMethod
closure
object
).
7.
Perform !
SetFunctionName
closure
propKey
).
8.
Let
desc
be the PropertyDescriptor { [[Value]]:
closure
, [[Writable]]:
true
, [[Enumerable]]:
enumerable
, [[Configurable]]:
true
}.
9.
Return ?
DefinePropertyOrThrow
object
propKey
desc
).
15.5
Generator Function Definitions
Syntax
GeneratorMethod
[Yield, Await]
PropertyName
[?Yield, ?Await]
UniqueFormalParameters
[+Yield, ~Await]
GeneratorBody
GeneratorDeclaration
[Yield, Await, Default]
function
BindingIdentifier
[?Yield, ?Await]
FormalParameters
[+Yield, ~Await]
GeneratorBody
[+Default]
function
FormalParameters
[+Yield, ~Await]
GeneratorBody
GeneratorExpression
function
BindingIdentifier
[+Yield, ~Await]
opt
FormalParameters
[+Yield, ~Await]
GeneratorBody
GeneratorBody
FunctionBody
[+Yield, ~Await]
YieldExpression
[In, Await]
yield
yield
[no
LineTerminator
here]
AssignmentExpression
[?In, +Yield, ?Await]
yield
[no
LineTerminator
here]
AssignmentExpression
[?In, +Yield, ?Await]
Note 1
The syntactic context immediately following
yield
requires use of the
InputElementRegExpOrTemplateTail
lexical goal.
Note 2
YieldExpression
cannot be used within the
FormalParameters
of a generator function because any expressions that are part of
FormalParameters
are evaluated before the resulting generator object is in a resumable state.
Note 3
Abstract operations
relating to generator objects are defined in
27.5.3
15.5.1
Static Semantics: Early Errors
GeneratorMethod
PropertyName
UniqueFormalParameters
GeneratorBody
It is a Syntax Error if
HasDirectSuper
of
GeneratorMethod
is
true
It is a Syntax Error if
UniqueFormalParameters
Contains
YieldExpression
is
true
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
GeneratorBody
is
true
and
IsSimpleParameterList
of
UniqueFormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
UniqueFormalParameters
also occurs in the
LexicallyDeclaredNames
of
GeneratorBody
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
function
FormalParameters
GeneratorBody
GeneratorExpression
function
BindingIdentifier
opt
FormalParameters
GeneratorBody
If the source code matching
FormalParameters
is
strict mode code
, the Early Error rules for
UniqueFormalParameters
FormalParameters
are applied.
If
BindingIdentifier
is present and the source code matching
BindingIdentifier
is
strict mode code
, it is a Syntax Error if the
StringValue
of
BindingIdentifier
is
"eval"
or
"arguments"
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
GeneratorBody
is
true
and
IsSimpleParameterList
of
FormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
FormalParameters
also occurs in the
LexicallyDeclaredNames
of
GeneratorBody
It is a Syntax Error if
FormalParameters
Contains
YieldExpression
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperProperty
is
true
It is a Syntax Error if
GeneratorBody
Contains
SuperProperty
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperCall
is
true
It is a Syntax Error if
GeneratorBody
Contains
SuperCall
is
true
15.5.2
Runtime Semantics: EvaluateGeneratorBody
With parameters
functionObject
and
argumentsList
(a
List
).
GeneratorBody
FunctionBody
1.
Perform ?
FunctionDeclarationInstantiation
functionObject
argumentsList
).
2.
Let
be ?
OrdinaryCreateFromConstructor
functionObject
"%GeneratorFunction.prototype.prototype%"
, « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »).
3.
Set
.[[GeneratorBrand]] to
empty
4.
Perform
GeneratorStart
FunctionBody
).
5.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
, [[Target]]:
empty
}.
15.5.3
Runtime Semantics: InstantiateGeneratorFunctionObject
With parameter
scope
GeneratorDeclaration
function
BindingIdentifier
FormalParameters
GeneratorBody
1.
Let
name
be
StringValue
of
BindingIdentifier
2.
Let
sourceText
be the
source text matched by
GeneratorDeclaration
3.
Let
be
OrdinaryFunctionCreate
%GeneratorFunction.prototype%
sourceText
FormalParameters
GeneratorBody
non-lexical-this
scope
).
4.
Perform
SetFunctionName
name
).
5.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
6.
Perform
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
7.
Return
GeneratorDeclaration
function
FormalParameters
GeneratorBody
1.
Let
sourceText
be the
source text matched by
GeneratorDeclaration
2.
Let
be
OrdinaryFunctionCreate
%GeneratorFunction.prototype%
sourceText
FormalParameters
GeneratorBody
non-lexical-this
scope
).
3.
Perform
SetFunctionName
"default"
).
4.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
5.
Perform
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
6.
Return
Note
An anonymous
GeneratorDeclaration
can only occur as part of an
export default
declaration, and its function code is therefore always
strict mode code
15.5.4
Runtime Semantics: InstantiateGeneratorFunctionExpression
With optional parameter
name
GeneratorExpression
function
FormalParameters
GeneratorBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
GeneratorExpression
4.
Let
closure
be
OrdinaryFunctionCreate
%GeneratorFunction.prototype%
sourceText
FormalParameters
GeneratorBody
non-lexical-this
scope
).
5.
Perform
SetFunctionName
closure
name
).
6.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
7.
Perform
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
8.
Return
closure
GeneratorExpression
function
BindingIdentifier
FormalParameters
GeneratorBody
1.
Assert
name
is not present.
2.
Set
name
to
StringValue
of
BindingIdentifier
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
funcEnv
be
NewDeclarativeEnvironment
scope
).
5.
Perform
funcEnv
.CreateImmutableBinding(
name
false
).
6.
Let
sourceText
be the
source text matched by
GeneratorExpression
7.
Let
closure
be
OrdinaryFunctionCreate
%GeneratorFunction.prototype%
sourceText
FormalParameters
GeneratorBody
non-lexical-this
funcEnv
).
8.
Perform
SetFunctionName
closure
name
).
9.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
10.
Perform
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
11.
Perform
funcEnv
.InitializeBinding(
name
closure
).
12.
Return
closure
Note
The
BindingIdentifier
in a
GeneratorExpression
can be referenced from inside the
GeneratorExpression
's
FunctionBody
to allow the generator code to call itself recursively. However, unlike in a
GeneratorDeclaration
, the
BindingIdentifier
in a
GeneratorExpression
cannot be referenced from and does not affect the scope enclosing the
GeneratorExpression
15.5.5
Runtime Semantics: Evaluation
GeneratorExpression
function
BindingIdentifier
opt
FormalParameters
GeneratorBody
1.
Return
InstantiateGeneratorFunctionExpression
of
GeneratorExpression
YieldExpression
yield
1.
Return ?
Yield
undefined
).
YieldExpression
yield
AssignmentExpression
1.
Let
exprRef
be the result of evaluating
AssignmentExpression
2.
Let
value
be ?
GetValue
exprRef
).
3.
Return ?
Yield
value
).
YieldExpression
yield
AssignmentExpression
1.
Let
generatorKind
be !
GetGeneratorKind
().
2.
Let
exprRef
be the result of evaluating
AssignmentExpression
3.
Let
value
be ?
GetValue
exprRef
).
4.
Let
iteratorRecord
be ?
GetIterator
value
generatorKind
).
5.
Let
iterator
be
iteratorRecord
.[[Iterator]].
6.
Let
received
be
NormalCompletion
undefined
).
7.
Repeat,
a.
If
received
.[[Type]] is
normal
, then
i.
Let
innerResult
be ?
Call
iteratorRecord
.[[NextMethod]],
iteratorRecord
.[[Iterator]], «
received
.[[Value]] »).
ii.
If
generatorKind
is
async
, set
innerResult
to ?
Await
innerResult
).
iii.
If
Type
innerResult
) is not Object, throw a
TypeError
exception.
iv.
Let
done
be ?
IteratorComplete
innerResult
).
v.
If
done
is
true
, then
1.
Return ?
IteratorValue
innerResult
).
vi.
If
generatorKind
is
async
, set
received
to
AsyncGeneratorYield
(?
IteratorValue
innerResult
)).
vii.
Else, set
received
to
GeneratorYield
innerResult
).
b.
Else if
received
.[[Type]] is
throw
, then
i.
Let
throw
be ?
GetMethod
iterator
"throw"
).
ii.
If
throw
is not
undefined
, then
1.
Let
innerResult
be ?
Call
throw
iterator
, «
received
.[[Value]] »).
2.
If
generatorKind
is
async
, set
innerResult
to ?
Await
innerResult
).
3.
NOTE: Exceptions from the inner iterator
throw
method are propagated. Normal completions from an inner
throw
method are processed similarly to an inner
next
4.
If
Type
innerResult
) is not Object, throw a
TypeError
exception.
5.
Let
done
be ?
IteratorComplete
innerResult
).
6.
If
done
is
true
, then
a.
Return ?
IteratorValue
innerResult
).
7.
If
generatorKind
is
async
, set
received
to
AsyncGeneratorYield
(?
IteratorValue
innerResult
)).
8.
Else, set
received
to
GeneratorYield
innerResult
).
iii.
Else,
1.
NOTE: If
iterator
does not have a
throw
method, this throw is going to terminate the
yield*
loop. But first we need to give
iterator
a chance to clean up.
2.
Let
closeCompletion
be
Completion
{ [[Type]]:
normal
, [[Value]]:
empty
, [[Target]]:
empty
}.
3.
If
generatorKind
is
async
, perform ?
AsyncIteratorClose
iteratorRecord
closeCompletion
).
4.
Else, perform ?
IteratorClose
iteratorRecord
closeCompletion
).
5.
NOTE: The next step throws a
TypeError
to indicate that there was a
yield*
protocol violation:
iterator
does not have a
throw
method.
6.
Throw a
TypeError
exception.
c.
Else,
i.
Assert
received
.[[Type]] is
return
ii.
Let
return
be ?
GetMethod
iterator
"return"
).
iii.
If
return
is
undefined
, then
1.
If
generatorKind
is
async
, set
received
.[[Value]] to ?
Await
received
.[[Value]]).
2.
Return
Completion
received
).
iv.
Let
innerReturnResult
be ?
Call
return
iterator
, «
received
.[[Value]] »).
v.
If
generatorKind
is
async
, set
innerReturnResult
to ?
Await
innerReturnResult
).
vi.
If
Type
innerReturnResult
) is not Object, throw a
TypeError
exception.
vii.
Let
done
be ?
IteratorComplete
innerReturnResult
).
viii.
If
done
is
true
, then
1.
Let
value
be ?
IteratorValue
innerReturnResult
).
2.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
value
, [[Target]]:
empty
}.
ix.
If
generatorKind
is
async
, set
received
to
AsyncGeneratorYield
(?
IteratorValue
innerReturnResult
)).
x.
Else, set
received
to
GeneratorYield
innerReturnResult
).
15.6
Async Generator Function Definitions
Syntax
AsyncGeneratorMethod
[Yield, Await]
async
[no
LineTerminator
here]
PropertyName
[?Yield, ?Await]
UniqueFormalParameters
[+Yield, +Await]
AsyncGeneratorBody
AsyncGeneratorDeclaration
[Yield, Await, Default]
async
[no
LineTerminator
here]
function
BindingIdentifier
[?Yield, ?Await]
FormalParameters
[+Yield, +Await]
AsyncGeneratorBody
[+Default]
async
[no
LineTerminator
here]
function
FormalParameters
[+Yield, +Await]
AsyncGeneratorBody
AsyncGeneratorExpression
async
[no
LineTerminator
here]
function
BindingIdentifier
[+Yield, +Await]
opt
FormalParameters
[+Yield, +Await]
AsyncGeneratorBody
AsyncGeneratorBody
FunctionBody
[+Yield, +Await]
Note 1
YieldExpression
and
AwaitExpression
cannot be used within the
FormalParameters
of an async generator function because any expressions that are part of
FormalParameters
are evaluated before the resulting async generator object is in a resumable state.
Note 2
Abstract operations
relating to async generator objects are defined in
27.6.3
15.6.1
Static Semantics: Early Errors
AsyncGeneratorMethod
async
PropertyName
UniqueFormalParameters
AsyncGeneratorBody
It is a Syntax Error if
HasDirectSuper
of
AsyncGeneratorMethod
is
true
It is a Syntax Error if
UniqueFormalParameters
Contains
YieldExpression
is
true
It is a Syntax Error if
UniqueFormalParameters
Contains
AwaitExpression
is
true
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
AsyncGeneratorBody
is
true
and
IsSimpleParameterList
of
UniqueFormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
UniqueFormalParameters
also occurs in the
LexicallyDeclaredNames
of
AsyncGeneratorBody
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
async
function
FormalParameters
AsyncGeneratorBody
AsyncGeneratorExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncGeneratorBody
If the source code matching
FormalParameters
is
strict mode code
, the Early Error rules for
UniqueFormalParameters
FormalParameters
are applied.
If
BindingIdentifier
is present and the source code matching
BindingIdentifier
is
strict mode code
, it is a Syntax Error if the
StringValue
of
BindingIdentifier
is
"eval"
or
"arguments"
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
AsyncGeneratorBody
is
true
and
IsSimpleParameterList
of
FormalParameters
is
false
It is a Syntax Error if any element of the
BoundNames
of
FormalParameters
also occurs in the
LexicallyDeclaredNames
of
AsyncGeneratorBody
It is a Syntax Error if
FormalParameters
Contains
YieldExpression
is
true
It is a Syntax Error if
FormalParameters
Contains
AwaitExpression
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperProperty
is
true
It is a Syntax Error if
AsyncGeneratorBody
Contains
SuperProperty
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperCall
is
true
It is a Syntax Error if
AsyncGeneratorBody
Contains
SuperCall
is
true
15.6.2
Runtime Semantics: EvaluateAsyncGeneratorBody
With parameters
functionObject
and
argumentsList
(a
List
).
AsyncGeneratorBody
FunctionBody
1.
Perform ?
FunctionDeclarationInstantiation
functionObject
argumentsList
).
2.
Let
generator
be ?
OrdinaryCreateFromConstructor
functionObject
"%AsyncGeneratorFunction.prototype.prototype%"
, « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »).
3.
Set
generator
.[[GeneratorBrand]] to
empty
4.
Perform !
AsyncGeneratorStart
generator
FunctionBody
).
5.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
generator
, [[Target]]:
empty
}.
15.6.3
Runtime Semantics: InstantiateAsyncGeneratorFunctionObject
With parameter
scope
AsyncGeneratorDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
1.
Let
name
be
StringValue
of
BindingIdentifier
2.
Let
sourceText
be the
source text matched by
AsyncGeneratorDeclaration
3.
Let
be !
OrdinaryFunctionCreate
%AsyncGeneratorFunction.prototype%
sourceText
FormalParameters
AsyncGeneratorBody
non-lexical-this
scope
).
4.
Perform !
SetFunctionName
name
).
5.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
6.
Perform !
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
7.
Return
AsyncGeneratorDeclaration
async
function
FormalParameters
AsyncGeneratorBody
1.
Let
sourceText
be the
source text matched by
AsyncGeneratorDeclaration
2.
Let
be
OrdinaryFunctionCreate
%AsyncGeneratorFunction.prototype%
sourceText
FormalParameters
AsyncGeneratorBody
non-lexical-this
scope
).
3.
Perform
SetFunctionName
"default"
).
4.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
5.
Perform
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
6.
Return
Note
An anonymous
AsyncGeneratorDeclaration
can only occur as part of an
export default
declaration.
15.6.4
Runtime Semantics: InstantiateAsyncGeneratorFunctionExpression
With optional parameter
name
AsyncGeneratorExpression
async
function
FormalParameters
AsyncGeneratorBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
AsyncGeneratorExpression
4.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncGeneratorFunction.prototype%
sourceText
FormalParameters
AsyncGeneratorBody
non-lexical-this
scope
).
5.
Perform
SetFunctionName
closure
name
).
6.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
7.
Perform !
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
8.
Return
closure
AsyncGeneratorExpression
async
function
BindingIdentifier
FormalParameters
AsyncGeneratorBody
1.
Assert
name
is not present.
2.
Set
name
to
StringValue
of
BindingIdentifier
3.
Let
scope
be the
running execution context
's LexicalEnvironment.
4.
Let
funcEnv
be !
NewDeclarativeEnvironment
scope
).
5.
Perform !
funcEnv
.CreateImmutableBinding(
name
false
).
6.
Let
sourceText
be the
source text matched by
AsyncGeneratorExpression
7.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncGeneratorFunction.prototype%
sourceText
FormalParameters
AsyncGeneratorBody
non-lexical-this
funcEnv
).
8.
Perform !
SetFunctionName
closure
name
).
9.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
10.
Perform !
DefinePropertyOrThrow
closure
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
11.
Perform !
funcEnv
.InitializeBinding(
name
closure
).
12.
Return
closure
Note
The
BindingIdentifier
in an
AsyncGeneratorExpression
can be referenced from inside the
AsyncGeneratorExpression
's
AsyncGeneratorBody
to allow the generator code to call itself recursively. However, unlike in an
AsyncGeneratorDeclaration
, the
BindingIdentifier
in an
AsyncGeneratorExpression
cannot be referenced from and does not affect the scope enclosing the
AsyncGeneratorExpression
15.6.5
Runtime Semantics: Evaluation
AsyncGeneratorExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncGeneratorBody
1.
Return
InstantiateAsyncGeneratorFunctionExpression
of
AsyncGeneratorExpression
15.7
Class Definitions
Syntax
ClassDeclaration
[Yield, Await, Default]
class
BindingIdentifier
[?Yield, ?Await]
ClassTail
[?Yield, ?Await]
[+Default]
class
ClassTail
[?Yield, ?Await]
ClassExpression
[Yield, Await]
class
BindingIdentifier
[?Yield, ?Await]
opt
ClassTail
[?Yield, ?Await]
ClassTail
[Yield, Await]
ClassHeritage
[?Yield, ?Await]
opt
ClassBody
[?Yield, ?Await]
opt
ClassHeritage
[Yield, Await]
extends
LeftHandSideExpression
[?Yield, ?Await]
ClassBody
[Yield, Await]
ClassElementList
[?Yield, ?Await]
ClassElementList
[Yield, Await]
ClassElement
[?Yield, ?Await]
ClassElementList
[?Yield, ?Await]
ClassElement
[?Yield, ?Await]
ClassElement
[Yield, Await]
MethodDefinition
[?Yield, ?Await]
static
MethodDefinition
[?Yield, ?Await]
Note
A class definition is always
strict mode code
15.7.1
Static Semantics: Early Errors
ClassTail
ClassHeritage
opt
ClassBody
It is a Syntax Error if
ClassHeritage
is not present and the following algorithm evaluates to
true
1.
Let
constructor
be
ConstructorMethod
of
ClassBody
2.
If
constructor
is
empty
, return
false
3.
Return
HasDirectSuper
of
constructor
ClassBody
ClassElementList
It is a Syntax Error if
PrototypePropertyNameList
of
ClassElementList
contains more than one occurrence of
"constructor"
ClassElement
MethodDefinition
It is a Syntax Error if
PropName
of
MethodDefinition
is not
"constructor"
and
HasDirectSuper
of
MethodDefinition
is
true
It is a Syntax Error if
PropName
of
MethodDefinition
is
"constructor"
and
SpecialMethod
of
MethodDefinition
is
true
ClassElement
static
MethodDefinition
It is a Syntax Error if
HasDirectSuper
of
MethodDefinition
is
true
It is a Syntax Error if
PropName
of
MethodDefinition
is
"prototype"
15.7.2
Static Semantics: ClassElementKind
ClassElement
MethodDefinition
1.
If
PropName
of
MethodDefinition
is
"constructor"
, return
ConstructorMethod
2.
Return
NonConstructorMethod
ClassElement
static
MethodDefinition
1.
Return
NonConstructorMethod
ClassElement
1.
Return
empty
15.7.3
Static Semantics: ConstructorMethod
ClassElementList
ClassElement
1.
If
ClassElementKind
of
ClassElement
is
ConstructorMethod
, return
ClassElement
2.
Return
empty
ClassElementList
ClassElementList
ClassElement
1.
Let
head
be
ConstructorMethod
of
ClassElementList
2.
If
head
is not
empty
, return
head
3.
If
ClassElementKind
of
ClassElement
is
ConstructorMethod
, return
ClassElement
4.
Return
empty
Note
Early Error rules ensure that there is only one method definition named
"constructor"
and that it is not an
accessor property
or generator definition.
15.7.4
Static Semantics: IsStatic
ClassElement
MethodDefinition
1.
Return
false
ClassElement
static
MethodDefinition
1.
Return
true
ClassElement
1.
Return
false
15.7.5
Static Semantics: NonConstructorMethodDefinitions
ClassElementList
ClassElement
1.
If
ClassElementKind
of
ClassElement
is
NonConstructorMethod
, then
a.
Return a
List
whose sole element is
ClassElement
2.
Return a new empty
List
ClassElementList
ClassElementList
ClassElement
1.
Let
list
be
NonConstructorMethodDefinitions
of
ClassElementList
2.
If
ClassElementKind
of
ClassElement
is
NonConstructorMethod
, then
a.
Append
ClassElement
to the end of
list
3.
Return
list
15.7.6
Static Semantics: PrototypePropertyNameList
ClassElementList
ClassElement
1.
If
PropName
of
ClassElement
is
empty
, return a new empty
List
2.
If
IsStatic
of
ClassElement
is
true
, return a new empty
List
3.
Return a
List
whose sole element is
PropName
of
ClassElement
ClassElementList
ClassElementList
ClassElement
1.
Let
list
be
PrototypePropertyNameList
of
ClassElementList
2.
If
PropName
of
ClassElement
is
empty
, return
list
3.
If
IsStatic
of
ClassElement
is
true
, return
list
4.
Append
PropName
of
ClassElement
to the end of
list
5.
Return
list
15.7.7
Runtime Semantics: ClassDefinitionEvaluation
With parameters
classBinding
and
className
ClassTail
ClassHeritage
opt
ClassBody
opt
1.
Let
env
be the LexicalEnvironment of the
running execution context
2.
Let
classScope
be
NewDeclarativeEnvironment
env
).
3.
If
classBinding
is not
undefined
, then
a.
Perform
classScope
.CreateImmutableBinding(
classBinding
true
).
4.
If
ClassHeritage
opt
is not present, then
a.
Let
protoParent
be
%Object.prototype%
b.
Let
constructorParent
be
%Function.prototype%
5.
Else,
a.
Set the
running execution context
's LexicalEnvironment to
classScope
b.
Let
superclassRef
be the result of evaluating
ClassHeritage
c.
Set the
running execution context
's LexicalEnvironment to
env
d.
Let
superclass
be ?
GetValue
superclassRef
).
e.
If
superclass
is
null
, then
i.
Let
protoParent
be
null
ii.
Let
constructorParent
be
%Function.prototype%
f.
Else if
IsConstructor
superclass
) is
false
, throw a
TypeError
exception.
g.
Else,
i.
Let
protoParent
be ?
Get
superclass
"prototype"
).
ii.
If
Type
protoParent
) is neither Object nor Null, throw a
TypeError
exception.
iii.
Let
constructorParent
be
superclass
6.
Let
proto
be !
OrdinaryObjectCreate
protoParent
).
7.
If
ClassBody
opt
is not present, let
constructor
be
empty
8.
Else, let
constructor
be
ConstructorMethod
of
ClassBody
9.
Set the
running execution context
's LexicalEnvironment to
classScope
10.
If
constructor
is
empty
, then
a.
Let
steps
be the algorithm steps defined in
Default Constructor Functions
b.
Let
be !
CreateBuiltinFunction
steps
, 0,
className
, « [[ConstructorKind]], [[SourceText]] »,
empty
constructorParent
).
11.
Else,
a.
Let
constructorInfo
be !
DefineMethod
of
constructor
with arguments
proto
and
constructorParent
b.
Let
be
constructorInfo
.[[Closure]].
c.
Perform !
MakeClassConstructor
).
d.
Perform !
SetFunctionName
className
).
12.
Perform !
MakeConstructor
false
proto
).
13.
If
ClassHeritage
opt
is present, set
.[[ConstructorKind]] to
derived
14.
Perform !
CreateMethodProperty
proto
"constructor"
).
15.
If
ClassBody
opt
is not present, let
methods
be a new empty
List
16.
Else, let
methods
be
NonConstructorMethodDefinitions
of
ClassBody
17.
For each
ClassElement
of
methods
, do
a.
If
IsStatic
of
is
false
, then
i.
Let
status
be
PropertyDefinitionEvaluation
of
with arguments
proto
and
false
b.
Else,
i.
Let
status
be
PropertyDefinitionEvaluation
of
with arguments
and
false
c.
If
status
is an
abrupt completion
, then
i.
Set the
running execution context
's LexicalEnvironment to
env
ii.
Return
Completion
status
).
18.
Set the
running execution context
's LexicalEnvironment to
env
19.
If
classBinding
is not
undefined
, then
a.
Perform
classScope
.InitializeBinding(
classBinding
).
20.
Return
15.7.7.1
Default Constructor Functions
When a Default
Constructor
Function is called with zero or more arguments which form the rest parameter ...
args
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
be the
active function object
3.
If
.[[ConstructorKind]] is
derived
, then
a.
NOTE: This branch behaves similarly to
constructor(...args) { super(...args); }
. The most notable distinction is that while the aforementioned ECMAScript source text observably calls the
@@iterator
method on
%Array.prototype%
, a Default
Constructor
Function does not.
b.
Let
func
be !
.[[GetPrototypeOf]]().
c.
If
IsConstructor
func
) is
false
, throw a
TypeError
exception.
d.
Return ?
Construct
func
args
, NewTarget).
4.
Else,
a.
NOTE: This branch behaves similarly to
constructor() {}
b.
Return ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Object.prototype%"
).
The
"length"
property of a default
constructor
function is
+0
15.7.8
Runtime Semantics: BindingClassDeclarationEvaluation
ClassDeclaration
class
BindingIdentifier
ClassTail
1.
Let
className
be
StringValue
of
BindingIdentifier
2.
Let
value
be ?
ClassDefinitionEvaluation
of
ClassTail
with arguments
className
and
className
3.
Set
value
.[[SourceText]] to the
source text matched by
ClassDeclaration
4.
Let
env
be the
running execution context
's LexicalEnvironment.
5.
Perform ?
InitializeBoundName
className
value
env
).
6.
Return
value
ClassDeclaration
class
ClassTail
1.
Let
value
be ?
ClassDefinitionEvaluation
of
ClassTail
with arguments
undefined
and
"default"
2.
Set
value
.[[SourceText]] to the
source text matched by
ClassDeclaration
3.
Return
value
Note
ClassDeclaration
class
ClassTail
only occurs as part of an
ExportDeclaration
and establishing its binding is handled as part of the evaluation action for that production. See
16.2.3.7
15.7.9
Runtime Semantics: Evaluation
ClassDeclaration
class
BindingIdentifier
ClassTail
1.
Perform ?
BindingClassDeclarationEvaluation
of this
ClassDeclaration
2.
Return
NormalCompletion
empty
).
Note
ClassDeclaration
class
ClassTail
only occurs as part of an
ExportDeclaration
and is never directly evaluated.
ClassExpression
class
ClassTail
1.
Let
value
be ?
ClassDefinitionEvaluation
of
ClassTail
with arguments
undefined
and
""
2.
Set
value
.[[SourceText]] to the
source text matched by
ClassExpression
3.
Return
value
ClassExpression
class
BindingIdentifier
ClassTail
1.
Let
className
be
StringValue
of
BindingIdentifier
2.
Let
value
be ?
ClassDefinitionEvaluation
of
ClassTail
with arguments
className
and
className
3.
Set
value
.[[SourceText]] to the
source text matched by
ClassExpression
4.
Return
value
15.8
Async Function Definitions
Syntax
AsyncFunctionDeclaration
[Yield, Await, Default]
async
[no
LineTerminator
here]
function
BindingIdentifier
[?Yield, ?Await]
FormalParameters
[~Yield, +Await]
AsyncFunctionBody
[+Default]
async
[no
LineTerminator
here]
function
FormalParameters
[~Yield, +Await]
AsyncFunctionBody
AsyncFunctionExpression
async
[no
LineTerminator
here]
function
BindingIdentifier
[~Yield, +Await]
opt
FormalParameters
[~Yield, +Await]
AsyncFunctionBody
AsyncMethod
[Yield, Await]
async
[no
LineTerminator
here]
PropertyName
[?Yield, ?Await]
UniqueFormalParameters
[~Yield, +Await]
AsyncFunctionBody
AsyncFunctionBody
FunctionBody
[~Yield, +Await]
AwaitExpression
[Yield]
await
UnaryExpression
[?Yield, +Await]
Note 1
await
is parsed as an
AwaitExpression
when the
[Await]
parameter is present. The
[Await]
parameter is present in the following contexts:
In an
AsyncFunctionBody
In the
FormalParameters
of an
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
, or
AsyncGeneratorExpression
AwaitExpression
in this position is a Syntax error via
static semantics
When
Module
is the syntactic
goal symbol
and the
[Await]
parameter is absent,
await
is parsed as a
keyword
and will be a Syntax error. When
Script
is the syntactic
goal symbol
await
may be parsed as an identifier when the
[Await]
parameter is absent. This includes the following contexts:
Anywhere outside of an
AsyncFunctionBody
or
FormalParameters
of an
AsyncFunctionDeclaration
AsyncFunctionExpression
AsyncGeneratorDeclaration
, or
AsyncGeneratorExpression
In the
BindingIdentifier
of a
FunctionExpression
GeneratorExpression
, or
AsyncGeneratorExpression
Note 2
Unlike
YieldExpression
, it is a Syntax Error to omit the operand of an
AwaitExpression
. You must await something.
15.8.1
Static Semantics: Early Errors
AsyncMethod
async
PropertyName
UniqueFormalParameters
AsyncFunctionBody
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
AsyncFunctionBody
is
true
and
IsSimpleParameterList
of
UniqueFormalParameters
is
false
It is a Syntax Error if
HasDirectSuper
of
AsyncMethod
is
true
It is a Syntax Error if
UniqueFormalParameters
Contains
AwaitExpression
is
true
It is a Syntax Error if any element of the
BoundNames
of
UniqueFormalParameters
also occurs in the
LexicallyDeclaredNames
of
AsyncFunctionBody
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
async
function
FormalParameters
AsyncFunctionBody
AsyncFunctionExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncFunctionBody
It is a Syntax Error if
FunctionBodyContainsUseStrict
of
AsyncFunctionBody
is
true
and
IsSimpleParameterList
of
FormalParameters
is
false
It is a Syntax Error if
FormalParameters
Contains
AwaitExpression
is
true
If the source code matching
FormalParameters
is
strict mode code
, the Early Error rules for
UniqueFormalParameters
FormalParameters
are applied.
If
BindingIdentifier
is present and the source code matching
BindingIdentifier
is
strict mode code
, it is a Syntax Error if the
StringValue
of
BindingIdentifier
is
"eval"
or
"arguments"
It is a Syntax Error if any element of the
BoundNames
of
FormalParameters
also occurs in the
LexicallyDeclaredNames
of
AsyncFunctionBody
It is a Syntax Error if
FormalParameters
Contains
SuperProperty
is
true
It is a Syntax Error if
AsyncFunctionBody
Contains
SuperProperty
is
true
It is a Syntax Error if
FormalParameters
Contains
SuperCall
is
true
It is a Syntax Error if
AsyncFunctionBody
Contains
SuperCall
is
true
15.8.2
Runtime Semantics: InstantiateAsyncFunctionObject
With parameter
scope
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
1.
Let
name
be
StringValue
of
BindingIdentifier
2.
Let
sourceText
be the
source text matched by
AsyncFunctionDeclaration
3.
Let
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
FormalParameters
AsyncFunctionBody
non-lexical-this
scope
).
4.
Perform !
SetFunctionName
name
).
5.
Return
AsyncFunctionDeclaration
async
function
FormalParameters
AsyncFunctionBody
1.
Let
sourceText
be the
source text matched by
AsyncFunctionDeclaration
2.
Let
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
FormalParameters
AsyncFunctionBody
non-lexical-this
scope
).
3.
Perform !
SetFunctionName
"default"
).
4.
Return
15.8.3
Runtime Semantics: InstantiateAsyncFunctionExpression
With optional parameter
name
AsyncFunctionExpression
async
function
FormalParameters
AsyncFunctionBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
AsyncFunctionExpression
4.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
FormalParameters
AsyncFunctionBody
non-lexical-this
scope
).
5.
Perform
SetFunctionName
closure
name
).
6.
Return
closure
AsyncFunctionExpression
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
1.
Assert
name
is not present.
2.
Set
name
to
StringValue
of
BindingIdentifier
3.
Let
scope
be the LexicalEnvironment of the
running execution context
4.
Let
funcEnv
be !
NewDeclarativeEnvironment
scope
).
5.
Perform !
funcEnv
.CreateImmutableBinding(
name
false
).
6.
Let
sourceText
be the
source text matched by
AsyncFunctionExpression
7.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
FormalParameters
AsyncFunctionBody
non-lexical-this
funcEnv
).
8.
Perform !
SetFunctionName
closure
name
).
9.
Perform !
funcEnv
.InitializeBinding(
name
closure
).
10.
Return
closure
Note
The
BindingIdentifier
in an
AsyncFunctionExpression
can be referenced from inside the
AsyncFunctionExpression
's
AsyncFunctionBody
to allow the function to call itself recursively. However, unlike in a
FunctionDeclaration
, the
BindingIdentifier
in a
AsyncFunctionExpression
cannot be referenced from and does not affect the scope enclosing the
AsyncFunctionExpression
15.8.4
Runtime Semantics: EvaluateAsyncFunctionBody
With parameters
functionObject
and
argumentsList
(a
List
).
AsyncFunctionBody
FunctionBody
1.
Let
promiseCapability
be !
NewPromiseCapability
%Promise%
).
2.
Let
declResult
be
FunctionDeclarationInstantiation
functionObject
argumentsList
).
3.
If
declResult
is not an
abrupt completion
, then
a.
Perform !
AsyncFunctionStart
promiseCapability
FunctionBody
).
4.
Else,
a.
Perform !
Call
promiseCapability
.[[Reject]],
undefined
, «
declResult
.[[Value]] »).
5.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
promiseCapability
.[[Promise]], [[Target]]:
empty
}.
15.8.5
Runtime Semantics: Evaluation
AsyncFunctionDeclaration
async
function
BindingIdentifier
FormalParameters
AsyncFunctionBody
1.
Return
NormalCompletion
empty
).
AsyncFunctionDeclaration
async
function
FormalParameters
AsyncFunctionBody
1.
Return
NormalCompletion
empty
).
AsyncFunctionExpression
async
function
BindingIdentifier
opt
FormalParameters
AsyncFunctionBody
1.
Return
InstantiateAsyncFunctionExpression
of
AsyncFunctionExpression
AwaitExpression
await
UnaryExpression
1.
Let
exprRef
be the result of evaluating
UnaryExpression
2.
Let
value
be ?
GetValue
exprRef
).
3.
Return ?
Await
value
).
15.9
Async Arrow Function Definitions
Syntax
AsyncArrowFunction
[In, Yield, Await]
async
[no
LineTerminator
here]
AsyncArrowBindingIdentifier
[?Yield]
[no
LineTerminator
here]
=>
AsyncConciseBody
[?In]
CoverCallExpressionAndAsyncArrowHead
[?Yield, ?Await]
[no
LineTerminator
here]
=>
AsyncConciseBody
[?In]
AsyncConciseBody
[In]
[lookahead ≠
ExpressionBody
[?In, +Await]
AsyncFunctionBody
AsyncArrowBindingIdentifier
[Yield]
BindingIdentifier
[?Yield, +Await]
CoverCallExpressionAndAsyncArrowHead
[Yield, Await]
MemberExpression
[?Yield, ?Await]
Arguments
[?Yield, ?Await]
Supplemental Syntax
When processing an instance of the production
AsyncArrowFunction
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
the interpretation of
CoverCallExpressionAndAsyncArrowHead
is refined using the following grammar:
AsyncArrowHead
async
[no
LineTerminator
here]
ArrowFormalParameters
[~Yield, +Await]
15.9.1
Static Semantics: Early Errors
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
It is a Syntax Error if any element of the
BoundNames
of
AsyncArrowBindingIdentifier
also occurs in the
LexicallyDeclaredNames
of
AsyncConciseBody
AsyncArrowFunction
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
It is a Syntax Error if
CoverCallExpressionAndAsyncArrowHead
Contains
YieldExpression
is
true
It is a Syntax Error if
CoverCallExpressionAndAsyncArrowHead
Contains
AwaitExpression
is
true
It is a Syntax Error if
CoverCallExpressionAndAsyncArrowHead
is not
covering
an
AsyncArrowHead
It is a Syntax Error if any element of the
BoundNames
of
CoverCallExpressionAndAsyncArrowHead
also occurs in the
LexicallyDeclaredNames
of
AsyncConciseBody
It is a Syntax Error if
AsyncConciseBodyContainsUseStrict
of
AsyncConciseBody
is
true
and
IsSimpleParameterList
of
CoverCallExpressionAndAsyncArrowHead
is
false
All Early Error rules for
AsyncArrowHead
and its derived productions apply to
CoveredAsyncArrowHead
of
CoverCallExpressionAndAsyncArrowHead
15.9.2
Static Semantics: CoveredAsyncArrowHead
CoverCallExpressionAndAsyncArrowHead
MemberExpression
Arguments
1.
Return the
AsyncArrowHead
that is
covered
by
CoverCallExpressionAndAsyncArrowHead
15.9.3
Static Semantics: AsyncConciseBodyContainsUseStrict
AsyncConciseBody
ExpressionBody
1.
Return
false
AsyncConciseBody
AsyncFunctionBody
1.
Return
FunctionBodyContainsUseStrict
of
AsyncFunctionBody
15.9.4
Runtime Semantics: EvaluateAsyncConciseBody
With parameters
functionObject
and
argumentsList
(a
List
).
AsyncConciseBody
ExpressionBody
1.
Let
promiseCapability
be !
NewPromiseCapability
%Promise%
).
2.
Let
declResult
be
FunctionDeclarationInstantiation
functionObject
argumentsList
).
3.
If
declResult
is not an
abrupt completion
, then
a.
Perform !
AsyncFunctionStart
promiseCapability
ExpressionBody
).
4.
Else,
a.
Perform !
Call
promiseCapability
.[[Reject]],
undefined
, «
declResult
.[[Value]] »).
5.
Return
Completion
{ [[Type]]:
return
, [[Value]]:
promiseCapability
.[[Promise]], [[Target]]:
empty
}.
15.9.5
Runtime Semantics: InstantiateAsyncArrowFunctionExpression
With optional parameter
name
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
AsyncArrowFunction
4.
Let
parameters
be
AsyncArrowBindingIdentifier
5.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
parameters
AsyncConciseBody
lexical-this
scope
).
6.
Perform
SetFunctionName
closure
name
).
7.
Return
closure
AsyncArrowFunction
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
1.
If
name
is not present, set
name
to
""
2.
Let
scope
be the LexicalEnvironment of the
running execution context
3.
Let
sourceText
be the
source text matched by
AsyncArrowFunction
4.
Let
head
be
CoveredAsyncArrowHead
of
CoverCallExpressionAndAsyncArrowHead
5.
Let
parameters
be the
ArrowFormalParameters
of
head
6.
Let
closure
be !
OrdinaryFunctionCreate
%AsyncFunction.prototype%
sourceText
parameters
AsyncConciseBody
lexical-this
scope
).
7.
Perform
SetFunctionName
closure
name
).
8.
Return
closure
15.9.6
Runtime Semantics: Evaluation
AsyncArrowFunction
async
AsyncArrowBindingIdentifier
=>
AsyncConciseBody
CoverCallExpressionAndAsyncArrowHead
=>
AsyncConciseBody
1.
Return
InstantiateAsyncArrowFunctionExpression
of
AsyncArrowFunction
15.10
Tail Position Calls
15.10.1
Static Semantics: IsInTailPosition (
call
The abstract operation IsInTailPosition takes argument
call
. It performs the following steps when called:
1.
Assert
call
is a
Parse Node
2.
If the source code matching
call
is
non-strict code
, return
false
3.
If
call
is not contained within a
FunctionBody
ConciseBody
, or
AsyncConciseBody
, return
false
4.
Let
body
be the
FunctionBody
ConciseBody
, or
AsyncConciseBody
that most closely contains
call
5.
If
body
is the
FunctionBody
of a
GeneratorBody
, return
false
6.
If
body
is the
FunctionBody
of an
AsyncFunctionBody
, return
false
7.
If
body
is the
FunctionBody
of an
AsyncGeneratorBody
, return
false
8.
If
body
is an
AsyncConciseBody
, return
false
9.
Return the result of
HasCallInTailPosition
of
body
with argument
call
Note
Tail Position calls are only defined in
strict mode code
because of a common non-standard language extension (see
10.2.4
) that enables observation of the chain of caller contexts.
15.10.2
Static Semantics: HasCallInTailPosition
With parameter
call
Note
call
is a
Parse Node
that represents a specific range of source text. When the following algorithms compare
call
to another
Parse Node
, it is a test of whether they represent the same source text.
15.10.2.1
Statement Rules
StatementList
StatementList
StatementListItem
1.
Let
has
be
HasCallInTailPosition
of
StatementList
with argument
call
2.
If
has
is
true
, return
true
3.
Return
HasCallInTailPosition
of
StatementListItem
with argument
call
FunctionStatementList
[empty]
StatementListItem
Declaration
Statement
VariableStatement
EmptyStatement
ExpressionStatement
ContinueStatement
BreakStatement
ThrowStatement
DebuggerStatement
Block
ReturnStatement
return
LabelledItem
FunctionDeclaration
ForInOfStatement
for
LeftHandSideExpression
of
AssignmentExpression
Statement
for
var
ForBinding
of
AssignmentExpression
Statement
for
ForDeclaration
of
AssignmentExpression
Statement
CaseBlock
1.
Return
false
IfStatement
if
Expression
Statement
else
Statement
1.
Let
has
be
HasCallInTailPosition
of the first
Statement
with argument
call
2.
If
has
is
true
, return
true
3.
Return
HasCallInTailPosition
of the second
Statement
with argument
call
IfStatement
if
Expression
Statement
DoWhileStatement
do
Statement
while
Expression
WhileStatement
while
Expression
Statement
ForStatement
for
Expression
opt
Expression
opt
Expression
opt
Statement
for
var
VariableDeclarationList
Expression
opt
Expression
opt
Statement
for
LexicalDeclaration
Expression
opt
Expression
opt
Statement
ForInOfStatement
for
LeftHandSideExpression
in
Expression
Statement
for
var
ForBinding
in
Expression
Statement
for
ForDeclaration
in
Expression
Statement
for
await
LeftHandSideExpression
of
AssignmentExpression
Statement
for
await
var
ForBinding
of
AssignmentExpression
Statement
for
await
ForDeclaration
of
AssignmentExpression
Statement
WithStatement
with
Expression
Statement
1.
Return
HasCallInTailPosition
of
Statement
with argument
call
LabelledStatement
LabelIdentifier
LabelledItem
1.
Return
HasCallInTailPosition
of
LabelledItem
with argument
call
ReturnStatement
return
Expression
1.
Return
HasCallInTailPosition
of
Expression
with argument
call
SwitchStatement
switch
Expression
CaseBlock
1.
Return
HasCallInTailPosition
of
CaseBlock
with argument
call
CaseBlock
CaseClauses
opt
DefaultClause
CaseClauses
opt
1.
Let
has
be
false
2.
If the first
CaseClauses
is present, let
has
be
HasCallInTailPosition
of the first
CaseClauses
with argument
call
3.
If
has
is
true
, return
true
4.
Let
has
be
HasCallInTailPosition
of
DefaultClause
with argument
call
5.
If
has
is
true
, return
true
6.
If the second
CaseClauses
is present, let
has
be
HasCallInTailPosition
of the second
CaseClauses
with argument
call
7.
Return
has
CaseClauses
CaseClauses
CaseClause
1.
Let
has
be
HasCallInTailPosition
of
CaseClauses
with argument
call
2.
If
has
is
true
, return
true
3.
Return
HasCallInTailPosition
of
CaseClause
with argument
call
CaseClause
case
Expression
StatementList
opt
DefaultClause
default
StatementList
opt
1.
If
StatementList
is present, return
HasCallInTailPosition
of
StatementList
with argument
call
2.
Return
false
TryStatement
try
Block
Catch
1.
Return
HasCallInTailPosition
of
Catch
with argument
call
TryStatement
try
Block
Finally
TryStatement
try
Block
Catch
Finally
1.
Return
HasCallInTailPosition
of
Finally
with argument
call
Catch
catch
CatchParameter
Block
1.
Return
HasCallInTailPosition
of
Block
with argument
call
15.10.2.2
Expression Rules
Note
A potential tail position call that is immediately followed by return
GetValue
of the call result is also a possible tail position call. A function call cannot return a
Reference Record
, so such a
GetValue
operation will always return the same value as the actual function call result.
AssignmentExpression
YieldExpression
ArrowFunction
AsyncArrowFunction
LeftHandSideExpression
AssignmentExpression
LeftHandSideExpression
AssignmentOperator
AssignmentExpression
LeftHandSideExpression
&&=
AssignmentExpression
LeftHandSideExpression
||=
AssignmentExpression
LeftHandSideExpression
??=
AssignmentExpression
BitwiseANDExpression
BitwiseANDExpression
EqualityExpression
BitwiseXORExpression
BitwiseXORExpression
BitwiseANDExpression
BitwiseORExpression
BitwiseORExpression
BitwiseXORExpression
EqualityExpression
EqualityExpression
==
RelationalExpression
EqualityExpression
!=
RelationalExpression
EqualityExpression
===
RelationalExpression
EqualityExpression
!==
RelationalExpression
RelationalExpression
RelationalExpression
ShiftExpression
RelationalExpression
ShiftExpression
RelationalExpression
<=
ShiftExpression
RelationalExpression
>=
ShiftExpression
RelationalExpression
instanceof
ShiftExpression
RelationalExpression
in
ShiftExpression
ShiftExpression
ShiftExpression
<<
AdditiveExpression
ShiftExpression
>>
AdditiveExpression
ShiftExpression
>>>
AdditiveExpression
AdditiveExpression
AdditiveExpression
MultiplicativeExpression
AdditiveExpression
MultiplicativeExpression
MultiplicativeExpression
MultiplicativeExpression
MultiplicativeOperator
ExponentiationExpression
ExponentiationExpression
UpdateExpression
**
ExponentiationExpression
UpdateExpression
LeftHandSideExpression
++
LeftHandSideExpression
--
++
UnaryExpression
--
UnaryExpression
UnaryExpression
delete
UnaryExpression
void
UnaryExpression
typeof
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
UnaryExpression
AwaitExpression
CallExpression
SuperCall
CallExpression
Expression
CallExpression
IdentifierName
NewExpression
new
NewExpression
MemberExpression
MemberExpression
Expression
MemberExpression
IdentifierName
SuperProperty
MetaProperty
new
MemberExpression
Arguments
PrimaryExpression
this
IdentifierReference
Literal
ArrayLiteral
ObjectLiteral
FunctionExpression
ClassExpression
GeneratorExpression
AsyncFunctionExpression
AsyncGeneratorExpression
RegularExpressionLiteral
TemplateLiteral
1.
Return
false
Expression
AssignmentExpression
Expression
AssignmentExpression
1.
Return
HasCallInTailPosition
of
AssignmentExpression
with argument
call
ConditionalExpression
ShortCircuitExpression
AssignmentExpression
AssignmentExpression
1.
Let
has
be
HasCallInTailPosition
of the first
AssignmentExpression
with argument
call
2.
If
has
is
true
, return
true
3.
Return
HasCallInTailPosition
of the second
AssignmentExpression
with argument
call
LogicalANDExpression
LogicalANDExpression
&&
BitwiseORExpression
1.
Return
HasCallInTailPosition
of
BitwiseORExpression
with argument
call
LogicalORExpression
LogicalORExpression
||
LogicalANDExpression
1.
Return
HasCallInTailPosition
of
LogicalANDExpression
with argument
call
CoalesceExpression
CoalesceExpressionHead
??
BitwiseORExpression
1.
Return
HasCallInTailPosition
of
BitwiseORExpression
with argument
call
CallExpression
CoverCallExpressionAndAsyncArrowHead
CallExpression
Arguments
CallExpression
TemplateLiteral
1.
If this
CallExpression
is
call
, return
true
2.
Return
false
OptionalExpression
MemberExpression
OptionalChain
CallExpression
OptionalChain
OptionalExpression
OptionalChain
1.
Return
HasCallInTailPosition
of
OptionalChain
with argument
call
OptionalChain
?.
Expression
?.
IdentifierName
OptionalChain
Expression
OptionalChain
IdentifierName
1.
Return
false
OptionalChain
?.
Arguments
OptionalChain
Arguments
1.
If this
OptionalChain
is
call
, return
true
2.
Return
false
MemberExpression
MemberExpression
TemplateLiteral
1.
If this
MemberExpression
is
call
, return
true
2.
Return
false
PrimaryExpression
CoverParenthesizedExpressionAndArrowParameterList
1.
Let
expr
be
CoveredParenthesizedExpression
of
CoverParenthesizedExpressionAndArrowParameterList
2.
Return
HasCallInTailPosition
of
expr
with argument
call
ParenthesizedExpression
Expression
1.
Return
HasCallInTailPosition
of
Expression
with argument
call
15.10.3
PrepareForTailCall ( )
The abstract operation PrepareForTailCall takes no arguments. It performs the following steps when called:
1.
Let
leafContext
be the
running execution context
2.
Suspend
leafContext
3.
Pop
leafContext
from the
execution context stack
. The
execution context
now on the top of the stack becomes the
running execution context
4.
Assert
leafContext
has no further use. It will never be activated as the
running execution context
A tail position call must either release any transient internal resources associated with the currently executing function
execution context
before invoking the target function or reuse those resources in support of the target function.
Note
For example, a tail position call should only grow an
implementation's activation record stack by the amount that the size of
the target function's activation record exceeds the size of the calling
function's activation record. If the target function's activation record
is smaller, then the total size of the stack should decrease.
16
ECMAScript Language: Scripts and Modules
16.1
Scripts
Syntax
Script
ScriptBody
opt
ScriptBody
StatementList
[~Yield, ~Await, ~Return]
16.1.1
Static Semantics: Early Errors
Script
ScriptBody
It is a Syntax Error if the
LexicallyDeclaredNames
of
ScriptBody
contains any duplicate entries.
It is a Syntax Error if any element of the
LexicallyDeclaredNames
of
ScriptBody
also occurs in the
VarDeclaredNames
of
ScriptBody
ScriptBody
StatementList
It is a Syntax Error if
StatementList
Contains
super
unless the source code containing
super
is eval code that is being processed by a
direct eval
. Additional
early error
rules for
super
within
direct eval
are defined in
19.2.1.1
It is a Syntax Error if
StatementList
Contains
NewTarget
unless the source code containing
NewTarget
is eval code that is being processed by a
direct eval
. Additional
early error
rules for
NewTarget
in
direct eval
are defined in
19.2.1.1
It is a Syntax Error if
ContainsDuplicateLabels
of
StatementList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedBreakTarget
of
StatementList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedContinueTarget
of
StatementList
with arguments « » and « » is
true
16.1.2
Static Semantics: IsStrict
Script
ScriptBody
opt
1.
If
ScriptBody
is present and the
Directive Prologue
of
ScriptBody
contains a
Use Strict Directive
, return
true
; otherwise, return
false
16.1.3
Runtime Semantics: Evaluation
Script
[empty]
1.
Return
NormalCompletion
undefined
).
16.1.4
Script Records
Script Record
encapsulates information about a script being evaluated. Each script record contains the fields listed in
Table 39
Table 39:
Script Record
Fields
Field Name
Value Type
Meaning
[[Realm]]
Realm Record
undefined
The
realm
within which this script was created.
undefined
if not yet assigned.
[[Environment]]
Environment Record
undefined
The
Environment Record
containing the top level bindings for this script. This field is set when the script is instantiated.
[[ECMAScriptCode]]
Parse Node
The result of parsing the source text of this script using
Script
as the
goal symbol
[[HostDefined]]
Any, default value is
empty
Field reserved for use by
host
environments that need to associate additional information with a script.
16.1.5
ParseScript (
sourceText
realm
hostDefined
The abstract operation ParseScript takes arguments
sourceText
realm
, and
hostDefined
. It creates a
Script Record
based upon the result of parsing
sourceText
as a
Script
. It performs the following steps when called:
1.
Assert
sourceText
is an ECMAScript source text (see clause
11
).
2.
Let
body
be
ParseText
sourceText
Script
).
3.
If
body
is a
List
of errors, return
body
4.
Return
Script Record
{ [[Realm]]:
realm
, [[Environment]]:
undefined
, [[ECMAScriptCode]]:
body
, [[HostDefined]]:
hostDefined
}.
Note
An implementation may parse script source text and analyse it
for Early Error conditions prior to evaluation of ParseScript for that
script source text. However, the reporting of any errors must be
deferred until the point where this specification actually performs
ParseScript upon that source text.
16.1.6
ScriptEvaluation (
scriptRecord
The abstract operation ScriptEvaluation takes argument
scriptRecord
. It performs the following steps when called:
1.
Let
globalEnv
be
scriptRecord
.[[Realm]].[[GlobalEnv]].
2.
Let
scriptContext
be a new ECMAScript code
execution context
3.
Set the Function of
scriptContext
to
null
4.
Set the
Realm
of
scriptContext
to
scriptRecord
.[[Realm]].
5.
Set the ScriptOrModule of
scriptContext
to
scriptRecord
6.
Set the VariableEnvironment of
scriptContext
to
globalEnv
7.
Set the LexicalEnvironment of
scriptContext
to
globalEnv
8.
Suspend
the currently
running execution context
9.
Push
scriptContext
onto the
execution context stack
scriptContext
is now the
running execution context
10.
Let
scriptBody
be
scriptRecord
.[[ECMAScriptCode]].
11.
Let
result
be
GlobalDeclarationInstantiation
scriptBody
globalEnv
).
12.
If
result
.[[Type]] is
normal
, then
a.
Set
result
to the result of evaluating
scriptBody
13.
If
result
.[[Type]] is
normal
and
result
.[[Value]] is
empty
, then
a.
Set
result
to
NormalCompletion
undefined
).
14.
Suspend
scriptContext
and remove it from the
execution context stack
15.
Assert
: The
execution context stack
is not empty.
16.
Resume the context that is now on the top of the
execution context stack
as the
running execution context
17.
Return
Completion
result
).
16.1.7
GlobalDeclarationInstantiation (
script
env
Note 1
When an
execution context
is established for evaluating scripts, declarations are instantiated in the current
global environment
. Each global binding declared in the code is instantiated.
The abstract operation GlobalDeclarationInstantiation takes arguments
script
(a
Parse Node
for
ScriptBody
) and
env
(an
Environment Record
).
script
is the
ScriptBody
for which the
execution context
is being established.
env
is the
global environment
in which bindings are to be created. It performs the following steps when called:
1.
Assert
env
is a
global Environment Record
2.
Let
lexNames
be the
LexicallyDeclaredNames
of
script
3.
Let
varNames
be the
VarDeclaredNames
of
script
4.
For each element
name
of
lexNames
, do
a.
If
env
.HasVarDeclaration(
name
) is
true
, throw a
SyntaxError
exception.
b.
If
env
.HasLexicalDeclaration(
name
) is
true
, throw a
SyntaxError
exception.
c.
Let
hasRestrictedGlobal
be ?
env
.HasRestrictedGlobalProperty(
name
).
d.
If
hasRestrictedGlobal
is
true
, throw a
SyntaxError
exception.
5.
For each element
name
of
varNames
, do
a.
If
env
.HasLexicalDeclaration(
name
) is
true
, throw a
SyntaxError
exception.
6.
Let
varDeclarations
be the
VarScopedDeclarations
of
script
7.
Let
functionsToInitialize
be a new empty
List
8.
Let
declaredFunctionNames
be a new empty
List
9.
For each element
of
varDeclarations
, in reverse
List
order, do
a.
If
is neither a
VariableDeclaration
nor a
ForBinding
nor a
BindingIdentifier
, then
i.
Assert
is either a
FunctionDeclaration
, a
GeneratorDeclaration
, an
AsyncFunctionDeclaration
, or an
AsyncGeneratorDeclaration
ii.
NOTE: If there are multiple function declarations for the same name, the last declaration is used.
iii.
Let
fn
be the sole element of the
BoundNames
of
iv.
If
fn
is not an element of
declaredFunctionNames
, then
1.
Let
fnDefinable
be ?
env
.CanDeclareGlobalFunction(
fn
).
2.
If
fnDefinable
is
false
, throw a
TypeError
exception.
3.
Append
fn
to
declaredFunctionNames
4.
Insert
as the first element of
functionsToInitialize
10.
Let
declaredVarNames
be a new empty
List
11.
For each element
of
varDeclarations
, do
a.
If
is a
VariableDeclaration
, a
ForBinding
, or a
BindingIdentifier
, then
i.
For each String
vn
of the
BoundNames
of
, do
1.
If
vn
is not an element of
declaredFunctionNames
, then
a.
Let
vnDefinable
be ?
env
.CanDeclareGlobalVar(
vn
).
b.
If
vnDefinable
is
false
, throw a
TypeError
exception.
c.
If
vn
is not an element of
declaredVarNames
, then
i.
Append
vn
to
declaredVarNames
12.
NOTE: No abnormal terminations occur after this algorithm step if the
global object
is an
ordinary object
. However, if the
global object
is a
Proxy exotic object
it may exhibit behaviours that cause abnormal terminations in some of the following steps.
13.
NOTE: Annex
B.3.3.2
adds additional steps at this point.
14.
Let
lexDeclarations
be the
LexicallyScopedDeclarations
of
script
15.
For each element
of
lexDeclarations
, do
a.
NOTE: Lexically declared names are only instantiated here but not initialized.
b.
For each element
dn
of the
BoundNames
of
, do
i.
If
IsConstantDeclaration
of
is
true
, then
1.
Perform ?
env
.CreateImmutableBinding(
dn
true
).
ii.
Else,
1.
Perform ?
env
.CreateMutableBinding(
dn
false
).
16.
For each
Parse Node
of
functionsToInitialize
, do
a.
Let
fn
be the sole element of the
BoundNames
of
b.
Let
fo
be
InstantiateFunctionObject
of
with argument
env
c.
Perform ?
env
.CreateGlobalFunctionBinding(
fn
fo
false
).
17.
For each String
vn
of
declaredVarNames
, do
a.
Perform ?
env
.CreateGlobalVarBinding(
vn
false
).
18.
Return
NormalCompletion
empty
).
Note 2
Early errors specified in
16.1.1
prevent name conflicts between function/var declarations and
let/const/class declarations as well as redeclaration of let/const/class
bindings for declaration contained within a single
Script
. However, such conflicts and redeclarations that span more than one
Script
are detected as runtime errors during GlobalDeclarationInstantiation.
If any such errors are detected, no bindings are instantiated for the
script. However, if the
global object
is defined using Proxy exotic objects then the runtime tests for conflicting declarations may be unreliable resulting in an
abrupt completion
and some global declarations not being instantiated. If this occurs, the code for the
Script
is not evaluated.
Unlike explicit var or function declarations, properties that are directly created on the
global object
result in global bindings that may be shadowed by let/const/class declarations.
16.2
Modules
Syntax
Module
ModuleBody
opt
ModuleBody
ModuleItemList
ModuleItemList
ModuleItem
ModuleItemList
ModuleItem
ModuleItem
ImportDeclaration
ExportDeclaration
StatementListItem
[~Yield, ~Await, ~Return]
16.2.1
Module Semantics
16.2.1.1
Static Semantics: Early Errors
ModuleBody
ModuleItemList
It is a Syntax Error if the
LexicallyDeclaredNames
of
ModuleItemList
contains any duplicate entries.
It is a Syntax Error if any element of the
LexicallyDeclaredNames
of
ModuleItemList
also occurs in the
VarDeclaredNames
of
ModuleItemList
It is a Syntax Error if the
ExportedNames
of
ModuleItemList
contains any duplicate entries.
It is a Syntax Error if any element of the
ExportedBindings
of
ModuleItemList
does not also occur in either the
VarDeclaredNames
of
ModuleItemList
, or the
LexicallyDeclaredNames
of
ModuleItemList
It is a Syntax Error if
ModuleItemList
Contains
super
It is a Syntax Error if
ModuleItemList
Contains
NewTarget
It is a Syntax Error if
ContainsDuplicateLabels
of
ModuleItemList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedBreakTarget
of
ModuleItemList
with argument « » is
true
It is a Syntax Error if
ContainsUndefinedContinueTarget
of
ModuleItemList
with arguments « » and « » is
true
Note
The duplicate
ExportedNames
rule implies that multiple
export default
ExportDeclaration
items within a
ModuleBody
is a Syntax Error. Additional error conditions relating to conflicting
or duplicate declarations are checked during module linking prior to
evaluation of a
Module
. If any such errors are detected the
Module
is not evaluated.
16.2.1.2
Static Semantics: ImportedLocalNames (
importEntries
The abstract operation ImportedLocalNames takes argument
importEntries
(a
List
of ImportEntry Records (see
Table 45
)). It creates a
List
of all of the local name bindings defined by
importEntries
. It performs the following steps when called:
1.
Let
localNames
be a new empty
List
2.
For each
ImportEntry Record
of
importEntries
, do
a.
Append
.[[LocalName]] to
localNames
3.
Return
localNames
16.2.1.3
Static Semantics: ModuleRequests
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItem
1.
Return
ModuleRequests
of
ModuleItem
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
moduleNames
be
ModuleRequests
of
ModuleItemList
2.
Let
additionalNames
be
ModuleRequests
of
ModuleItem
3.
Append to
moduleNames
each element of
additionalNames
that is not already an element of
moduleNames
4.
Return
moduleNames
ModuleItem
StatementListItem
1.
Return a new empty
List
ImportDeclaration
import
ImportClause
FromClause
1.
Return
ModuleRequests
of
FromClause
ModuleSpecifier
StringLiteral
1.
Return a
List
whose sole element is the
SV
of
StringLiteral
ExportDeclaration
export
ExportFromClause
FromClause
1.
Return the
ModuleRequests
of
FromClause
ExportDeclaration
export
NamedExports
export
VariableStatement
export
Declaration
export
default
HoistableDeclaration
export
default
ClassDeclaration
export
default
AssignmentExpression
1.
Return a new empty
List
16.2.1.4
Abstract Module Records
Module Record
encapsulates structural
information about the imports and exports of a single module. This
information is used to link the imports and exports of sets of connected
modules. A Module Record includes four fields that are only used when
evaluating a module.
For specification purposes Module Record values are values of the
Record
specification type and can be thought of as existing in a simple
object-oriented hierarchy where Module Record is an abstract class with
both abstract and concrete subclasses. This specification defines the
abstract subclass named
Cyclic Module Record
and its concrete subclass named
Source Text Module Record
Other specifications and implementations may define additional Module
Record subclasses corresponding to alternative module definition
facilities that they defined.
Module Record defines the fields listed in
Table 40
. All Module Definition subclasses include at least those fields. Module Record also defines the abstract method list in
Table 41
. All Module definition subclasses must provide concrete implementations of these abstract methods.
Table 40:
Module Record
Fields
Field Name
Value Type
Meaning
[[Realm]]
Realm Record
undefined
The
Realm
within which this module was created.
undefined
if not yet assigned.
[[Environment]]
module Environment Record
undefined
The
Environment Record
containing the top level bindings for this module. This field is set when the module is linked.
[[Namespace]]
Object |
undefined
The Module Namespace Object (
28.3
) if one has been created for this module. Otherwise
undefined
[[HostDefined]]
Any, default value is
undefined
Field reserved for use by
host
environments that need to associate additional information with a module.
Table 41: Abstract Methods of Module Records
Method
Purpose
GetExportedNames([
exportStarSet
])
Return a list of all names that are either directly or indirectly exported from this module.
ResolveExport(
exportName
[,
resolveSet
])
Return the binding of a name exported by this module. Bindings are represented by a
ResolvedBinding Record
, of the form { [[Module]]:
Module Record
[[BindingName]]: String }. If the export is a Module Namespace Object
without a direct binding in any module, [[BindingName]] will be set to
"*namespace*"
. Return
null
if the name cannot be resolved, or
"ambiguous"
if multiple bindings were found.
Each time this operation is called with a specific
exportName
resolveSet
pair as arguments it must return the same result if it completes normally.
Link()
Prepare the module for evaluation by transitively resolving all module dependencies and creating a
module Environment Record
Evaluate()
If this module has already been evaluated successfully, return
undefined
if it has already been evaluated unsuccessfully, throw the exception
that was produced. Otherwise, transitively evaluate all module
dependencies of this module and then evaluate this module.
Link must have completed successfully prior to invoking this method.
16.2.1.5
Cyclic Module Records
Cyclic Module Record
is used to represent information about a module that can participate in
dependency cycles with other modules that are subclasses of the
Cyclic Module Record
type. Module Records that are not subclasses of the
Cyclic Module Record
type must not participate in dependency cycles with Source Text Module Records.
In addition to the fields defined in
Table 40
Cyclic Module Records have the additional fields listed in
Table 42
Table 42: Additional Fields of Cyclic Module Records
Field Name
Value Type
Meaning
[[Status]]
unlinked
linking
linked
evaluating
evaluated
Initially
unlinked
. Transitions to
linking
linked
evaluating
evaluated
(in that order) as the module progresses throughout its lifecycle.
[[EvaluationError]]
An
abrupt completion
undefined
A completion of type
throw
representing the exception that occurred during evaluation.
undefined
if no exception occurred or if [[Status]] is not
evaluated
[[DFSIndex]]
Integer
undefined
Auxiliary field used during Link and Evaluate only.
If [[Status]] is
linking
or
evaluating
this non-negative number records the point at which the module was
first visited during the ongoing depth-first traversal of the dependency
graph.
[[DFSAncestorIndex]]
Integer
undefined
Auxiliary field used during Link and Evaluate only. If [[Status]] is
linking
or
evaluating
, this is either the module's own [[DFSIndex]] or that of an "earlier" module in the same strongly connected component.
[[RequestedModules]]
List
of String
List
of all the
ModuleSpecifier
strings used by the module represented by this record to request the importation of a module. The
List
is source code occurrence ordered.
In addition to the methods defined in
Table 41
Cyclic Module Records have the additional methods listed in
Table 43
Table 43: Additional Abstract Methods of Cyclic Module Records
Method
Purpose
InitializeEnvironment
()
Initialize the
Environment Record
of the module, including resolving all imported bindings, and create the module's
execution context
ExecuteModule
()
Evaluate the module's code within its
execution context
16.2.1.5.1
Link ( ) Concrete Method
The Link concrete method of a
Cyclic Module Record
module
takes no arguments. On success, Link transitions this module's [[Status]] from
unlinked
to
linked
. On failure, an exception is thrown and this module's [[Status]] remains
unlinked
. (Most of the work is done by the auxiliary function
InnerModuleLinking
.) It performs the following steps when called:
1.
Assert
module
.[[Status]] is not
linking
or
evaluating
2.
Let
stack
be a new empty
List
3.
Let
result
be
InnerModuleLinking
module
stack
, 0).
4.
If
result
is an
abrupt completion
, then
a.
For each
Cyclic Module Record
of
stack
, do
i.
Assert
.[[Status]] is
linking
ii.
Set
.[[Status]] to
unlinked
iii.
Set
.[[Environment]] to
undefined
iv.
Set
.[[DFSIndex]] to
undefined
v.
Set
.[[DFSAncestorIndex]] to
undefined
b.
Assert
module
.[[Status]] is
unlinked
c.
Return
result
5.
Assert
module
.[[Status]] is
linked
or
evaluated
6.
Assert
stack
is empty.
7.
Return
undefined
16.2.1.5.1.1
InnerModuleLinking (
module
stack
index
The abstract operation InnerModuleLinking takes arguments
module
(a
Cyclic Module Record
),
stack
, and
index
(a non-negative
integer
). It is used by Link to perform the actual linking process for
module
, as well as recursively on all other modules in the dependency graph. The
stack
and
index
parameters, as well as a module's [[DFSIndex]] and [[DFSAncestorIndex]]
fields, keep track of the depth-first search (DFS) traversal. In
particular, [[DFSAncestorIndex]] is used to discover strongly connected
components (SCCs), such that all modules in an SCC transition to
linked
together. It performs the following steps when called:
1.
If
module
is not a
Cyclic Module Record
, then
a.
Perform ?
module
.Link().
b.
Return
index
2.
If
module
.[[Status]] is
linking
linked
, or
evaluated
, then
a.
Return
index
3.
Assert
module
.[[Status]] is
unlinked
4.
Set
module
.[[Status]] to
linking
5.
Set
module
.[[DFSIndex]] to
index
6.
Set
module
.[[DFSAncestorIndex]] to
index
7.
Set
index
to
index
+ 1.
8.
Append
module
to
stack
9.
For each String
required
of
module
.[[RequestedModules]], do
a.
Let
requiredModule
be ?
HostResolveImportedModule
module
required
).
b.
Set
index
to ?
InnerModuleLinking
requiredModule
stack
index
).
c.
If
requiredModule
is a
Cyclic Module Record
, then
i.
Assert
requiredModule
.[[Status]] is either
linking
linked
, or
evaluated
ii.
Assert
requiredModule
.[[Status]] is
linking
if and only if
requiredModule
is in
stack
iii.
If
requiredModule
.[[Status]] is
linking
, then
1.
Set
module
.[[DFSAncestorIndex]] to
min
module
.[[DFSAncestorIndex]],
requiredModule
.[[DFSAncestorIndex]]).
10.
Perform ?
module
InitializeEnvironment
().
11.
Assert
module
occurs exactly once in
stack
12.
Assert
module
.[[DFSAncestorIndex]] ≤
module
.[[DFSIndex]].
13.
If
module
.[[DFSAncestorIndex]] =
module
.[[DFSIndex]], then
a.
Let
done
be
false
b.
Repeat, while
done
is
false
i.
Let
requiredModule
be the last element in
stack
ii.
Remove the last element of
stack
iii.
Assert
requiredModule
is a
Cyclic Module Record
iv.
Set
requiredModule
.[[Status]] to
linked
v.
If
requiredModule
and
module
are the same
Module Record
, set
done
to
true
14.
Return
index
16.2.1.5.2
Evaluate ( ) Concrete Method
The Evaluate concrete method of a
Cyclic Module Record
module
takes no arguments. Evaluate transitions this module's [[Status]] from
linked
to
evaluated
If execution results in an exception, that exception is recorded in the
[[EvaluationError]] field and rethrown by future invocations of
Evaluate. (Most of the work is done by the auxiliary function
InnerModuleEvaluation
.) It performs the following steps when called:
1.
Assert
: This call to Evaluate is not happening at the same time as another call to Evaluate within the
surrounding agent
2.
Assert
module
.[[Status]] is
linked
or
evaluated
3.
Let
stack
be a new empty
List
4.
Let
result
be
InnerModuleEvaluation
module
stack
, 0).
5.
If
result
is an
abrupt completion
, then
a.
For each
Cyclic Module Record
of
stack
, do
i.
Assert
.[[Status]] is
evaluating
ii.
Set
.[[Status]] to
evaluated
iii.
Set
.[[EvaluationError]] to
result
b.
Assert
module
.[[Status]] is
evaluated
and
module
.[[EvaluationError]] is
result
c.
Return
result
6.
Assert
module
.[[Status]] is
evaluated
and
module
.[[EvaluationError]] is
undefined
7.
Assert
stack
is empty.
8.
Return
undefined
16.2.1.5.2.1
InnerModuleEvaluation (
module
stack
index
The abstract operation InnerModuleEvaluation takes arguments
module
(a
Module Record
),
stack
, and
index
(a non-negative
integer
). It is used by Evaluate to perform the actual evaluation process for
module
, as well as recursively on all other modules in the dependency graph. The
stack
and
index
parameters, as well as
module
's [[DFSIndex]] and [[DFSAncestorIndex]] fields, are used the same way as in
InnerModuleLinking
. It performs the following steps when called:
1.
If
module
is not a
Cyclic Module Record
, then
a.
Perform ?
module
.Evaluate().
b.
Return
index
2.
If
module
.[[Status]] is
evaluated
, then
a.
If
module
.[[EvaluationError]] is
undefined
, return
index
b.
Otherwise, return
module
.[[EvaluationError]].
3.
If
module
.[[Status]] is
evaluating
, return
index
4.
Assert
module
.[[Status]] is
linked
5.
Set
module
.[[Status]] to
evaluating
6.
Set
module
.[[DFSIndex]] to
index
7.
Set
module
.[[DFSAncestorIndex]] to
index
8.
Set
index
to
index
+ 1.
9.
Append
module
to
stack
10.
For each String
required
of
module
.[[RequestedModules]], do
a.
Let
requiredModule
be !
HostResolveImportedModule
module
required
).
b.
NOTE:
Link must be completed successfully prior to invoking this method, so
every requested module is guaranteed to resolve successfully.
c.
Set
index
to ?
InnerModuleEvaluation
requiredModule
stack
index
).
d.
If
requiredModule
is a
Cyclic Module Record
, then
i.
Assert
requiredModule
.[[Status]] is either
evaluating
or
evaluated
ii.
Assert
requiredModule
.[[Status]] is
evaluating
if and only if
requiredModule
is in
stack
iii.
If
requiredModule
.[[Status]] is
evaluating
, then
1.
Set
module
.[[DFSAncestorIndex]] to
min
module
.[[DFSAncestorIndex]],
requiredModule
.[[DFSAncestorIndex]]).
11.
Perform ?
module
ExecuteModule
().
12.
Assert
module
occurs exactly once in
stack
13.
Assert
module
.[[DFSAncestorIndex]] ≤
module
.[[DFSIndex]].
14.
If
module
.[[DFSAncestorIndex]] =
module
.[[DFSIndex]], then
a.
Let
done
be
false
b.
Repeat, while
done
is
false
i.
Let
requiredModule
be the last element in
stack
ii.
Remove the last element of
stack
iii.
Assert
requiredModule
is a
Cyclic Module Record
iv.
Set
requiredModule
.[[Status]] to
evaluated
v.
If
requiredModule
and
module
are the same
Module Record
, set
done
to
true
15.
Return
index
16.2.1.5.3
Example Cyclic Module Record Graphs
This non-normative section gives a series of examples of
the linking and evaluation of a few common module graphs, with a
specific focus on how errors can occur.
First consider the following simple module graph:
Figure 2: A simple module graph
Let's first assume that there are no error conditions. When a
host
first calls
.Link(), this will complete successfully by assumption, and recursively link modules
and
as well, such that
.[[Status]] =
.[[Status]] =
.[[Status]] =
linked
. This preparatory step can be performed at any time. Later, when the
host
is ready to incur any possible side effects of the modules, it can call
.Evaluate(), which will complete successfully (again by assumption), recursively having evaluated first
and then
. Each module's [[Status]] at this point will be
evaluated
Consider then cases involving linking errors. If
InnerModuleLinking
of
succeeds but, thereafter, fails for
, for example because it imports something that
does not provide, then the original
.Link() will fail, and both
and
's [[Status]] remain
unlinked
's [[Status]] has become
linked
, though.
Finally, consider a case involving evaluation errors. If
InnerModuleEvaluation
of
succeeds but, thereafter, fails for
, for example because
contains code that throws an exception, then the original
.Evaluate() will fail. The resulting exception will be recorded in both
and
's [[EvaluationError]] fields, and their [[Status]] will become
evaluated
will also become
evaluated
but, in contrast to
and
will remain without an [[EvaluationError]], as it successfully
completed evaluation. Storing the exception ensures that any time a
host
tries to reuse
or
by calling their Evaluate() method, it will encounter the same
exception. (Hosts are not required to reuse Cyclic Module Records;
similarly, hosts are not required to expose the exception objects thrown
by these methods. However, the specification enables such uses.)
The difference here between linking and evaluation errors
is due to how evaluation must be only performed once, as it can cause
side effects; it is thus important to remember whether evaluation has
already been performed, even if unsuccessfully. (In the error case, it
makes sense to also remember the exception because otherwise subsequent
Evaluate() calls would have to synthesize a new one.) Linking, on the
other hand, is side-effect-free, and thus even if it fails, it can be
retried at a later time with no issues.
Now consider a different type of error condition:
Figure 3: A module graph with an unresolvable module
In this scenario, module
declares a dependency on some other module, but no
Module Record
exists for that module, i.e.
HostResolveImportedModule
throws an exception when asked for it. This could occur for a variety
of reasons, such as the corresponding resource not existing, or the
resource existing but
ParseModule
throwing an exception when trying to parse the resulting source text.
Hosts can choose to expose the cause of failure via the exception they
throw from
HostResolveImportedModule
. In any case, this exception causes a linking failure, which as before results in
's [[Status]] remaining
unlinked
Lastly, consider a module graph with a cycle:
Figure 4: A cyclic module graph
Here we assume that the entry point is module
, so that the
host
proceeds by calling
.Link(), which performs
InnerModuleLinking
on
. This in turn calls
InnerModuleLinking
on
. Because of the cycle, this again triggers
InnerModuleLinking
on
, but at this point it is a no-op since
.[[Status]] is already
linking
.[[Status]] itself remains
linking
when control gets back to
and
InnerModuleLinking
is triggered on
. After this returns with
.[[Status]] being
linked
, both
and
transition from
linking
to
linked
together; this is by design, since they form a strongly connected component.
An analogous story occurs for the evaluation phase of a cyclic module graph, in the success case.
Now consider a case where
has an linking error; for example, it tries to import a binding from
that does not exist. In that case, the above steps still occur, including the early return from the second call to
InnerModuleLinking
on
. However, once we unwind back to the original
InnerModuleLinking
on
, it fails during
InitializeEnvironment
, namely right after
.ResolveExport(). The thrown
SyntaxError
exception propagates up to
.Link, which resets all modules that are currently on its
stack
(these are always exactly the modules that are still
linking
). Hence both
and
become
unlinked
. Note that
is left as
linked
Finally, consider a case where
has an
evaluation error; for example, its source code throws an exception. In
that case, the evaluation-time analog of the above steps still occurs,
including the early return from the second call to
InnerModuleEvaluation
on
. However, once we unwind back to the original
InnerModuleEvaluation
on
, it fails by assumption. The exception thrown propagates up to
.Evaluate(), which records the error in all modules that are currently on its
stack
(i.e., the modules that are still
evaluating
). Hence both
and
become
evaluated
and the exception is recorded in both
and
's [[EvaluationError]] fields, while
is left as
evaluated
with no [[EvaluationError]].
16.2.1.6
Source Text Module Records
Source Text Module Record
is used to represent information about a module that was defined from ECMAScript source text (
11
) that was parsed using the
goal symbol
Module
Its fields contain digested information about the names that are
imported by the module and its concrete methods use this digest to link,
link, and evaluate the module.
Source Text Module Record
can exist in a module graph with other subclasses of the abstract
Module Record
type, and can participate in cycles with other subclasses of the
Cyclic Module Record
type.
In addition to the fields defined in
Table 42
, Source Text Module Records have the additional fields listed in
Table 44
. Each of these fields is initially set in
ParseModule
Table 44: Additional Fields of Source Text Module Records
Field Name
Value Type
Meaning
[[ECMAScriptCode]]
Parse Node
The result of parsing the source text of this module using
Module
as the
goal symbol
[[Context]]
An ECMAScript
execution context
The
execution context
associated with this module.
[[ImportMeta]]
Object
An object exposed through the
import.meta
meta property. It is
empty
until it is accessed by ECMAScript code.
[[ImportEntries]]
List
of ImportEntry Records
List
of ImportEntry records derived from the code of this module.
[[LocalExportEntries]]
List
of ExportEntry Records
List
of ExportEntry records derived from the code of this module that correspond to declarations that occur within the module.
[[IndirectExportEntries]]
List
of ExportEntry Records
List
of ExportEntry records derived from the code of this module that
correspond to reexported imports that occur within the module or exports
from
export * as namespace
declarations.
[[StarExportEntries]]
List
of ExportEntry Records
List
of ExportEntry records derived from the code of this module that correspond to
export *
declarations that occur within the module, not including
export * as namespace
declarations.
An
ImportEntry Record
is a
Record
that digests information about a single declarative import. Each
ImportEntry Record
has the fields defined in
Table 45
Table 45:
ImportEntry Record
Fields
Field Name
Value Type
Meaning
[[ModuleRequest]]
String
String value of the
ModuleSpecifier
of the
ImportDeclaration
[[ImportName]]
String
The name under which the desired binding is exported by the module identified by [[ModuleRequest]]. The value
"*"
indicates that the import request is for the target module's namespace object.
[[LocalName]]
String
The name that is used to locally access the imported value from within the importing module.
Note 1
Table 46
gives examples of ImportEntry records fields used to represent the syntactic import forms:
Table 46 (Informative): Import Forms Mappings to ImportEntry Records
Import Statement Form
[[ModuleRequest]]
[[ImportName]]
[[LocalName]]
import v from "mod";
"mod"
"default"
"v"
import * as ns from "mod";
"mod"
"*"
"ns"
import {x} from "mod";
"mod"
"x"
"x"
import {x as v} from "mod";
"mod"
"x"
"v"
import "mod";
An
ImportEntry Record
is not created.
An
ExportEntry Record
is a
Record
that digests information about a single declarative export. Each
ExportEntry Record
has the fields defined in
Table 47
Table 47:
ExportEntry Record
Fields
Field Name
Value Type
Meaning
[[ExportName]]
String | null
The name used to export this binding by this module.
[[ModuleRequest]]
String | null
The String value of the
ModuleSpecifier
of the
ExportDeclaration
null
if the
ExportDeclaration
does not have a
ModuleSpecifier
[[ImportName]]
String | null
The name under which the desired binding is exported by the module identified by [[ModuleRequest]].
null
if the
ExportDeclaration
does not have a
ModuleSpecifier
"*"
indicates that the export request is for all exported bindings.
[[LocalName]]
String | null
The name that is used to locally access the exported value from within the importing module.
null
if the exported value is not locally accessible from within the module.
Note 2
Table 48
gives examples of the ExportEntry record fields used to represent the syntactic export forms:
Table 48 (Informative): Export Forms Mappings to ExportEntry Records
Export Statement Form
[[ExportName]]
[[ModuleRequest]]
[[ImportName]]
[[LocalName]]
export var v;
"v"
null
null
"v"
export default function f() {}
"default"
null
null
"f"
export default function () {}
"default"
null
null
"*default*"
export default 42;
"default"
null
null
"*default*"
export {x};
"x"
null
null
"x"
export {v as x};
"x"
null
null
"v"
export {x} from "mod";
"x"
"mod"
"x"
null
export {v as x} from "mod";
"x"
"mod"
"v"
null
export * from "mod";
null
"mod"
"*"
null
export * as ns from "mod";
"ns"
"mod"
"*"
null
The following definitions specify the required concrete methods and other
abstract operations
for Source Text Module Records
16.2.1.6.1
ParseModule (
sourceText
realm
hostDefined
The abstract operation ParseModule takes arguments
sourceText
(ECMAScript source text),
realm
, and
hostDefined
. It creates a
Source Text Module Record
based upon the result of parsing
sourceText
as a
Module
. It performs the following steps when called:
1.
Assert
sourceText
is an ECMAScript source text (see clause
11
).
2.
Let
body
be
ParseText
sourceText
Module
).
3.
If
body
is a
List
of errors, return
body
4.
Let
requestedModules
be the
ModuleRequests
of
body
5.
Let
importEntries
be
ImportEntries
of
body
6.
Let
importedBoundNames
be
ImportedLocalNames
importEntries
).
7.
Let
indirectExportEntries
be a new empty
List
8.
Let
localExportEntries
be a new empty
List
9.
Let
starExportEntries
be a new empty
List
10.
Let
exportEntries
be
ExportEntries
of
body
11.
For each
ExportEntry Record
ee
of
exportEntries
, do
a.
If
ee
.[[ModuleRequest]] is
null
, then
i.
If
ee
.[[LocalName]] is not an element of
importedBoundNames
, then
1.
Append
ee
to
localExportEntries
ii.
Else,
1.
Let
ie
be the element of
importEntries
whose [[LocalName]] is the same as
ee
.[[LocalName]].
2.
If
ie
.[[ImportName]] is
"*"
, then
a.
NOTE: This is a re-export of an imported module namespace object.
b.
Append
ee
to
localExportEntries
3.
Else,
a.
NOTE: This is a re-export of a single name.
b.
Append the
ExportEntry Record
{ [[ModuleRequest]]:
ie
.[[ModuleRequest]], [[ImportName]]:
ie
.[[ImportName]], [[LocalName]]:
null
, [[ExportName]]:
ee
.[[ExportName]] } to
indirectExportEntries
b.
Else if
ee
.[[ImportName]] is
"*"
and
ee
.[[ExportName]] is
null
, then
i.
Append
ee
to
starExportEntries
c.
Else,
i.
Append
ee
to
indirectExportEntries
12.
Return
Source Text Module Record
{ [[Realm]]:
realm
, [[Environment]]:
undefined
, [[Namespace]]:
undefined
, [[Status]]:
unlinked
, [[EvaluationError]]:
undefined
, [[HostDefined]]:
hostDefined
, [[ECMAScriptCode]]:
body
, [[Context]]:
empty
, [[ImportMeta]]:
empty
, [[RequestedModules]]:
requestedModules
, [[ImportEntries]]:
importEntries
, [[LocalExportEntries]]:
localExportEntries
, [[IndirectExportEntries]]:
indirectExportEntries
, [[StarExportEntries]]:
starExportEntries
, [[DFSIndex]]:
undefined
, [[DFSAncestorIndex]]:
undefined
}.
Note
An implementation may parse module source text and
analyse it for Early Error conditions prior to the evaluation of
ParseModule for that module source text. However, the reporting of any
errors must be deferred until the point where this specification
actually performs ParseModule upon that source text.
16.2.1.6.2
GetExportedNames ( [
exportStarSet
] ) Concrete Method
The GetExportedNames concrete method of a
Source Text Module Record
module
takes optional argument
exportStarSet
. It performs the following steps when called:
1.
If
exportStarSet
is not present, set
exportStarSet
to a new empty
List
2.
Assert
exportStarSet
is a
List
of Source Text Module Records.
3.
If
exportStarSet
contains
module
, then
a.
Assert
: We've reached the starting point of an
export *
circularity.
b.
Return a new empty
List
4.
Append
module
to
exportStarSet
5.
Let
exportedNames
be a new empty
List
6.
For each
ExportEntry Record
of
module
.[[LocalExportEntries]], do
a.
Assert
module
provides the direct binding for this export.
b.
Append
.[[ExportName]] to
exportedNames
7.
For each
ExportEntry Record
of
module
.[[IndirectExportEntries]], do
a.
Assert
module
imports a specific binding for this export.
b.
Append
.[[ExportName]] to
exportedNames
8.
For each
ExportEntry Record
of
module
.[[StarExportEntries]], do
a.
Let
requestedModule
be ?
HostResolveImportedModule
module
.[[ModuleRequest]]).
b.
Let
starNames
be ?
requestedModule
.GetExportedNames(
exportStarSet
).
c.
For each element
of
starNames
, do
i.
If
SameValue
"default"
) is
false
, then
1.
If
is not an element of
exportedNames
, then
a.
Append
to
exportedNames
9.
Return
exportedNames
Note
GetExportedNames does not filter out or throw an exception for names that have ambiguous star export bindings.
16.2.1.6.3
ResolveExport (
exportName
[ ,
resolveSet
] ) Concrete Method
The ResolveExport concrete method of a
Source Text Module Record
module
takes argument
exportName
(a String) and optional argument
resolveSet
ResolveExport attempts to resolve an imported binding to
the actual defining module and local binding name. The defining module
may be the module represented by the
Module Record
this method was invoked on or some other module that is imported by that module. The parameter
resolveSet
is used to detect unresolved circular import/export paths. If a pair consisting of specific
Module Record
and
exportName
is reached that is already in
resolveSet
, an import circularity has been encountered. Before recursively calling ResolveExport, a pair consisting of
module
and
exportName
is added to
resolveSet
If a defining module is found, a
ResolvedBinding Record
{ [[Module]], [[BindingName]] } is returned. This record identifies the
resolved binding of the originally requested export, unless this is the
export of a namespace with no local binding. In this case,
[[BindingName]] will be set to
"*namespace*"
. If no definition was found or the request is found to be circular,
null
is returned. If the request is found to be ambiguous, the string
"ambiguous"
is returned.
This concrete method performs the following steps when called:
1.
If
resolveSet
is not present, set
resolveSet
to a new empty
List
2.
Assert
resolveSet
is a
List
of
Record
{ [[Module]], [[ExportName]] }.
3.
For each
Record
{ [[Module]], [[ExportName]] }
of
resolveSet
, do
a.
If
module
and
.[[Module]] are the same
Module Record
and
SameValue
exportName
.[[ExportName]]) is
true
, then
i.
Assert
: This is a circular import request.
ii.
Return
null
4.
Append the
Record
{ [[Module]]:
module
, [[ExportName]]:
exportName
} to
resolveSet
5.
For each
ExportEntry Record
of
module
.[[LocalExportEntries]], do
a.
If
SameValue
exportName
.[[ExportName]]) is
true
, then
i.
Assert
module
provides the direct binding for this export.
ii.
Return
ResolvedBinding Record
{ [[Module]]:
module
, [[BindingName]]:
.[[LocalName]] }.
6.
For each
ExportEntry Record
of
module
.[[IndirectExportEntries]], do
a.
If
SameValue
exportName
.[[ExportName]]) is
true
, then
i.
Let
importedModule
be ?
HostResolveImportedModule
module
.[[ModuleRequest]]).
ii.
If
.[[ImportName]] is
"*"
, then
1.
Assert
module
does not provide the direct binding for this export.
2.
Return
ResolvedBinding Record
{ [[Module]]:
importedModule
, [[BindingName]]:
"*namespace*"
}.
iii.
Else,
1.
Assert
module
imports a specific binding for this export.
2.
Return
importedModule
.ResolveExport(
.[[ImportName]],
resolveSet
).
7.
If
SameValue
exportName
"default"
) is
true
, then
a.
Assert
: A
default
export was not explicitly defined by this module.
b.
Return
null
c.
NOTE: A
default
export cannot be provided by an
export *
or
export * from "mod"
declaration.
8.
Let
starResolution
be
null
9.
For each
ExportEntry Record
of
module
.[[StarExportEntries]], do
a.
Let
importedModule
be ?
HostResolveImportedModule
module
.[[ModuleRequest]]).
b.
Let
resolution
be ?
importedModule
.ResolveExport(
exportName
resolveSet
).
c.
If
resolution
is
"ambiguous"
, return
"ambiguous"
d.
If
resolution
is not
null
, then
i.
Assert
resolution
is a
ResolvedBinding Record
ii.
If
starResolution
is
null
, set
starResolution
to
resolution
iii.
Else,
1.
Assert
: There is more than one
import that includes the requested name.
2.
If
resolution
.[[Module]] and
starResolution
.[[Module]] are not the same
Module Record
or
SameValue
resolution
.[[BindingName]],
starResolution
.[[BindingName]]) is
false
, return
"ambiguous"
10.
Return
starResolution
16.2.1.6.4
InitializeEnvironment ( ) Concrete Method
The InitializeEnvironment concrete method of a
Source Text Module Record
module
takes no arguments. It performs the following steps when called:
1.
For each
ExportEntry Record
of
module
.[[IndirectExportEntries]], do
a.
Let
resolution
be ?
module
.ResolveExport(
.[[ExportName]]).
b.
If
resolution
is
null
or
"ambiguous"
, throw a
SyntaxError
exception.
c.
Assert
resolution
is a
ResolvedBinding Record
2.
Assert
: All named exports from
module
are resolvable.
3.
Let
realm
be
module
.[[Realm]].
4.
Assert
realm
is not
undefined
5.
Let
env
be
NewModuleEnvironment
realm
.[[GlobalEnv]]).
6.
Set
module
.[[Environment]] to
env
7.
For each
ImportEntry Record
in
of
module
.[[ImportEntries]], do
a.
Let
importedModule
be !
HostResolveImportedModule
module
in
.[[ModuleRequest]]).
b.
NOTE: The above call cannot fail because imported module requests are a subset of
module
.[[RequestedModules]], and these have been resolved earlier in this algorithm.
c.
If
in
.[[ImportName]] is
"*"
, then
i.
Let
namespace
be ?
GetModuleNamespace
importedModule
).
ii.
Perform !
env
.CreateImmutableBinding(
in
.[[LocalName]],
true
).
iii.
Call
env
.InitializeBinding(
in
.[[LocalName]],
namespace
).
d.
Else,
i.
Let
resolution
be ?
importedModule
.ResolveExport(
in
.[[ImportName]]).
ii.
If
resolution
is
null
or
"ambiguous"
, throw a
SyntaxError
exception.
iii.
If
resolution
.[[BindingName]] is
"*namespace*"
, then
1.
Let
namespace
be ?
GetModuleNamespace
resolution
.[[Module]]).
2.
Perform !
env
.CreateImmutableBinding(
in
.[[LocalName]],
true
).
3.
Call
env
.InitializeBinding(
in
.[[LocalName]],
namespace
).
iv.
Else,
1.
Call
env
.CreateImportBinding(
in
.[[LocalName]],
resolution
.[[Module]],
resolution
.[[BindingName]]).
8.
Let
moduleContext
be a new ECMAScript code
execution context
9.
Set the Function of
moduleContext
to
null
10.
Assert
module
.[[Realm]] is not
undefined
11.
Set the
Realm
of
moduleContext
to
module
.[[Realm]].
12.
Set the ScriptOrModule of
moduleContext
to
module
13.
Set the VariableEnvironment of
moduleContext
to
module
.[[Environment]].
14.
Set the LexicalEnvironment of
moduleContext
to
module
.[[Environment]].
15.
Set
module
.[[Context]] to
moduleContext
16.
Push
moduleContext
onto the
execution context stack
moduleContext
is now the
running execution context
17.
Let
code
be
module
.[[ECMAScriptCode]].
18.
Let
varDeclarations
be the
VarScopedDeclarations
of
code
19.
Let
declaredVarNames
be a new empty
List
20.
For each element
of
varDeclarations
, do
a.
For each element
dn
of the
BoundNames
of
, do
i.
If
dn
is not an element of
declaredVarNames
, then
1.
Perform !
env
.CreateMutableBinding(
dn
false
).
2.
Call
env
.InitializeBinding(
dn
undefined
).
3.
Append
dn
to
declaredVarNames
21.
Let
lexDeclarations
be the
LexicallyScopedDeclarations
of
code
22.
For each element
of
lexDeclarations
, do
a.
For each element
dn
of the
BoundNames
of
, do
i.
If
IsConstantDeclaration
of
is
true
, then
1.
Perform !
env
.CreateImmutableBinding(
dn
true
).
ii.
Else,
1.
Perform !
env
.CreateMutableBinding(
dn
false
).
iii.
If
is a
FunctionDeclaration
, a
GeneratorDeclaration
, an
AsyncFunctionDeclaration
, or an
AsyncGeneratorDeclaration
, then
1.
Let
fo
be
InstantiateFunctionObject
of
with argument
env
2.
Call
env
.InitializeBinding(
dn
fo
).
23.
Remove
moduleContext
from the
execution context stack
24.
Return
NormalCompletion
empty
).
16.2.1.6.5
ExecuteModule ( ) Concrete Method
The ExecuteModule concrete method of a
Source Text Module Record
module
takes no arguments. It performs the following steps when called:
1.
Suspend
the currently
running execution context
2.
Let
moduleContext
be
module
.[[Context]].
3.
Push
moduleContext
onto the
execution context stack
moduleContext
is now the
running execution context
4.
Let
result
be the result of evaluating
module
.[[ECMAScriptCode]].
5.
Suspend
moduleContext
and remove it from the
execution context stack
6.
Resume the context that is now on the top of the
execution context stack
as the
running execution context
7.
Return
Completion
result
).
16.2.1.7
HostResolveImportedModule (
referencingScriptOrModule
specifier
The
host-defined
abstract operation HostResolveImportedModule takes arguments
referencingScriptOrModule
(a
Script Record
or
Module Record
or
null
) and
specifier
(a
ModuleSpecifier
String). It provides the concrete
Module Record
subclass instance that corresponds to
specifier
occurring within the context of the script or module represented by
referencingScriptOrModule
referencingScriptOrModule
may be
null
if the resolution is being performed in the context of an
import()
expression and there is no
active script or module
at that time.
Note
An example of when
referencingScriptOrModule
can be
null
is in a web browser
host
. There, if a user clicks on a control given by
button
type
"button"
onclick
"import('./foo.mjs')"
Click me
button
there will be no
active script or module
at the time the
import()
expression runs. More generally, this can happen in any situation where the
host
pushes execution contexts with
null
ScriptOrModule components onto the
execution context stack
The implementation of HostResolveImportedModule must conform to the following requirements:
The normal return value must be an instance of a concrete subclass of
Module Record
If a
Module Record
corresponding to the pair
referencingScriptOrModule
specifier
does not exist or cannot be created, an exception must be thrown.
Each time this operation is called with a specific
referencingScriptOrModule
specifier
pair as arguments it must return the same
Module Record
instance if it completes normally.
Multiple different
referencingScriptOrModule
specifier
pairs may map to the same
Module Record
instance. The actual mapping semantic is
host-defined
but typically a normalization process is applied to
specifier
as part of the mapping process. A typical normalization process would
include actions such as alphabetic case folding and expansion of
relative and abbreviated path specifiers.
16.2.1.8
HostImportModuleDynamically (
referencingScriptOrModule
specifier
promiseCapability
The
host-defined
abstract operation HostImportModuleDynamically takes arguments
referencingScriptOrModule
(a
Script Record
or
Module Record
or
null
),
specifier
(a
ModuleSpecifier
String), and
promiseCapability
(a
PromiseCapability Record
). It performs any necessary setup work in order to make available the module corresponding to
specifier
occurring within the context of the script or module represented by
referencingScriptOrModule
referencingScriptOrModule
may be
null
if there is no
active script or module
when the
import()
expression occurs. It then performs
FinishDynamicImport
to finish the dynamic import process.
The implementation of HostImportModuleDynamically must conform to the following requirements:
The abstract operation must always complete normally with
undefined
. Success or failure must instead be signaled as discussed below.
The
host environment
must conform to one of the two following sets of requirements:
Success path
At some future time, the
host environment
must perform
FinishDynamicImport
referencingScriptOrModule
specifier
promiseCapability
NormalCompletion
undefined
)).
Any subsequent call to
HostResolveImportedModule
after
FinishDynamicImport
has completed, given the arguments
referencingScriptOrModule
and
specifier
, must complete normally.
The completion value of any subsequent call to
HostResolveImportedModule
after
FinishDynamicImport
has completed, given the arguments
referencingScriptOrModule
and
specifier
must be a module which has already been evaluated, i.e. whose Evaluate
concrete method has already been called and returned a normal
completion.
Failure path
At some future time, the
host environment
must perform
FinishDynamicImport
referencingScriptOrModule
specifier
promiseCapability
, an
abrupt completion
), with the
abrupt completion
representing the cause of failure.
If the
host environment
takes the success path once for a given
referencingScriptOrModule
specifier
pair, it must always do so for subsequent calls.
The operation must not call
promiseCapability
.[[Resolve]] or
promiseCapability
.[[Reject]], but instead must treat
promiseCapability
as an opaque identifying value to be passed through to
FinishDynamicImport
The actual process performed is
host-defined
, but typically consists of performing whatever I/O operations are necessary to allow
HostResolveImportedModule
to synchronously retrieve the appropriate
Module Record
, and then calling its Evaluate concrete method. This might require performing similar normalization as
HostResolveImportedModule
does.
16.2.1.9
FinishDynamicImport (
referencingScriptOrModule
specifier
promiseCapability
completion
The abstract operation FinishDynamicImport takes arguments
referencingScriptOrModule
specifier
promiseCapability
(a
PromiseCapability Record
), and
completion
. FinishDynamicImport completes the process of a dynamic import originally started by an
import()
call, resolving or rejecting the promise returned by that call as appropriate according to
completion
. It is performed by
host
environments as part of
HostImportModuleDynamically
. It performs the following steps when called:
1.
If
completion
is an
abrupt completion
, perform !
Call
promiseCapability
.[[Reject]],
undefined
, «
completion
.[[Value]] »).
2.
Else,
a.
Assert
completion
is a normal completion and
completion
.[[Value]] is
undefined
b.
Let
moduleRecord
be !
HostResolveImportedModule
referencingScriptOrModule
specifier
).
c.
Assert
: Evaluate has already been invoked on
moduleRecord
and successfully completed.
d.
Let
namespace
be
GetModuleNamespace
moduleRecord
).
e.
If
namespace
is an
abrupt completion
, perform !
Call
promiseCapability
.[[Reject]],
undefined
, «
namespace
.[[Value]] »).
f.
Else, perform !
Call
promiseCapability
.[[Resolve]],
undefined
, «
namespace
.[[Value]] »).
16.2.1.10
GetModuleNamespace (
module
The abstract operation GetModuleNamespace takes argument
module
. It retrieves the Module Namespace Object representing
module
's exports, lazily creating it the first time it was requested, and storing it in
module
.[[Namespace]] for future retrieval. It performs the following steps when called:
1.
Assert
module
is an instance of a concrete subclass of
Module Record
2.
Assert
: If
module
is a
Cyclic Module Record
, then
module
.[[Status]] is not
unlinked
3.
Let
namespace
be
module
.[[Namespace]].
4.
If
namespace
is
undefined
, then
a.
Let
exportedNames
be ?
module
.GetExportedNames().
b.
Let
unambiguousNames
be a new empty
List
c.
For each element
name
of
exportedNames
, do
i.
Let
resolution
be ?
module
.ResolveExport(
name
).
ii.
If
resolution
is a
ResolvedBinding Record
, append
name
to
unambiguousNames
d.
Set
namespace
to
ModuleNamespaceCreate
module
unambiguousNames
).
5.
Return
namespace
Note
The only way GetModuleNamespace can throw is via one of the triggered
HostResolveImportedModule
calls. Unresolvable names are simply excluded from the namespace at
this point. They will lead to a real linking error later unless they are
all ambiguous star exports that are not explicitly requested anywhere.
16.2.1.11
Runtime Semantics: Evaluation
Module
[empty]
1.
Return
NormalCompletion
undefined
).
ModuleBody
ModuleItemList
1.
Let
result
be the result of evaluating
ModuleItemList
2.
If
result
.[[Type]] is
normal
and
result
.[[Value]] is
empty
, then
a.
Return
NormalCompletion
undefined
).
3.
Return
Completion
result
).
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
sl
be the result of evaluating
ModuleItemList
2.
ReturnIfAbrupt
sl
).
3.
Let
be the result of evaluating
ModuleItem
4.
Return
Completion
UpdateEmpty
sl
)).
Note
The value of a
ModuleItemList
is the value of the last value-producing item in the
ModuleItemList
ModuleItem
ImportDeclaration
1.
Return
NormalCompletion
empty
).
16.2.2
Imports
Syntax
ImportDeclaration
import
ImportClause
FromClause
import
ModuleSpecifier
ImportClause
ImportedDefaultBinding
NameSpaceImport
NamedImports
ImportedDefaultBinding
NameSpaceImport
ImportedDefaultBinding
NamedImports
ImportedDefaultBinding
ImportedBinding
NameSpaceImport
as
ImportedBinding
NamedImports
ImportsList
ImportsList
FromClause
from
ModuleSpecifier
ImportsList
ImportSpecifier
ImportsList
ImportSpecifier
ImportSpecifier
ImportedBinding
IdentifierName
as
ImportedBinding
ModuleSpecifier
StringLiteral
ImportedBinding
BindingIdentifier
[~Yield, ~Await]
16.2.2.1
Static Semantics: Early Errors
ModuleItem
ImportDeclaration
It is a Syntax Error if the
BoundNames
of
ImportDeclaration
contains any duplicate entries.
16.2.2.2
Static Semantics: ImportEntries
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
entries
be
ImportEntries
of
ModuleItemList
2.
Append to
entries
the elements of the
ImportEntries
of
ModuleItem
3.
Return
entries
ModuleItem
ExportDeclaration
StatementListItem
1.
Return a new empty
List
ImportDeclaration
import
ImportClause
FromClause
1.
Let
module
be the sole element of
ModuleRequests
of
FromClause
2.
Return
ImportEntriesForModule
of
ImportClause
with argument
module
ImportDeclaration
import
ModuleSpecifier
1.
Return a new empty
List
16.2.2.3
Static Semantics: ImportEntriesForModule
With parameter
module
ImportClause
ImportedDefaultBinding
NameSpaceImport
1.
Let
entries
be
ImportEntriesForModule
of
ImportedDefaultBinding
with argument
module
2.
Append to
entries
the elements of the
ImportEntriesForModule
of
NameSpaceImport
with argument
module
3.
Return
entries
ImportClause
ImportedDefaultBinding
NamedImports
1.
Let
entries
be
ImportEntriesForModule
of
ImportedDefaultBinding
with argument
module
2.
Append to
entries
the elements of the
ImportEntriesForModule
of
NamedImports
with argument
module
3.
Return
entries
ImportedDefaultBinding
ImportedBinding
1.
Let
localName
be the sole element of
BoundNames
of
ImportedBinding
2.
Let
defaultEntry
be the
ImportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
"default"
, [[LocalName]]:
localName
}.
3.
Return a
List
whose sole element is
defaultEntry
NameSpaceImport
as
ImportedBinding
1.
Let
localName
be the
StringValue
of
ImportedBinding
2.
Let
entry
be the
ImportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
"*"
, [[LocalName]]:
localName
}.
3.
Return a
List
whose sole element is
entry
NamedImports
1.
Return a new empty
List
ImportsList
ImportsList
ImportSpecifier
1.
Let
specs
be the
ImportEntriesForModule
of
ImportsList
with argument
module
2.
Append to
specs
the elements of the
ImportEntriesForModule
of
ImportSpecifier
with argument
module
3.
Return
specs
ImportSpecifier
ImportedBinding
1.
Let
localName
be the sole element of
BoundNames
of
ImportedBinding
2.
Let
entry
be the
ImportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
localName
, [[LocalName]]:
localName
}.
3.
Return a
List
whose sole element is
entry
ImportSpecifier
IdentifierName
as
ImportedBinding
1.
Let
importName
be the
StringValue
of
IdentifierName
2.
Let
localName
be the
StringValue
of
ImportedBinding
3.
Let
entry
be the
ImportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
importName
, [[LocalName]]:
localName
}.
4.
Return a
List
whose sole element is
entry
16.2.3
Exports
Syntax
ExportDeclaration
export
ExportFromClause
FromClause
export
NamedExports
export
VariableStatement
[~Yield, ~Await]
export
Declaration
[~Yield, ~Await]
export
default
HoistableDeclaration
[~Yield, ~Await, +Default]
export
default
ClassDeclaration
[~Yield, ~Await, +Default]
export
default
[lookahead ∉ {
function
async
[no
LineTerminator
here]
function
class
}]
AssignmentExpression
[+In, ~Yield, ~Await]
ExportFromClause
as
IdentifierName
NamedExports
NamedExports
ExportsList
ExportsList
ExportsList
ExportSpecifier
ExportsList
ExportSpecifier
ExportSpecifier
IdentifierName
IdentifierName
as
IdentifierName
16.2.3.1
Static Semantics: Early Errors
ExportDeclaration
export
NamedExports
For each
IdentifierName
in
ReferencedBindings
of
NamedExports
: It is a Syntax Error if
StringValue
of
is a
ReservedWord
or if the
StringValue
of
is one of:
"implements"
"interface"
"let"
"package"
"private"
"protected"
"public"
, or
"static"
Note
The above rule means that each
ReferencedBindings
of
NamedExports
is treated as an
IdentifierReference
16.2.3.2
Static Semantics: ExportedBindings
Note
ExportedBindings are the locally bound names that are explicitly associated with a
Module
's
ExportedNames
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
names
be
ExportedBindings
of
ModuleItemList
2.
Append to
names
the elements of the
ExportedBindings
of
ModuleItem
3.
Return
names
ModuleItem
ImportDeclaration
StatementListItem
1.
Return a new empty
List
ExportDeclaration
export
ExportFromClause
FromClause
1.
Return a new empty
List
ExportDeclaration
export
NamedExports
1.
Return the
ExportedBindings
of
NamedExports
ExportDeclaration
export
VariableStatement
1.
Return the
BoundNames
of
VariableStatement
ExportDeclaration
export
Declaration
1.
Return the
BoundNames
of
Declaration
ExportDeclaration
export
default
HoistableDeclaration
export
default
ClassDeclaration
export
default
AssignmentExpression
1.
Return the
BoundNames
of this
ExportDeclaration
NamedExports
1.
Return a new empty
List
ExportsList
ExportsList
ExportSpecifier
1.
Let
names
be the
ExportedBindings
of
ExportsList
2.
Append to
names
the elements of the
ExportedBindings
of
ExportSpecifier
3.
Return
names
ExportSpecifier
IdentifierName
1.
Return a
List
whose sole element is the
StringValue
of
IdentifierName
ExportSpecifier
IdentifierName
as
IdentifierName
1.
Return a
List
whose sole element is the
StringValue
of the first
IdentifierName
16.2.3.3
Static Semantics: ExportedNames
Note
ExportedNames are the externally visible names that a
Module
explicitly maps to one of its local name bindings.
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
names
be
ExportedNames
of
ModuleItemList
2.
Append to
names
the elements of the
ExportedNames
of
ModuleItem
3.
Return
names
ModuleItem
ExportDeclaration
1.
Return the
ExportedNames
of
ExportDeclaration
ModuleItem
ImportDeclaration
StatementListItem
1.
Return a new empty
List
ExportDeclaration
export
ExportFromClause
FromClause
1.
Return the
ExportedNames
of
ExportFromClause
ExportFromClause
1.
Return a new empty
List
ExportFromClause
as
IdentifierName
1.
Return a
List
whose sole element is the
StringValue
of
IdentifierName
ExportFromClause
NamedExports
1.
Return the
ExportedNames
of
NamedExports
ExportDeclaration
export
VariableStatement
1.
Return the
BoundNames
of
VariableStatement
ExportDeclaration
export
Declaration
1.
Return the
BoundNames
of
Declaration
ExportDeclaration
export
default
HoistableDeclaration
export
default
ClassDeclaration
export
default
AssignmentExpression
1.
Return «
"default"
».
NamedExports
1.
Return a new empty
List
ExportsList
ExportsList
ExportSpecifier
1.
Let
names
be the
ExportedNames
of
ExportsList
2.
Append to
names
the elements of the
ExportedNames
of
ExportSpecifier
3.
Return
names
ExportSpecifier
IdentifierName
1.
Return a
List
whose sole element is the
StringValue
of
IdentifierName
ExportSpecifier
IdentifierName
as
IdentifierName
1.
Return a
List
whose sole element is the
StringValue
of the second
IdentifierName
16.2.3.4
Static Semantics: ExportEntries
Module
[empty]
1.
Return a new empty
List
ModuleItemList
ModuleItemList
ModuleItem
1.
Let
entries
be
ExportEntries
of
ModuleItemList
2.
Append to
entries
the elements of the
ExportEntries
of
ModuleItem
3.
Return
entries
ModuleItem
ImportDeclaration
StatementListItem
1.
Return a new empty
List
ExportDeclaration
export
ExportFromClause
FromClause
1.
Let
module
be the sole element of
ModuleRequests
of
FromClause
2.
Return
ExportEntriesForModule
of
ExportFromClause
with argument
module
ExportDeclaration
export
NamedExports
1.
Return
ExportEntriesForModule
of
NamedExports
with argument
null
ExportDeclaration
export
VariableStatement
1.
Let
entries
be a new empty
List
2.
Let
names
be the
BoundNames
of
VariableStatement
3.
For each element
name
of
names
, do
a.
Append the
ExportEntry Record
{ [[ModuleRequest]]:
null
, [[ImportName]]:
null
, [[LocalName]]:
name
, [[ExportName]]:
name
} to
entries
4.
Return
entries
ExportDeclaration
export
Declaration
1.
Let
entries
be a new empty
List
2.
Let
names
be the
BoundNames
of
Declaration
3.
For each element
name
of
names
, do
a.
Append the
ExportEntry Record
{ [[ModuleRequest]]:
null
, [[ImportName]]:
null
, [[LocalName]]:
name
, [[ExportName]]:
name
} to
entries
4.
Return
entries
ExportDeclaration
export
default
HoistableDeclaration
1.
Let
names
be
BoundNames
of
HoistableDeclaration
2.
Let
localName
be the sole element of
names
3.
Return a
List
whose sole element is the
ExportEntry Record
{ [[ModuleRequest]]:
null
, [[ImportName]]:
null
, [[LocalName]]:
localName
, [[ExportName]]:
"default"
}.
ExportDeclaration
export
default
ClassDeclaration
1.
Let
names
be
BoundNames
of
ClassDeclaration
2.
Let
localName
be the sole element of
names
3.
Return a
List
whose sole element is the
ExportEntry Record
{ [[ModuleRequest]]:
null
, [[ImportName]]:
null
, [[LocalName]]:
localName
, [[ExportName]]:
"default"
}.
ExportDeclaration
export
default
AssignmentExpression
1.
Let
entry
be the
ExportEntry Record
{ [[ModuleRequest]]:
null
, [[ImportName]]:
null
, [[LocalName]]:
"*default*"
, [[ExportName]]:
"default"
}.
2.
Return a
List
whose sole element is
entry
Note
"*default*"
is used within this specification as a synthetic name for anonymous default export values.
16.2.3.5
Static Semantics: ExportEntriesForModule
With parameter
module
ExportFromClause
1.
Let
entry
be the
ExportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
"*"
, [[LocalName]]:
null
, [[ExportName]]:
null
}.
2.
Return a
List
whose sole element is
entry
ExportFromClause
as
IdentifierName
1.
Let
exportName
be the
StringValue
of
IdentifierName
2.
Let
entry
be the
ExportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
"*"
, [[LocalName]]:
null
, [[ExportName]]:
exportName
}.
3.
Return a
List
whose sole element is
entry
NamedExports
1.
Return a new empty
List
ExportsList
ExportsList
ExportSpecifier
1.
Let
specs
be the
ExportEntriesForModule
of
ExportsList
with argument
module
2.
Append to
specs
the elements of the
ExportEntriesForModule
of
ExportSpecifier
with argument
module
3.
Return
specs
ExportSpecifier
IdentifierName
1.
Let
sourceName
be the
StringValue
of
IdentifierName
2.
If
module
is
null
, then
a.
Let
localName
be
sourceName
b.
Let
importName
be
null
3.
Else,
a.
Let
localName
be
null
b.
Let
importName
be
sourceName
4.
Return a
List
whose sole element is the
ExportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
importName
, [[LocalName]]:
localName
, [[ExportName]]:
sourceName
}.
ExportSpecifier
IdentifierName
as
IdentifierName
1.
Let
sourceName
be the
StringValue
of the first
IdentifierName
2.
Let
exportName
be the
StringValue
of the second
IdentifierName
3.
If
module
is
null
, then
a.
Let
localName
be
sourceName
b.
Let
importName
be
null
4.
Else,
a.
Let
localName
be
null
b.
Let
importName
be
sourceName
5.
Return a
List
whose sole element is the
ExportEntry Record
{ [[ModuleRequest]]:
module
, [[ImportName]]:
importName
, [[LocalName]]:
localName
, [[ExportName]]:
exportName
}.
16.2.3.6
Static Semantics: ReferencedBindings
NamedExports
1.
Return a new empty
List
ExportsList
ExportsList
ExportSpecifier
1.
Let
names
be the
ReferencedBindings
of
ExportsList
2.
Append to
names
the elements of the
ReferencedBindings
of
ExportSpecifier
3.
Return
names
ExportSpecifier
IdentifierName
1.
Return a
List
whose sole element is the
IdentifierName
ExportSpecifier
IdentifierName
as
IdentifierName
1.
Return a
List
whose sole element is the first
IdentifierName
16.2.3.7
Runtime Semantics: Evaluation
ExportDeclaration
export
ExportFromClause
FromClause
export
NamedExports
1.
Return
NormalCompletion
empty
).
ExportDeclaration
export
VariableStatement
1.
Return the result of evaluating
VariableStatement
ExportDeclaration
export
Declaration
1.
Return the result of evaluating
Declaration
ExportDeclaration
export
default
HoistableDeclaration
1.
Return the result of evaluating
HoistableDeclaration
ExportDeclaration
export
default
ClassDeclaration
1.
Let
value
be ?
BindingClassDeclarationEvaluation
of
ClassDeclaration
2.
Let
className
be the sole element of
BoundNames
of
ClassDeclaration
3.
If
className
is
"*default*"
, then
a.
Let
env
be the
running execution context
's LexicalEnvironment.
b.
Perform ?
InitializeBoundName
"*default*"
value
env
).
4.
Return
NormalCompletion
empty
).
ExportDeclaration
export
default
AssignmentExpression
1.
If
IsAnonymousFunctionDefinition
AssignmentExpression
) is
true
, then
a.
Let
value
be ?
NamedEvaluation
of
AssignmentExpression
with argument
"default"
2.
Else,
a.
Let
rhs
be the result of evaluating
AssignmentExpression
b.
Let
value
be ?
GetValue
rhs
).
3.
Let
env
be the
running execution context
's LexicalEnvironment.
4.
Perform ?
InitializeBoundName
"*default*"
value
env
).
5.
Return
NormalCompletion
empty
).
17
Error Handling and Language Extensions
An implementation must report most errors at the time the relevant ECMAScript language construct is evaluated. An
early error
is an error that can be detected and reported prior to the evaluation of any construct in the
Script
containing the error. The presence of an
early error
prevents the evaluation of the construct. An implementation must report early errors in a
Script
as part of parsing that
Script
in
ParseScript
. Early errors in a
Module
are reported at the point when the
Module
would be evaluated and the
Module
is never initialized. Early errors in
eval
code are reported at the time
eval
is called and prevent evaluation of the
eval
code. All errors that are not early errors are runtime errors.
An implementation must report as an
early error
any occurrence of a condition that is listed in a “Static Semantics: Early Errors” subclause of this specification.
An implementation shall not treat other kinds of errors as early
errors even if the compiler can prove that a construct cannot execute
without error under any circumstances. An implementation may issue an
early warning in such a case, but it should not report the error until
the relevant construct is actually executed.
An implementation shall report all errors as specified, except for the following:
Except as restricted in
17.1
, a
host
or implementation may extend
Script
syntax,
Module
syntax, and regular expression pattern or flag syntax. To permit this, all operations (such as calling
eval
, using a regular expression literal, or using the Function or RegExp
constructor
) that are allowed to throw
SyntaxError
are permitted to exhibit
host-defined
behaviour instead of throwing
SyntaxError
when they encounter a
host-defined
extension to the script syntax or regular expression pattern or flag syntax.
Except as restricted in
17.1
, a
host
or implementation may provide additional types, values, objects,
properties, and functions beyond those described in this specification.
This may cause constructs (such as looking up a variable in the global
scope) to have
host-defined
behaviour instead of throwing an error (such as
ReferenceError
).
17.1
Forbidden Extensions
An implementation must not extend this specification in the following ways:
ECMAScript function objects defined using syntactic constructors in
strict mode code
must not be created with own properties named
"caller"
or
"arguments"
. Such own properties also must not be created for function objects defined using an
ArrowFunction
MethodDefinition
GeneratorDeclaration
GeneratorExpression
AsyncGeneratorDeclaration
AsyncGeneratorExpression
ClassDeclaration
ClassExpression
AsyncFunctionDeclaration
AsyncFunctionExpression
, or
AsyncArrowFunction
regardless of whether the definition is contained in
strict mode code
. Built-in functions, strict functions created using the Function
constructor
, generator functions created using the Generator
constructor
, async functions created using the AsyncFunction
constructor
, and functions created using the
bind
method also must not be created with such own properties.
If an implementation extends any
function object
with an own property named
"caller"
the value of that property, as observed using [[Get]] or [[GetOwnProperty]], must not be a
strict function
object. If it is an
accessor property
, the function that is the value of the property's [[Get]] attribute must never return a
strict function
when called.
Neither mapped nor unmapped arguments objects may be created with an own property named
"caller"
The behaviour of built-in methods which are specified in ECMA-402, such as those named
toLocaleString
, must not be extended except as specified in ECMA-402.
The RegExp pattern grammars in
22.2.1
and
B.1.4
must not be extended to recognize any of the source characters A-Z or a-z as
IdentityEscape
[+U]
when the
[U]
grammar parameter is present.
The Syntactic Grammar must not be extended in any manner that allows the token
to immediately follow source text that matches the
BindingIdentifier
nonterminal symbol.
When processing
strict mode code
, the syntax of
NumericLiteral
must not be extended to include
LegacyOctalIntegerLiteral
and the syntax of
DecimalIntegerLiteral
must not be extended to include
NonOctalDecimalIntegerLiteral
as described in
B.1.1
TemplateCharacter
must not be extended to include
LegacyOctalEscapeSequence
or
NonOctalDecimalEscapeSequence
as defined in
B.1.2
When processing
strict mode code
, the extensions defined in
B.3.2
B.3.3
B.3.4
, and
B.3.6
must not be supported.
When parsing for the
Module
goal symbol
, the lexical grammar extensions defined in
B.1.3
must not be supported.
ImportCall
must not be extended.
18
ECMAScript Standard Built-in Objects
There are certain built-in objects available whenever an ECMAScript
Script
or
Module
begins execution. One, the
global object
, is part of the
global environment
of the executing program. Others are accessible as initial properties of the
global object
or indirectly as properties of accessible built-in objects.
Unless specified otherwise, a built-in object that is callable as a function is a built-in
function object
with the characteristics described in
10.3
. Unless specified otherwise, the [[Extensible]] internal slot of a built-in object initially has the value
true
. Every built-in
function object
has a [[Realm]] internal slot whose value is the
Realm Record
of the
realm
for which the object was initially created.
Many built-in objects are functions: they can be invoked with
arguments. Some of them furthermore are constructors: they are functions
intended for use with the
new
operator. For each built-in
function, this specification describes the arguments required by that
function and the properties of that
function object
. For each built-in
constructor
, this specification furthermore describes properties of the prototype object of that
constructor
and properties of specific object instances returned by a
new
expression that invokes that
constructor
Unless otherwise specified in the description of a particular function, if a built-in function or
constructor
is given fewer arguments than the function is specified to require, the function or
constructor
shall behave exactly as if it had been given sufficient additional arguments, each such argument being the
undefined
value. Such missing arguments are considered to be “not present” and
may be identified in that manner by specification algorithms. In the
description of a particular function, the terms “
this
value” and “NewTarget” have the meanings given in
10.3
Unless otherwise specified in the description of a particular function, if a built-in function or
constructor
described is given more arguments than the function is specified to
allow, the extra arguments are evaluated by the call and then ignored by
the function. However, an implementation may define implementation
specific behaviour relating to such arguments as long as the behaviour
is not the throwing of a
TypeError
exception that is predicated simply on the presence of an extra argument.
Note 1
Implementations that add additional capabilities to the set of
built-in functions are encouraged to do so by adding new functions
rather than adding new parameters to existing functions.
Unless otherwise specified every built-in function and every built-in
constructor
has the
Function prototype object
, which is the initial value of the expression
Function.prototype
20.2.3
), as the value of its [[Prototype]] internal slot.
Unless otherwise specified every built-in prototype object has the
Object prototype object
, which is the initial value of the expression
Object.prototype
20.1.3
), as the value of its [[Prototype]] internal slot, except the
Object prototype object
itself.
Built-in function objects that are not identified as constructors
do not implement the [[Construct]] internal method unless otherwise
specified in the description of a particular function.
Each built-in function defined in this specification is created by calling the
CreateBuiltinFunction
abstract operation (
10.3.3
). The values of the
length
and
name
parameters are the initial values of the
"length"
and
"name"
properties as discussed below. The values of the
prefix
parameter are similarly discussed below.
Every built-in
function object
, including constructors, has a
"length"
property whose value is a non-negative
integral Number
Unless otherwise specified, this value is equal to the number of
required parameters shown in the subclause headings for the function
description. Optional parameters and rest parameters are not included in
the parameter count.
Note 2
For example, the
function object
that is the initial value of the
"map"
property of the
Array prototype object
is described under the subclause heading «Array.prototype.map
(callbackFn [ , thisArg])» which shows the two named arguments
callbackFn and thisArg, the latter being optional; therefore the value
of the
"length"
property of that
function object
is
Unless otherwise specified, the
"length"
property of a built-in
function object
has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
Every built-in
function object
, including constructors, has a
"name"
property whose value is a String. Unless otherwise specified, this
value is the name that is given to the function in this specification.
Functions that are identified as anonymous functions use the empty
String as the value of the
"name"
property. For functions that are specified as properties of objects, the name value is the
property name
string used to access the function. Functions that are specified as get or set accessor functions of built-in properties have
"get"
or
"set"
(respectively) passed to the
prefix
parameter when calling
CreateBuiltinFunction
The value of the
"name"
property is explicitly
specified for each built-in functions whose property key is a Symbol
value. If such an explicitly specified value starts with the prefix
"get "
or
"set "
and the function for which it is specified is a get or set accessor
function of a built-in property, the value without the prefix is passed
to the
name
parameter, and the value
"get"
or
"set"
(respectively) is passed to the
prefix
parameter when calling
CreateBuiltinFunction
Unless otherwise specified, the
"name"
property of a built-in
function object
has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
Every other
data property
described in clauses
19
through
28
and in Annex
B.2
has the attributes { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
} unless otherwise specified.
Every
accessor property
described in clauses
19
through
28
and in Annex
B.2
has the attributes { [[Enumerable]]:
false
, [[Configurable]]:
true
} unless otherwise specified. If only a get accessor function is described, the set accessor function is the default value,
undefined
. If only a set accessor is described the get accessor is the default value,
undefined
19
The Global Object
The
global object
is created before control enters any
execution context
does not have a [[Construct]] internal method; it cannot be used as a
constructor
with the
new
operator.
does not have a [[Call]] internal method; it cannot be invoked as a function.
has a [[Prototype]] internal slot whose value is
host-defined
may have
host
defined properties in addition to the properties defined in this
specification. This may include a property whose value is the global
object itself.
19.1
Value Properties of the Global Object
19.1.1
globalThis
The initial value of the
"globalThis"
property of the
global object
in a
Realm Record
realm
is
realm
.[[GlobalEnv]].[[GlobalThisValue]].
This property has the attributes { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
19.1.2
Infinity
The value of
Infinity
is
+∞
(see
6.1.6.1
). This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
19.1.3
NaN
The value of
NaN
is
NaN
(see
6.1.6.1
). This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
19.1.4
undefined
The value of
undefined
is
undefined
(see
6.1.1
). This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
19.2
Function Properties of the Global Object
19.2.1
eval (
The
eval
function is the
%eval%
intrinsic object. When the
eval
function is called with one argument
, the following steps are taken:
1.
Assert
: The
execution context stack
has at least two elements.
2.
Let
callerContext
be the second to top element of the
execution context stack
3.
Let
callerRealm
be
callerContext
's
Realm
4.
Return ?
PerformEval
callerRealm
false
false
).
19.2.1.1
PerformEval (
callerRealm
strictCaller
direct
The abstract operation PerformEval takes arguments
callerRealm
strictCaller
, and
direct
. It performs the following steps when called:
1.
Assert
: If
direct
is
false
, then
strictCaller
is also
false
2.
If
Type
) is not String, return
3.
Let
evalRealm
be
the current Realm Record
4.
Perform ?
HostEnsureCanCompileStrings
callerRealm
evalRealm
).
5.
Let
inFunction
be
false
6.
Let
inMethod
be
false
7.
Let
inDerivedConstructor
be
false
8.
If
direct
is
true
, then
a.
Let
thisEnvRec
be !
GetThisEnvironment
().
b.
If
thisEnvRec
is a
function Environment Record
, then
i.
Let
be
thisEnvRec
.[[FunctionObject]].
ii.
Set
inFunction
to
true
iii.
Set
inMethod
to
thisEnvRec
.HasSuperBinding().
iv.
If
.[[ConstructorKind]] is
derived
, set
inDerivedConstructor
to
true
9.
Perform the following substeps in an
implementation-defined
order, possibly interleaving parsing and error detection:
a.
Let
script
be
ParseText
(!
StringToCodePoints
),
Script
).
b.
If
script
is a
List
of errors, throw a
SyntaxError
exception.
c.
If
script
Contains
ScriptBody
is
false
, return
undefined
d.
Let
body
be the
ScriptBody
of
script
e.
If
inFunction
is
false
, and
body
Contains
NewTarget
, throw a
SyntaxError
exception.
f.
If
inMethod
is
false
, and
body
Contains
SuperProperty
, throw a
SyntaxError
exception.
g.
If
inDerivedConstructor
is
false
, and
body
Contains
SuperCall
, throw a
SyntaxError
exception.
10.
If
strictCaller
is
true
, let
strictEval
be
true
11.
Else, let
strictEval
be
IsStrict
of
script
12.
Let
runningContext
be the
running execution context
13.
NOTE: If
direct
is
true
runningContext
will be the
execution context
that performed the
direct eval
. If
direct
is
false
runningContext
will be the
execution context
for the invocation of the
eval
function.
14.
If
direct
is
true
, then
a.
Let
lexEnv
be
NewDeclarativeEnvironment
runningContext
's LexicalEnvironment).
b.
Let
varEnv
be
runningContext
's VariableEnvironment.
15.
Else,
a.
Let
lexEnv
be
NewDeclarativeEnvironment
evalRealm
.[[GlobalEnv]]).
b.
Let
varEnv
be
evalRealm
.[[GlobalEnv]].
16.
If
strictEval
is
true
, set
varEnv
to
lexEnv
17.
If
runningContext
is not already suspended, suspend
runningContext
18.
Let
evalContext
be a new ECMAScript code
execution context
19.
Set
evalContext
's Function to
null
20.
Set
evalContext
's
Realm
to
evalRealm
21.
Set
evalContext
's ScriptOrModule to
runningContext
's ScriptOrModule.
22.
Set
evalContext
's VariableEnvironment to
varEnv
23.
Set
evalContext
's LexicalEnvironment to
lexEnv
24.
Push
evalContext
onto the
execution context stack
evalContext
is now the
running execution context
25.
Let
result
be
EvalDeclarationInstantiation
body
varEnv
lexEnv
strictEval
).
26.
If
result
.[[Type]] is
normal
, then
a.
Set
result
to the result of evaluating
body
27.
If
result
.[[Type]] is
normal
and
result
.[[Value]] is
empty
, then
a.
Set
result
to
NormalCompletion
undefined
).
28.
Suspend
evalContext
and remove it from the
execution context stack
29.
Resume the context that is now on the top of the
execution context stack
as the
running execution context
30.
Return
Completion
result
).
Note
The eval code cannot instantiate variable or function
bindings in the variable environment of the calling context that invoked
the eval if the calling context is evaluating formal parameter
initializers or if either the code of the calling context or the eval
code is
strict mode code
Instead such bindings are instantiated in a new VariableEnvironment
that is only accessible to the eval code. Bindings introduced by
let
const
, or
class
declarations are always instantiated in a new LexicalEnvironment.
19.2.1.2
HostEnsureCanCompileStrings (
callerRealm
calleeRealm
The
host-defined
abstract operation HostEnsureCanCompileStrings takes arguments
callerRealm
(a
Realm Record
) and
calleeRealm
(a
Realm Record
). It allows
host
environments to block certain ECMAScript functions which allow developers to compile strings into ECMAScript code.
An implementation of HostEnsureCanCompileStrings may complete
normally or abruptly. Any abrupt completions will be propagated to its
callers. The default implementation of HostEnsureCanCompileStrings is to
unconditionally return an empty normal completion.
19.2.1.3
EvalDeclarationInstantiation (
body
varEnv
lexEnv
strict
The abstract operation EvalDeclarationInstantiation takes arguments
body
varEnv
lexEnv
, and
strict
. It performs the following steps when called:
1.
Let
varNames
be the
VarDeclaredNames
of
body
2.
Let
varDeclarations
be the
VarScopedDeclarations
of
body
3.
If
strict
is
false
, then
a.
If
varEnv
is a
global Environment Record
, then
i.
For each element
name
of
varNames
, do
1.
If
varEnv
.HasLexicalDeclaration(
name
) is
true
, throw a
SyntaxError
exception.
2.
NOTE:
eval
will not create a global var declaration that would be shadowed by a global lexical declaration.
b.
Let
thisEnv
be
lexEnv
c.
Assert
: The following loop will terminate.
d.
Repeat, while
thisEnv
is not the same as
varEnv
i.
If
thisEnv
is not an
object Environment Record
, then
1.
NOTE:
The environment of with statements cannot contain any lexical
declaration so it doesn't need to be checked for var/let hoisting
conflicts.
2.
For each element
name
of
varNames
, do
a.
If
thisEnv
.HasBinding(
name
) is
true
, then
i.
Throw a
SyntaxError
exception.
ii.
NOTE: Annex
B.3.5
defines alternate semantics for the above step.
b.
NOTE: A
direct eval
will not hoist var declaration over a like-named lexical declaration.
ii.
Set
thisEnv
to
thisEnv
.[[OuterEnv]].
4.
Let
functionsToInitialize
be a new empty
List
5.
Let
declaredFunctionNames
be a new empty
List
6.
For each element
of
varDeclarations
, in reverse
List
order, do
a.
If
is neither a
VariableDeclaration
nor a
ForBinding
nor a
BindingIdentifier
, then
i.
Assert
is either a
FunctionDeclaration
, a
GeneratorDeclaration
, an
AsyncFunctionDeclaration
, or an
AsyncGeneratorDeclaration
ii.
NOTE: If there are multiple function declarations for the same name, the last declaration is used.
iii.
Let
fn
be the sole element of the
BoundNames
of
iv.
If
fn
is not an element of
declaredFunctionNames
, then
1.
If
varEnv
is a
global Environment Record
, then
a.
Let
fnDefinable
be ?
varEnv
.CanDeclareGlobalFunction(
fn
).
b.
If
fnDefinable
is
false
, throw a
TypeError
exception.
2.
Append
fn
to
declaredFunctionNames
3.
Insert
as the first element of
functionsToInitialize
7.
NOTE: Annex
B.3.3.3
adds additional steps at this point.
8.
Let
declaredVarNames
be a new empty
List
9.
For each element
of
varDeclarations
, do
a.
If
is a
VariableDeclaration
, a
ForBinding
, or a
BindingIdentifier
, then
i.
For each String
vn
of the
BoundNames
of
, do
1.
If
vn
is not an element of
declaredFunctionNames
, then
a.
If
varEnv
is a
global Environment Record
, then
i.
Let
vnDefinable
be ?
varEnv
.CanDeclareGlobalVar(
vn
).
ii.
If
vnDefinable
is
false
, throw a
TypeError
exception.
b.
If
vn
is not an element of
declaredVarNames
, then
i.
Append
vn
to
declaredVarNames
10.
NOTE: No abnormal terminations occur after this algorithm step unless
varEnv
is a
global Environment Record
and the
global object
is a
Proxy exotic object
11.
Let
lexDeclarations
be the
LexicallyScopedDeclarations
of
body
12.
For each element
of
lexDeclarations
, do
a.
NOTE: Lexically declared names are only instantiated here but not initialized.
b.
For each element
dn
of the
BoundNames
of
, do
i.
If
IsConstantDeclaration
of
is
true
, then
1.
Perform ?
lexEnv
.CreateImmutableBinding(
dn
true
).
ii.
Else,
1.
Perform ?
lexEnv
.CreateMutableBinding(
dn
false
).
13.
For each
Parse Node
of
functionsToInitialize
, do
a.
Let
fn
be the sole element of the
BoundNames
of
b.
Let
fo
be
InstantiateFunctionObject
of
with argument
lexEnv
c.
If
varEnv
is a
global Environment Record
, then
i.
Perform ?
varEnv
.CreateGlobalFunctionBinding(
fn
fo
true
).
d.
Else,
i.
Let
bindingExists
be
varEnv
.HasBinding(
fn
).
ii.
If
bindingExists
is
false
, then
1.
Let
status
be !
varEnv
.CreateMutableBinding(
fn
true
).
2.
Assert
status
is not an
abrupt completion
because of validation preceding step
10
3.
Perform !
varEnv
.InitializeBinding(
fn
fo
).
iii.
Else,
1.
Perform !
varEnv
.SetMutableBinding(
fn
fo
false
).
14.
For each String
vn
of
declaredVarNames
, do
a.
If
varEnv
is a
global Environment Record
, then
i.
Perform ?
varEnv
.CreateGlobalVarBinding(
vn
true
).
b.
Else,
i.
Let
bindingExists
be
varEnv
.HasBinding(
vn
).
ii.
If
bindingExists
is
false
, then
1.
Let
status
be !
varEnv
.CreateMutableBinding(
vn
true
).
2.
Assert
status
is not an
abrupt completion
because of validation preceding step
10
3.
Perform !
varEnv
.InitializeBinding(
vn
undefined
).
15.
Return
NormalCompletion
empty
).
Note
An alternative version of this algorithm is described in
B.3.5
19.2.2
isFinite (
number
The
isFinite
function is the
%isFinite%
intrinsic object. When the
isFinite
function is called with one argument
number
, the following steps are taken:
1.
Let
num
be ?
ToNumber
number
).
2.
If
num
is
NaN
+∞
, or
-∞
, return
false
3.
Otherwise, return
true
19.2.3
isNaN (
number
The
isNaN
function is the
%isNaN%
intrinsic object. When the
isNaN
function is called with one argument
number
, the following steps are taken:
1.
Let
num
be ?
ToNumber
number
).
2.
If
num
is
NaN
, return
true
3.
Otherwise, return
false
Note
A reliable way for ECMAScript code to test if a value
is a
NaN
is an expression of the form
X !== X
. The result will be
true
if and only if
is a
NaN
19.2.4
parseFloat (
string
The
parseFloat
function produces a
Number value
dictated by interpretation of the contents of the
string
argument as a decimal literal.
The
parseFloat
function is the
%parseFloat%
intrinsic object. When the
parseFloat
function is called with one argument
string
, the following steps are taken:
1.
Let
inputString
be ?
ToString
string
).
2.
Let
trimmedString
be !
TrimString
inputString
start
).
3.
If neither
trimmedString
nor any prefix of
trimmedString
satisfies the syntax of a
StrDecimalLiteral
(see
7.1.4.1
), return
NaN
4.
Let
numberString
be the longest prefix of
trimmedString
, which might be
trimmedString
itself, that satisfies the syntax of a
StrDecimalLiteral
5.
Let
mathFloat
be MV of
numberString
6.
If
mathFloat
= 0, then
a.
If the first code unit of
trimmedString
is the code unit 0x002D (HYPHEN-MINUS), return
-0
b.
Return
+0
7.
Return
mathFloat
).
Note
parseFloat
may interpret only a leading portion of
string
as a
Number value
it ignores any code units that cannot be interpreted as part of the
notation of a decimal literal, and no indication is given that any such
code units were ignored.
19.2.5
parseInt (
string
radix
The
parseInt
function produces an
integral Number
dictated by interpretation of the contents of the
string
argument according to the specified
radix
. Leading white space in
string
is ignored. If
radix
is
undefined
or 0, it is assumed to be 10 except when the number begins with the code unit pairs
0x
or
0X
, in which case a radix of 16 is assumed. If
radix
is 16, the number may also optionally begin with the code unit pairs
0x
or
0X
The
parseInt
function is the
%parseInt%
intrinsic object. When the
parseInt
function is called, the following steps are taken:
1.
Let
inputString
be ?
ToString
string
).
2.
Let
be !
TrimString
inputString
start
).
3.
Let
sign
be 1.
4.
If
is not empty and the first code unit of
is the code unit 0x002D (HYPHEN-MINUS), set
sign
to -1.
5.
If
is not empty and the first code unit of
is the code unit 0x002B (PLUS SIGN) or the code unit 0x002D (HYPHEN-MINUS), remove the first code unit from
6.
Let
be
(?
ToInt32
radix
)).
7.
Let
stripPrefix
be
true
8.
If
≠ 0, then
a.
If
< 2 or
> 36, return
NaN
b.
If
≠ 16, set
stripPrefix
to
false
9.
Else,
a.
Set
to 10.
10.
If
stripPrefix
is
true
, then
a.
If the length of
is at least 2 and the first two code units of
are either
"0x"
or
"0X"
, then
i.
Remove the first two code units from
ii.
Set
to 16.
11.
If
contains a code unit that is not a radix-
digit, let
end
be the index within
of the first such code unit; otherwise, let
end
be the length of
12.
Let
be the
substring
of
from 0 to
end
13.
If
is empty, return
NaN
14.
Let
mathInt
be the
integer
value that is represented by
in radix-
notation, using the letters
and
for digits with values 10 through 35. (However, if
is 10 and
contains more than 20 significant digits, every significant digit after
the 20th may be replaced by a 0 digit, at the option of the
implementation; and if
is not 2, 4, 8, 10, 16, or 32, then
mathInt
may be an
implementation-approximated
value representing the
integer
value that is represented by
in radix-
notation.)
15.
If
mathInt
= 0, then
a.
If
sign
= -1, return
-0
b.
Return
+0
16.
Return
sign
mathInt
).
Note
parseInt
may interpret only a leading portion of
string
as an
integer
value; it ignores any code units that cannot be interpreted as part of the notation of an
integer
, and no indication is given that any such code units were ignored.
19.2.6
URI Handling Functions
Uniform Resource Identifiers, or URIs, are Strings that
identify resources (e.g. web pages or files) and transport protocols by
which to access them (e.g. HTTP or FTP) on the Internet. The ECMAScript
language itself does not provide any support for using URIs except for
functions that encode and decode URIs as described in
19.2.6.2
19.2.6.3
19.2.6.4
and
19.2.6.5
Note
Many implementations of ECMAScript provide additional
functions and methods that manipulate web pages; these functions are
beyond the scope of this standard.
19.2.6.1
URI Syntax and Semantics
A URI is composed of a sequence of components separated by component separators. The general form is:
Scheme
First
Second
Third
Fourth
where the italicized names represent components and “
”, “
”, “
” and “
” are reserved for use as separators. The
encodeURI
and
decodeURI
functions are intended to work with complete URIs; they assume that any
reserved code units in the URI are intended to have special meaning and
so are not encoded. The
encodeURIComponent
and
decodeURIComponent
functions are intended to work with the individual component parts of a
URI; they assume that any reserved code units represent text and so
must be encoded so that they are not interpreted as reserved code units
when the component is part of a complete URI.
The following lexical grammar specifies the form of encoded URIs.
Syntax
uri
:::
uriCharacters
opt
uriCharacters
:::
uriCharacter
uriCharacters
opt
uriCharacter
:::
uriReserved
uriUnescaped
uriEscaped
uriReserved
:::
one of
uriUnescaped
:::
uriAlpha
DecimalDigit
uriMark
uriEscaped
:::
HexDigit
HexDigit
uriAlpha
:::
one of
uriMark
:::
one of
Note
The above syntax is based upon RFC 2396 and does not reflect changes introduced by the more recent RFC 3986.
Runtime Semantics
When a code unit to be included in a URI is not listed above
or is not intended to have the special meaning sometimes given to the
reserved code units, that code unit must be encoded. The code unit is
transformed into its UTF-8 encoding, with
surrogate pairs
first converted from UTF-16 to the corresponding code point value.
(Note that for code units in the range [0, 127] this results in a single
octet with the same value.) The resulting sequence of octets is then
transformed into a String with each octet represented by an escape
sequence of the form
"%xx"
19.2.6.1.1
Encode (
string
unescapedSet
The abstract operation Encode takes arguments
string
(a String) and
unescapedSet
(a String). It performs URI encoding and escaping. It performs the following steps when called:
1.
Let
strLen
be the number of code units in
string
2.
Let
be the empty String.
3.
Let
be 0.
4.
Repeat,
a.
If
strLen
, return
b.
Let
be the code unit at index
within
string
c.
If
is in
unescapedSet
, then
i.
Set
to
+ 1.
ii.
Set
to the
string-concatenation
of
and
d.
Else,
i.
Let
cp
be !
CodePointAt
string
).
ii.
If
cp
.[[IsUnpairedSurrogate]] is
true
, throw a
URIError
exception.
iii.
Set
to
cp
.[[CodeUnitCount]].
iv.
Let
Octets
be the
List
of octets resulting by applying the UTF-8 transformation to
cp
.[[CodePoint]].
v.
For each element
octet
of
Octets
, do
1.
Set
to the
string-concatenation
of:
"%"
the String representation of
octet
, formatted as a two-digit uppercase hexadecimal number, padded to the left with a zero if necessary
19.2.6.1.2
Decode (
string
reservedSet
The abstract operation Decode takes arguments
string
(a String) and
reservedSet
(a String). It performs URI unescaping and decoding. It performs the following steps when called:
1.
Let
strLen
be the length of
string
2.
Let
be the empty String.
3.
Let
be 0.
4.
Repeat,
a.
If
strLen
, return
b.
Let
be the code unit at index
within
string
c.
If
is not the code unit 0x0025 (PERCENT SIGN), then
i.
Let
be the String value containing only the code unit
d.
Else,
i.
Let
start
be
ii.
If
+ 2 ≥
strLen
, throw a
URIError
exception.
iii.
If the code units at index (
+ 1) and (
+ 2) within
string
do not represent hexadecimal digits, throw a
URIError
exception.
iv.
Let
be the 8-bit value represented by the two hexadecimal digits at index (
+ 1) and (
+ 2).
v.
Set
to
+ 2.
vi.
Let
be the number of leading 1 bits in
vii.
If
= 0, then
1.
Let
be the code unit whose value is
2.
If
is not in
reservedSet
, then
a.
Let
be the String value containing only the code unit
3.
Else,
a.
Let
be the
substring
of
string
from
start
to
+ 1.
viii.
Else,
1.
If
= 1 or
> 4, throw a
URIError
exception.
2.
If
+ (3 × (
- 1)) ≥
strLen
, throw a
URIError
exception.
3.
Let
Octets
be a
List
whose sole element is
4.
Let
be 1.
5.
Repeat, while
a.
Set
to
+ 1.
b.
If the code unit at index
within
string
is not the code unit 0x0025 (PERCENT SIGN), throw a
URIError
exception.
c.
If the code units at index (
+ 1) and (
+ 2) within
string
do not represent hexadecimal digits, throw a
URIError
exception.
d.
Let
be the 8-bit value represented by the two hexadecimal digits at index (
+ 1) and (
+ 2).
e.
Set
to
+ 2.
f.
Append
to
Octets
g.
Set
to
+ 1.
6.
Assert
: The length of
Octets
is
7.
If
Octets
does not contain a valid UTF-8 encoding of a Unicode code point, throw a
URIError
exception.
8.
Let
be the code point obtained by applying the UTF-8 transformation to
Octets
, that is, from a
List
of octets into a 21-bit value.
9.
Let
be
UTF16EncodeCodePoint
).
e.
Set
to the
string-concatenation
of
and
f.
Set
to
+ 1.
Note
This syntax of Uniform Resource Identifiers is based upon
RFC 2396 and does not reflect the more recent RFC 3986 which replaces
RFC 2396. A formal description and implementation of UTF-8 is given in
RFC 3629.
In UTF-8, characters are encoded using sequences of 1 to 6
octets. The only octet of a sequence of one has the higher-order bit
set to 0, the remaining 7 bits being used to encode the character value.
In a sequence of n octets, n > 1, the initial octet has the n
higher-order bits set to 1, followed by a bit set to 0. The remaining
bits of that octet contain bits from the value of the character to be
encoded. The following octets all have the higher-order bit set to 1 and
the following bit set to 0, leaving 6 bits in each to contain bits from
the character to be encoded. The possible UTF-8 encodings of ECMAScript
characters are specified in
Table 49
Table 49 (Informative): UTF-8 Encodings
Code Unit Value
Representation
st
Octet
nd
Octet
rd
Octet
th
Octet
0x0000 - 0x007F
00000000 0
zzzzzzz
zzzzzzz
0x0080 - 0x07FF
00000
yyy yyzzzzzz
110
yyyyy
10
zzzzzz
0x0800 - 0xD7FF
xxxxyyyy yyzzzzzz
1110
xxxx
10
yyyyyy
10
zzzzzz
0xD800 - 0xDBFF
followed by
0xDC00 - 0xDFFF
110110
vv vvwwwwxx
followed by
110111
yy yyzzzzzz
11110
uuu
10
uuwwww
10
xxyyyy
10
zzzzzz
0xD800 - 0xDBFF
not followed by
0xDC00 - 0xDFFF
causes
URIError
0xDC00 - 0xDFFF
causes
URIError
0xE000 - 0xFFFF
xxxxyyyy yyzzzzzz
1110
xxxx
10
yyyyyy
10
zzzzzz
Where
uuuuu
vvvv
+ 1
to account for the addition of 0x10000 as in section 3.8 of the Unicode Standard (Surrogates).
The above transformation combines each
surrogate pair
(for which code unit values in the inclusive range 0xD800 to 0xDFFF are
reserved) into a UTF-32 representation and encodes the resulting 21-bit
value into UTF-8. Decoding reconstructs the
surrogate pair
RFC 3629 prohibits the decoding of invalid UTF-8 octet
sequences. For example, the invalid sequence C0 80 must not decode into
the code unit 0x0000. Implementations of the Decode algorithm are
required to throw a
URIError
when encountering such invalid sequences.
19.2.6.2
decodeURI (
encodedURI
The
decodeURI
function computes a new version of
a URI in which each escape sequence and UTF-8 encoding of the sort that
might be introduced by the
encodeURI
function is replaced
with the UTF-16 encoding of the code points that it represents. Escape
sequences that could not have been introduced by
encodeURI
are not replaced.
The
decodeURI
function is the
%decodeURI%
intrinsic object. When the
decodeURI
function is called with one argument
encodedURI
, the following steps are taken:
1.
Let
uriString
be ?
ToString
encodedURI
).
2.
Let
reservedURISet
be a String containing one instance of each code unit valid in
uriReserved
plus
"#"
3.
Return ?
Decode
uriString
reservedURISet
).
Note
The code point
is not decoded from escape sequences even though it is not a reserved URI code point.
19.2.6.3
decodeURIComponent (
encodedURIComponent
The
decodeURIComponent
function computes a new
version of a URI in which each escape sequence and UTF-8 encoding of the
sort that might be introduced by the
encodeURIComponent
function is replaced with the UTF-16 encoding of the code points that it represents.
The
decodeURIComponent
function is the
%decodeURIComponent%
intrinsic object. When the
decodeURIComponent
function is called with one argument
encodedURIComponent
, the following steps are taken:
1.
Let
componentString
be ?
ToString
encodedURIComponent
).
2.
Let
reservedURIComponentSet
be the empty String.
3.
Return ?
Decode
componentString
reservedURIComponentSet
).
19.2.6.4
encodeURI (
uri
The
encodeURI
function computes a new version of a UTF-16 encoded (
6.1.4
URI in which each instance of certain code points is replaced by one,
two, three, or four escape sequences representing the UTF-8 encoding of
the code points.
The
encodeURI
function is the
%encodeURI%
intrinsic object. When the
encodeURI
function is called with one argument
uri
, the following steps are taken:
1.
Let
uriString
be ?
ToString
uri
).
2.
Let
unescapedURISet
be a String containing one instance of each code unit valid in
uriReserved
and
uriUnescaped
plus
"#"
3.
Return ?
Encode
uriString
unescapedURISet
).
Note
The code point
is not encoded to an escape sequence even though it is not a reserved or unescaped URI code point.
19.2.6.5
encodeURIComponent (
uriComponent
The
encodeURIComponent
function computes a new version of a UTF-16 encoded (
6.1.4
URI in which each instance of certain code points is replaced by one,
two, three, or four escape sequences representing the UTF-8 encoding of
the code point.
The
encodeURIComponent
function is the
%encodeURIComponent%
intrinsic object. When the
encodeURIComponent
function is called with one argument
uriComponent
, the following steps are taken:
1.
Let
componentString
be ?
ToString
uriComponent
).
2.
Let
unescapedURIComponentSet
be a String containing one instance of each code unit valid in
uriUnescaped
3.
Return ?
Encode
componentString
unescapedURIComponentSet
).
19.3
Constructor Properties of the Global Object
19.3.1
Array ( . . . )
See
23.1.1
19.3.2
ArrayBuffer ( . . . )
See
25.1.3
19.3.3
BigInt ( . . . )
See
21.2.1
19.3.4
BigInt64Array ( . . . )
See
23.2.5
19.3.5
BigUint64Array ( . . . )
See
23.2.5
19.3.6
Boolean ( . . . )
See
20.3.1
19.3.7
DataView ( . . . )
See
25.3.2
19.3.8
Date ( . . . )
See
21.4.2
19.3.9
Error ( . . . )
See
20.5.1
19.3.10
EvalError ( . . . )
See
20.5.5.1
19.3.11
FinalizationRegistry ( . . . )
See
26.2.1
19.3.12
Float32Array ( . . . )
See
23.2.5
19.3.13
Float64Array ( . . . )
See
23.2.5
19.3.14
Function ( . . . )
See
20.2.1
19.3.15
Int8Array ( . . . )
See
23.2.5
19.3.16
Int16Array ( . . . )
See
23.2.5
19.3.17
Int32Array ( . . . )
See
23.2.5
19.3.18
Map ( . . . )
See
24.1.1
19.3.19
Number ( . . . )
See
21.1.1
19.3.20
Object ( . . . )
See
20.1.1
19.3.21
Promise ( . . . )
See
27.2.3
19.3.22
Proxy ( . . . )
See
28.2.1
19.3.23
RangeError ( . . . )
See
20.5.5.2
19.3.24
ReferenceError ( . . . )
See
20.5.5.3
19.3.25
RegExp ( . . . )
See
22.2.3
19.3.26
Set ( . . . )
See
24.2.1
19.3.27
SharedArrayBuffer ( . . . )
See
25.2.2
19.3.28
String ( . . . )
See
22.1.1
19.3.29
Symbol ( . . . )
See
20.4.1
19.3.30
SyntaxError ( . . . )
See
20.5.5.4
19.3.31
TypeError ( . . . )
See
20.5.5.5
19.3.32
Uint8Array ( . . . )
See
23.2.5
19.3.33
Uint8ClampedArray ( . . . )
See
23.2.5
19.3.34
Uint16Array ( . . . )
See
23.2.5
19.3.35
Uint32Array ( . . . )
See
23.2.5
19.3.36
URIError ( . . . )
See
20.5.5.6
19.3.37
WeakMap ( . . . )
See
24.3.1
19.3.38
WeakRef ( . . . )
See
26.1.1
19.3.39
WeakSet ( . . . )
See
24.4
19.4
Other Properties of the Global Object
19.4.1
Atomics
See
25.4
19.4.2
JSON
See
25.5
19.4.3
Math
See
21.3
19.4.4
Reflect
See
28.1
20
Fundamental Objects
20.1
Object Objects
20.1.1
The Object Constructor
The Object
constructor
is
%Object%
is the initial value of the
"Object"
property of the
global object
creates a new
ordinary object
when called as a
constructor
performs a type conversion when called as a function rather than as a
constructor
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition.
20.1.1.1
Object ( [
value
] )
When the
Object
function is called with optional argument
value
, the following steps are taken:
1.
If NewTarget is neither
undefined
nor the active function, then
a.
Return ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Object.prototype%"
).
2.
If
value
is
undefined
or
null
, return !
OrdinaryObjectCreate
%Object.prototype%
).
3.
Return !
ToObject
value
).
The
"length"
property of the
Object
function is
20.1.2
Properties of the Object Constructor
The Object
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has a
"length"
property.
has the following additional properties:
20.1.2.1
Object.assign (
target
, ...
sources
The
assign
function is used to copy the values of all of the enumerable own properties from one or more source objects to a
target
object. When the
assign
function is called, the following steps are taken:
1.
Let
to
be ?
ToObject
target
).
2.
If only one argument was passed, return
to
3.
For each element
nextSource
of
sources
, do
a.
If
nextSource
is neither
undefined
nor
null
, then
i.
Let
from
be !
ToObject
nextSource
).
ii.
Let
keys
be ?
from
.[[OwnPropertyKeys]]().
iii.
For each element
nextKey
of
keys
, do
1.
Let
desc
be ?
from
.[[GetOwnProperty]](
nextKey
).
2.
If
desc
is not
undefined
and
desc
.[[Enumerable]] is
true
, then
a.
Let
propValue
be ?
Get
from
nextKey
).
b.
Perform ?
Set
to
nextKey
propValue
true
).
4.
Return
to
The
"length"
property of the
assign
function is
20.1.2.2
Object.create (
Properties
The
create
function creates a new object with a specified prototype. When the
create
function is called, the following steps are taken:
1.
If
Type
) is neither Object nor Null, throw a
TypeError
exception.
2.
Let
obj
be !
OrdinaryObjectCreate
).
3.
If
Properties
is not
undefined
, then
a.
Return ?
ObjectDefineProperties
obj
Properties
).
4.
Return
obj
20.1.2.3
Object.defineProperties (
Properties
The
defineProperties
function is used to add own properties and/or update the attributes of existing own properties of an object. When the
defineProperties
function is called, the following steps are taken:
1.
If
Type
) is not Object, throw a
TypeError
exception.
2.
Return ?
ObjectDefineProperties
Properties
).
20.1.2.3.1
ObjectDefineProperties (
Properties
The abstract operation ObjectDefineProperties takes arguments
and
Properties
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Let
props
be ?
ToObject
Properties
).
3.
Let
keys
be ?
props
.[[OwnPropertyKeys]]().
4.
Let
descriptors
be a new empty
List
5.
For each element
nextKey
of
keys
, do
a.
Let
propDesc
be ?
props
.[[GetOwnProperty]](
nextKey
).
b.
If
propDesc
is not
undefined
and
propDesc
.[[Enumerable]] is
true
, then
i.
Let
descObj
be ?
Get
props
nextKey
).
ii.
Let
desc
be ?
ToPropertyDescriptor
descObj
).
iii.
Append the pair (a two element
List
) consisting of
nextKey
and
desc
to the end of
descriptors
6.
For each element
pair
of
descriptors
, do
a.
Let
be the first element of
pair
b.
Let
desc
be the second element of
pair
c.
Perform ?
DefinePropertyOrThrow
desc
).
7.
Return
20.1.2.4
Object.defineProperty (
Attributes
The
defineProperty
function is used to add an own property and/or update the attributes of an existing own property of an object. When the
defineProperty
function is called, the following steps are taken:
1.
If
Type
) is not Object, throw a
TypeError
exception.
2.
Let
key
be ?
ToPropertyKey
).
3.
Let
desc
be ?
ToPropertyDescriptor
Attributes
).
4.
Perform ?
DefinePropertyOrThrow
key
desc
).
5.
Return
20.1.2.5
Object.entries (
When the
entries
function is called with argument
, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Let
nameList
be ?
EnumerableOwnPropertyNames
obj
key+value
).
3.
Return
CreateArrayFromList
nameList
).
20.1.2.6
Object.freeze (
When the
freeze
function is called, the following steps are taken:
1.
If
Type
) is not Object, return
2.
Let
status
be ?
SetIntegrityLevel
frozen
).
3.
If
status
is
false
, throw a
TypeError
exception.
4.
Return
20.1.2.7
Object.fromEntries (
iterable
When the
fromEntries
method is called with argument
iterable
, the following steps are taken:
1.
Perform ?
RequireObjectCoercible
iterable
).
2.
Let
obj
be !
OrdinaryObjectCreate
%Object.prototype%
).
3.
Assert
obj
is an extensible
ordinary object
with no own properties.
4.
Let
stepsDefine
be the algorithm steps defined in
CreateDataPropertyOnObject Functions
5.
Let
lengthDefine
be the number of non-optional parameters of the function definition in
CreateDataPropertyOnObject Functions
6.
Let
adder
be !
CreateBuiltinFunction
stepsDefine
lengthDefine
""
, « »).
7.
Return ?
AddEntriesFromIterable
obj
iterable
adder
).
Note
The function created for
adder
is never directly accessible to ECMAScript code.
20.1.2.7.1
CreateDataPropertyOnObject Functions
A CreateDataPropertyOnObject function is an anonymous
built-in function. When a CreateDataPropertyOnObject function is called
with arguments
key
and
value
, the following steps are taken:
1.
Let
be the
this
value.
2.
Assert
Type
) is Object.
3.
Assert
is an extensible
ordinary object
4.
Let
propertyKey
be ?
ToPropertyKey
key
).
5.
Perform !
CreateDataPropertyOrThrow
propertyKey
value
).
6.
Return
undefined
20.1.2.8
Object.getOwnPropertyDescriptor (
When the
getOwnPropertyDescriptor
function is called, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Let
key
be ?
ToPropertyKey
).
3.
Let
desc
be ?
obj
.[[GetOwnProperty]](
key
).
4.
Return
FromPropertyDescriptor
desc
).
20.1.2.9
Object.getOwnPropertyDescriptors (
When the
getOwnPropertyDescriptors
function is called, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Let
ownKeys
be ?
obj
.[[OwnPropertyKeys]]().
3.
Let
descriptors
be !
OrdinaryObjectCreate
%Object.prototype%
).
4.
For each element
key
of
ownKeys
, do
a.
Let
desc
be ?
obj
.[[GetOwnProperty]](
key
).
b.
Let
descriptor
be !
FromPropertyDescriptor
desc
).
c.
If
descriptor
is not
undefined
, perform !
CreateDataPropertyOrThrow
descriptors
key
descriptor
).
5.
Return
descriptors
20.1.2.10
Object.getOwnPropertyNames (
When the
getOwnPropertyNames
function is called, the following steps are taken:
1.
Return ?
GetOwnPropertyKeys
string
).
20.1.2.11
Object.getOwnPropertySymbols (
When the
getOwnPropertySymbols
function is called with argument
, the following steps are taken:
1.
Return ?
GetOwnPropertyKeys
symbol
).
20.1.2.11.1
GetOwnPropertyKeys (
type
The abstract operation GetOwnPropertyKeys takes arguments
and
type
(either
string
or
symbol
). It performs the following steps when called:
1.
Let
obj
be ?
ToObject
).
2.
Let
keys
be ?
obj
.[[OwnPropertyKeys]]().
3.
Let
nameList
be a new empty
List
4.
For each element
nextKey
of
keys
, do
a.
If
Type
nextKey
) is Symbol and
type
is
symbol
or
Type
nextKey
) is String and
type
is
string
, then
i.
Append
nextKey
as the last element of
nameList
5.
Return
CreateArrayFromList
nameList
).
20.1.2.12
Object.getPrototypeOf (
When the
getPrototypeOf
function is called with argument
, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Return ?
obj
.[[GetPrototypeOf]]().
20.1.2.13
Object.is (
value1
value2
When the
is
function is called with arguments
value1
and
value2
, the following steps are taken:
1.
Return
SameValue
value1
value2
).
20.1.2.14
Object.isExtensible (
When the
isExtensible
function is called with argument
, the following steps are taken:
1.
If
Type
) is not Object, return
false
2.
Return ?
IsExtensible
).
20.1.2.15
Object.isFrozen (
When the
isFrozen
function is called with argument
, the following steps are taken:
1.
If
Type
) is not Object, return
true
2.
Return ?
TestIntegrityLevel
frozen
).
20.1.2.16
Object.isSealed (
When the
isSealed
function is called with argument
, the following steps are taken:
1.
If
Type
) is not Object, return
true
2.
Return ?
TestIntegrityLevel
sealed
).
20.1.2.17
Object.keys (
When the
keys
function is called with argument
, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Let
nameList
be ?
EnumerableOwnPropertyNames
obj
key
).
3.
Return
CreateArrayFromList
nameList
).
20.1.2.18
Object.preventExtensions (
When the
preventExtensions
function is called, the following steps are taken:
1.
If
Type
) is not Object, return
2.
Let
status
be ?
.[[PreventExtensions]]().
3.
If
status
is
false
, throw a
TypeError
exception.
4.
Return
20.1.2.19
Object.prototype
The initial value of
Object.prototype
is the
Object prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.1.2.20
Object.seal (
When the
seal
function is called, the following steps are taken:
1.
If
Type
) is not Object, return
2.
Let
status
be ?
SetIntegrityLevel
sealed
).
3.
If
status
is
false
, throw a
TypeError
exception.
4.
Return
20.1.2.21
Object.setPrototypeOf (
proto
When the
setPrototypeOf
function is called with arguments
and
proto
, the following steps are taken:
1.
Set
to ?
RequireObjectCoercible
).
2.
If
Type
proto
) is neither Object nor Null, throw a
TypeError
exception.
3.
If
Type
) is not Object, return
4.
Let
status
be ?
.[[SetPrototypeOf]](
proto
).
5.
If
status
is
false
, throw a
TypeError
exception.
6.
Return
20.1.2.22
Object.values (
When the
values
function is called with argument
, the following steps are taken:
1.
Let
obj
be ?
ToObject
).
2.
Let
nameList
be ?
EnumerableOwnPropertyNames
obj
value
).
3.
Return
CreateArrayFromList
nameList
).
20.1.3
Properties of the Object Prototype Object
The
Object prototype object
is
%Object.prototype%
has an [[Extensible]] internal slot whose value is
true
has the internal methods defined for ordinary objects, except for the [[SetPrototypeOf]] method, which is as defined in
10.4.7.1
. (Thus, it is an
immutable prototype exotic object
.)
has a [[Prototype]] internal slot whose value is
null
20.1.3.1
Object.prototype.constructor
The initial value of
Object.prototype.constructor
is
%Object%
20.1.3.2
Object.prototype.hasOwnProperty (
When the
hasOwnProperty
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToPropertyKey
).
2.
Let
be ?
ToObject
this
value).
3.
Return ?
HasOwnProperty
).
Note
The ordering of steps
and
is chosen to ensure that any exception that would have been thrown by step
in previous editions of this specification will continue to be thrown even if the
this
value is
undefined
or
null
20.1.3.3
Object.prototype.isPrototypeOf (
When the
isPrototypeOf
method is called with argument
, the following steps are taken:
1.
If
Type
) is not Object, return
false
2.
Let
be ?
ToObject
this
value).
3.
Repeat,
a.
Set
to ?
.[[GetPrototypeOf]]().
b.
If
is
null
, return
false
c.
If
SameValue
) is
true
, return
true
Note
The ordering of steps
and
preserves the behaviour specified by previous editions of this specification for the case where
is not an object and the
this
value is
undefined
or
null
20.1.3.4
Object.prototype.propertyIsEnumerable (
When the
propertyIsEnumerable
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToPropertyKey
).
2.
Let
be ?
ToObject
this
value).
3.
Let
desc
be ?
.[[GetOwnProperty]](
).
4.
If
desc
is
undefined
, return
false
5.
Return
desc
.[[Enumerable]].
Note 1
This method does not consider objects in the prototype chain.
Note 2
The ordering of steps
and
is chosen to ensure that any exception that would have been thrown by step
in previous editions of this specification will continue to be thrown even if the
this
value is
undefined
or
null
20.1.3.5
Object.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
When the
toLocaleString
method is called, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
Invoke
"toString"
).
The optional parameters to this function are not used but are intended to correspond to the parameter pattern used by ECMA-402
toLocaleString
functions. Implementations that do not include ECMA-402 support must not use those parameter positions for other purposes.
Note 1
This function provides a generic
toLocaleString
implementation for objects that have no locale-specific
toString
behaviour.
Array
Number
Date
, and
%TypedArray%
provide their own locale-sensitive
toLocaleString
methods.
Note 2
ECMA-402 intentionally does not provide an alternative to this default implementation.
20.1.3.6
Object.prototype.toString ( )
When the
toString
method is called, the following steps are taken:
1.
If the
this
value is
undefined
, return
"[object Undefined]"
2.
If the
this
value is
null
, return
"[object Null]"
3.
Let
be !
ToObject
this
value).
4.
Let
isArray
be ?
IsArray
).
5.
If
isArray
is
true
, let
builtinTag
be
"Array"
6.
Else if
has a [[ParameterMap]] internal slot, let
builtinTag
be
"Arguments"
7.
Else if
has a [[Call]] internal method, let
builtinTag
be
"Function"
8.
Else if
has an [[ErrorData]] internal slot, let
builtinTag
be
"Error"
9.
Else if
has a [[BooleanData]] internal slot, let
builtinTag
be
"Boolean"
10.
Else if
has a [[NumberData]] internal slot, let
builtinTag
be
"Number"
11.
Else if
has a [[StringData]] internal slot, let
builtinTag
be
"String"
12.
Else if
has a [[DateValue]] internal slot, let
builtinTag
be
"Date"
13.
Else if
has a [[RegExpMatcher]] internal slot, let
builtinTag
be
"RegExp"
14.
Else, let
builtinTag
be
"Object"
15.
Let
tag
be ?
Get
@@toStringTag
).
16.
If
Type
tag
) is not String, set
tag
to
builtinTag
17.
Return the
string-concatenation
of
"[object "
tag
, and
"]"
Note
Historically, this function was occasionally used to access
the String value of the [[Class]] internal slot that was used in
previous editions of this specification as a nominal type tag for
various built-in objects. The above definition of
toString
preserves compatibility for legacy code that uses
toString
as a test for those specific kinds of built-in objects. It does not
provide a reliable type testing mechanism for other kinds of built-in or
program defined objects. In addition, programs can use
@@toStringTag
in ways that will invalidate the reliability of such legacy type tests.
20.1.3.7
Object.prototype.valueOf ( )
When the
valueOf
method is called, the following steps are taken:
1.
Return ?
ToObject
this
value).
20.1.4
Properties of Object Instances
Object instances have no special properties beyond those inherited from the
Object prototype object
20.2
Function Objects
20.2.1
The Function Constructor
The Function
constructor
is
%Function%
is the initial value of the
"Function"
property of the
global object
creates and initializes a new
function object
when called as a function rather than as a
constructor
. Thus the function call
Function(…)
is equivalent to the object creation expression
new Function(…)
with the same arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Function behaviour must include a
super
call to the Function
constructor
to create and initialize a subclass instance with the internal slots
necessary for built-in function behaviour. All ECMAScript syntactic
forms for defining function objects create instances of Function. There
is no syntactic means to create instances of Function subclasses except
for the built-in GeneratorFunction, AsyncFunction, and
AsyncGeneratorFunction subclasses.
20.2.1.1
Function (
p1
p2
, … ,
pn
body
The last argument specifies the body (executable code) of a function; any preceding arguments specify formal parameters.
When the
Function
function is called with some arguments
p1
p2
, … ,
pn
body
(where
might be 0, that is, there are no “
” arguments, and where
body
might also not be provided), the following steps are taken:
1.
Let
be the
active function object
2.
Let
args
be the
argumentsList
that was passed to this function by [[Call]] or [[Construct]].
3.
Return ?
CreateDynamicFunction
, NewTarget,
normal
args
).
Note
It is permissible but not necessary to have one argument
for each formal parameter to be specified. For example, all three of the
following expressions produce the same result:
new
Function
"a"
"b"
"c"
"return a+b+c"
new
Function
"a, b, c"
"return a+b+c"
new
Function
"a,b"
"c"
"return a+b+c"
20.2.1.1.1
CreateDynamicFunction (
constructor
newTarget
kind
args
The abstract operation CreateDynamicFunction takes arguments
constructor
(a
constructor
),
newTarget
(a
constructor
),
kind
(either
normal
generator
async
, or
asyncGenerator
), and
args
(a
List
of ECMAScript language values).
constructor
is the
constructor
function that is performing this action.
newTarget
is the
constructor
that
new
was initially applied to.
args
is the argument values that were passed to
constructor
. It performs the following steps when called:
1.
Assert
: The
execution context stack
has at least two elements.
2.
Let
callerContext
be the second to top element of the
execution context stack
3.
Let
callerRealm
be
callerContext
's
Realm
4.
Let
calleeRealm
be
the current Realm Record
5.
Perform ?
HostEnsureCanCompileStrings
callerRealm
calleeRealm
).
6.
If
newTarget
is
undefined
, set
newTarget
to
constructor
7.
If
kind
is
normal
, then
a.
Let
goal
be the grammar symbol
FunctionBody
[~Yield, ~Await]
b.
Let
parameterGoal
be the grammar symbol
FormalParameters
[~Yield, ~Await]
c.
Let
fallbackProto
be
"%Function.prototype%"
8.
Else if
kind
is
generator
, then
a.
Let
goal
be the grammar symbol
GeneratorBody
b.
Let
parameterGoal
be the grammar symbol
FormalParameters
[+Yield, ~Await]
c.
Let
fallbackProto
be
"%GeneratorFunction.prototype%"
9.
Else if
kind
is
async
, then
a.
Let
goal
be the grammar symbol
AsyncFunctionBody
b.
Let
parameterGoal
be the grammar symbol
FormalParameters
[~Yield, +Await]
c.
Let
fallbackProto
be
"%AsyncFunction.prototype%"
10.
Else,
a.
Assert
kind
is
asyncGenerator
b.
Let
goal
be the grammar symbol
AsyncGeneratorBody
c.
Let
parameterGoal
be the grammar symbol
FormalParameters
[+Yield, +Await]
d.
Let
fallbackProto
be
"%AsyncGeneratorFunction.prototype%"
11.
Let
argCount
be the number of elements in
args
12.
Let
be the empty String.
13.
If
argCount
= 0, let
bodyArg
be the empty String.
14.
Else if
argCount
= 1, let
bodyArg
be
args
[0].
15.
Else,
a.
Assert
argCount
> 1.
b.
Let
firstArg
be
args
[0].
c.
Set
to ?
ToString
firstArg
).
d.
Let
be 1.
e.
Repeat, while
argCount
- 1,
i.
Let
nextArg
be
args
].
ii.
Let
nextArgString
be ?
ToString
nextArg
).
iii.
Set
to the
string-concatenation
of
","
(a comma), and
nextArgString
iv.
Set
to
+ 1.
f.
Let
bodyArg
be
args
].
16.
Let
bodyString
be the
string-concatenation
of 0x000A (LINE FEED), ?
ToString
bodyArg
), and 0x000A (LINE FEED).
17.
Let
prefix
be the prefix associated with
kind
in
Table 50
18.
Let
sourceString
be the
string-concatenation
of
prefix
" anonymous("
, 0x000A (LINE FEED),
") {"
bodyString
, and
"}"
19.
Let
sourceText
be !
StringToCodePoints
sourceString
).
20.
Perform the following substeps in an
implementation-defined
order, possibly interleaving parsing and error detection:
a.
Let
parameters
be
ParseText
(!
StringToCodePoints
),
parameterGoal
).
b.
If
parameters
is a
List
of errors, throw a
SyntaxError
exception.
c.
Let
body
be
ParseText
(!
StringToCodePoints
bodyString
),
goal
).
d.
If
body
is a
List
of errors, throw a
SyntaxError
exception.
e.
Let
strict
be
FunctionBodyContainsUseStrict
of
body
f.
If
strict
is
true
, apply the
early error
rules for
UniqueFormalParameters
FormalParameters
to
parameters
g.
If
strict
is
true
and
IsSimpleParameterList
of
parameters
is
false
, throw a
SyntaxError
exception.
h.
If any element of the
BoundNames
of
parameters
also occurs in the
LexicallyDeclaredNames
of
body
, throw a
SyntaxError
exception.
i.
If
body
Contains
SuperCall
is
true
, throw a
SyntaxError
exception.
j.
If
parameters
Contains
SuperCall
is
true
, throw a
SyntaxError
exception.
k.
If
body
Contains
SuperProperty
is
true
, throw a
SyntaxError
exception.
l.
If
parameters
Contains
SuperProperty
is
true
, throw a
SyntaxError
exception.
m.
If
kind
is
generator
or
asyncGenerator
, then
i.
If
parameters
Contains
YieldExpression
is
true
, throw a
SyntaxError
exception.
n.
If
kind
is
async
or
asyncGenerator
, then
i.
If
parameters
Contains
AwaitExpression
is
true
, throw a
SyntaxError
exception.
o.
If
strict
is
true
, then
i.
If
BoundNames
of
parameters
contains any duplicate elements, throw a
SyntaxError
exception.
21.
Let
proto
be ?
GetPrototypeFromConstructor
newTarget
fallbackProto
).
22.
Let
realmF
be
the current Realm Record
23.
Let
scope
be
realmF
.[[GlobalEnv]].
24.
Let
be !
OrdinaryFunctionCreate
proto
sourceText
parameters
body
non-lexical-this
scope
).
25.
Perform
SetFunctionName
"anonymous"
).
26.
If
kind
is
generator
, then
a.
Let
prototype
be !
OrdinaryObjectCreate
%GeneratorFunction.prototype.prototype%
).
b.
Perform
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
27.
Else if
kind
is
asyncGenerator
, then
a.
Let
prototype
be !
OrdinaryObjectCreate
%AsyncGeneratorFunction.prototype.prototype%
).
b.
Perform
DefinePropertyOrThrow
"prototype"
, PropertyDescriptor { [[Value]]:
prototype
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
28.
Else if
kind
is
normal
, perform
MakeConstructor
).
29.
NOTE: Functions whose
kind
is
async
are not constructible and do not have a [[Construct]] internal method or a
"prototype"
property.
30.
Return
Note
CreateDynamicFunction defines a
"prototype"
property on any function it creates whose
kind
is not
async
to provide for the possibility that the function will be used as a
constructor
Table 50: Dynamic Function
SourceText
Prefixes
Kind
Prefix
normal
"function"
generator
"function*"
async
"async function"
asyncGenerator
"async function*"
20.2.2
Properties of the Function Constructor
The Function
constructor
is itself a built-in
function object
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
20.2.2.1
Function.length
This is a
data property
with a value of 1. This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
20.2.2.2
Function.prototype
The value of
Function.prototype
is the
Function prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.2.3
Properties of the Function Prototype Object
The
Function prototype object
is
%Function.prototype%
is itself a built-in
function object
accepts any arguments and returns
undefined
when invoked.
does not have a [[Construct]] internal method; it cannot be used as a
constructor
with the
new
operator.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
does not have a
"prototype"
property.
has a
"length"
property whose value is
+0
has a
"name"
property whose value is the empty String.
Note
The Function prototype object is specified to be a
function object
to ensure compatibility with ECMAScript code that was created prior to the ECMAScript 2015 specification.
20.2.3.1
Function.prototype.apply (
thisArg
argArray
When the
apply
method is called with arguments
thisArg
and
argArray
, the following steps are taken:
1.
Let
func
be the
this
value.
2.
If
IsCallable
func
) is
false
, throw a
TypeError
exception.
3.
If
argArray
is
undefined
or
null
, then
a.
Perform
PrepareForTailCall
().
b.
Return ?
Call
func
thisArg
).
4.
Let
argList
be ?
CreateListFromArrayLike
argArray
).
5.
Perform
PrepareForTailCall
().
6.
Return ?
Call
func
thisArg
argList
).
Note 1
The
thisArg
value is passed without modification as the
this
value. This is a change from Edition 3, where an
undefined
or
null
thisArg
is replaced with the
global object
and
ToObject
is applied to all other values and that result is passed as the
this
value. Even though the
thisArg
is passed without modification, non-strict functions still perform these transformations upon entry to the function.
Note 2
If
func
is an arrow function or a
bound function exotic object
then the
thisArg
will be ignored by the function [[Call]] in step
20.2.3.2
Function.prototype.bind (
thisArg
, ...
args
When the
bind
method is called with argument
thisArg
and zero or more
args
, it performs the following steps:
1.
Let
Target
be the
this
value.
2.
If
IsCallable
Target
) is
false
, throw a
TypeError
exception.
3.
Let
be ?
BoundFunctionCreate
Target
thisArg
args
).
4.
Let
be 0.
5.
Let
targetHasLength
be ?
HasOwnProperty
Target
"length"
).
6.
If
targetHasLength
is
true
, then
a.
Let
targetLen
be ?
Get
Target
"length"
).
b.
If
Type
targetLen
) is Number, then
i.
If
targetLen
is
+∞
, set
to +∞.
ii.
Else if
targetLen
is
-∞
, set
to 0.
iii.
Else,
1.
Let
targetLenAsInt
be !
ToIntegerOrInfinity
targetLen
).
2.
Assert
targetLenAsInt
is finite.
3.
Let
argCount
be the number of elements in
args
4.
Set
to
max
targetLenAsInt
argCount
, 0).
7.
Perform !
SetFunctionLength
).
8.
Let
targetName
be ?
Get
Target
"name"
).
9.
If
Type
targetName
) is not String, set
targetName
to the empty String.
10.
Perform
SetFunctionName
targetName
"bound"
).
11.
Return
Note 1
Function objects created using
Function.prototype.bind
are exotic objects. They also do not have a
"prototype"
property.
Note 2
If
Target
is an arrow function or a
bound function exotic object
then the
thisArg
passed to this method will not be used by subsequent calls to
20.2.3.3
Function.prototype.call (
thisArg
, ...
args
When the
call
method is called with argument
thisArg
and zero or more
args
, the following steps are taken:
1.
Let
func
be the
this
value.
2.
If
IsCallable
func
) is
false
, throw a
TypeError
exception.
3.
Perform
PrepareForTailCall
().
4.
Return ?
Call
func
thisArg
args
).
Note 1
The
thisArg
value is passed without modification as the
this
value. This is a change from Edition 3, where an
undefined
or
null
thisArg
is replaced with the
global object
and
ToObject
is applied to all other values and that result is passed as the
this
value. Even though the
thisArg
is passed without modification, non-strict functions still perform these transformations upon entry to the function.
Note 2
If
func
is an arrow function or a
bound function exotic object
then the
thisArg
will be ignored by the function [[Call]] in step
20.2.3.4
Function.prototype.constructor
The initial value of
Function.prototype.constructor
is
%Function%
20.2.3.5
Function.prototype.toString ( )
When the
toString
method is called, the following steps are taken:
1.
Let
func
be the
this
value.
2.
If
Type
func
) is Object and
func
has a [[SourceText]] internal slot and
func
.[[SourceText]] is a sequence of Unicode code points and !
HostHasSourceTextAvailable
func
) is
true
, then
a.
Return !
CodePointsToString
func
.[[SourceText]]).
3.
If
func
is a
built-in function object
, return an
implementation-defined
String source code representation of
func
. The representation must have the syntax of a
NativeFunction
. Additionally, if
func
has an [[InitialName]] internal slot and
func
.[[InitialName]] is a String, the portion of the returned String that would be matched by
NativeFunctionAccessor
opt
PropertyName
must be the value of
func
.[[InitialName]].
4.
If
Type
func
) is Object and
IsCallable
func
) is
true
, return an
implementation-defined
String source code representation of
func
. The representation must have the syntax of a
NativeFunction
5.
Throw a
TypeError
exception.
NativeFunction
function
NativeFunctionAccessor
opt
PropertyName
[~Yield, ~Await]
opt
FormalParameters
[~Yield, ~Await]
native
code
NativeFunctionAccessor
get
set
20.2.3.6
Function.prototype [ @@hasInstance ] (
When the
@@hasInstance
method of an object
is called with value
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
OrdinaryHasInstance
).
The value of the
"name"
property of this function is
"[Symbol.hasInstance]"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
This is the default implementation of
@@hasInstance
that most functions inherit.
@@hasInstance
is called by the
instanceof
operator to determine whether a value is an instance of a specific
constructor
. An expression such as
instanceof
evaluates as
F[@@hasInstance](v)
constructor
function can control which objects are recognized as its instances by
instanceof
by exposing a different
@@hasInstance
method on the function.
This property is non-writable and non-configurable to prevent
tampering that could be used to globally expose the target function of a
bound function
20.2.4
Function Instances
Every Function instance is an ECMAScript
function object
and has the internal slots listed in
Table 29
. Function objects created using the
Function.prototype.bind
method (
20.2.3.2
) have the internal slots listed in
Table 30
Function instances have the following properties:
20.2.4.1
length
The value of the
"length"
property is an
integral Number
that indicates the typical number of arguments expected by the
function. However, the language permits the function to be invoked with
some other number of arguments. The behaviour of a function when invoked
on a number of arguments other than the number specified by its
"length"
property depends on the function. This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
20.2.4.2
name
The value of the
"name"
property is a String that is descriptive of the function. The name has no semantic significance but is typically a variable or
property name
that is used to refer to the function at its point of definition in
ECMAScript code. This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
Anonymous functions objects that do not have a contextual
name associated with them by this specification use the empty String as
the value of the
"name"
property.
20.2.4.3
prototype
Function instances that can be used as a
constructor
have a
"prototype"
property. Whenever such a Function instance is created another
ordinary object
is also created and is the initial value of the function's
"prototype"
property. Unless otherwise specified, the value of the
"prototype"
property is used to initialize the [[Prototype]] internal slot of the object created when that function is invoked as a
constructor
This property has the attributes { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
Function objects created using
Function.prototype.bind
, or by evaluating a
MethodDefinition
(that is not a
GeneratorMethod
or
AsyncGeneratorMethod
) or an
ArrowFunction
do not have a
"prototype"
property.
20.2.5
HostHasSourceTextAvailable (
func
The
host-defined
abstract operation HostHasSourceTextAvailable takes argument
func
(a
function object
). It allows
host
environments to prevent the source text from being provided for
func
An implementation of HostHasSourceTextAvailable must complete
normally in all cases. This operation must be deterministic with respect
to its parameters. Each time it is called with a specific
func
as its argument, it must return the same completion record. The default
implementation of HostHasSourceTextAvailable is to unconditionally
return a normal completion with a value of
true
20.3
Boolean Objects
20.3.1
The Boolean Constructor
The Boolean
constructor
is
%Boolean%
is the initial value of the
"Boolean"
property of the
global object
creates and initializes a new Boolean object when called as a
constructor
performs a type conversion when called as a function rather than as a
constructor
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Boolean behaviour must include a
super
call to the Boolean
constructor
to create and initialize the subclass instance with a [[BooleanData]] internal slot.
20.3.1.1
Boolean (
value
When
Boolean
is called with argument
value
, the following steps are taken:
1.
Let
be !
ToBoolean
value
).
2.
If NewTarget is
undefined
, return
3.
Let
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Boolean.prototype%"
, « [[BooleanData]] »).
4.
Set
.[[BooleanData]] to
5.
Return
20.3.2
Properties of the Boolean Constructor
The Boolean
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
20.3.2.1
Boolean.prototype
The initial value of
Boolean.prototype
is the
Boolean prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.3.3
Properties of the Boolean Prototype Object
The
Boolean prototype object
is
%Boolean.prototype%
is an
ordinary object
is itself a Boolean object; it has a [[BooleanData]] internal slot with the value
false
has a [[Prototype]] internal slot whose value is
%Object.prototype%
The abstract operation
thisBooleanValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is Boolean, return
value
2.
If
Type
value
) is Object and
value
has a [[BooleanData]] internal slot, then
a.
Let
be
value
.[[BooleanData]].
b.
Assert
Type
) is Boolean.
c.
Return
3.
Throw a
TypeError
exception.
20.3.3.1
Boolean.prototype.constructor
The initial value of
Boolean.prototype.constructor
is
%Boolean%
20.3.3.2
Boolean.prototype.toString ( )
The following steps are taken:
1.
Let
be ?
thisBooleanValue
this
value).
2.
If
is
true
, return
"true"
; else return
"false"
20.3.3.3
Boolean.prototype.valueOf ( )
The following steps are taken:
1.
Return ?
thisBooleanValue
this
value).
20.3.4
Properties of Boolean Instances
Boolean instances are ordinary objects that inherit properties from the
Boolean prototype object
Boolean instances have a [[BooleanData]] internal slot. The
[[BooleanData]] internal slot is the Boolean value represented by this
Boolean object.
20.4
Symbol Objects
20.4.1
The Symbol Constructor
The Symbol
constructor
is
%Symbol%
is the initial value of the
"Symbol"
property of the
global object
returns a new Symbol value when called as a function.
is not intended to be used with the
new
operator.
is not intended to be subclassed.
may be used as the value of an
extends
clause of a class definition but a
super
call to it will cause an exception.
20.4.1.1
Symbol ( [
description
] )
When
Symbol
is called with optional argument
description
, the following steps are taken:
1.
If NewTarget is not
undefined
, throw a
TypeError
exception.
2.
If
description
is
undefined
, let
descString
be
undefined
3.
Else, let
descString
be ?
ToString
description
).
4.
Return a new unique Symbol value whose [[Description]] value is
descString
20.4.2
Properties of the Symbol Constructor
The Symbol
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
20.4.2.1
Symbol.asyncIterator
The initial value of
Symbol.asyncIterator
is the well known symbol
@@asyncIterator
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.2
Symbol.for (
key
When
Symbol.for
is called with argument
key
it performs the following steps:
1.
Let
stringKey
be ?
ToString
key
).
2.
For each element
of the GlobalSymbolRegistry
List
, do
a.
If
SameValue
.[[Key]],
stringKey
) is
true
, return
.[[Symbol]].
3.
Assert
: GlobalSymbolRegistry does not currently contain an entry for
stringKey
4.
Let
newSymbol
be a new unique Symbol value whose [[Description]] value is
stringKey
5.
Append the
Record
{ [[Key]]:
stringKey
, [[Symbol]]:
newSymbol
} to the GlobalSymbolRegistry
List
6.
Return
newSymbol
The GlobalSymbolRegistry is a
List
that is globally available. It is shared by all realms. Prior to the
evaluation of any ECMAScript code it is initialized as a new empty
List
. Elements of the GlobalSymbolRegistry are Records with the structure defined in
Table 51
Table 51: GlobalSymbolRegistry
Record
Fields
Field Name
Value
Usage
[[Key]]
A String
A string key used to globally identify a Symbol.
[[Symbol]]
A Symbol
A symbol that can be retrieved from any
realm
20.4.2.3
Symbol.hasInstance
The initial value of
Symbol.hasInstance
is the well-known symbol
@@hasInstance
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.4
Symbol.isConcatSpreadable
The initial value of
Symbol.isConcatSpreadable
is the well-known symbol
@@isConcatSpreadable
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.5
Symbol.iterator
The initial value of
Symbol.iterator
is the well-known symbol
@@iterator
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.6
Symbol.keyFor (
sym
When
Symbol.keyFor
is called with argument
sym
it performs the following steps:
1.
If
Type
sym
) is not Symbol, throw a
TypeError
exception.
2.
For each element
of the GlobalSymbolRegistry
List
(see
20.4.2.2
), do
a.
If
SameValue
.[[Symbol]],
sym
) is
true
, return
.[[Key]].
3.
Assert
: GlobalSymbolRegistry does not currently contain an entry for
sym
4.
Return
undefined
20.4.2.7
Symbol.match
The initial value of
Symbol.match
is the well-known symbol
@@match
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.8
Symbol.matchAll
The initial value of
Symbol.matchAll
is the well-known symbol
@@matchAll
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.9
Symbol.prototype
The initial value of
Symbol.prototype
is the
Symbol prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.10
Symbol.replace
The initial value of
Symbol.replace
is the well-known symbol
@@replace
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.11
Symbol.search
The initial value of
Symbol.search
is the well-known symbol
@@search
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.12
Symbol.species
The initial value of
Symbol.species
is the well-known symbol
@@species
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.13
Symbol.split
The initial value of
Symbol.split
is the well-known symbol
@@split
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.14
Symbol.toPrimitive
The initial value of
Symbol.toPrimitive
is the well-known symbol
@@toPrimitive
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.15
Symbol.toStringTag
The initial value of
Symbol.toStringTag
is the well-known symbol
@@toStringTag
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.2.16
Symbol.unscopables
The initial value of
Symbol.unscopables
is the well-known symbol
@@unscopables
Table 1
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.4.3
Properties of the Symbol Prototype Object
The
Symbol prototype object
is
%Symbol.prototype%
is an
ordinary object
is not a Symbol instance and does not have a [[SymbolData]] internal slot.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
The abstract operation
thisSymbolValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is Symbol, return
value
2.
If
Type
value
) is Object and
value
has a [[SymbolData]] internal slot, then
a.
Let
be
value
.[[SymbolData]].
b.
Assert
Type
) is Symbol.
c.
Return
3.
Throw a
TypeError
exception.
20.4.3.1
Symbol.prototype.constructor
The initial value of
Symbol.prototype.constructor
is
%Symbol%
20.4.3.2
get Symbol.prototype.description
Symbol.prototype.description
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Let
sym
be ?
thisSymbolValue
).
3.
Return
sym
.[[Description]].
20.4.3.3
Symbol.prototype.toString ( )
The following steps are taken:
1.
Let
sym
be ?
thisSymbolValue
this
value).
2.
Return
SymbolDescriptiveString
sym
).
20.4.3.3.1
SymbolDescriptiveString (
sym
The abstract operation SymbolDescriptiveString takes argument
sym
. It performs the following steps when called:
1.
Assert
Type
sym
) is Symbol.
2.
Let
desc
be
sym
's [[Description]] value.
3.
If
desc
is
undefined
, set
desc
to the empty String.
4.
Assert
Type
desc
) is String.
5.
Return the
string-concatenation
of
"Symbol("
desc
, and
")"
20.4.3.4
Symbol.prototype.valueOf ( )
The following steps are taken:
1.
Return ?
thisSymbolValue
this
value).
20.4.3.5
Symbol.prototype [ @@toPrimitive ] (
hint
This function is called by ECMAScript language operators to convert a Symbol object to a primitive value.
When the
@@toPrimitive
method is called with argument
hint
, the following steps are taken:
1.
Return ?
thisSymbolValue
this
value).
The value of the
"name"
property of this function is
"[Symbol.toPrimitive]"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
Note
The argument is ignored.
20.4.3.6
Symbol.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Symbol"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
20.4.4
Properties of Symbol Instances
Symbol instances are ordinary objects that inherit properties from the
Symbol prototype object
Symbol instances have a [[SymbolData]] internal slot. The
[[SymbolData]] internal slot is the Symbol value represented by this
Symbol object.
20.5
Error Objects
Instances of Error objects are thrown as exceptions when runtime
errors occur. The Error objects may also serve as base objects for
user-defined exception classes.
When an ECMAScript implementation detects a runtime error, it throws a new instance of one of the
NativeError
objects defined in
20.5.5
or a new instance of AggregateError object defined in
20.5.7
. Each of these objects has the structure described below, differing only in the name used as the
constructor
name instead of
NativeError
, in the
name
property of the prototype object, in the
implementation-defined
message
property of the prototype object, and in the presence of the
%AggregateError%
-specific
errors
property.
20.5.1
The Error Constructor
The Error
constructor
is
%Error%
is the initial value of the
"Error"
property of the
global object
creates and initializes a new Error object when called as a function rather than as a
constructor
. Thus the function call
Error(…)
is equivalent to the object creation expression
new Error(…)
with the same arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Error behaviour must include a
super
call to the Error
constructor
to create and initialize subclass instances with an [[ErrorData]] internal slot.
20.5.1.1
Error (
message
When the
Error
function is called with argument
message
, the following steps are taken:
1.
If NewTarget is
undefined
, let
newTarget
be the
active function object
; else let
newTarget
be NewTarget.
2.
Let
be ?
OrdinaryCreateFromConstructor
newTarget
"%Error.prototype%"
, « [[ErrorData]] »).
3.
If
message
is not
undefined
, then
a.
Let
msg
be ?
ToString
message
).
b.
Let
msgDesc
be the PropertyDescriptor { [[Value]]:
msg
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
c.
Perform !
DefinePropertyOrThrow
"message"
msgDesc
).
4.
Return
20.5.2
Properties of the Error Constructor
The Error
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
20.5.2.1
Error.prototype
The initial value of
Error.prototype
is the
Error prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.5.3
Properties of the Error Prototype Object
The
Error prototype object
is
%Error.prototype%
is an
ordinary object
is not an Error instance and does not have an [[ErrorData]] internal slot.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
20.5.3.1
Error.prototype.constructor
The initial value of
Error.prototype.constructor
is
%Error%
20.5.3.2
Error.prototype.message
The initial value of
Error.prototype.message
is the empty String.
20.5.3.3
Error.prototype.name
The initial value of
Error.prototype.name
is
"Error"
20.5.3.4
Error.prototype.toString ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
Let
name
be ?
Get
"name"
).
4.
If
name
is
undefined
, set
name
to
"Error"
; otherwise set
name
to ?
ToString
name
).
5.
Let
msg
be ?
Get
"message"
).
6.
If
msg
is
undefined
, set
msg
to the empty String; otherwise set
msg
to ?
ToString
msg
).
7.
If
name
is the empty String, return
msg
8.
If
msg
is the empty String, return
name
9.
Return the
string-concatenation
of
name
, the code unit 0x003A (COLON), the code unit 0x0020 (SPACE), and
msg
20.5.4
Properties of Error Instances
Error instances are ordinary objects that inherit properties from the
Error prototype object
and have an [[ErrorData]] internal slot whose value is
undefined
. The only specified uses of [[ErrorData]] is to identify Error, AggregateError, and
NativeError
instances as Error objects within
Object.prototype.toString
20.5.5
Native Error Types Used in This Standard
A new instance of one of the
NativeError
objects below or of the AggregateError object is thrown when a runtime error is detected. All
NativeError
objects share the same structure, as described in
20.5.6
20.5.5.1
EvalError
The EvalError
constructor
is
%EvalError%
This exception is not currently used within this
specification. This object remains for compatibility with previous
editions of this specification.
20.5.5.2
RangeError
The RangeError
constructor
is
%RangeError%
Indicates a value that is not in the set or range of allowable values.
20.5.5.3
ReferenceError
The ReferenceError
constructor
is
%ReferenceError%
Indicate that an invalid reference has been detected.
20.5.5.4
SyntaxError
The SyntaxError
constructor
is
%SyntaxError%
Indicates that a parsing error has occurred.
20.5.5.5
TypeError
The TypeError
constructor
is
%TypeError%
TypeError is used to indicate an unsuccessful operation when none of the other
NativeError
objects are an appropriate indication of the failure cause.
20.5.5.6
URIError
The URIError
constructor
is
%URIError%
Indicates that one of the global URI handling functions was used in a way that is incompatible with its definition.
20.5.6
NativeError
Object Structure
When an ECMAScript implementation detects a runtime error, it throws a new instance of one of the
NativeError
objects defined in
20.5.5
. Each of these objects has the structure described below, differing only in the name used as the
constructor
name instead of
NativeError
, in the
"name"
property of the prototype object, and in the
implementation-defined
"message"
property of the prototype object.
For each error object, references to
NativeError
in the definition should be replaced with the appropriate error object name from
20.5.5
20.5.6.1
The
NativeError
Constructors
Each
NativeError
constructor
creates and initializes a new
NativeError
object when called as a function rather than as a
constructor
. A call of the object as a function is equivalent to calling it as a
constructor
with the same arguments. Thus the function call
NativeError
(…)
is equivalent to the object creation expression
new
NativeError
(…)
with the same arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified
NativeError
behaviour must include a
super
call to the
NativeError
constructor
to create and initialize subclass instances with an [[ErrorData]] internal slot.
20.5.6.1.1
NativeError
message
When a
NativeError
function is called with argument
message
, the following steps are taken:
1.
If NewTarget is
undefined
, let
newTarget
be the
active function object
; else let
newTarget
be NewTarget.
2.
Let
be ?
OrdinaryCreateFromConstructor
newTarget
"%
NativeError
.prototype%"
, « [[ErrorData]] »).
3.
If
message
is not
undefined
, then
a.
Let
msg
be ?
ToString
message
).
b.
Let
msgDesc
be the PropertyDescriptor { [[Value]]:
msg
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
c.
Perform !
DefinePropertyOrThrow
"message"
msgDesc
).
4.
Return
The actual value of the string passed in step
is either
"%EvalError.prototype%"
"%RangeError.prototype%"
"%ReferenceError.prototype%"
"%SyntaxError.prototype%"
"%TypeError.prototype%"
, or
"%URIError.prototype%"
corresponding to which
NativeError
constructor
is being defined.
20.5.6.2
Properties of the
NativeError
Constructors
Each
NativeError
constructor
has a [[Prototype]] internal slot whose value is
%Error%
has a
"name"
property whose value is the String value
NativeError
has the following properties:
20.5.6.2.1
NativeError
.prototype
The initial value of
NativeError
.prototype
is a
NativeError
prototype object (
20.5.6.3
). Each
NativeError
constructor
has a distinct prototype object.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.5.6.3
Properties of the
NativeError
Prototype Objects
Each
NativeError
prototype object
is an
ordinary object
is not an Error instance and does not have an [[ErrorData]] internal slot.
has a [[Prototype]] internal slot whose value is
%Error.prototype%
20.5.6.3.1
NativeError
.prototype.constructor
The initial value of the
"constructor"
property of the prototype for a given
NativeError
constructor
is the corresponding intrinsic object %
NativeError
% (
20.5.6.1
).
20.5.6.3.2
NativeError
.prototype.message
The initial value of the
"message"
property of the prototype for a given
NativeError
constructor
is the empty String.
20.5.6.3.3
NativeError
.prototype.name
The initial value of the
"name"
property of the prototype for a given
NativeError
constructor
is the String value consisting of the name of the
constructor
(the name used instead of
NativeError
).
20.5.6.4
Properties of
NativeError
Instances
NativeError
instances are ordinary objects that inherit properties from their
NativeError
prototype object and have an [[ErrorData]] internal slot whose value is
undefined
. The only specified use of [[ErrorData]] is by
Object.prototype.toString
20.1.3.6
) to identify Error, AggregateError, or
NativeError
instances.
20.5.7
AggregateError Objects
20.5.7.1
The AggregateError Constructor
The AggregateError
constructor
is
%AggregateError%
is the initial value of the
"AggregateError"
property of the
global object
creates and initializes a new AggregateError object when called as a function rather than as a
constructor
. Thus the function call
AggregateError(…)
is equivalent to the object creation expression
new AggregateError(…)
with the same arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to
inherit the specified AggregateError behaviour must include a
super
call to the AggregateError
constructor
to create and initialize subclass instances with an [[ErrorData]] internal slot.
20.5.7.1.1
AggregateError (
errors
message
When the
AggregateError
function is called with arguments
errors
and
message
, the following steps are taken:
1.
If NewTarget is
undefined
, let
newTarget
be the
active function object
; else let
newTarget
be NewTarget.
2.
Let
be ?
OrdinaryCreateFromConstructor
newTarget
"%AggregateError.prototype%"
, « [[ErrorData]] »).
3.
If
message
is not
undefined
, then
a.
Let
msg
be ?
ToString
message
).
b.
Let
msgDesc
be the PropertyDescriptor { [[Value]]:
msg
, [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
c.
Perform !
DefinePropertyOrThrow
"message"
msgDesc
).
4.
Let
errorsList
be ?
IterableToList
errors
).
5.
Perform !
DefinePropertyOrThrow
"errors"
, PropertyDescriptor { [[Configurable]]:
true
, [[Enumerable]]:
false
, [[Writable]]:
true
, [[Value]]: !
CreateArrayFromList
errorsList
) }).
6.
Return
20.5.7.2
Properties of the AggregateError Constructor
The AggregateError
constructor
has a [[Prototype]] internal slot whose value is
%Error%
has the following properties:
20.5.7.2.1
AggregateError.prototype
The initial value of
AggregateError.prototype
is
%AggregateError.prototype%
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
20.5.7.3
Properties of the AggregateError Prototype Object
The
AggregateError prototype object
is
%AggregateError.prototype%
is an
ordinary object
is not an Error instance or an AggregateError instance and does not have an [[ErrorData]] internal slot.
has a [[Prototype]] internal slot whose value is
%Error.prototype%
20.5.7.3.1
AggregateError.prototype.constructor
The initial value of
AggregateError.prototype.constructor
is
%AggregateError%
20.5.7.3.2
AggregateError.prototype.message
The initial value of
AggregateError.prototype.message
is the empty String.
20.5.7.3.3
AggregateError.prototype.name
The initial value of
AggregateError.prototype.name
is
"AggregateError"
20.5.7.4
Properties of AggregateError Instances
AggregateError instances are ordinary objects that inherit properties from their
AggregateError prototype object
and have an [[ErrorData]] internal slot whose value is
undefined
. The only specified use of [[ErrorData]] is by
Object.prototype.toString
20.1.3.6
) to identify Error, AggregateError, or
NativeError
instances.
21
Numbers and Dates
21.1
Number Objects
21.1.1
The Number Constructor
The Number
constructor
is
%Number%
is the initial value of the
"Number"
property of the
global object
creates and initializes a new Number object when called as a
constructor
performs a type conversion when called as a function rather than as a
constructor
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Number behaviour must include a
super
call to the Number
constructor
to create and initialize the subclass instance with a [[NumberData]] internal slot.
21.1.1.1
Number (
value
When
Number
is called with argument
value
, the following steps are taken:
1.
If
value
is present, then
a.
Let
prim
be ?
ToNumeric
value
).
b.
If
Type
prim
) is BigInt, let
be
prim
)).
c.
Otherwise, let
be
prim
2.
Else,
a.
Let
be
+0
3.
If NewTarget is
undefined
, return
4.
Let
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Number.prototype%"
, « [[NumberData]] »).
5.
Set
.[[NumberData]] to
6.
Return
21.1.2
Properties of the Number Constructor
The Number
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
21.1.2.1
Number.EPSILON
The value of
Number.EPSILON
is the
Number value
for the magnitude of the difference between 1 and the smallest value greater than 1 that is representable as a
Number value
, which is approximately 2.2204460492503130808472633361816 × 10
-16
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.2
Number.isFinite (
number
When
Number.isFinite
is called with one argument
number
, the following steps are taken:
1.
If
Type
number
) is not Number, return
false
2.
If
number
is
NaN
+∞
, or
-∞
, return
false
3.
Otherwise, return
true
21.1.2.3
Number.isInteger (
number
When
Number.isInteger
is called with one argument
number
, the following steps are taken:
1.
Return !
IsIntegralNumber
number
).
21.1.2.4
Number.isNaN (
number
When
Number.isNaN
is called with one argument
number
, the following steps are taken:
1.
If
Type
number
) is not Number, return
false
2.
If
number
is
NaN
, return
true
3.
Otherwise, return
false
Note
This function differs from the global isNaN function (
19.2.3
) in that it does not convert its argument to a Number before determining whether it is
NaN
21.1.2.5
Number.isSafeInteger (
number
When
Number.isSafeInteger
is called with one argument
number
, the following steps are taken:
1.
If !
IsIntegralNumber
number
) is
true
, then
a.
If
abs
number
)) ≤ 2
53
- 1, return
true
2.
Return
false
21.1.2.6
Number.MAX_SAFE_INTEGER
Note
The value of
Number.MAX_SAFE_INTEGER
is the largest
integral Number
n such that
(n) and
(n) + 1 are both exactly representable as a
Number value
The value of
Number.MAX_SAFE_INTEGER
is
9007199254740991
(2
53
- 1)).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.7
Number.MAX_VALUE
The value of
Number.MAX_VALUE
is the largest positive finite value of the Number type, which is approximately
1.7976931348623157 × 10
308
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.8
Number.MIN_SAFE_INTEGER
Note
The value of
Number.MIN_SAFE_INTEGER
is the smallest
integral Number
n such that
(n) and
(n) - 1 are both exactly representable as a
Number value
The value of
Number.MIN_SAFE_INTEGER
is
-9007199254740991
(-(2
53
- 1))).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.9
Number.MIN_VALUE
The value of
Number.MIN_VALUE
is the smallest positive value of the Number type, which is approximately
5 × 10
-324
In the
IEEE 754-2019
double precision binary representation, the smallest possible value is a
denormalized number. If an implementation does not support denormalized
values, the value of
Number.MIN_VALUE
must be the smallest non-zero positive value that can actually be represented by the implementation.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.10
Number.NaN
The value of
Number.NaN
is
NaN
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.11
Number.NEGATIVE_INFINITY
The value of
Number.NEGATIVE_INFINITY
is
-∞
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.12
Number.parseFloat (
string
The value of the
Number.parseFloat
data property
is the same built-in
function object
that is the initial value of the
"parseFloat"
property of the
global object
defined in
19.2.4
21.1.2.13
Number.parseInt (
string
radix
The value of the
Number.parseInt
data property
is the same built-in
function object
that is the initial value of the
"parseInt"
property of the
global object
defined in
19.2.5
21.1.2.14
Number.POSITIVE_INFINITY
The value of
Number.POSITIVE_INFINITY
is
+∞
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.2.15
Number.prototype
The initial value of
Number.prototype
is the
Number prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.1.3
Properties of the Number Prototype Object
The
Number prototype object
is
%Number.prototype%
is an
ordinary object
is itself a Number object; it has a [[NumberData]] internal slot with the value
+0
has a [[Prototype]] internal slot whose value is
%Object.prototype%
Unless explicitly stated otherwise, the methods of the Number prototype object defined below are not generic and the
this
value passed to them must be either a
Number value
or an object that has a [[NumberData]] internal slot that has been initialized to a
Number value
The abstract operation
thisNumberValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is Number, return
value
2.
If
Type
value
) is Object and
value
has a [[NumberData]] internal slot, then
a.
Let
be
value
.[[NumberData]].
b.
Assert
Type
) is Number.
c.
Return
3.
Throw a
TypeError
exception.
The phrase “this
Number value
” within the specification of a method refers to the result returned by calling the abstract operation
thisNumberValue
with the
this
value of the method invocation passed as the argument.
21.1.3.1
Number.prototype.constructor
The initial value of
Number.prototype.constructor
is
%Number%
21.1.3.2
Number.prototype.toExponential (
fractionDigits
Return a String containing this
Number value
represented in decimal exponential notation with one digit before the significand's decimal point and
fractionDigits
digits after the significand's decimal point. If
fractionDigits
is
undefined
, include as many significand digits as necessary to uniquely specify the Number (just like in
ToString
except that in this case the Number is always output in exponential notation). Specifically, perform the following steps:
1.
Let
be ?
thisNumberValue
this
value).
2.
Let
be ?
ToIntegerOrInfinity
fractionDigits
).
3.
Assert
: If
fractionDigits
is
undefined
, then
is 0.
4.
If
is not finite, return !
Number::toString
).
5.
If
< 0 or
> 100, throw a
RangeError
exception.
6.
Set
to
).
7.
Let
be the empty String.
8.
If
< 0, then
a.
Set
to
"-"
b.
Set
to -
9.
If
= 0, then
a.
Let
be the String value consisting of
+ 1 occurrences of the code unit 0x0030 (DIGIT ZERO).
b.
Let
be 0.
10.
Else,
a.
If
fractionDigits
is not
undefined
, then
i.
Let
and
be integers such that 10
< 10
+ 1
and for which
× 10
is as close to zero as possible. If there are two such sets of
and
, pick the
and
for which
× 10
is larger.
b.
Else,
i.
Let
, and
be integers such that
≥ 0, 10
< 10
+ 1
× 10
is
, and
is as small as possible. Note that the decimal representation of
has
+ 1 digits,
is not divisible by 10, and the least significant digit of
is not necessarily uniquely determined by these criteria.
c.
Let
be the String value consisting of the digits of the decimal representation of
(in order, with no leading zeroes).
11.
If
≠ 0, then
a.
Let
be the first code unit of
b.
Let
be the other
code units of
c.
Set
to the
string-concatenation
of
"."
, and
12.
If
= 0, then
a.
Let
be
"+"
b.
Let
be
"0"
13.
Else,
a.
If
> 0, let
be
"+"
b.
Else,
i.
Assert
< 0.
ii.
Let
be
"-"
iii.
Set
to -
c.
Let
be the String value consisting of the digits of the decimal representation of
(in order, with no leading zeroes).
14.
Set
to the
string-concatenation
of
"e"
, and
15.
Return the
string-concatenation
of
and
Note
For implementations that provide more accurate conversions
than required by the rules above, it is recommended that the following
alternative version of step
10.b.i
be used as a guideline:
1.
Let
, and
be integers such that
≥ 0, 10
< 10
+ 1
× 10
is
, and
is as small as possible. If there are multiple possibilities for
, choose the value of
for which
× 10
is closest in value to
. If there are two such possible values of
, choose the one that is even.
21.1.3.3
Number.prototype.toFixed (
fractionDigits
Note 1
toFixed
returns a String containing this
Number value
represented in decimal fixed-point notation with
fractionDigits
digits after the decimal point. If
fractionDigits
is
undefined
, 0 is assumed.
The following steps are performed:
1.
Let
be ?
thisNumberValue
this
value).
2.
Let
be ?
ToIntegerOrInfinity
fractionDigits
).
3.
Assert
: If
fractionDigits
is
undefined
, then
is 0.
4.
If
is not finite, throw a
RangeError
exception.
5.
If
< 0 or
> 100, throw a
RangeError
exception.
6.
If
is not finite, return !
Number::toString
).
7.
Set
to
).
8.
Let
be the empty String.
9.
If
< 0, then
a.
Set
to
"-"
b.
Set
to -
10.
If
≥ 10
21
, then
a.
Let
be !
ToString
)).
11.
Else,
a.
Let
be an
integer
for which
/ 10
is as close to zero as possible. If there are two such
, pick the larger
b.
If
= 0, let
be the String
"0"
. Otherwise, let
be the String value consisting of the digits of the decimal representation of
(in order, with no leading zeroes).
c.
If
≠ 0, then
i.
Let
be the length of
ii.
If
, then
1.
Let
be the String value consisting of
+ 1 -
occurrences of the code unit 0x0030 (DIGIT ZERO).
2.
Set
to the
string-concatenation
of
and
3.
Set
to
+ 1.
iii.
Let
be the first
code units of
iv.
Let
be the other
code units of
v.
Set
to the
string-concatenation
of
"."
, and
12.
Return the
string-concatenation
of
and
Note 2
The output of
toFixed
may be more precise than
toString
for some values because toString only prints enough significant digits
to distinguish the number from adjacent Number values. For example,
(1000000000000000128).toString()
returns
"1000000000000000100"
, while
(1000000000000000128).toFixed(0)
returns
"1000000000000000128"
21.1.3.4
Number.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
Number.prototype.toLocaleString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleString
method is used.
Produces a String value that represents this
Number value
formatted according to the conventions of the
host environment
's current locale. This function is
implementation-defined
, and it is permissible, but not encouraged, for it to return the same thing as
toString
The meanings of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
21.1.3.5
Number.prototype.toPrecision (
precision
Return a String containing this
Number value
represented either in decimal exponential notation with one digit before the significand's decimal point and
precision
- 1
digits after the significand's decimal point or in decimal fixed notation with
precision
significant digits. If
precision
is
undefined
, call
ToString
instead. Specifically, perform the following steps:
1.
Let
be ?
thisNumberValue
this
value).
2.
If
precision
is
undefined
, return !
ToString
).
3.
Let
be ?
ToIntegerOrInfinity
precision
).
4.
If
is not finite, return !
Number::toString
).
5.
If
< 1 or
> 100, throw a
RangeError
exception.
6.
Set
to
).
7.
Let
be the empty String.
8.
If
< 0, then
a.
Set
to the code unit 0x002D (HYPHEN-MINUS).
b.
Set
to -
9.
If
= 0, then
a.
Let
be the String value consisting of
occurrences of the code unit 0x0030 (DIGIT ZERO).
b.
Let
be 0.
10.
Else,
a.
Let
and
be integers such that 10
- 1
< 10
and for which
× 10
+ 1
is as close to zero as possible. If there are two such sets of
and
, pick the
and
for which
× 10
+ 1
is larger.
b.
Let
be the String value consisting of the digits of the decimal representation of
(in order, with no leading zeroes).
c.
If
< -6 or
, then
i.
Assert
≠ 0.
ii.
If
≠ 1, then
1.
Let
be the first code unit of
2.
Let
be the other
- 1 code units of
3.
Set
to the
string-concatenation
of
"."
, and
iii.
If
> 0, then
1.
Let
be the code unit 0x002B (PLUS SIGN).
iv.
Else,
1.
Assert
< 0.
2.
Let
be the code unit 0x002D (HYPHEN-MINUS).
3.
Set
to -
v.
Let
be the String value consisting of the digits of the decimal representation of
(in order, with no leading zeroes).
vi.
Return the
string-concatenation
of
, the code unit 0x0065 (LATIN SMALL LETTER E),
, and
11.
If
- 1, return the
string-concatenation
of
and
12.
If
≥ 0, then
a.
Set
to the
string-concatenation
of the first
+ 1 code units of
, the code unit 0x002E (FULL STOP), and the remaining
- (
+ 1) code units of
13.
Else,
a.
Set
to the
string-concatenation
of the code unit 0x0030 (DIGIT ZERO), the code unit 0x002E (FULL STOP), -(
+ 1) occurrences of the code unit 0x0030 (DIGIT ZERO), and the String
14.
Return the
string-concatenation
of
and
21.1.3.6
Number.prototype.toString ( [
radix
] )
Note
The optional
radix
should be an
integral Number
value in the inclusive range
to
36
. If
radix
is
undefined
then
10
is used as the value of
radix
The following steps are performed:
1.
Let
be ?
thisNumberValue
this
value).
2.
If
radix
is
undefined
, let
radixMV
be 10.
3.
Else, let
radixMV
be ?
ToIntegerOrInfinity
radix
).
4.
If
radixMV
< 2 or
radixMV
> 36, throw a
RangeError
exception.
5.
If
radixMV
= 10, return !
ToString
).
6.
Return the String representation of this
Number value
using the radix specified by
radixMV
. Letters
are used for digits with values 10 through 35. The precise algorithm is
implementation-defined
, however the algorithm should be a generalization of that specified in
6.1.6.1.20
The
toString
function is not generic; it throws a
TypeError
exception if its
this
value is not a Number or a Number object. Therefore, it cannot be transferred to other kinds of objects for use as a method.
The
"length"
property of the
toString
method is
21.1.3.7
Number.prototype.valueOf ( )
1.
Return ?
thisNumberValue
this
value).
21.1.4
Properties of Number Instances
Number instances are ordinary objects that inherit properties from the
Number prototype object
. Number instances also have a [[NumberData]] internal slot. The [[NumberData]] internal slot is the
Number value
represented by this Number object.
21.2
BigInt Objects
21.2.1
The BigInt Constructor
The BigInt
constructor
is
%BigInt%
is the initial value of the
"BigInt"
property of the
global object
performs a type conversion when called as a function rather than as a
constructor
is not intended to be used with the
new
operator or to be subclassed. It may be used as the value of an
extends
clause of a class definition but a
super
call to the BigInt
constructor
will cause an exception.
21.2.1.1
BigInt (
value
When
BigInt
is called with argument
value
, the following steps are taken:
1.
If NewTarget is not
undefined
, throw a
TypeError
exception.
2.
Let
prim
be ?
ToPrimitive
value
number
).
3.
If
Type
prim
) is Number, return ?
NumberToBigInt
prim
).
4.
Otherwise, return ?
ToBigInt
value
).
21.2.1.1.1
NumberToBigInt (
number
The abstract operation NumberToBigInt takes argument
number
(a Number). It performs the following steps when called:
1.
If
IsIntegralNumber
number
) is
false
, throw a
RangeError
exception.
2.
Return the BigInt value that represents
number
).
21.2.2
Properties of the BigInt Constructor
The value of the [[Prototype]] internal slot of the BigInt
constructor
is
%Function.prototype%
The BigInt
constructor
has the following properties:
21.2.2.1
BigInt.asIntN (
bits
bigint
When the
BigInt.asIntN
function is called with two arguments
bits
and
bigint
, the following steps are taken:
1.
Set
bits
to ?
ToIndex
bits
).
2.
Set
bigint
to ?
ToBigInt
bigint
).
3.
Let
mod
be
bigint
modulo
bits
4.
If
mod
≥ 2
bits
- 1
, return
mod
- 2
bits
); otherwise, return
mod
).
21.2.2.2
BigInt.asUintN (
bits
bigint
When the
BigInt.asUintN
function is called with two arguments
bits
and
bigint
, the following steps are taken:
1.
Set
bits
to ?
ToIndex
bits
).
2.
Set
bigint
to ?
ToBigInt
bigint
).
3.
Return the BigInt value that represents
bigint
modulo
bits
21.2.2.3
BigInt.prototype
The initial value of
BigInt.prototype
is the
BigInt prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.2.3
Properties of the BigInt Prototype Object
The
BigInt prototype object
is
%BigInt.prototype%
is an
ordinary object
is not a BigInt object; it does not have a [[BigIntData]] internal slot.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
The abstract operation
thisBigIntValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is BigInt, return
value
2.
If
Type
value
) is Object and
value
has a [[BigIntData]] internal slot, then
a.
Assert
Type
value
.[[BigIntData]]) is BigInt.
b.
Return
value
.[[BigIntData]].
3.
Throw a
TypeError
exception.
The phrase “this BigInt value” within the specification of a
method refers to the result returned by calling the abstract operation
thisBigIntValue
with the
this
value of the method invocation passed as the argument.
21.2.3.1
BigInt.prototype.constructor
The initial value of
BigInt.prototype.constructor
is
%BigInt%
21.2.3.2
BigInt.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
BigInt.prototype.toLocaleString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleString
method is used.
Produces a String value that represents this BigInt value formatted according to the conventions of the
host environment
's current locale. This function is
implementation-defined
, and it is permissible, but not encouraged, for it to return the same thing as
toString
The meanings of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
21.2.3.3
BigInt.prototype.toString ( [
radix
] )
Note
The optional
radix
should be an
integral Number
value in the inclusive range
to
36
. If
radix
is
undefined
then
10
is used as the value of
radix
The following steps are performed:
1.
Let
be ?
thisBigIntValue
this
value).
2.
If
radix
is
undefined
, let
radixMV
be 10.
3.
Else, let
radixMV
be ?
ToIntegerOrInfinity
radix
).
4.
If
radixMV
< 2 or
radixMV
> 36, throw a
RangeError
exception.
5.
If
radixMV
= 10, return !
ToString
).
6.
Return the String representation of this
Number value
using the radix specified by
radixMV
. Letters
are used for digits with values 10 through 35. The precise algorithm is
implementation-defined
, however the algorithm should be a generalization of that specified in
6.1.6.2.23
The
toString
function is not generic; it throws a
TypeError
exception if its
this
value is not a BigInt or a BigInt object. Therefore, it cannot be transferred to other kinds of objects for use as a method.
21.2.3.4
BigInt.prototype.valueOf ( )
1.
Return ?
thisBigIntValue
this
value).
21.2.3.5
BigInt.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"BigInt"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
21.3
The Math Object
The Math object:
is
%Math%
is the initial value of the
"Math"
property of the
global object
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is not a
function object
does not have a [[Construct]] internal method; it cannot be used as a
constructor
with the
new
operator.
does not have a [[Call]] internal method; it cannot be invoked as a function.
Note
In this specification, the phrase “the
Number value
for
” has a technical meaning defined in
6.1.6.1
21.3.1
Value Properties of the Math Object
21.3.1.1
Math.E
The
Number value
for
, the base of the natural logarithms, which is approximately 2.7182818284590452354.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.3.1.2
Math.LN10
The
Number value
for the natural logarithm of 10, which is approximately 2.302585092994046.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.3.1.3
Math.LN2
The
Number value
for the natural logarithm of 2, which is approximately 0.6931471805599453.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.3.1.4
Math.LOG10E
The
Number value
for the base-10 logarithm of
, the base of the natural logarithms; this value is approximately 0.4342944819032518.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
The value of
Math.LOG10E
is approximately the reciprocal of the value of
Math.LN10
21.3.1.5
Math.LOG2E
The
Number value
for the base-2 logarithm of
, the base of the natural logarithms; this value is approximately 1.4426950408889634.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
The value of
Math.LOG2E
is approximately the reciprocal of the value of
Math.LN2
21.3.1.6
Math.PI
The
Number value
for π, the ratio of the circumference of a circle to its diameter, which is approximately 3.1415926535897932.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.3.1.7
Math.SQRT1_2
The
Number value
for the square root of ½, which is approximately 0.7071067811865476.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
The value of
Math.SQRT1_2
is approximately the reciprocal of the value of
Math.SQRT2
21.3.1.8
Math.SQRT2
The
Number value
for the square root of 2, which is approximately 1.4142135623730951.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.3.1.9
Math [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Math"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
21.3.2
Function Properties of the Math Object
Note
The behaviour of the functions
acos
acosh
asin
asinh
atan
atanh
atan2
cbrt
cos
cosh
exp
expm1
hypot
log
log1p
log2
log10
pow
random
sin
sinh
sqrt
tan
, and
tanh
is not precisely specified here except to require specific results for
certain argument values that represent boundary cases of interest. For
other argument values, these functions are intended to compute
approximations to the results of familiar mathematical functions, but
some latitude is allowed in the choice of approximation algorithms. The
general intent is that an implementer should be able to use the same
mathematical library for ECMAScript on a given hardware platform that is
available to C programmers on that platform.
Although the choice of algorithms is left to the
implementation, it is recommended (but not specified by this standard)
that implementations use the approximation algorithms for
IEEE 754-2019
arithmetic contained in
fdlibm
, the freely distributable mathematical library from Sun Microsystems (
).
21.3.2.1
Math.abs (
Returns the absolute value of
; the result has the same magnitude as
but has positive sign.
When the
Math.abs
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
, return
NaN
3.
If
is
-0
, return
+0
4.
If
is
-∞
, return
+∞
5.
If
+0
, return -
6.
Return
21.3.2.2
Math.acos (
Returns the inverse cosine of
. The result is expressed in radians and ranges from
+0
to
(π), inclusive.
When the
Math.acos
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
, or
-1
, return
NaN
3.
If
is
, return
+0
4.
Return an
implementation-approximated
value representing the result of the inverse cosine of
).
21.3.2.3
Math.acosh (
Returns the inverse hyperbolic cosine of
When the
Math.acosh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
or
is
+∞
, return
3.
If
is
, return
+0
4.
If
, return
NaN
5.
Return an
implementation-approximated
value representing the result of the inverse hyperbolic cosine of
).
21.3.2.4
Math.asin (
Returns the inverse sine of
. The result is expressed in radians and ranges from
(-π / 2) to
(π / 2), inclusive.
When the
Math.asin
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
or
-1
, return
NaN
4.
Return an
implementation-approximated
value representing the result of the inverse sine of
).
21.3.2.5
Math.asinh (
Returns the inverse hyperbolic sine of
When the
Math.asinh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
Return an
implementation-approximated
value representing the result of the inverse hyperbolic sine of
).
21.3.2.6
Math.atan (
Returns the inverse tangent of
. The result is expressed in radians and ranges from
(-π / 2) to
(π / 2), inclusive.
When the
Math.atan
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
is
+∞
, return an
implementation-approximated
value representing π / 2.
4.
If
is
-∞
, return an
implementation-approximated
value representing -π / 2.
5.
Return an
implementation-approximated
value representing the result of the inverse tangent of
).
21.3.2.7
Math.atanh (
Returns the inverse hyperbolic tangent of
When the
Math.atanh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
or
-1
, return
NaN
4.
If
is
, return
+∞
5.
If
is
-1
, return
-∞
6.
Return an
implementation-approximated
value representing the result of the inverse hyperbolic tangent of
).
21.3.2.8
Math.atan2 (
Returns the inverse tangent of the quotient
of the arguments
and
, where the signs of
and
are used to determine the quadrant of the result. Note that it is
intentional and traditional for the two-argument inverse tangent
function that the argument named
be first and the argument named
be second. The result is expressed in radians and ranges from -π to +π, inclusive.
When the
Math.atan2
method is called with arguments
and
, the following steps are taken:
1.
Let
ny
be ?
ToNumber
).
2.
Let
nx
be ?
ToNumber
).
3.
If
ny
is
NaN
or
nx
is
NaN
, return
NaN
4.
If
ny
is
+∞
, then
a.
If
nx
is
+∞
, return an
implementation-approximated
value representing π / 4.
b.
If
nx
is
-∞
, return an
implementation-approximated
value representing 3π / 4.
c.
Return an
implementation-approximated
value representing π / 2.
5.
If
ny
is
-∞
, then
a.
If
nx
is
+∞
, return an
implementation-approximated
value representing -π / 4.
b.
If
nx
is
-∞
, return an
implementation-approximated
value representing -3π / 4.
c.
Return an
implementation-approximated
value representing -π / 2.
6.
If
ny
is
+0
, then
a.
If
nx
+0
or
nx
is
+0
, return
+0
b.
Return an
implementation-approximated
value representing π.
7.
If
ny
is
-0
, then
a.
If
nx
+0
or
nx
is
+0
, return
-0
b.
Return an
implementation-approximated
value representing -π.
8.
Assert
ny
is finite and is neither
+0
nor
-0
9.
If
ny
+0
, then
a.
If
nx
is
+∞
, return
+0
b.
If
nx
is
-∞
, return an
implementation-approximated
value representing π.
c.
If
nx
is
+0
or
nx
is
-0
, return an
implementation-approximated
value representing π / 2.
10.
If
ny
+0
, then
a.
If
nx
is
+∞
, return
-0
b.
If
nx
is
-∞
, return an
implementation-approximated
value representing -π.
c.
If
nx
is
+0
or
nx
is
-0
, return an
implementation-approximated
value representing -π / 2.
11.
Assert
nx
is finite and is neither
+0
nor
-0
12.
Return an
implementation-approximated
value representing the result of the inverse tangent of the quotient
ny
) /
nx
).
21.3.2.9
Math.cbrt (
Returns the cube root of
When the
Math.cbrt
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
Return an
implementation-approximated
value representing the result of the cube root of
).
21.3.2.10
Math.ceil (
Returns the smallest (closest to -∞)
integral Number
value that is not less than
. If
is already an
integral Number
, the result is
When the
Math.ceil
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
If
+0
and
-1
, return
-0
4.
If
is an
integral Number
, return
5.
Return the smallest (closest to -∞)
integral Number
value that is not less than
Note
The value of
Math.ceil(x)
is the same as the value of
-Math.floor(-x)
21.3.2.11
Math.clz32 (
When the
Math.clz32
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToUint32
).
2.
Let
be the number of leading zero bits in the unsigned 32-bit binary representation of
3.
Return
).
Note
If
is
+0
or
is
-0
, this method returns
32
. If the most significant bit of the 32-bit binary encoding of
is 1, this method returns
+0
21.3.2.12
Math.cos (
Returns the cosine of
. The argument is expressed in radians.
When the
Math.cos
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
is
+∞
or
is
-∞
, return
NaN
4.
Return an
implementation-approximated
value representing the result of the cosine of
).
21.3.2.13
Math.cosh (
Returns the hyperbolic cosine of
When the
Math.cosh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+∞
, or
is
-∞
, return
3.
If
is
+0
or
is
-0
, return
4.
Return an
implementation-approximated
value representing the result of the hyperbolic cosine of
).
Note
The value of
Math.cosh(x)
is the same as the value of
(Math.exp(x) + Math.exp(-x)) / 2
21.3.2.14
Math.exp (
Returns the exponential function of
raised to the power of
, where
is the base of the natural logarithms).
When the
Math.exp
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
or
is
+∞
, return
3.
If
is
+0
or
is
-0
, return
4.
If
is
-∞
, return
+0
5.
Return an
implementation-approximated
value representing the result of the exponential function of
).
21.3.2.15
Math.expm1 (
Returns the result of subtracting 1 from the exponential function of
raised to the power of
, where
is the base of the natural logarithms). The result is computed in a way that is accurate even when the value of
is close to 0.
When the
Math.expm1
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
, or
is
+∞
, return
3.
If
is
-∞
, return
-1
4.
Return an
implementation-approximated
value representing the result of subtracting 1 from the exponential function of
).
21.3.2.16
Math.floor (
Returns the greatest (closest to +∞)
integral Number
value that is not greater than
. If
is already an
integral Number
, the result is
When the
Math.floor
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
If
and
+0
, return
+0
4.
If
is an
integral Number
, return
5.
Return the greatest (closest to +∞)
integral Number
value that is not greater than
Note
The value of
Math.floor(x)
is the same as the value of
-Math.ceil(-x)
21.3.2.17
Math.fround (
When the
Math.fround
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
, return
NaN
3.
If
is one of
+0
-0
+∞
, or
-∞
, return
4.
Let
n32
be the result of converting
to a value in
IEEE 754-2019
binary32 format using roundTiesToEven mode.
5.
Let
n64
be the result of converting
n32
to a value in
IEEE 754-2019
binary64 format.
6.
Return the ECMAScript
Number value
corresponding to
n64
21.3.2.18
Math.hypot ( ...
args
Returns the square root of the sum of squares of its arguments.
When the
Math.hypot
method is called with zero or more arguments which form the rest parameter ...
args
, the following steps are taken:
1.
Let
coerced
be a new empty
List
2.
For each element
arg
of
args
, do
a.
Let
be ?
ToNumber
arg
).
b.
Append
to
coerced
3.
Let
onlyZero
be
true
4.
For each element
number
of
coerced
, do
a.
If
number
is
NaN
or
number
is
+∞
, return
number
b.
If
number
is
-∞
, return
+∞
c.
If
number
is neither
+0
nor
-0
, set
onlyZero
to
false
5.
If
onlyZero
is
true
, return
+0
6.
Return an
implementation-approximated
value representing the square root of the sum of squares of the mathematical values of the elements of
coerced
The
"length"
property of the
hypot
method is
Note
Implementations should take care to avoid the loss of
precision from overflows and underflows that are prone to occur in naive
implementations when this function is called with two or more
arguments.
21.3.2.19
Math.imul (
When
Math.imul
is called with arguments
and
, the following steps are taken:
1.
Let
be
(?
ToUint32
)).
2.
Let
be
(?
ToUint32
)).
3.
Let
product
be (
modulo
32
4.
If
product
≥ 2
31
, return
product
- 2
32
); otherwise return
product
).
21.3.2.20
Math.log (
Returns the natural logarithm of
When the
Math.log
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
or
is
+∞
, return
3.
If
is
, return
+0
4.
If
is
+0
or
is
-0
, return
-∞
5.
If
+0
, return
NaN
6.
Return an
implementation-approximated
value representing the result of the natural logarithm of
).
21.3.2.21
Math.log1p (
Returns the natural logarithm of 1 +
. The result is computed in a way that is accurate even when the value of x is close to zero.
When the
Math.log1p
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
, or
is
+∞
, return
3.
If
is
-1
, return
-∞
4.
If
-1
, return
NaN
5.
Return an
implementation-approximated
value representing the result of the natural logarithm of 1 +
).
21.3.2.22
Math.log10 (
Returns the base 10 logarithm of
When the
Math.log10
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
or
is
+∞
, return
3.
If
is
, return
+0
4.
If
is
+0
or
is
-0
, return
-∞
5.
If
+0
, return
NaN
6.
Return an
implementation-approximated
value representing the result of the base 10 logarithm of
).
21.3.2.23
Math.log2 (
Returns the base 2 logarithm of
When the
Math.log2
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
or
is
+∞
, return
3.
If
is
, return
+0
4.
If
is
+0
or
is
-0
, return
-∞
5.
If
+0
, return
NaN
6.
Return an
implementation-approximated
value representing the result of the base 2 logarithm of
).
21.3.2.24
Math.max ( ...
args
Given zero or more arguments, calls
ToNumber
on each of the arguments and returns the largest of the resulting values.
When the
Math.max
method is called with zero or more arguments which form the rest parameter ...
args
, the following steps are taken:
1.
Let
coerced
be a new empty
List
2.
For each element
arg
of
args
, do
a.
Let
be ?
ToNumber
arg
).
b.
Append
to
coerced
3.
Let
highest
be
-∞
4.
For each element
number
of
coerced
, do
a.
If
number
is
NaN
, return
NaN
b.
If
number
is
+0
and
highest
is
-0
, set
highest
to
+0
c.
If
number
highest
, set
highest
to
number
5.
Return
highest
Note
The comparison of values to determine the largest value is done using the
Abstract Relational Comparison
algorithm except that
+0
is considered to be larger than
-0
The
"length"
property of the
max
method is
21.3.2.25
Math.min ( ...
args
Given zero or more arguments, calls
ToNumber
on each of the arguments and returns the smallest of the resulting values.
When the
Math.min
method is called with zero or more arguments which form the rest parameter ...
args
, the following steps are taken:
1.
Let
coerced
be a new empty
List
2.
For each element
arg
of
args
, do
a.
Let
be ?
ToNumber
arg
).
b.
Append
to
coerced
3.
Let
lowest
be
+∞
4.
For each element
number
of
coerced
, do
a.
If
number
is
NaN
, return
NaN
b.
If
number
is
-0
and
lowest
is
+0
, set
lowest
to
-0
c.
If
number
lowest
, set
lowest
to
number
5.
Return
lowest
Note
The comparison of values to determine the largest value is done using the
Abstract Relational Comparison
algorithm except that
+0
is considered to be larger than
-0
The
"length"
property of the
min
method is
21.3.2.26
Math.pow (
base
exponent
When the
Math.pow
method is called with arguments
base
and
exponent
, the following steps are taken:
1.
Set
base
to ?
ToNumber
base
).
2.
Set
exponent
to ?
ToNumber
exponent
).
3.
Return ! Number::exponentiate(
base
exponent
).
21.3.2.27
Math.random ( )
Returns a
Number value
with positive sign, greater than or equal to
+0
but strictly less than
, chosen randomly or pseudo randomly with approximately uniform distribution over that range, using an
implementation-defined
algorithm or strategy. This function takes no arguments.
Each
Math.random
function created for distinct realms must produce a distinct sequence of values from successive calls.
21.3.2.28
Math.round (
Returns the
Number value
that is closest to
and is integral. If two integral Numbers are equally close to
, then the result is the
Number value
that is closer to +∞. If
is already integral, the result is
When the
Math.round
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
+∞
-∞
, or an
integral Number
, return
3.
If
0.5
and
+0
, return
+0
4.
If
+0
and
-0.5
, return
-0
5.
Return the
integral Number
closest to
, preferring the Number closer to +∞ in the case of a tie.
Note 1
Math.round(3.5)
returns 4, but
Math.round(-3.5)
returns -3.
Note 2
The value of
Math.round(x)
is not always the same as the value of
Math.floor(x + 0.5)
. When
is
-0
or is less than
+0
but greater than or equal to
-0.5
Math.round(x)
returns
-0
, but
Math.floor(x + 0.5)
returns
+0
Math.round(x)
may also differ from the value of
Math.floor(x + 0.5)
because of internal rounding when computing
x + 0.5
21.3.2.29
Math.sign (
Returns the sign of
, indicating whether
is positive, negative, or zero.
When the
Math.sign
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
+0
, return
-1
4.
Return
21.3.2.30
Math.sin (
Returns the sine of
. The argument is expressed in radians.
When the
Math.sin
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
is
+∞
or
is
-∞
, return
NaN
4.
Return an
implementation-approximated
value representing the result of the sine of
).
21.3.2.31
Math.sinh (
Returns the hyperbolic sine of
When the
Math.sinh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
Return an
implementation-approximated
value representing the result of the hyperbolic sine of
).
Note
The value of
Math.sinh(x)
is the same as the value of
(Math.exp(x) - Math.exp(-x)) / 2
21.3.2.32
Math.sqrt (
Returns the square root of
When the
Math.sqrt
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
, or
is
+∞
, return
3.
If
+0
, return
NaN
4.
Return an
implementation-approximated
value representing the result of the square root of
).
21.3.2.33
Math.tan (
Returns the tangent of
. The argument is expressed in radians.
When the
Math.tan
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
is
+∞
, or
is
-∞
, return
NaN
4.
Return an
implementation-approximated
value representing the result of the tangent of
).
21.3.2.34
Math.tanh (
Returns the hyperbolic tangent of
When the
Math.tanh
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
, or
is
-0
, return
3.
If
is
+∞
, return
4.
If
is
-∞
, return
-1
5.
Return an
implementation-approximated
value representing the result of the hyperbolic tangent of
).
Note
The value of
Math.tanh(x)
is the same as the value of
(Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x))
21.3.2.35
Math.trunc (
Returns the integral part of the number
, removing any fractional digits. If
is already integral, the result is
When the
Math.trunc
method is called with argument
, the following steps are taken:
1.
Let
be ?
ToNumber
).
2.
If
is
NaN
is
+0
is
-0
is
+∞
, or
is
-∞
, return
3.
If
and
+0
, return
+0
4.
If
+0
and
-1
, return
-0
5.
Return the
integral Number
nearest
in the direction of
+0
21.4
Date Objects
21.4.1
Overview of Date Objects and Definitions of Abstract Operations
The following functions are
abstract operations
that operate on time values (defined in
21.4.1.1
). Note that, in every case, if any argument to one of these functions is
NaN
, the result will be
NaN
21.4.1.1
Time Values and Time Range
Time measurement in ECMAScript is analogous to time
measurement in POSIX, in particular sharing definition in terms of the
proleptic Gregorian calendar, an epoch of midnight at the beginning of 1
January 1970 UTC, and an accounting of every day as comprising exactly
86,400 seconds (each of which is 1000 milliseconds long).
An ECMAScript
time value
is a Number, either a finite
integral Number
representing an instant in time to millisecond precision or
NaN
representing no specific instant. A time value that is a multiple of
24 × 60 × 60 × 1000 = 86,400,000
(i.e., is equal to 86,400,000 ×
for some
integer
) represents the instant at the start of the UTC day that follows the epoch by
whole UTC days (preceding the epoch for negative
). Every other finite time value
is defined relative to the greatest preceding time value
that is such a multiple, and represents the instant that occurs within the same UTC day as
but follows it by
milliseconds.
Time values do not account for UTC leap seconds—there are no
time values representing instants within positive leap seconds, and
there are time values representing instants removed from the UTC
timeline by negative leap seconds. However, the definition of time
values nonetheless yields piecewise alignment with UTC, with
discontinuities only at leap second boundaries and zero difference
outside of leap seconds.
A Number can exactly represent all integers from -9,007,199,254,740,992 to 9,007,199,254,740,992 (
21.1.2.8
and
21.1.2.6
).
A time value supports a slightly smaller range of
-8,640,000,000,000,000 to 8,640,000,000,000,000 milliseconds. This
yields a supported time value range of exactly -100,000,000 days to
100,000,000 days relative to midnight at the beginning of 1 January 1970
UTC.
The exact moment of midnight at the beginning of 1 January 1970 UTC is represented by the time value
+0
Note
The 400 year cycle of the proleptic Gregorian calendar
contains 97 leap years. This yields an average of 365.2425 days per
year, which is 31,556,952,000 milliseconds. Therefore, the maximum range
a Number could represent exactly with millisecond precision is
approximately -285,426 to 285,426 years relative to 1970. The smaller
range supported by a time value as specified in this section is
approximately -273,790 to 273,790 years relative to 1970.
21.4.1.2
Day Number and Time within Day
A given
time value
belongs to day number
Day(
) =
floor
msPerDay
)))
where the number of milliseconds per day is
msPerDay =
86400000
The remainder is called the time within the day:
TimeWithinDay(
) =
modulo
msPerDay
))
21.4.1.3
Year Number
ECMAScript uses a proleptic Gregorian calendar to map a day
number to a year number and to determine the month and date within that
year. In this calendar, leap years are precisely those which are
(divisible by 4) and ((not divisible by 100) or (divisible by 400)). The
number of days in year number
is therefore defined by
DaysInYear(
365
if (
modulo
4) ≠ 0
366
if (
modulo
4) = 0 and (
modulo
100) ≠ 0
365
if (
modulo
100) = 0 and (
modulo
400) ≠ 0
366
if (
modulo
400) = 0
All non-leap years have 365 days with the usual number of
days per month and leap years have an extra day in February. The day
number of the first day of year
is given by:
DayFromYear(
) =
(365 × (
) - 1970) +
floor
((
) - 1969) / 4) -
floor
((
) - 1901) / 100) +
floor
((
) - 1601) / 400))
The
time value
of the start of a year is:
TimeFromYear(
) =
msPerDay
DayFromYear
time value
determines a year by:
YearFromTime(
) = the largest
integral Number
(closest to +∞) such that
TimeFromYear
) ≤
The leap-year function is
for a time within a leap year and otherwise is
+0
InLeapYear(
+0
if
DaysInYear
YearFromTime
)) =
365
if
DaysInYear
YearFromTime
)) =
366
21.4.1.4
Month Number
Months are identified by an
integral Number
in the range
+0
to
11
, inclusive. The mapping
MonthFromTime
) from a
time value
to a month number is defined by:
MonthFromTime(
+0
if
+0
DayWithinYear
) <
31
if
31
DayWithinYear
) <
59
InLeapYear
if
59
InLeapYear
) ≤
DayWithinYear
) <
90
InLeapYear
if
90
InLeapYear
) ≤
DayWithinYear
) <
120
InLeapYear
if
120
InLeapYear
) ≤
DayWithinYear
) <
151
InLeapYear
if
151
InLeapYear
) ≤
DayWithinYear
) <
181
InLeapYear
if
181
InLeapYear
) ≤
DayWithinYear
) <
212
InLeapYear
if
212
InLeapYear
) ≤
DayWithinYear
) <
243
InLeapYear
if
243
InLeapYear
) ≤
DayWithinYear
) <
273
InLeapYear
if
273
InLeapYear
) ≤
DayWithinYear
) <
304
InLeapYear
10
if
304
InLeapYear
) ≤
DayWithinYear
) <
334
InLeapYear
11
if
334
InLeapYear
) ≤
DayWithinYear
) <
365
InLeapYear
where
DayWithinYear(
) =
Day
) -
DayFromYear
YearFromTime
))
A month value of
+0
specifies January;
specifies February;
specifies March;
specifies April;
specifies May;
specifies June;
specifies July;
specifies August;
specifies September;
specifies October;
10
specifies November; and
11
specifies December. Note that
MonthFromTime
+0
) =
+0
, corresponding to Thursday, 1 January 1970.
21.4.1.5
Date Number
A date number is identified by an
integral Number
in the range
through
31
, inclusive. The mapping DateFromTime(
) from a
time value
to a date number is defined by:
DateFromTime(
DayWithinYear
) +
if
MonthFromTime
) =
+0
DayWithinYear
) -
30
if
MonthFromTime
) =
DayWithinYear
) -
58
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
89
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
119
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
150
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
180
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
211
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
242
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
272
InLeapYear
) if
MonthFromTime
) =
DayWithinYear
) -
303
InLeapYear
) if
MonthFromTime
) =
10
DayWithinYear
) -
333
InLeapYear
) if
MonthFromTime
) =
11
21.4.1.6
Week Day
The weekday for a particular
time value
is defined as
WeekDay(
) =
Day
) +
modulo
7)
A weekday value of
+0
specifies Sunday;
specifies Monday;
specifies Tuesday;
specifies Wednesday;
specifies Thursday;
specifies Friday; and
specifies Saturday. Note that
WeekDay(
+0
) =
, corresponding to Thursday, 1 January 1970.
21.4.1.7
LocalTZA (
isUTC
LocalTZA(
isUTC
) is an
implementation-defined
algorithm that returns an
integral Number
representing the local time zone adjustment, or offset, in
milliseconds. The local political rules for standard time and daylight
saving time in effect at
should be used to determine the result in the way specified in this section.
When
isUTC
is true,
LocalTZA(
UTC
, true )
should return the offset of the local time zone from UTC measured in milliseconds at time represented by
time value
UTC
. When the result is added to
UTC
, it should yield the corresponding Number
local
When
isUTC
is false,
LocalTZA(
local
, false )
should return the offset of the local time zone from UTC measured in milliseconds at local time represented by Number
local
. When the result is subtracted from
local
, it should yield the corresponding
time value
UTC
Input
is nominally a
time value
but may be any
Number value
. This can occur when
isUTC
is false and
local
represents a
time value
that is already offset outside of the
time value
range at the range boundaries. The algorithm must not limit
local
to the
time value
range, so that such inputs are supported.
When
local
represents local time repeating multiple times at a negative time zone
transition (e.g. when the daylight saving time ends or the time zone
offset is decreased due to a time zone rule change) or skipped local
time at a positive time zone transitions (e.g. when the daylight saving
time starts or the time zone offset is increased due to a time zone rule
change),
local
must be interpreted using the time zone offset before the transition.
If an implementation does not support a conversion described above or if political rules for time
are not available within the implementation, the result must be
+0
Note
It is recommended that implementations use the time zone information of the IANA Time Zone Database
1:30 AM on 5 November 2017 in America/New_York is repeated
twice (fall backward), but it must be interpreted as 1:30 AM UTC-04
instead of 1:30 AM UTC-05. LocalTZA(
TimeClip
MakeDate
MakeDay
(2017, 10, 5),
MakeTime
(1, 30, 0, 0))), false) is
-4 ×
msPerHour
2:30 AM on 12 March 2017 in America/New_York does not
exist, but it must be interpreted as 2:30 AM UTC-05 (equivalent to 3:30
AM UTC-04). LocalTZA(
TimeClip
MakeDate
MakeDay
(2017, 2, 12),
MakeTime
(2, 30, 0, 0))), false) is
-5 ×
msPerHour
Local time zone offset values may be positive
or
negative.
21.4.1.8
LocalTime (
The abstract operation LocalTime takes argument
. It converts
from UTC to local time. It performs the following steps when called:
1.
Return
LocalTZA
true
).
Note
Two different input time values
UTC
are converted to the same local time
local
at a negative time zone transition when there are repeated times (e.g.
the daylight saving time ends or the time zone adjustment is
decreased.).
LocalTime(
UTC
local
))
is not necessarily always equal to
local
. Correspondingly,
UTC
(LocalTime(
UTC
))
is not necessarily always equal to
UTC
21.4.1.9
UTC (
The abstract operation UTC takes argument
. It converts
from local time to UTC. It performs the following steps when called:
1.
Return
LocalTZA
false
).
Note
UTC(
LocalTime
UTC
))
is not necessarily always equal to
UTC
. Correspondingly,
LocalTime
(UTC(
local
))
is not necessarily always equal to
local
21.4.1.10
Hours, Minutes, Second, and Milliseconds
The following
abstract operations
are useful in decomposing time values:
HourFromTime(
) =
floor
msPerHour
))
modulo
HoursPerDay
MinFromTime(
) =
floor
msPerMinute
))
modulo
MinutesPerHour
SecFromTime(
) =
floor
msPerSecond
))
modulo
SecondsPerMinute
msFromTime(
) =
modulo
msPerSecond
where
HoursPerDay = 24
MinutesPerHour = 60
SecondsPerMinute = 60
msPerSecond =
1000
msPerMinute =
60000
msPerSecond
SecondsPerMinute
msPerHour =
3600000
msPerMinute
MinutesPerHour
21.4.1.11
MakeTime (
hour
min
sec
ms
The abstract operation MakeTime takes arguments
hour
(a Number),
min
(a Number),
sec
(a Number), and
ms
(a Number). It calculates a number of milliseconds. It performs the following steps when called:
1.
If
hour
is not finite or
min
is not finite or
sec
is not finite or
ms
is not finite, return
NaN
2.
Let
be
(!
ToIntegerOrInfinity
hour
)).
3.
Let
be
(!
ToIntegerOrInfinity
min
)).
4.
Let
be
(!
ToIntegerOrInfinity
sec
)).
5.
Let
milli
be
(!
ToIntegerOrInfinity
ms
)).
6.
Let
be ((
msPerHour
msPerMinute
msPerSecond
milli
, performing the arithmetic according to
IEEE 754-2019
rules (that is, as if using the ECMAScript operators
and
).
7.
Return
21.4.1.12
MakeDay (
year
month
date
The abstract operation MakeDay takes arguments
year
(a Number),
month
(a Number), and
date
(a Number). It calculates a number of days. It performs the following steps when called:
1.
If
year
is not finite or
month
is not finite or
date
is not finite, return
NaN
2.
Let
be
(!
ToIntegerOrInfinity
year
)).
3.
Let
be
(!
ToIntegerOrInfinity
month
)).
4.
Let
dt
be
(!
ToIntegerOrInfinity
date
)).
5.
Let
ym
be
floor
) / 12)).
6.
If
ym
is not finite, return
NaN
7.
Let
mn
be
modulo
12).
8.
Find a finite
time value
such that
YearFromTime
) is
ym
and
MonthFromTime
) is
mn
and
DateFromTime
) is
; but if this is not possible (because some argument is out of range), return
NaN
9.
Return
Day
) +
dt
21.4.1.13
MakeDate (
day
time
The abstract operation MakeDate takes arguments
day
(a Number) and
time
(a Number). It calculates a number of milliseconds. It performs the following steps when called:
1.
If
day
is not finite or
time
is not finite, return
NaN
2.
Let
tv
be
day
msPerDay
time
3.
If
tv
is not finite, return
NaN
4.
Return
tv
21.4.1.14
TimeClip (
time
The abstract operation TimeClip takes argument
time
(a Number). It calculates a number of milliseconds. It performs the following steps when called:
1.
If
time
is not finite, return
NaN
2.
If
abs
time
)) > 8.64 × 10
15
, return
NaN
3.
Return
(!
ToIntegerOrInfinity
time
)).
21.4.1.15
Date Time String Format
ECMAScript defines a string interchange format for date-times
based upon a simplification of the ISO 8601 calendar date extended
format. The format is as follows:
YYYY-MM-DDTHH:mm:ss.sssZ
Where the elements are as follows:
YYYY
is the year in the proleptic Gregorian calendar as four decimal digits from 0000 to 9999, or as an
expanded year
of
"+"
or
"-"
followed by six decimal digits.
"-"
(hyphen) appears literally twice in the string.
MM
is the month of the year as two decimal digits from 01 (January) to 12 (December).
DD
is the day of the month as two decimal digits from 01 to 31.
"T"
appears literally in the string, to indicate the beginning of the time element.
HH
is the number of complete hours that have passed since midnight as two decimal digits from 00 to 24.
":"
(colon) appears literally twice in the string.
mm
is the number of complete minutes since the start of the hour as two decimal digits from 00 to 59.
ss
is the number of complete seconds since the start of the minute as two decimal digits from 00 to 59.
"."
(dot) appears literally in the string.
sss
is the number of complete milliseconds since the start of the second as three decimal digits.
is the UTC offset representation specified as
"Z"
(for UTC with no offset) or an offset of either
"+"
or
"-"
followed by a time expression
HH:mm
(indicating local time ahead of or behind UTC, respectively)
This format includes date-only forms:
YYYY
YYYY-MM
YYYY-MM-DD
It also includes “date-time” forms that consist of one of the
above date-only forms immediately followed by one of the following time
forms with an optional UTC offset representation appended:
THH:mm
THH:mm:ss
THH:mm:ss.sss
A string containing out-of-bounds or nonconforming elements is not a valid instance of this format.
Note 1
As every day both starts and ends with midnight, the two notations
00:00
and
24:00
are available to distinguish the two midnights that can be associated
with one date. This means that the following two notations refer to
exactly the same point in time:
1995-02-04T24:00
and
1995-02-05T00:00
This interpretation of the latter form as "end of a calendar day" is
consistent with ISO 8601, even though that specification reserves it for
describing time intervals and does not permit it within representations
of single points in time.
Note 2
There exists no international standard that specifies
abbreviations for civil time zones like CET, EST, etc. and sometimes the
same abbreviation is even used for two very different time zones. For
this reason, both ISO 8601 and this format specify numeric
representations of time zone offsets.
21.4.1.15.1
Expanded Years
Covering
the full
time value
range of approximately 273,790 years forward or backward from 1 January 1970 (
21.4.1.1
requires representing years before 0 or after 9999. ISO 8601 permits
expansion of the year representation, but only by mutual agreement of
the partners in information interchange. In the simplified ECMAScript
format, such an expanded year representation shall have 6 digits and is
always prefixed with a + or - sign. The year 0 is considered positive
and hence prefixed with a + sign. Strings matching the
Date Time String Format
with expanded years representing instants in time outside the range of a
time value
are treated as unrecognizable by
Date.parse
and cause that function to return
NaN
without falling back to implementation-specific behaviour or heuristics.
Note
Examples of date-time values with expanded years:
-271821-04-20T00:00:00Z
271822 B.C.
-000001-01-01T00:00:00Z
2 B.C.
+000000-01-01T00:00:00Z
1 B.C.
+000001-01-01T00:00:00Z
1 A.D.
+001970-01-01T00:00:00Z
1970 A.D.
+002009-12-15T00:00:00Z
2009 A.D.
+275760-09-13T00:00:00Z
275760 A.D.
21.4.2
The Date Constructor
The Date
constructor
is
%Date%
is the initial value of the
"Date"
property of the
global object
creates and initializes a new Date object when called as a
constructor
returns a String representing the current time (UTC) when called as a function rather than as a
constructor
is a function whose behaviour differs based upon the number and types of its arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Date behaviour must include a
super
call to the Date
constructor
to create and initialize the subclass instance with a [[DateValue]] internal slot.
has a
"length"
property whose value is
21.4.2.1
Date ( ...
values
When the
Date
function is called, the following steps are taken:
1.
If NewTarget is
undefined
, then
a.
Let
now
be the
time value
(UTC) identifying the current time.
b.
Return
ToDateString
now
).
2.
Let
numberOfArgs
be the number of elements in
values
3.
If
numberOfArgs
= 0, then
a.
Let
dv
be the
time value
(UTC) identifying the current time.
4.
Else if
numberOfArgs
= 1, then
a.
Let
value
be
values
[0].
b.
If
Type
value
) is Object and
value
has a [[DateValue]] internal slot, then
i.
Let
tv
be !
thisTimeValue
value
).
c.
Else,
i.
Let
be ?
ToPrimitive
value
).
ii.
If
Type
) is String, then
1.
Assert
: The next step never returns an
abrupt completion
because
Type
) is String.
2.
Let
tv
be the result of parsing
as a date, in exactly the same manner as for the
parse
method (
21.4.3.2
).
iii.
Else,
1.
Let
tv
be ?
ToNumber
).
d.
Let
dv
be
TimeClip
tv
).
5.
Else,
a.
Assert
numberOfArgs
≥ 2.
b.
Let
be ?
ToNumber
values
[0]).
c.
Let
be ?
ToNumber
values
[1]).
d.
If
numberOfArgs
> 2, let
dt
be ?
ToNumber
values
[2]); else let
dt
be
e.
If
numberOfArgs
> 3, let
be ?
ToNumber
values
[3]); else let
be
+0
f.
If
numberOfArgs
> 4, let
min
be ?
ToNumber
values
[4]); else let
min
be
+0
g.
If
numberOfArgs
> 5, let
be ?
ToNumber
values
[5]); else let
be
+0
h.
If
numberOfArgs
> 6, let
milli
be ?
ToNumber
values
[6]); else let
milli
be
+0
i.
If
is
NaN
, let
yr
be
NaN
j.
Else,
i.
Let
yi
be !
ToIntegerOrInfinity
).
ii.
If 0 ≤
yi
≤ 99, let
yr
be
1900
yi
); otherwise, let
yr
be
k.
Let
finalDate
be
MakeDate
MakeDay
yr
dt
),
MakeTime
min
milli
)).
l.
Let
dv
be
TimeClip
UTC
finalDate
)).
6.
Let
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Date.prototype%"
, « [[DateValue]] »).
7.
Set
.[[DateValue]] to
dv
8.
Return
21.4.3
Properties of the Date Constructor
The Date
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
21.4.3.1
Date.now ( )
The
now
function returns the
time value
designating the UTC date and time of the occurrence of the call to
now
21.4.3.2
Date.parse (
string
The
parse
function applies the
ToString
operator to its argument. If
ToString
results in an
abrupt completion
the
Completion Record
is immediately returned. Otherwise,
parse
interprets the resulting String as a date and time; it returns a Number, the UTC
time value
corresponding to the date and time. The String may be interpreted as a
local time, a UTC time, or a time in some other time zone, depending on
the contents of the String. The function first attempts to parse the
String according to the format described in Date Time String Format (
21.4.1.15
),
including expanded years. If the String does not conform to that format
the function may fall back to any implementation-specific heuristics or
implementation-specific date formats. Strings that are unrecognizable
or contain out-of-bounds format element values shall cause
Date.parse
to return
NaN
If the String conforms to the
Date Time String Format
, substitute values take the place of absent format elements. When the
MM
or
DD
elements are absent,
"01"
is used. When the
HH
mm
, or
ss
elements are absent,
"00"
is used. When the
sss
element is absent,
"000"
is used. When the UTC offset representation is absent, date-only forms
are interpreted as a UTC time and date-time forms are interpreted as a
local time.
If
is any Date object whose milliseconds
amount is zero within a particular implementation of ECMAScript, then
all of the following expressions should produce the same numeric value
in that implementation, if all the properties referenced have their
initial values:
x.valueOf()
Date
.parse(x.toString())
Date
.parse(x.toUTCString())
Date
.parse(x.toISOString())
However, the expression
Date
.parse(x.toLocaleString())
is not required to produce the same
Number value
as the preceding three expressions and, in general, the value produced by
Date.parse
is
implementation-defined
when given any String value that does not conform to the Date Time String Format (
21.4.1.15
) and that could not be produced in that implementation by the
toString
or
toUTCString
method.
21.4.3.3
Date.prototype
The initial value of
Date.prototype
is the
Date prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
21.4.3.4
Date.UTC (
year
[ ,
month
[ ,
date
[ ,
hours
[ ,
minutes
[ ,
seconds
[ ,
ms
] ] ] ] ] ] )
When the
UTC
function is called, the following steps are taken:
1.
Let
be ?
ToNumber
year
).
2.
If
month
is present, let
be ?
ToNumber
month
); else let
be
+0
3.
If
date
is present, let
dt
be ?
ToNumber
date
); else let
dt
be
4.
If
hours
is present, let
be ?
ToNumber
hours
); else let
be
+0
5.
If
minutes
is present, let
min
be ?
ToNumber
minutes
); else let
min
be
+0
6.
If
seconds
is present, let
be ?
ToNumber
seconds
); else let
be
+0
7.
If
ms
is present, let
milli
be ?
ToNumber
ms
); else let
milli
be
+0
8.
If
is
NaN
, let
yr
be
NaN
9.
Else,
a.
Let
yi
be !
ToIntegerOrInfinity
).
b.
If 0 ≤
yi
≤ 99, let
yr
be
1900
yi
); otherwise, let
yr
be
10.
Return
TimeClip
MakeDate
MakeDay
yr
dt
),
MakeTime
min
milli
))).
The
"length"
property of the
UTC
function is
Note
The
UTC
function differs from the Date
constructor
in two ways: it returns a
time value
as a Number, rather than creating a Date object, and it interprets the arguments in UTC rather than as local time.
21.4.4
Properties of the Date Prototype Object
The
Date prototype object
is
%Date.prototype%
is itself an
ordinary object
is not a Date instance and does not have a [[DateValue]] internal slot.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
Unless explicitly defined otherwise, the methods of the Date prototype object defined below are not generic and the
this
value passed to them must be an object that has a [[DateValue]] internal slot that has been initialized to a
time value
The abstract operation
thisTimeValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is Object and
value
has a [[DateValue]] internal slot, then
a.
Return
value
.[[DateValue]].
2.
Throw a
TypeError
exception.
In following descriptions of functions that are properties of the Date prototype object, the phrase “
this Date object
” refers to the object that is the
this
value for the invocation of the function. If the Type of the
this
value is not Object, a
TypeError
exception is thrown. The phrase “
this time value
” within the specification of a method refers to the result returned by calling the abstract operation
thisTimeValue
with the
this
value of the method invocation passed as the argument.
21.4.4.1
Date.prototype.constructor
The initial value of
Date.prototype.constructor
is
%Date%
21.4.4.2
Date.prototype.getDate ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
DateFromTime
LocalTime
)).
21.4.4.3
Date.prototype.getDay ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
WeekDay
LocalTime
)).
21.4.4.4
Date.prototype.getFullYear ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
YearFromTime
LocalTime
)).
21.4.4.5
Date.prototype.getHours ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
HourFromTime
LocalTime
)).
21.4.4.6
Date.prototype.getMilliseconds ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
msFromTime
LocalTime
)).
21.4.4.7
Date.prototype.getMinutes ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
MinFromTime
LocalTime
)).
21.4.4.8
Date.prototype.getMonth ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
MonthFromTime
LocalTime
)).
21.4.4.9
Date.prototype.getSeconds ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
SecFromTime
LocalTime
)).
21.4.4.10
Date.prototype.getTime ( )
The following steps are performed:
1.
Return ?
thisTimeValue
this
value).
21.4.4.11
Date.prototype.getTimezoneOffset ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return (
LocalTime
)) /
msPerMinute
21.4.4.12
Date.prototype.getUTCDate ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
DateFromTime
).
21.4.4.13
Date.prototype.getUTCDay ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
WeekDay
).
21.4.4.14
Date.prototype.getUTCFullYear ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
YearFromTime
).
21.4.4.15
Date.prototype.getUTCHours ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
HourFromTime
).
21.4.4.16
Date.prototype.getUTCMilliseconds ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
msFromTime
).
21.4.4.17
Date.prototype.getUTCMinutes ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
MinFromTime
).
21.4.4.18
Date.prototype.getUTCMonth ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
MonthFromTime
).
21.4.4.19
Date.prototype.getUTCSeconds ( )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, return
NaN
3.
Return
SecFromTime
).
21.4.4.20
Date.prototype.setDate (
date
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Let
dt
be ?
ToNumber
date
).
3.
Let
newDate
be
MakeDate
MakeDay
YearFromTime
),
MonthFromTime
),
dt
),
TimeWithinDay
)).
4.
Let
be
TimeClip
UTC
newDate
)).
5.
Set the [[DateValue]] internal slot of
this Date object
to
6.
Return
21.4.4.21
Date.prototype.setFullYear (
year
[ ,
month
[ ,
date
] ] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, set
to
+0
; otherwise, set
to
LocalTime
).
3.
Let
be ?
ToNumber
year
).
4.
If
month
is not present, let
be
MonthFromTime
); otherwise, let
be ?
ToNumber
month
).
5.
If
date
is not present, let
dt
be
DateFromTime
); otherwise, let
dt
be ?
ToNumber
date
).
6.
Let
newDate
be
MakeDate
MakeDay
dt
),
TimeWithinDay
)).
7.
Let
be
TimeClip
UTC
newDate
)).
8.
Set the [[DateValue]] internal slot of
this Date object
to
9.
Return
The
"length"
property of the
setFullYear
method is
Note
If
month
is not present, this method behaves as if
month
was present with the value
getMonth()
. If
date
is not present, it behaves as if
date
was present with the value
getDate()
21.4.4.22
Date.prototype.setHours (
hour
[ ,
min
[ ,
sec
[ ,
ms
] ] ] )
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Let
be ?
ToNumber
hour
).
3.
If
min
is not present, let
be
MinFromTime
); otherwise, let
be ?
ToNumber
min
).
4.
If
sec
is not present, let
be
SecFromTime
); otherwise, let
be ?
ToNumber
sec
).
5.
If
ms
is not present, let
milli
be
msFromTime
); otherwise, let
milli
be ?
ToNumber
ms
).
6.
Let
date
be
MakeDate
Day
),
MakeTime
milli
)).
7.
Let
be
TimeClip
UTC
date
)).
8.
Set the [[DateValue]] internal slot of
this Date object
to
9.
Return
The
"length"
property of the
setHours
method is
Note
If
min
is not present, this method behaves as if
min
was present with the value
getMinutes()
. If
sec
is not present, it behaves as if
sec
was present with the value
getSeconds()
. If
ms
is not present, it behaves as if
ms
was present with the value
getMilliseconds()
21.4.4.23
Date.prototype.setMilliseconds (
ms
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Set
ms
to ?
ToNumber
ms
).
3.
Let
time
be
MakeTime
HourFromTime
),
MinFromTime
),
SecFromTime
),
ms
).
4.
Let
be
TimeClip
UTC
MakeDate
Day
),
time
))).
5.
Set the [[DateValue]] internal slot of
this Date object
to
6.
Return
21.4.4.24
Date.prototype.setMinutes (
min
[ ,
sec
[ ,
ms
] ] )
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Let
be ?
ToNumber
min
).
3.
If
sec
is not present, let
be
SecFromTime
); otherwise, let
be ?
ToNumber
sec
).
4.
If
ms
is not present, let
milli
be
msFromTime
); otherwise, let
milli
be ?
ToNumber
ms
).
5.
Let
date
be
MakeDate
Day
),
MakeTime
HourFromTime
),
milli
)).
6.
Let
be
TimeClip
UTC
date
)).
7.
Set the [[DateValue]] internal slot of
this Date object
to
8.
Return
The
"length"
property of the
setMinutes
method is
Note
If
sec
is not present, this method behaves as if
sec
was present with the value
getSeconds()
. If
ms
is not present, this behaves as if
ms
was present with the value
getMilliseconds()
21.4.4.25
Date.prototype.setMonth (
month
[ ,
date
] )
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Let
be ?
ToNumber
month
).
3.
If
date
is not present, let
dt
be
DateFromTime
); otherwise, let
dt
be ?
ToNumber
date
).
4.
Let
newDate
be
MakeDate
MakeDay
YearFromTime
),
dt
),
TimeWithinDay
)).
5.
Let
be
TimeClip
UTC
newDate
)).
6.
Set the [[DateValue]] internal slot of
this Date object
to
7.
Return
The
"length"
property of the
setMonth
method is
Note
If
date
is not present, this method behaves as if
date
was present with the value
getDate()
21.4.4.26
Date.prototype.setSeconds (
sec
[ ,
ms
] )
The following steps are performed:
1.
Let
be
LocalTime
(?
thisTimeValue
this
value)).
2.
Let
be ?
ToNumber
sec
).
3.
If
ms
is not present, let
milli
be
msFromTime
); otherwise, let
milli
be ?
ToNumber
ms
).
4.
Let
date
be
MakeDate
Day
),
MakeTime
HourFromTime
),
MinFromTime
),
milli
)).
5.
Let
be
TimeClip
UTC
date
)).
6.
Set the [[DateValue]] internal slot of
this Date object
to
7.
Return
The
"length"
property of the
setSeconds
method is
Note
If
ms
is not present, this method behaves as if
ms
was present with the value
getMilliseconds()
21.4.4.27
Date.prototype.setTime (
time
The following steps are performed:
1.
Perform ?
thisTimeValue
this
value).
2.
Let
be ?
ToNumber
time
).
3.
Let
be
TimeClip
).
4.
Set the [[DateValue]] internal slot of
this Date object
to
5.
Return
21.4.4.28
Date.prototype.setUTCDate (
date
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
dt
be ?
ToNumber
date
).
3.
Let
newDate
be
MakeDate
MakeDay
YearFromTime
),
MonthFromTime
),
dt
),
TimeWithinDay
)).
4.
Let
be
TimeClip
newDate
).
5.
Set the [[DateValue]] internal slot of
this Date object
to
6.
Return
21.4.4.29
Date.prototype.setUTCFullYear (
year
[ ,
month
[ ,
date
] ] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
If
is
NaN
, set
to
+0
3.
Let
be ?
ToNumber
year
).
4.
If
month
is not present, let
be
MonthFromTime
); otherwise, let
be ?
ToNumber
month
).
5.
If
date
is not present, let
dt
be
DateFromTime
); otherwise, let
dt
be ?
ToNumber
date
).
6.
Let
newDate
be
MakeDate
MakeDay
dt
),
TimeWithinDay
)).
7.
Let
be
TimeClip
newDate
).
8.
Set the [[DateValue]] internal slot of
this Date object
to
9.
Return
The
"length"
property of the
setUTCFullYear
method is
Note
If
month
is not present, this method behaves as if
month
was present with the value
getUTCMonth()
. If
date
is not present, it behaves as if
date
was present with the value
getUTCDate()
21.4.4.30
Date.prototype.setUTCHours (
hour
[ ,
min
[ ,
sec
[ ,
ms
] ] ] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
be ?
ToNumber
hour
).
3.
If
min
is not present, let
be
MinFromTime
); otherwise, let
be ?
ToNumber
min
).
4.
If
sec
is not present, let
be
SecFromTime
); otherwise, let
be ?
ToNumber
sec
).
5.
If
ms
is not present, let
milli
be
msFromTime
); otherwise, let
milli
be ?
ToNumber
ms
).
6.
Let
newDate
be
MakeDate
Day
),
MakeTime
milli
)).
7.
Let
be
TimeClip
newDate
).
8.
Set the [[DateValue]] internal slot of
this Date object
to
9.
Return
The
"length"
property of the
setUTCHours
method is
Note
If
min
is not present, this method behaves as if
min
was present with the value
getUTCMinutes()
. If
sec
is not present, it behaves as if
sec
was present with the value
getUTCSeconds()
. If
ms
is not present, it behaves as if
ms
was present with the value
getUTCMilliseconds()
21.4.4.31
Date.prototype.setUTCMilliseconds (
ms
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
milli
be ?
ToNumber
ms
).
3.
Let
time
be
MakeTime
HourFromTime
),
MinFromTime
),
SecFromTime
),
milli
).
4.
Let
be
TimeClip
MakeDate
Day
),
time
)).
5.
Set the [[DateValue]] internal slot of
this Date object
to
6.
Return
21.4.4.32
Date.prototype.setUTCMinutes (
min
[ ,
sec
[ ,
ms
] ] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
be ?
ToNumber
min
).
3.
If
sec
is not present, let
be
SecFromTime
).
4.
Else,
a.
Let
be ?
ToNumber
sec
).
5.
If
ms
is not present, let
milli
be
msFromTime
).
6.
Else,
a.
Let
milli
be ?
ToNumber
ms
).
7.
Let
date
be
MakeDate
Day
),
MakeTime
HourFromTime
),
milli
)).
8.
Let
be
TimeClip
date
).
9.
Set the [[DateValue]] internal slot of
this Date object
to
10.
Return
The
"length"
property of the
setUTCMinutes
method is
Note
If
sec
is not present, this method behaves as if
sec
was present with the value
getUTCSeconds()
. If
ms
is not present, it function behaves as if
ms
was present with the value return by
getUTCMilliseconds()
21.4.4.33
Date.prototype.setUTCMonth (
month
[ ,
date
] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
be ?
ToNumber
month
).
3.
If
date
is not present, let
dt
be
DateFromTime
).
4.
Else,
a.
Let
dt
be ?
ToNumber
date
).
5.
Let
newDate
be
MakeDate
MakeDay
YearFromTime
),
dt
),
TimeWithinDay
)).
6.
Let
be
TimeClip
newDate
).
7.
Set the [[DateValue]] internal slot of
this Date object
to
8.
Return
The
"length"
property of the
setUTCMonth
method is
Note
If
date
is not present, this method behaves as if
date
was present with the value
getUTCDate()
21.4.4.34
Date.prototype.setUTCSeconds (
sec
[ ,
ms
] )
The following steps are performed:
1.
Let
be ?
thisTimeValue
this
value).
2.
Let
be ?
ToNumber
sec
).
3.
If
ms
is not present, let
milli
be
msFromTime
).
4.
Else,
a.
Let
milli
be ?
ToNumber
ms
).
5.
Let
date
be
MakeDate
Day
),
MakeTime
HourFromTime
),
MinFromTime
),
milli
)).
6.
Let
be
TimeClip
date
).
7.
Set the [[DateValue]] internal slot of
this Date object
to
8.
Return
The
"length"
property of the
setUTCSeconds
method is
Note
If
ms
is not present, this method behaves as if
ms
was present with the value
getUTCMilliseconds()
21.4.4.35
Date.prototype.toDateString ( )
The following steps are performed:
1.
Let
be
this Date object
2.
Let
tv
be ?
thisTimeValue
).
3.
If
tv
is
NaN
, return
"Invalid Date"
4.
Let
be
LocalTime
tv
).
5.
Return
DateString
).
21.4.4.36
Date.prototype.toISOString ( )
If
this time value
is not a finite Number or if it corresponds with a year that cannot be represented in the
Date Time String Format
, this function throws a
RangeError
exception. Otherwise, it returns a String representation of
this time value
in that format on the UTC time scale, including all format elements and the UTC offset representation
"Z"
21.4.4.37
Date.prototype.toJSON (
key
This function provides a String representation of a Date object for use by
JSON.stringify
25.5.2
).
When the
toJSON
method is called with argument
key
, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
tv
be ?
ToPrimitive
number
).
3.
If
Type
tv
) is Number and
tv
is not finite, return
null
4.
Return ?
Invoke
"toISOString"
).
Note 1
The argument is ignored.
Note 2
The
toJSON
function is intentionally generic; it does not require that its
this
value be a Date object. Therefore, it can be transferred to other kinds
of objects for use as a method. However, it does require that any such
object have a
toISOString
method.
21.4.4.38
Date.prototype.toLocaleDateString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
Date.prototype.toLocaleDateString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleDateString
method is used.
This function returns a String value. The contents of the String are
implementation-defined
but are intended to represent the “date” portion of the Date in the
current time zone in a convenient, human-readable form that corresponds
to the conventions of the
host environment
's current locale.
The meaning of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
21.4.4.39
Date.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
Date.prototype.toLocaleString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleString
method is used.
This function returns a String value. The contents of the String are
implementation-defined
but are intended to represent the Date in the current time zone in a
convenient, human-readable form that corresponds to the conventions of
the
host environment
's current locale.
The meaning of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
21.4.4.40
Date.prototype.toLocaleTimeString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
Date.prototype.toLocaleTimeString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleTimeString
method is used.
This function returns a String value. The contents of the String are
implementation-defined
but are intended to represent the “time” portion of the Date in the
current time zone in a convenient, human-readable form that corresponds
to the conventions of the
host environment
's current locale.
The meaning of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
21.4.4.41
Date.prototype.toString ( )
The following steps are performed:
1.
Let
tv
be ?
thisTimeValue
this
value).
2.
Return
ToDateString
tv
).
Note 1
For any Date object
such that
d.[[DateValue]]
is evenly divisible by 1000, the result of
Date.parse(d.toString())
d.valueOf()
. See
21.4.3.2
Note 2
The
toString
function is not generic; it throws a
TypeError
exception if its
this
value is not a Date object. Therefore, it cannot be transferred to other kinds of objects for use as a method.
21.4.4.41.1
TimeString (
tv
The abstract operation TimeString takes argument
tv
. It performs the following steps when called:
1.
Assert
Type
tv
) is Number.
2.
Assert
tv
is not
NaN
3.
Let
hour
be the String representation of
HourFromTime
tv
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
4.
Let
minute
be the String representation of
MinFromTime
tv
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
5.
Let
second
be the String representation of
SecFromTime
tv
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
6.
Return the
string-concatenation
of
hour
":"
minute
":"
second
, the code unit 0x0020 (SPACE), and
"GMT"
21.4.4.41.2
DateString (
tv
The abstract operation DateString takes argument
tv
. It performs the following steps when called:
1.
Assert
Type
tv
) is Number.
2.
Assert
tv
is not
NaN
3.
Let
weekday
be the Name of the entry in
Table 52
with the Number
WeekDay
tv
).
4.
Let
month
be the Name of the entry in
Table 53
with the Number
MonthFromTime
tv
).
5.
Let
day
be the String representation of
DateFromTime
tv
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
6.
Let
yv
be
YearFromTime
tv
).
7.
If
yv
+0
, let
yearSign
be the empty String; otherwise, let
yearSign
be
"-"
8.
Let
year
be the String representation of
abs
yv
)), formatted as a decimal number.
9.
Let
paddedYear
be !
StringPad
year
"0"
start
).
10.
Return the
string-concatenation
of
weekday
, the code unit 0x0020 (SPACE),
month
, the code unit 0x0020 (SPACE),
day
, the code unit 0x0020 (SPACE),
yearSign
, and
paddedYear
Table 52: Names of days of the week
Number
Name
+0
"Sun"
"Mon"
"Tue"
"Wed"
"Thu"
"Fri"
"Sat"
Table 53: Names of months of the year
Number
Name
+0
"Jan"
"Feb"
"Mar"
"Apr"
"May"
"Jun"
"Jul"
"Aug"
"Sep"
"Oct"
10
"Nov"
11
"Dec"
21.4.4.41.3
TimeZoneString (
tv
The abstract operation TimeZoneString takes argument
tv
. It performs the following steps when called:
1.
Assert
Type
tv
) is Number.
2.
Assert
tv
is not
NaN
3.
Let
offset
be
LocalTZA
tv
true
).
4.
If
offset
+0
, then
a.
Let
offsetSign
be
"+"
b.
Let
absOffset
be
offset
5.
Else,
a.
Let
offsetSign
be
"-"
b.
Let
absOffset
be -
offset
6.
Let
offsetMin
be the String representation of
MinFromTime
absOffset
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
7.
Let
offsetHour
be the String representation of
HourFromTime
absOffset
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
8.
Let
tzName
be an
implementation-defined
string that is either the empty String or the
string-concatenation
of the code unit 0x0020 (SPACE), the code unit 0x0028 (LEFT PARENTHESIS), an
implementation-defined
timezone name, and the code unit 0x0029 (RIGHT PARENTHESIS).
9.
Return the
string-concatenation
of
offsetSign
offsetHour
offsetMin
, and
tzName
21.4.4.41.4
ToDateString (
tv
The abstract operation ToDateString takes argument
tv
. It performs the following steps when called:
1.
Assert
Type
tv
) is Number.
2.
If
tv
is
NaN
, return
"Invalid Date"
3.
Let
be
LocalTime
tv
).
4.
Return the
string-concatenation
of
DateString
), the code unit 0x0020 (SPACE),
TimeString
), and
TimeZoneString
tv
).
21.4.4.42
Date.prototype.toTimeString ( )
The following steps are performed:
1.
Let
be
this Date object
2.
Let
tv
be ?
thisTimeValue
).
3.
If
tv
is
NaN
, return
"Invalid Date"
4.
Let
be
LocalTime
tv
).
5.
Return the
string-concatenation
of
TimeString
) and
TimeZoneString
tv
).
21.4.4.43
Date.prototype.toUTCString ( )
The
toUTCString
method returns a String value representing the instance in time corresponding to
this time value
The format of the String is based upon "HTTP-date" from RFC 7231,
generalized to support the full range of times supported by ECMAScript
Date objects. It performs the following steps when called:
1.
Let
be
this Date object
2.
Let
tv
be ?
thisTimeValue
).
3.
If
tv
is
NaN
, return
"Invalid Date"
4.
Let
weekday
be the Name of the entry in
Table 52
with the Number
WeekDay
tv
).
5.
Let
month
be the Name of the entry in
Table 53
with the Number
MonthFromTime
tv
).
6.
Let
day
be the String representation of
DateFromTime
tv
), formatted as a two-digit decimal number, padded to the left with the code unit 0x0030 (DIGIT ZERO) if necessary.
7.
Let
yv
be
YearFromTime
tv
).
8.
If
yv
+0
, let
yearSign
be the empty String; otherwise, let
yearSign
be
"-"
9.
Let
year
be the String representation of
abs
yv
)), formatted as a decimal number.
10.
Let
paddedYear
be !
StringPad
year
"0"
start
).
11.
Return the
string-concatenation
of
weekday
","
, the code unit 0x0020 (SPACE),
day
, the code unit 0x0020 (SPACE),
month
, the code unit 0x0020 (SPACE),
yearSign
paddedYear
, the code unit 0x0020 (SPACE), and
TimeString
tv
).
21.4.4.44
Date.prototype.valueOf ( )
The following steps are performed:
1.
Return ?
thisTimeValue
this
value).
21.4.4.45
Date.prototype [ @@toPrimitive ] (
hint
This function is called by ECMAScript language operators to convert a Date object to a primitive value. The allowed values for
hint
are
"default"
"number"
, and
"string"
. Date objects, are unique among built-in ECMAScript object in that they treat
"default"
as being equivalent to
"string"
, All other built-in ECMAScript objects treat
"default"
as being equivalent to
"number"
When the
@@toPrimitive
method is called with argument
hint
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
hint
is
"string"
or
"default"
, then
a.
Let
tryFirst
be
string
4.
Else if
hint
is
"number"
, then
a.
Let
tryFirst
be
number
5.
Else, throw a
TypeError
exception.
6.
Return ?
OrdinaryToPrimitive
tryFirst
).
The value of the
"name"
property of this function is
"[Symbol.toPrimitive]"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
21.4.5
Properties of Date Instances
Date instances are ordinary objects that inherit properties from the
Date prototype object
. Date instances also have a [[DateValue]] internal slot. The [[DateValue]] internal slot is the
time value
represented by
this Date object
22
Text Processing
22.1
String Objects
22.1.1
The String Constructor
The String
constructor
is
%String%
is the initial value of the
"String"
property of the
global object
creates and initializes a new String object when called as a
constructor
performs a type conversion when called as a function rather than as a
constructor
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified String behaviour must include a
super
call to the String
constructor
to create and initialize the subclass instance with a [[StringData]] internal slot.
22.1.1.1
String (
value
When
String
is called with argument
value
, the following steps are taken:
1.
If
value
is not present, let
be the empty String.
2.
Else,
a.
If NewTarget is
undefined
and
Type
value
) is Symbol, return
SymbolDescriptiveString
value
).
b.
Let
be ?
ToString
value
).
3.
If NewTarget is
undefined
, return
4.
Return !
StringCreate
, ?
GetPrototypeFromConstructor
(NewTarget,
"%String.prototype%"
)).
22.1.2
Properties of the String Constructor
The String
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
22.1.2.1
String.fromCharCode ( ...
codeUnits
The
String.fromCharCode
function may be called with any number of arguments which form the rest parameter
codeUnits
. The following steps are taken:
1.
Let
length
be the number of elements in
codeUnits
2.
Let
elements
be a new empty
List
3.
For each element
next
of
codeUnits
, do
a.
Let
nextCU
be
(?
ToUint16
next
)).
b.
Append
nextCU
to the end of
elements
4.
Return the String value whose code units are the elements in the
List
elements
. If
codeUnits
is empty, the empty String is returned.
The
"length"
property of the
fromCharCode
function is
22.1.2.2
String.fromCodePoint ( ...
codePoints
The
String.fromCodePoint
function may be called with any number of arguments which form the rest parameter
codePoints
. The following steps are taken:
1.
Let
result
be the empty String.
2.
For each element
next
of
codePoints
, do
a.
Let
nextCP
be ?
ToNumber
next
).
b.
If !
IsIntegralNumber
nextCP
) is
false
, throw a
RangeError
exception.
c.
If
nextCP
) < 0 or
nextCP
) > 0x10FFFF, throw a
RangeError
exception.
d.
Set
result
to the
string-concatenation
of
result
and !
UTF16EncodeCodePoint
nextCP
)).
3.
Assert
: If
codePoints
is empty, then
result
is the empty String.
4.
Return
result
The
"length"
property of the
fromCodePoint
function is
22.1.2.3
String.prototype
The initial value of
String.prototype
is the
String prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
22.1.2.4
String.raw (
template
, ...
substitutions
The
String.raw
function may be called with a variable number of arguments. The first argument is
template
and the remainder of the arguments form the
List
substitutions
. The following steps are taken:
1.
Let
numberOfSubstitutions
be the number of elements in
substitutions
2.
Let
cooked
be ?
ToObject
template
).
3.
Let
raw
be ?
ToObject
(?
Get
cooked
"raw"
)).
4.
Let
literalSegments
be ?
LengthOfArrayLike
raw
).
5.
If
literalSegments
≤ 0, return the empty String.
6.
Let
stringElements
be a new empty
List
7.
Let
nextIndex
be 0.
8.
Repeat,
a.
Let
nextKey
be !
ToString
nextIndex
)).
b.
Let
nextSeg
be ?
ToString
(?
Get
raw
nextKey
)).
c.
Append the code unit elements of
nextSeg
to the end of
stringElements
d.
If
nextIndex
+ 1 =
literalSegments
, then
i.
Return the String value whose code units are the elements in the
List
stringElements
. If
stringElements
has no elements, the empty String is returned.
e.
If
nextIndex
numberOfSubstitutions
, let
next
be
substitutions
nextIndex
].
f.
Else, let
next
be the empty String.
g.
Let
nextSub
be ?
ToString
next
).
h.
Append the code unit elements of
nextSub
to the end of
stringElements
i.
Set
nextIndex
to
nextIndex
+ 1.
Note
The
raw
function is intended for use as a tag function of a Tagged Template (
13.3.11
).
When called as such, the first argument will be a well formed template
object and the rest parameter will contain the substitution values.
22.1.3
Properties of the String Prototype Object
The
String prototype object
is
%String.prototype%
is a
String exotic object
and has the internal methods specified for such objects.
has a [[StringData]] internal slot whose value is the empty String.
has a
"length"
property whose initial value is
+0
and whose attributes are { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
Unless explicitly stated otherwise, the methods of the String prototype object defined below are not generic and the
this
value passed to them must be either a String value or an object that
has a [[StringData]] internal slot that has been initialized to a String
value.
The abstract operation
thisStringValue
takes argument
value
. It performs the following steps when called:
1.
If
Type
value
) is String, return
value
2.
If
Type
value
) is Object and
value
has a [[StringData]] internal slot, then
a.
Let
be
value
.[[StringData]].
b.
Assert
Type
) is String.
c.
Return
3.
Throw a
TypeError
exception.
22.1.3.1
String.prototype.charAt (
pos
Note 1
Returns a single element String containing the code unit at index
pos
within the String value resulting from converting this object to a
String. If there is no element at that index, the result is the empty
String. The result is a String value, not a String object.
If
pos
is an
integral Number
, then the result of
x.charAt(pos)
is equivalent to the result of
x.substring(pos, pos + 1)
When the
charAt
method is called with one argument
pos
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
position
be ?
ToIntegerOrInfinity
pos
).
4.
Let
size
be the length of
5.
If
position
< 0 or
position
size
, return the empty String.
6.
Return the String value of length 1, containing one code unit from
, namely the code unit at index
position
Note 2
The
charAt
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.2
String.prototype.charCodeAt (
pos
Note 1
Returns a Number (a non-negative
integral Number
less than 2
16
) that is the numeric value of the code unit at index
pos
within the String resulting from converting this object to a String. If there is no element at that index, the result is
NaN
When the
charCodeAt
method is called with one argument
pos
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
position
be ?
ToIntegerOrInfinity
pos
).
4.
Let
size
be the length of
5.
If
position
< 0 or
position
size
, return
NaN
6.
Return the
Number value
for the numeric value of the code unit at index
position
within the String
Note 2
The
charCodeAt
function is intentionally generic; it does not require that its
this
value be a String object. Therefore it can be transferred to other kinds of objects for use as a method.
22.1.3.3
String.prototype.codePointAt (
pos
Note 1
Returns a non-negative
integral Number
less than or equal to
0x10FFFF
that is the code point value of the UTF-16 encoded code point (
6.1.4
) starting at the string element at index
pos
within the String resulting from converting this object to a String. If there is no element at that index, the result is
undefined
. If a valid UTF-16
surrogate pair
does not begin at
pos
, the result is the code unit at
pos
When the
codePointAt
method is called with one argument
pos
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
position
be ?
ToIntegerOrInfinity
pos
).
4.
Let
size
be the length of
5.
If
position
< 0 or
position
size
, return
undefined
6.
Let
cp
be !
CodePointAt
position
).
7.
Return
cp
.[[CodePoint]]).
Note 2
The
codePointAt
function is intentionally generic; it does not require that its
this
value be a String object. Therefore it can be transferred to other kinds of objects for use as a method.
22.1.3.4
String.prototype.concat ( ...
args
Note 1
When the
concat
method is called it returns the String value consisting of the code units of the
this
value (converted to a String) followed by the code units of each of the
arguments converted to a String. The result is a String value, not a
String object.
When the
concat
method is called with zero or more arguments, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
be
4.
For each element
next
of
args
, do
a.
Let
nextString
be ?
ToString
next
).
b.
Set
to the
string-concatenation
of
and
nextString
5.
Return
The
"length"
property of the
concat
method is
Note 2
The
concat
function is intentionally generic; it does not require that its
this
value be a String object. Therefore it can be transferred to other kinds of objects for use as a method.
22.1.3.5
String.prototype.constructor
The initial value of
String.prototype.constructor
is
%String%
22.1.3.6
String.prototype.endsWith (
searchString
[ ,
endPosition
] )
The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
isRegExp
be ?
IsRegExp
searchString
).
4.
If
isRegExp
is
true
, throw a
TypeError
exception.
5.
Let
searchStr
be ?
ToString
searchString
).
6.
Let
len
be the length of
7.
If
endPosition
is
undefined
, let
pos
be
len
; else let
pos
be ?
ToIntegerOrInfinity
endPosition
).
8.
Let
end
be the result of
clamping
pos
between 0 and
len
9.
Let
searchLength
be the length of
searchStr
10.
If
searchLength
= 0, return
true
11.
Let
start
be
end
searchLength
12.
If
start
< 0, return
false
13.
Let
substring
be the
substring
of
from
start
to
end
14.
Return !
SameValueNonNumeric
substring
searchStr
).
Note 1
Returns
true
if the sequence of code units of
searchString
converted to a String is the same as the corresponding code units of this object (converted to a String) starting at
endPosition
- length(this). Otherwise returns
false
Note 2
Throwing an exception if the first argument is a RegExp is
specified in order to allow future editions to define extensions that
allow such argument values.
Note 3
The
endsWith
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.7
String.prototype.includes (
searchString
[ ,
position
] )
The
includes
method takes two arguments,
searchString
and
position
, and performs the following steps:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
isRegExp
be ?
IsRegExp
searchString
).
4.
If
isRegExp
is
true
, throw a
TypeError
exception.
5.
Let
searchStr
be ?
ToString
searchString
).
6.
Let
pos
be ?
ToIntegerOrInfinity
position
).
7.
Assert
: If
position
is
undefined
, then
pos
is 0.
8.
Let
len
be the length of
9.
Let
start
be the result of
clamping
pos
between 0 and
len
10.
Let
index
be !
StringIndexOf
searchStr
start
).
11.
If
index
is not -1, return
true
12.
Return
false
Note 1
If
searchString
appears as a
substring
of the result of converting this object to a String, at one or more indices that are greater than or equal to
position
, return
true
; otherwise, returns
false
. If
position
is
undefined
, 0 is assumed, so as to search all of the String.
Note 2
Throwing an exception if the first argument is a RegExp is
specified in order to allow future editions to define extensions that
allow such argument values.
Note 3
The
includes
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.8
String.prototype.indexOf (
searchString
[ ,
position
] )
Note 1
If
searchString
appears as a
substring
of the result of converting this object to a String, at one or more indices that are greater than or equal to
position
, then the smallest such index is returned; otherwise,
-1
is returned. If
position
is
undefined
+0
is assumed, so as to search all of the String.
The
indexOf
method takes two arguments,
searchString
and
position
, and performs the following steps:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
searchStr
be ?
ToString
searchString
).
4.
Let
pos
be ?
ToIntegerOrInfinity
position
).
5.
Assert
: If
position
is
undefined
, then
pos
is 0.
6.
Let
len
be the length of
7.
Let
start
be the result of
clamping
pos
between 0 and
len
8.
Return
(!
StringIndexOf
searchStr
start
)).
Note 2
The
indexOf
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.9
String.prototype.lastIndexOf (
searchString
[ ,
position
] )
Note 1
If
searchString
appears as a
substring
of the result of converting this object to a String at one or more indices that are smaller than or equal to
position
, then the greatest such index is returned; otherwise,
-1
is returned. If
position
is
undefined
, the length of the String value is assumed, so as to search all of the String.
The
lastIndexOf
method takes two arguments,
searchString
and
position
, and performs the following steps:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
searchStr
be ?
ToString
searchString
).
4.
Let
numPos
be ?
ToNumber
position
).
5.
Assert
: If
position
is
undefined
, then
numPos
is
NaN
6.
If
numPos
is
NaN
, let
pos
be +∞; otherwise, let
pos
be !
ToIntegerOrInfinity
numPos
).
7.
Let
len
be the length of
8.
Let
start
be the result of
clamping
pos
between 0 and
len
9.
Let
searchLen
be the length of
searchStr
10.
Let
be the largest possible non-negative
integer
not larger than
start
such that
searchLen
len
, and for all non-negative integers
such that
searchLen
, the code unit at index
within
is the same as the code unit at index
within
searchStr
; but if there is no such
integer
, let
be -1.
11.
Return
).
Note 2
The
lastIndexOf
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.10
String.prototype.localeCompare (
that
[ ,
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
localeCompare
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
localeCompare
method is used.
When the
localeCompare
method is called with argument
that
, it returns a Number other than
NaN
that represents the result of a locale-sensitive String comparison of the
this
value (converted to a String) with
that
(converted to a String). The two Strings are
and
That
. The two Strings are compared in an
implementation-defined
fashion. The result is intended to order String values in the sort order specified by a
host
default locale, and will be negative, zero, or positive, depending on whether
comes before
That
in the sort order, the Strings are equal, or
comes after
That
in the sort order, respectively.
Before performing the comparisons, the following steps are performed to prepare the Strings:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
That
be ?
ToString
that
).
The meaning of the optional second and third parameters to
this method are defined in the ECMA-402 specification; implementations
that do not include ECMA-402 support must not assign any other
interpretation to those parameter positions.
The
localeCompare
method, if considered as a function of two arguments
this
and
that
, is a consistent comparison function (as defined in
23.1.3.27
) on the set of all Strings.
The actual return values are
implementation-defined
to permit implementers to encode additional information in the value,
but the function is required to define a total ordering on all Strings.
This function must treat Strings that are canonically equivalent
according to the Unicode standard as identical and must return
when comparing Strings that are considered canonically equivalent.
Note 1
The
localeCompare
method itself is not directly suitable as an argument to
Array.prototype.sort
because the latter requires a function of two arguments.
Note 2
This function is intended to rely on whatever
language-sensitive comparison functionality is available to the
ECMAScript environment from the
host environment
, and to compare according to the rules of the
host environment
's current locale. However, regardless of the
host
provided comparison capabilities, this function must treat Strings that
are canonically equivalent according to the Unicode standard as
identical. It is recommended that this function should not honour
Unicode compatibility equivalences or decompositions. For a definition
and discussion of canonical equivalence see the Unicode Standard,
chapters 2 and 3, as well as Unicode Standard Annex #15, Unicode
Normalization Forms (
) and Unicode Technical Note #5, Canonical Equivalence in Applications (
). Also see Unicode Technical Standard #10, Unicode Collation Algorithm (
).
Note 3
The
localeCompare
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.11
String.prototype.match (
regexp
When the
match
method is called with argument
regexp
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
regexp
is neither
undefined
nor
null
, then
a.
Let
matcher
be ?
GetMethod
regexp
@@match
).
b.
If
matcher
is not
undefined
, then
i.
Return ?
Call
matcher
regexp
, «
»).
3.
Let
be ?
ToString
).
4.
Let
rx
be ?
RegExpCreate
regexp
undefined
).
5.
Return ?
Invoke
rx
@@match
, «
»).
Note
The
match
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.12
String.prototype.matchAll (
regexp
Performs a regular expression match of the String representing the
this
value against
regexp
and returns an iterator. Each iteration result's value is an Array object containing the results of the match, or
null
if the String did not match.
When the
matchAll
method is called, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
regexp
is neither
undefined
nor
null
, then
a.
Let
isRegExp
be ?
IsRegExp
regexp
).
b.
If
isRegExp
is
true
, then
i.
Let
flags
be ?
Get
regexp
"flags"
).
ii.
Perform ?
RequireObjectCoercible
flags
).
iii.
If ?
ToString
flags
) does not contain
"g"
, throw a
TypeError
exception.
c.
Let
matcher
be ?
GetMethod
regexp
@@matchAll
).
d.
If
matcher
is not
undefined
, then
i.
Return ?
Call
matcher
regexp
, «
»).
3.
Let
be ?
ToString
).
4.
Let
rx
be ?
RegExpCreate
regexp
"g"
).
5.
Return ?
Invoke
rx
@@matchAll
, «
»).
Note 1
The
matchAll
function is intentionally generic, it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
Note 2
Similarly to
String.prototype.split
String.prototype.matchAll
is designed to typically act without mutating its inputs.
22.1.3.13
String.prototype.normalize ( [
form
] )
When the
normalize
method is called with one argument
form
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
If
form
is
undefined
, let
be
"NFC"
4.
Else, let
be ?
ToString
form
).
5.
If
is not one of
"NFC"
"NFD"
"NFKC"
, or
"NFKD"
, throw a
RangeError
exception.
6.
Let
ns
be the String value that is the result of normalizing
into the normalization form named by
as specified in
7.
Return
ns
Note
The
normalize
function is intentionally generic; it does not require that its
this
value be a String object. Therefore it can be transferred to other kinds of objects for use as a method.
22.1.3.14
String.prototype.padEnd (
maxLength
[ ,
fillString
] )
When the
padEnd
method is called, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Return ?
StringPad
maxLength
fillString
end
).
22.1.3.15
String.prototype.padStart (
maxLength
[ ,
fillString
] )
When the
padStart
method is called, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Return ?
StringPad
maxLength
fillString
start
).
22.1.3.15.1
StringPad (
maxLength
fillString
placement
The abstract operation StringPad takes arguments
maxLength
fillString
, and
placement
. It performs the following steps when called:
1.
Assert
placement
is
start
or
end
2.
Let
be ?
ToString
).
3.
Let
intMaxLength
be
(?
ToLength
maxLength
)).
4.
Let
stringLength
be the length of
5.
If
intMaxLength
stringLength
, return
6.
If
fillString
is
undefined
, let
filler
be the String value consisting solely of the code unit 0x0020 (SPACE).
7.
Else, let
filler
be ?
ToString
fillString
).
8.
If
filler
is the empty String, return
9.
Let
fillLen
be
intMaxLength
stringLength
10.
Let
truncatedStringFiller
be the String value consisting of repeated concatenations of
filler
truncated to length
fillLen
11.
If
placement
is
start
, return the
string-concatenation
of
truncatedStringFiller
and
12.
Else, return the
string-concatenation
of
and
truncatedStringFiller
Note 1
The argument
maxLength
will be clamped such that it can be no smaller than the length of
Note 2
The argument
fillString
defaults to
" "
(the String value consisting of the code unit 0x0020 SPACE).
22.1.3.16
String.prototype.repeat (
count
The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
be ?
ToIntegerOrInfinity
count
).
4.
If
< 0 or
is +∞, throw a
RangeError
exception.
5.
If
is 0, return the empty String.
6.
Return the String value that is made from
copies of
appended together.
Note 1
This method creates the String value consisting of the code units of the
this
value (converted to String) repeated
count
times.
Note 2
The
repeat
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.17
String.prototype.replace (
searchValue
replaceValue
When the
replace
method is called with arguments
searchValue
and
replaceValue
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
searchValue
is neither
undefined
nor
null
, then
a.
Let
replacer
be ?
GetMethod
searchValue
@@replace
).
b.
If
replacer
is not
undefined
, then
i.
Return ?
Call
replacer
searchValue
, «
replaceValue
»).
3.
Let
string
be ?
ToString
).
4.
Let
searchString
be ?
ToString
searchValue
).
5.
Let
functionalReplace
be
IsCallable
replaceValue
).
6.
If
functionalReplace
is
false
, then
a.
Set
replaceValue
to ?
ToString
replaceValue
).
7.
Let
searchLength
be the length of
searchString
8.
Let
position
be !
StringIndexOf
string
searchString
, 0).
9.
If
position
is -1, return
string
10.
Let
preserved
be the
substring
of
string
from 0 to
position
11.
If
functionalReplace
is
true
, then
a.
Let
replacement
be ?
ToString
(?
Call
replaceValue
undefined
, «
searchString
position
),
string
»)).
12.
Else,
a.
Assert
Type
replaceValue
) is String.
b.
Let
captures
be a new empty
List
c.
Let
replacement
be !
GetSubstitution
searchString
string
position
captures
undefined
replaceValue
).
13.
Return the
string-concatenation
of
preserved
replacement
, and the
substring
of
string
from
position
searchLength
Note
The
replace
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.17.1
GetSubstitution (
matched
str
position
captures
namedCaptures
replacement
The abstract operation GetSubstitution takes arguments
matched
str
position
(a non-negative
integer
),
captures
namedCaptures
, and
replacement
. It performs the following steps when called:
1.
Assert
Type
matched
) is String.
2.
Let
matchLength
be the number of code units in
matched
3.
Assert
Type
str
) is String.
4.
Let
stringLength
be the number of code units in
str
5.
Assert
position
stringLength
6.
Assert
captures
is a possibly empty
List
of Strings.
7.
Assert
Type
replacement
) is String.
8.
Let
tailPos
be
position
matchLength
9.
Let
be the number of elements in
captures
10.
Let
result
be the String value derived from
replacement
by copying code unit elements from
replacement
to
result
while performing replacements as specified in
Table 54
. These
replacements are done left-to-right, and, once such a replacement is
performed, the new replacement text is not subject to further
replacements.
11.
Return
result
Table 54: Replacement Text Symbol Substitutions
Code units
Unicode Characters
Replacement text
0x0024, 0x0024
$$
0x0024, 0x0026
$&
matched
0x0024, 0x0060
$`
The replacement is the
substring
of
str
from 0 to
position
0x0024, 0x0027
$'
If
tailPos
stringLength
, the replacement is the empty String. Otherwise the replacement is the
substring
of
str
from
tailPos
0x0024, N
Where
0x0031 ≤ N ≤ 0x0039
$n
where
is one of
1 2 3 4 5 6 7 8 9
and
$n
is not followed by a decimal digit
The
th
element of
captures
, where
is a single digit in the range 1 to 9. If
and the
th
element of
captures
is
undefined
, use the empty String instead. If
, no replacement is done.
0x0024, N, N
Where
0x0030 ≤ N ≤ 0x0039
$nn
where
is one of
0 1 2 3 4 5 6 7 8 9
The
nn
th
element of
captures
, where
nn
is a two-digit decimal number in the range 01 to 99. If
nn
and the
nn
th
element of
captures
is
undefined
, use the empty String instead. If
nn
is 00 or
nn
, no replacement is done.
0x0024, 0x003C
$<
1.
If
namedCaptures
is
undefined
, the replacement text is the String
"$<"
2.
Else,
a.
Assert
Type
namedCaptures
) is Object.
b.
Scan until the next
U+003E (GREATER-THAN SIGN).
c.
If none is found, the replacement text is the String
"$<"
d.
Else,
i.
Let
groupName
be the enclosed
substring
ii.
Let
capture
be ?
Get
namedCaptures
groupName
).
iii.
If
capture
is
undefined
, replace the text through
with the empty String.
iv.
Otherwise, replace the text through
with ?
ToString
capture
).
0x0024
in any context that does not match any of the above.
22.1.3.18
String.prototype.replaceAll (
searchValue
replaceValue
When the
replaceAll
method is called with arguments
searchValue
and
replaceValue
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
searchValue
is neither
undefined
nor
null
, then
a.
Let
isRegExp
be ?
IsRegExp
searchValue
).
b.
If
isRegExp
is
true
, then
i.
Let
flags
be ?
Get
searchValue
"flags"
).
ii.
Perform ?
RequireObjectCoercible
flags
).
iii.
If ?
ToString
flags
) does not contain
"g"
, throw a
TypeError
exception.
c.
Let
replacer
be ?
GetMethod
searchValue
@@replace
).
d.
If
replacer
is not
undefined
, then
i.
Return ?
Call
replacer
searchValue
, «
replaceValue
»).
3.
Let
string
be ?
ToString
).
4.
Let
searchString
be ?
ToString
searchValue
).
5.
Let
functionalReplace
be
IsCallable
replaceValue
).
6.
If
functionalReplace
is
false
, then
a.
Set
replaceValue
to ?
ToString
replaceValue
).
7.
Let
searchLength
be the length of
searchString
8.
Let
advanceBy
be
max
(1,
searchLength
).
9.
Let
matchPositions
be a new empty
List
10.
Let
position
be !
StringIndexOf
string
searchString
, 0).
11.
Repeat, while
position
is not -1,
a.
Append
position
to the end of
matchPositions
b.
Set
position
to !
StringIndexOf
string
searchString
position
advanceBy
).
12.
Let
endOfLastMatch
be 0.
13.
Let
result
be the empty String.
14.
For each element
of
matchPositions
, do
a.
Let
preserved
be the
substring
of
string
from
endOfLastMatch
to
b.
If
functionalReplace
is
true
, then
i.
Let
replacement
be ?
ToString
(?
Call
replaceValue
undefined
, «
searchString
),
string
»)).
c.
Else,
i.
Assert
Type
replaceValue
) is String.
ii.
Let
captures
be a new empty
List
iii.
Let
replacement
be !
GetSubstitution
searchString
string
captures
undefined
replaceValue
).
d.
Set
result
to the
string-concatenation
of
result
preserved
, and
replacement
e.
Set
endOfLastMatch
to
searchLength
15.
If
endOfLastMatch
< the length of
string
, then
a.
Set
result
to the
string-concatenation
of
result
and the
substring
of
string
from
endOfLastMatch
16.
Return
result
22.1.3.19
String.prototype.search (
regexp
When the
method is called with argument
regexp
, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
regexp
is neither
undefined
nor
null
, then
a.
Let
searcher
be ?
GetMethod
regexp
@@search
).
b.
If
searcher
is not
undefined
, then
i.
Return ?
Call
searcher
regexp
, «
»).
3.
Let
string
be ?
ToString
).
4.
Let
rx
be ?
RegExpCreate
regexp
undefined
).
5.
Return ?
Invoke
rx
@@search
, «
string
»).
Note
The
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.20
String.prototype.slice (
start
end
The
slice
method takes two arguments,
start
and
end
, and returns a
substring
of the result of converting this object to a String, starting from index
start
and running to, but not including, index
end
(or through the end of the String if
end
is
undefined
). If
start
is negative, it is treated as
sourceLength
start
where
sourceLength
is the length of the String. If
end
is negative, it is treated as
sourceLength
end
where
sourceLength
is the length of the String. The result is a String value, not a String object. The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
len
be the length of
4.
Let
intStart
be ?
ToIntegerOrInfinity
start
).
5.
If
intStart
is -∞, let
from
be 0.
6.
Else if
intStart
< 0, let
from
be
max
len
intStart
, 0).
7.
Else, let
from
be
min
intStart
len
).
8.
If
end
is
undefined
, let
intEnd
be
len
; else let
intEnd
be ?
ToIntegerOrInfinity
end
).
9.
If
intEnd
is -∞, let
to
be 0.
10.
Else if
intEnd
< 0, let
to
be
max
len
intEnd
, 0).
11.
Else, let
to
be
min
intEnd
len
).
12.
If
from
to
, return the empty String.
13.
Return the
substring
of
from
from
to
to
Note
The
slice
function is intentionally generic; it does not require that its
this
value be a String object. Therefore it can be transferred to other kinds of objects for use as a method.
22.1.3.21
String.prototype.split (
separator
limit
Returns an Array object into which substrings of the result
of converting this object to a String have been stored. The substrings
are determined by searching from left to right for occurrences of
separator
; these occurrences are not part of any String in the returned array, but serve to divide up the String value. The value of
separator
may be a String of any length or it may be an object, such as a RegExp, that has a
@@split
method.
When the
split
method is called, the following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
If
separator
is neither
undefined
nor
null
, then
a.
Let
splitter
be ?
GetMethod
separator
@@split
).
b.
If
splitter
is not
undefined
, then
i.
Return ?
Call
splitter
separator
, «
limit
»).
3.
Let
be ?
ToString
).
4.
Let
be !
ArrayCreate
(0).
5.
Let
lengthA
be 0.
6.
If
limit
is
undefined
, let
lim
be 2
32
- 1; else let
lim
be
(?
ToUint32
limit
)).
7.
Let
be ?
ToString
separator
).
8.
If
lim
= 0, return
9.
If
separator
is
undefined
, then
a.
Perform !
CreateDataPropertyOrThrow
"0"
).
b.
Return
10.
Let
be the length of
11.
If
= 0, then
a.
If
is not the empty String, then
i.
Perform !
CreateDataPropertyOrThrow
"0"
).
b.
Return
12.
Let
be 0.
13.
Let
be
14.
Repeat, while
a.
Let
be
SplitMatch
).
b.
If
is
not-matched
, set
to
+ 1.
c.
Else,
i.
Assert
is a non-negative
integer
ii.
If
, set
to
+ 1.
iii.
Else,
1.
Let
be the
substring
of
from
to
2.
Perform !
CreateDataPropertyOrThrow
, !
ToString
lengthA
)),
).
3.
Set
lengthA
to
lengthA
+ 1.
4.
If
lengthA
lim
, return
5.
Set
to
6.
Set
to
15.
Let
be the
substring
of
from
to
16.
Perform !
CreateDataPropertyOrThrow
, !
ToString
lengthA
)),
).
17.
Return
Note 1
The value of
separator
may be an empty String. In this case,
separator
does not match the empty
substring
at the beginning or end of the input String, nor does it match the empty
substring
at the end of the previous separator match. If
separator
is the empty String, the String is split up into individual code unit
elements; the length of the result array equals the length of the
String, and each
substring
contains one code unit.
If the
this
value is (or converts to) the empty String, the result depends on whether
separator
can match the empty String. If it can, the result array contains no
elements. Otherwise, the result array contains one element, which is the
empty String.
If
separator
is
undefined
, then the result array contains just one String, which is the
this
value (converted to a String). If
limit
is not
undefined
, then the output array is truncated so that it contains no more than
limit
elements.
Note 2
The
split
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.21.1
SplitMatch (
The abstract operation SplitMatch takes arguments
(a String),
(a non-negative
integer
), and
(a String). It returns either
not-matched
or the end index of a match. It performs the following steps when called:
1.
Let
be the number of code units in
2.
Let
be the number of code units in
3.
If
, return
not-matched
4.
If there exists an
integer
between 0 (inclusive) and
(exclusive) such that the code unit at index
within
is different from the code unit at index
within
, return
not-matched
5.
Return
22.1.3.22
String.prototype.startsWith (
searchString
[ ,
position
] )
The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
isRegExp
be ?
IsRegExp
searchString
).
4.
If
isRegExp
is
true
, throw a
TypeError
exception.
5.
Let
searchStr
be ?
ToString
searchString
).
6.
Let
len
be the length of
7.
If
position
is
undefined
, let
pos
be 0; else let
pos
be ?
ToIntegerOrInfinity
position
).
8.
Let
start
be the result of
clamping
pos
between 0 and
len
9.
Let
searchLength
be the length of
searchStr
10.
If
searchLength
= 0, return
true
11.
Let
end
be
start
searchLength
12.
If
end
len
, return
false
13.
Let
substring
be the
substring
of
from
start
to
end
14.
Return !
SameValueNonNumeric
substring
searchStr
).
Note 1
This method returns
true
if the sequence of code units of
searchString
converted to a String is the same as the corresponding code units of this object (converted to a String) starting at index
position
. Otherwise returns
false
Note 2
Throwing an exception if the first argument is a RegExp is
specified in order to allow future editions to define extensions that
allow such argument values.
Note 3
The
startsWith
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.23
String.prototype.substring (
start
end
The
substring
method takes two arguments,
start
and
end
, and returns a
substring
of the result of converting this object to a String, starting from index
start
and running to, but not including, index
end
of the String (or through the end of the String if
end
is
undefined
). The result is a String value, not a String object.
If either argument is
NaN
or negative, it
is replaced with zero; if either argument is larger than the length of
the String, it is replaced with the length of the String.
If
start
is larger than
end
, they are swapped.
The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
len
be the length of
4.
Let
intStart
be ?
ToIntegerOrInfinity
start
).
5.
If
end
is
undefined
, let
intEnd
be
len
; else let
intEnd
be ?
ToIntegerOrInfinity
end
).
6.
Let
finalStart
be the result of
clamping
intStart
between 0 and
len
7.
Let
finalEnd
be the result of
clamping
intEnd
between 0 and
len
8.
Let
from
be
min
finalStart
finalEnd
).
9.
Let
to
be
max
finalStart
finalEnd
).
10.
Return the
substring
of
from
from
to
to
Note
The
substring
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.24
String.prototype.toLocaleLowerCase ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
toLocaleLowerCase
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleLowerCase
method is used.
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
This function works exactly the same as
toLowerCase
except that its result is intended to yield the correct result for the
host environment
's
current locale, rather than a locale-independent result. There will
only be a difference in the few cases (such as Turkish) where the rules
for that language conflict with the regular Unicode case mappings.
The meaning of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
Note
The
toLocaleLowerCase
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.25
String.prototype.toLocaleUpperCase ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
toLocaleUpperCase
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleUpperCase
method is used.
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
This function works exactly the same as
toUpperCase
except that its result is intended to yield the correct result for the
host environment
's
current locale, rather than a locale-independent result. There will
only be a difference in the few cases (such as Turkish) where the rules
for that language conflict with the regular Unicode case mappings.
The meaning of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
Note
The
toLocaleUpperCase
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.26
String.prototype.toLowerCase ( )
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
. The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
sText
be !
StringToCodePoints
).
4.
Let
lowerText
be the result of toLowercase(
sText
), according to the Unicode Default Case Conversion algorithm.
5.
Let
be !
CodePointsToString
lowerText
).
6.
Return
The result must be derived according to the
locale-insensitive case mappings in the Unicode Character Database (this
explicitly includes not only the UnicodeData.txt file, but also all
locale-insensitive mappings in the SpecialCasings.txt file that
accompanies it).
Note 1
The case mapping of some code points may produce multiple
code points. In this case the result String may not be the same length
as the source String. Because both
toUpperCase
and
toLowerCase
have context-sensitive behaviour, the functions are not symmetrical. In other words,
s.toUpperCase().toLowerCase()
is not necessarily equal to
s.toLowerCase()
Note 2
The
toLowerCase
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.27
String.prototype.toString ( )
When the
toString
method is called, the following steps are taken:
1.
Return ?
thisStringValue
this
value).
Note
For a String object, the
toString
method happens to return the same thing as the
valueOf
method.
22.1.3.28
String.prototype.toUpperCase ( )
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
This function behaves in exactly the same way as
String.prototype.toLowerCase
, except that the String is mapped using the toUppercase algorithm of the Unicode Default Case Conversion.
Note
The
toUpperCase
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.29
String.prototype.trim ( )
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
TrimString
start+end
).
Note
The
trim
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.29.1
TrimString (
string
where
The abstract operation TrimString takes arguments
string
and
where
. It interprets
string
as a sequence of UTF-16 encoded code points, as described in
6.1.4
. It performs the following steps when called:
1.
Let
str
be ?
RequireObjectCoercible
string
).
2.
Let
be ?
ToString
str
).
3.
If
where
is
start
, let
be the String value that is a copy of
with leading white space removed.
4.
Else if
where
is
end
, let
be the String value that is a copy of
with trailing white space removed.
5.
Else,
a.
Assert
where
is
start+end
b.
Let
be the String value that is a copy of
with both leading and trailing white space removed.
6.
Return
The definition of white space is the union of
WhiteSpace
and
LineTerminator
When determining whether a Unicode code point is in Unicode general
category “Space_Separator” (“Zs”), code unit sequences are interpreted
as UTF-16 encoded code point sequences as specified in
6.1.4
22.1.3.30
String.prototype.trimEnd ( )
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
TrimString
end
).
Note
The
trimEnd
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.31
String.prototype.trimStart ( )
This function interprets a String value as a sequence of UTF-16 encoded code points, as described in
6.1.4
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
TrimString
start
).
Note
The
trimStart
function is intentionally generic; it does not require that its
this
value be a String object. Therefore, it can be transferred to other kinds of objects for use as a method.
22.1.3.32
String.prototype.valueOf ( )
When the
valueOf
method is called, the following steps are taken:
1.
Return ?
thisStringValue
this
value).
22.1.3.33
String.prototype [ @@iterator ] ( )
When the
@@iterator
method is called it returns an Iterator object (
27.1.1.2
that iterates over the code points of a String value, returning each
code point as a String value. The following steps are taken:
1.
Let
be ?
RequireObjectCoercible
this
value).
2.
Let
be ?
ToString
).
3.
Let
closure
be a new
Abstract Closure
with no parameters that captures
and performs the following steps when called:
a.
Let
position
be 0.
b.
Let
len
be the length of
c.
Repeat, while
position
len
i.
Let
cp
be !
CodePointAt
position
).
ii.
Let
nextIndex
be
position
cp
.[[CodeUnitCount]].
iii.
Let
resultString
be the
substring
of
from
position
to
nextIndex
iv.
Set
position
to
nextIndex
v.
Perform ?
Yield
resultString
).
d.
Return
undefined
4.
Return !
CreateIteratorFromClosure
closure
"%StringIteratorPrototype%"
%StringIteratorPrototype%
).
The value of the
"name"
property of this function is
"[Symbol.iterator]"
22.1.4
Properties of String Instances
String instances are String exotic objects and have the
internal methods specified for such objects. String instances inherit
properties from the
String prototype object
. String instances also have a [[StringData]] internal slot.
String instances have a
"length"
property, and a set of enumerable properties with
integer
-indexed names.
22.1.4.1
length
The number of elements in the String value represented by this String object.
Once a String object is initialized, this property is unchanging. It has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
22.1.5
String Iterator Objects
A String Iterator is an object, that represents a specific
iteration over some specific String instance object. There is not a
named
constructor
for String Iterator objects. Instead, String iterator objects are
created by calling certain methods of String instance objects.
22.1.5.1
The %StringIteratorPrototype% Object
The
%StringIteratorPrototype%
object:
has properties that are inherited by all String Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
has the following properties:
22.1.5.1.1
%StringIteratorPrototype%.next ( )
1.
Return ?
GeneratorResume
this
value,
empty
"%StringIteratorPrototype%"
).
22.1.5.1.2
%StringIteratorPrototype% [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"String Iterator"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
22.2
RegExp (Regular Expression) Objects
A RegExp object contains a regular expression and the associated flags.
Note
The form and functionality of regular expressions is modelled
after the regular expression facility in the Perl 5 programming
language.
22.2.1
Patterns
The RegExp
constructor
applies the following grammar to the input pattern String. An error
occurs if the grammar cannot interpret the String as an expansion of
Pattern
Syntax
Pattern
[U, N]
::
Disjunction
[?U, ?N]
Disjunction
[U, N]
::
Alternative
[?U, ?N]
Alternative
[?U, ?N]
Disjunction
[?U, ?N]
Alternative
[U, N]
::
[empty]
Alternative
[?U, ?N]
Term
[?U, ?N]
Term
[U, N]
::
Assertion
[?U, ?N]
Atom
[?U, ?N]
Atom
[?U, ?N]
Quantifier
Assertion
[U, N]
::
Disjunction
[?U, ?N]
Disjunction
[?U, ?N]
<=
Disjunction
[?U, ?N]
Disjunction
[?U, ?N]
Quantifier
::
QuantifierPrefix
QuantifierPrefix
QuantifierPrefix
::
DecimalDigits
[~Sep]
DecimalDigits
[~Sep]
DecimalDigits
[~Sep]
DecimalDigits
[~Sep]
Atom
[U, N]
::
PatternCharacter
AtomEscape
[?U, ?N]
CharacterClass
[?U]
GroupSpecifier
[?U]
Disjunction
[?U, ?N]
Disjunction
[?U, ?N]
SyntaxCharacter
::
one of
PatternCharacter
::
SourceCharacter
but not
SyntaxCharacter
AtomEscape
[U, N]
::
DecimalEscape
CharacterClassEscape
[?U]
CharacterEscape
[?U]
[+N]
GroupName
[?U]
CharacterEscape
[U]
::
ControlEscape
ControlLetter
[lookahead ∉
DecimalDigit
HexEscapeSequence
RegExpUnicodeEscapeSequence
[?U]
IdentityEscape
[?U]
ControlEscape
::
one of
ControlLetter
::
one of
GroupSpecifier
[U]
::
[empty]
GroupName
[?U]
GroupName
[U]
::
RegExpIdentifierName
[?U]
RegExpIdentifierName
[U]
::
RegExpIdentifierStart
[?U]
RegExpIdentifierName
[?U]
RegExpIdentifierPart
[?U]
RegExpIdentifierStart
[U]
::
UnicodeIDStart
RegExpUnicodeEscapeSequence
[+U]
[~U]
UnicodeLeadSurrogate
UnicodeTrailSurrogate
RegExpIdentifierPart
[U]
::
UnicodeIDContinue
RegExpUnicodeEscapeSequence
[+U]
[~U]
UnicodeLeadSurrogate
UnicodeTrailSurrogate


RegExpUnicodeEscapeSequence
[U]
::
[+U]
HexLeadSurrogate
\u
HexTrailSurrogate
[+U]
HexLeadSurrogate
[+U]
HexTrailSurrogate
[+U]
HexNonSurrogate
[~U]
Hex4Digits
[+U]
u{
CodePoint
UnicodeLeadSurrogate
::
any Unicode code point in the inclusive range 0xD800 to 0xDBFF
UnicodeTrailSurrogate
::
any Unicode code point in the inclusive range 0xDC00 to 0xDFFF
Each
\u
HexTrailSurrogate
for which the choice of associated
HexLeadSurrogate
is ambiguous shall be associated with the nearest possible
HexLeadSurrogate
that would otherwise have no corresponding
\u
HexTrailSurrogate
HexLeadSurrogate
::
Hex4Digits
but only if the MV of
Hex4Digits
is in the inclusive range 0xD800 to 0xDBFF
HexTrailSurrogate
::
Hex4Digits
but only if the MV of
Hex4Digits
is in the inclusive range 0xDC00 to 0xDFFF
HexNonSurrogate
::
Hex4Digits
but only if the MV of
Hex4Digits
is not in the inclusive range 0xD800 to 0xDFFF
IdentityEscape
[U]
::
[+U]
SyntaxCharacter
[+U]
[~U]
SourceCharacter
but not
UnicodeIDContinue
DecimalEscape
::
NonZeroDigit
DecimalDigits
[~Sep]
opt
[lookahead ∉
DecimalDigit
CharacterClassEscape
[U]
::
[+U]
p{
UnicodePropertyValueExpression
[+U]
P{
UnicodePropertyValueExpression
UnicodePropertyValueExpression
::
UnicodePropertyName
UnicodePropertyValue
LoneUnicodePropertyNameOrValue
UnicodePropertyName
::
UnicodePropertyNameCharacters
UnicodePropertyNameCharacters
::
UnicodePropertyNameCharacter
UnicodePropertyNameCharacters
opt
UnicodePropertyValue
::
UnicodePropertyValueCharacters
LoneUnicodePropertyNameOrValue
::
UnicodePropertyValueCharacters
UnicodePropertyValueCharacters
::
UnicodePropertyValueCharacter
UnicodePropertyValueCharacters
opt
UnicodePropertyValueCharacter
::
UnicodePropertyNameCharacter
DecimalDigit
UnicodePropertyNameCharacter
::
ControlLetter
CharacterClass
[U]
::
[lookahead ≠
ClassRanges
[?U]
ClassRanges
[?U]
ClassRanges
[U]
::
[empty]
NonemptyClassRanges
[?U]
NonemptyClassRanges
[U]
::
ClassAtom
[?U]
ClassAtom
[?U]
NonemptyClassRangesNoDash
[?U]
ClassAtom
[?U]
ClassAtom
[?U]
ClassRanges
[?U]
NonemptyClassRangesNoDash
[U]
::
ClassAtom
[?U]
ClassAtomNoDash
[?U]
NonemptyClassRangesNoDash
[?U]
ClassAtomNoDash
[?U]
ClassAtom
[?U]
ClassRanges
[?U]
ClassAtom
[U]
::
ClassAtomNoDash
[?U]
ClassAtomNoDash
[U]
::
SourceCharacter
but not one of
or
or
ClassEscape
[?U]
ClassEscape
[U]
::
[+U]
CharacterClassEscape
[?U]
CharacterEscape
[?U]
Note
A number of productions in this section are given alternative definitions in section
B.1.4
22.2.1.1
Static Semantics: Early Errors
Note
This section is amended in
B.1.4.1
Pattern
::
Disjunction
It is a Syntax Error if
NcapturingParens
≥ 2
32
- 1.
It is a Syntax Error if
Pattern
contains multiple
GroupSpecifier
s whose enclosed
RegExpIdentifierName
s have the same
CapturingGroupName
QuantifierPrefix
::
DecimalDigits
DecimalDigits
It is a Syntax Error if the MV of the first
DecimalDigits
is larger than the MV of the second
DecimalDigits
AtomEscape
::
GroupName
It is a Syntax Error if the enclosing
Pattern
does not contain a
GroupSpecifier
with an enclosed
RegExpIdentifierName
whose
CapturingGroupName
equals the
CapturingGroupName
of the
RegExpIdentifierName
of this production's
GroupName
AtomEscape
::
DecimalEscape
It is a Syntax Error if the
CapturingGroupNumber
of
DecimalEscape
is larger than
NcapturingParens
22.2.2.1
).
NonemptyClassRanges
::
ClassAtom
ClassAtom
ClassRanges
It is a Syntax Error if
IsCharacterClass
of the first
ClassAtom
is
true
or
IsCharacterClass
of the second
ClassAtom
is
true
It is a Syntax Error if
IsCharacterClass
of the first
ClassAtom
is
false
and
IsCharacterClass
of the second
ClassAtom
is
false
and the
CharacterValue
of the first
ClassAtom
is larger than the
CharacterValue
of the second
ClassAtom
NonemptyClassRangesNoDash
::
ClassAtomNoDash
ClassAtom
ClassRanges
It is a Syntax Error if
IsCharacterClass
of
ClassAtomNoDash
is
true
or
IsCharacterClass
of
ClassAtom
is
true
It is a Syntax Error if
IsCharacterClass
of
ClassAtomNoDash
is
false
and
IsCharacterClass
of
ClassAtom
is
false
and the
CharacterValue
of
ClassAtomNoDash
is larger than the
CharacterValue
of
ClassAtom
RegExpIdentifierStart
[U]
::
RegExpUnicodeEscapeSequence
[+U]
It is a Syntax Error if the
CharacterValue
of
RegExpUnicodeEscapeSequence
is not the code point value of
"$"
"_"
, or some code point matched by the
UnicodeIDStart
lexical grammar production.
RegExpIdentifierStart
[U]
::
UnicodeLeadSurrogate
UnicodeTrailSurrogate
It is a Syntax Error if the result of performing
UTF16SurrogatePairToCodePoint
on the two code points matched by
UnicodeLeadSurrogate
and
UnicodeTrailSurrogate
respectively is not matched by the
UnicodeIDStart
lexical grammar production.
RegExpIdentifierPart
[U]
::
RegExpUnicodeEscapeSequence
[+U]
It is a Syntax Error if the
CharacterValue
of
RegExpUnicodeEscapeSequence
is not the code point value of
"$"
"_"
, , , or some code point matched by the
UnicodeIDContinue
lexical grammar production.
RegExpIdentifierPart
[U]
::
UnicodeLeadSurrogate
UnicodeTrailSurrogate
It is a Syntax Error if the result of performing
UTF16SurrogatePairToCodePoint
on the two code points matched by
UnicodeLeadSurrogate
and
UnicodeTrailSurrogate
respectively is not matched by the
UnicodeIDContinue
lexical grammar production.
UnicodePropertyValueExpression
::
UnicodePropertyName
UnicodePropertyValue
It is a Syntax Error if the
List
of Unicode code points that is
SourceText
of
UnicodePropertyName
is not identical to a
List
of Unicode code points that is a Unicode
property name
or property alias listed in the “
Property name
and aliases” column of
Table 56
It is a Syntax Error if the
List
of Unicode code points that is
SourceText
of
UnicodePropertyValue
is not identical to a
List
of Unicode code points that is a value or value alias for the Unicode property or property alias given by
SourceText
of
UnicodePropertyName
listed in the “Property value and aliases” column of the corresponding tables
Table 58
or
Table 59
UnicodePropertyValueExpression
::
LoneUnicodePropertyNameOrValue
It is a Syntax Error if the
List
of Unicode code points that is
SourceText
of
LoneUnicodePropertyNameOrValue
is not identical to a
List
of Unicode code points that is a Unicode general category or general
category alias listed in the “Property value and aliases” column of
Table 58
, nor a binary property or binary property alias listed in the “
Property name
and aliases” column of
Table 57
22.2.1.2
Static Semantics: CapturingGroupNumber
Note
This section is amended in
B.1.4.1
DecimalEscape
::
NonZeroDigit
1.
Return the MV of
NonZeroDigit
DecimalEscape
::
NonZeroDigit
DecimalDigits
1.
Let
be the number of code points in
DecimalDigits
2.
Return (the MV of
NonZeroDigit
× 10
plus the MV of
DecimalDigits
).
The definitions of “the MV of
NonZeroDigit
” and “the MV of
DecimalDigits
” are in
12.8.3
22.2.1.3
Static Semantics: IsCharacterClass
Note
This section is amended in
B.1.4.2
ClassAtom
::
ClassAtomNoDash
::
SourceCharacter
but not one of
or
or
ClassEscape
::
ClassEscape
::
ClassEscape
::
CharacterEscape
1.
Return
false
ClassEscape
::
CharacterClassEscape
1.
Return
true
22.2.1.4
Static Semantics: CharacterValue
Note 1
This section is amended in
B.1.4.3
ClassAtom
::
1.
Return the code point value of U+002D (HYPHEN-MINUS).
ClassAtomNoDash
::
SourceCharacter
but not one of
or
or
1.
Let
ch
be the code point matched by
SourceCharacter
2.
Return the code point value of
ch
ClassEscape
::
1.
Return the code point value of U+0008 (BACKSPACE).
ClassEscape
::
1.
Return the code point value of U+002D (HYPHEN-MINUS).
CharacterEscape
::
ControlEscape
1.
Return the code point value according to
Table 55
Table 55: ControlEscape Code Point Values
ControlEscape
Code Point Value
Code Point
Unicode Name
Symbol
U+0009
CHARACTER TABULATION

10
U+000A
LINE FEED (LF)

11
U+000B
LINE TABULATION

12
U+000C
FORM FEED (FF)

13
U+000D
CARRIAGE RETURN (CR)

CharacterEscape
::
ControlLetter
1.
Let
ch
be the code point matched by
ControlLetter
2.
Let
be
ch
's code point value.
3.
Return the remainder of dividing
by 32.
CharacterEscape
::
[lookahead ∉
DecimalDigit
1.
Return the code point value of U+0000 (NULL).
Note 2
\0
represents the character and cannot be followed by a decimal digit.
CharacterEscape
::
HexEscapeSequence
1.
Return the MV of
HexEscapeSequence
RegExpUnicodeEscapeSequence
::
HexLeadSurrogate
\u
HexTrailSurrogate
1.
Let
lead
be the
CharacterValue
of
HexLeadSurrogate
2.
Let
trail
be the
CharacterValue
of
HexTrailSurrogate
3.
Let
cp
be
UTF16SurrogatePairToCodePoint
lead
trail
).
4.
Return the code point value of
cp
RegExpUnicodeEscapeSequence
::
Hex4Digits
1.
Return the MV of
Hex4Digits
RegExpUnicodeEscapeSequence
::
u{
CodePoint
1.
Return the MV of
CodePoint
HexLeadSurrogate
::
Hex4Digits
HexTrailSurrogate
::
Hex4Digits
HexNonSurrogate
::
Hex4Digits
1.
Return the MV of
HexDigits
CharacterEscape
::
IdentityEscape
1.
Let
ch
be the code point matched by
IdentityEscape
2.
Return the code point value of
ch
22.2.1.5
Static Semantics: SourceText
UnicodePropertyNameCharacters
::
UnicodePropertyNameCharacter
UnicodePropertyNameCharacters
opt
UnicodePropertyValueCharacters
::
UnicodePropertyValueCharacter
UnicodePropertyValueCharacters
opt
1.
Return the
List
, in source text order, of Unicode code points in the
source text matched by
this production.
22.2.1.6
Static Semantics: CapturingGroupName
RegExpIdentifierName
[U]
::
RegExpIdentifierStart
[?U]
RegExpIdentifierName
[?U]
RegExpIdentifierPart
[?U]
1.
Let
idText
be the
source text matched by
RegExpIdentifierName
2.
Let
idTextUnescaped
be the result of replacing any occurrences of
RegExpUnicodeEscapeSequence
in
idText
with the code point represented by the
RegExpUnicodeEscapeSequence
3.
Return !
CodePointsToString
idTextUnescaped
).
22.2.2
Pattern Semantics
Note 1
This section is amended in
B.1.4.4
A regular expression pattern is converted into an
Abstract Closure
using the process described below. An implementation is encouraged to
use more efficient algorithms than the ones listed below, as long as the
results are the same. The
Abstract Closure
is used as the value of a RegExp object's [[RegExpMatcher]] internal slot.
Pattern
is either a BMP pattern or a Unicode pattern depending upon whether or not its associated flags contain a
A BMP pattern matches against a String interpreted as consisting of a
sequence of 16-bit values that are Unicode code points in the range of
the Basic Multilingual Plane. A Unicode pattern matches against a String
interpreted as consisting of Unicode code points encoded using UTF-16.
In the context of describing the behaviour of a BMP pattern “character”
means a single 16-bit Unicode BMP code point. In the context of
describing the behaviour of a Unicode pattern “character” means a UTF-16
encoded code point (
6.1.4
). In either context, “character value” means the numeric value of the corresponding non-encoded code point.
The syntax and semantics of
Pattern
is defined as if the source code for the
Pattern
was a
List
of
SourceCharacter
values where each
SourceCharacter
corresponds to a Unicode code point. If a BMP pattern contains a non-BMP
SourceCharacter
the entire pattern is encoded using UTF-16 and the individual code units of that encoding are used as the elements of the
List
Note 2
For example, consider a pattern expressed in source text as
the single non-BMP character U+1D11E (MUSICAL SYMBOL G CLEF).
Interpreted as a Unicode pattern, it would be a single element
(character)
List
consisting of the single code point 0x1D11E. However, interpreted as a
BMP pattern, it is first UTF-16 encoded to produce a two element
List
consisting of the code units 0xD834 and 0xDD1E.
Patterns are passed to the RegExp
constructor
as ECMAScript String values in which non-BMP characters are UTF-16
encoded. For example, the single character MUSICAL SYMBOL G CLEF
pattern, expressed as a String value, is a String of length 2 whose
elements were the code units 0xD834 and 0xDD1E. So no further
translation of the string would be necessary to process it as a BMP
pattern consisting of two pattern characters. However, to process it as a
Unicode pattern
UTF16SurrogatePairToCodePoint
must be used in producing a
List
whose sole element is a single pattern character, the code point U+1D11E.
An implementation may not actually perform such translations
to or from UTF-16, but the semantics of this specification requires that
the result of pattern matching be as if such translations were
performed.
22.2.2.1
Notation
The descriptions below use the following aliases:
Input
is a
List
whose elements are the characters of the String being matched by the
regular expression pattern. Each character is either a code unit or a
code point, depending upon the kind of pattern involved. The notation
Input
] means the
th
character of
Input
, where
can range between 0 (inclusive) and
InputLength
(exclusive).
InputLength
is the number of characters in
Input
NcapturingParens
is the total number of left-capturing parentheses (i.e. the total number of
Atom
::
GroupSpecifier
Disjunction
Parse Nodes) in the pattern. A left-capturing parenthesis is any
pattern character that is matched by the
terminal of the
Atom
::
GroupSpecifier
Disjunction
production.
DotAll
is
true
if the RegExp object's [[OriginalFlags]] internal slot contains
"s"
and otherwise is
false
IgnoreCase
is
true
if the RegExp object's [[OriginalFlags]] internal slot contains
"i"
and otherwise is
false
Multiline
is
true
if the RegExp object's [[OriginalFlags]] internal slot contains
"m"
and otherwise is
false
Unicode
is
true
if the RegExp object's [[OriginalFlags]] internal slot contains
"u"
and otherwise is
false
WordCharacters
is the mathematical set that is the union of all sixty-three characters in
"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_"
(letters, numbers, and U+005F (LOW LINE) in the Unicode Basic Latin block) and all characters
for which
is not in that set but
Canonicalize
) is.
WordCharacters
cannot contain more than sixty-three characters unless
Unicode
and
IgnoreCase
are both
true
Furthermore, the descriptions below use the following internal data structures:
CharSet
is a mathematical set of characters. When the
Unicode
flag is
true
“all characters” means the CharSet containing all code point values;
otherwise “all characters” means the CharSet containing all code unit
values.
State
is an ordered pair (
endIndex
captures
) where
endIndex
is an
integer
and
captures
is a
List
of
NcapturingParens
values. States are used to represent partial match states in the regular expression matching algorithms. The
endIndex
is one plus the index of the last input character matched so far by the pattern, while
captures
holds the results of capturing parentheses. The
th
element of
captures
is either a
List
of characters that represents the value obtained by the
th
set of capturing parentheses or
undefined
if the
th
set of capturing parentheses hasn't been reached yet. Due to
backtracking, many States may be in use at any time during the matching
process.
MatchResult
is either a State or the special token
failure
that indicates that the match failed.
Continuation
is an
Abstract Closure
that takes one State argument and returns a MatchResult result. The
Continuation attempts to match the remaining portion (specified by the
closure's captured values) of the pattern against
Input
starting at the intermediate state given by its State argument. If the
match succeeds, the Continuation returns the final State that it
reached; if the match fails, the Continuation returns
failure
Matcher
is an
Abstract Closure
that takes two arguments—a State and a Continuation—and returns a
MatchResult result. A Matcher attempts to match a middle subpattern
(specified by the closure's captured values) of the pattern against
Input
starting at the intermediate state given by its State argument. The
Continuation argument should be a closure that matches the rest of the
pattern. After matching the subpattern of a pattern to obtain a new
State, the Matcher then calls Continuation on that new State to test if
the rest of the pattern can match as well. If it can, the Matcher
returns the State returned by Continuation; if not, the Matcher may try
different choices at its choice points, repeatedly calling Continuation
until it either succeeds or all possibilities have been exhausted.
22.2.2.2
Pattern
The production
Pattern
::
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with 1 as its
direction
argument to obtain a Matcher
2.
Return a new
Abstract Closure
with parameters (
str
index
) that captures
and performs the following steps when called:
a.
Assert
Type
str
) is String.
b.
Assert
index
is a non-negative
integer
which is ≤ the length of
str
c.
If
Unicode
is
true
, let
Input
be !
StringToCodePoints
str
). Otherwise, let
Input
be a
List
whose elements are the code units that are the elements of
str
Input
will be used throughout the algorithms in
22.2.2
. Each element of
Input
is considered to be a character.
d.
Let
InputLength
be the number of characters contained in
Input
. This alias will be used throughout the algorithms in
22.2.2
e.
Let
listIndex
be the index into
Input
of the character that was obtained from element
index
of
str
f.
Let
be a new Continuation with parameters (
) that captures nothing and performs the following steps when called:
i.
Assert
is a State.
ii.
Return
g.
Let
cap
be a
List
of
NcapturingParens
undefined
values, indexed 1 through
NcapturingParens
h.
Let
be the State (
listIndex
cap
).
i.
Return
).
Note
A Pattern evaluates (“compiles”) to an
Abstract Closure
value.
RegExpBuiltinExec
can then apply this procedure to a String and an offset within the
String to determine whether the pattern would match starting at exactly
that offset within the String, and, if it does match, what the values of
the capturing parentheses would be. The algorithms in
22.2.2
are designed so that compiling a pattern may throw a
SyntaxError
exception; on the other hand, once the pattern is successfully compiled, applying the resulting
Abstract Closure
to find a match in a String cannot throw an exception (except for any
implementation-defined
exceptions that can occur anywhere such as out-of-memory).
22.2.2.3
Disjunction
With parameter
direction
The production
Disjunction
::
Alternative
evaluates as follows:
1.
Evaluate
Alternative
with argument
direction
to obtain a Matcher
2.
Return
The production
Disjunction
::
Alternative
Disjunction
evaluates as follows:
1.
Evaluate
Alternative
with argument
direction
to obtain a Matcher
m1
2.
Evaluate
Disjunction
with argument
direction
to obtain a Matcher
m2
3.
Return a new Matcher with parameters (
) that captures
m1
and
m2
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
m1
).
d.
If
is not
failure
, return
e.
Return
m2
).
Note
The
regular expression operator separates two alternatives. The pattern first tries to match the left
Alternative
(followed by the sequel of the regular expression); if it fails, it tries to match the right
Disjunction
(followed by the sequel of the regular expression). If the left
Alternative
, the right
Disjunction
, and the sequel all have choice points, all choices in the sequel are tried before moving on to the next choice in the left
Alternative
. If choices in the left
Alternative
are exhausted, the right
Disjunction
is tried instead of the left
Alternative
. Any capturing parentheses inside a portion of the pattern skipped by
produce
undefined
values instead of Strings. Thus, for example,
/a|ab/.exec(
"abc"
returns the result
"a"
and not
"ab"
. Moreover,
/((a)|(ab))((c)|(bc))/.exec(
"abc"
returns the array
"abc"
"a"
"a"
undefined
"bc"
undefined
"bc"
and not
"abc"
"ab"
undefined
"ab"
"c"
"c"
undefined
The order in which the two alternatives are tried is independent of the value of
direction
22.2.2.4
Alternative
With parameter
direction
The production
Alternative
::
[empty]
evaluates as follows:
1.
Return a new Matcher with parameters (
) that captures nothing and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Return
).
The production
Alternative
::
Alternative
Term
evaluates as follows:
1.
Evaluate
Alternative
with argument
direction
to obtain a Matcher
m1
2.
Evaluate
Term
with argument
direction
to obtain a Matcher
m2
3.
If
direction
= 1, then
a.
Return a new Matcher with parameters (
) that captures
m1
and
m2
and performs the following steps when called:
i.
Assert
is a State.
ii.
Assert
is a Continuation.
iii.
Let
be a new Continuation with parameters (
) that captures
and
m2
and performs the following steps when called:
1.
Assert
is a State.
2.
Return
m2
).
iv.
Return
m1
).
4.
Else,
a.
Assert
direction
is -1.
b.
Return a new Matcher with parameters (
) that captures
m1
and
m2
and performs the following steps when called:
i.
Assert
is a State.
ii.
Assert
is a Continuation.
iii.
Let
be a new Continuation with parameters (
) that captures
and
m1
and performs the following steps when called:
1.
Assert
is a State.
2.
Return
m1
).
iv.
Return
m2
).
Note
Consecutive
Term
s try to simultaneously match consecutive portions of
Input
. When
direction
= 1, if the left
Alternative
, the right
Term
and the sequel of the regular expression all have choice points, all
choices in the sequel are tried before moving on to the next choice in
the right
Term
, and all choices in the right
Term
are tried before moving on to the next choice in the left
Alternative
. When
direction
= -1, the evaluation order of
Alternative
and
Term
are reversed.
22.2.2.5
Term
With parameter
direction
The production
Term
::
Assertion
evaluates as follows:
1.
Return the Matcher that is the result of evaluating
Assertion
Note
The resulting Matcher is independent of
direction
The production
Term
::
Atom
evaluates as follows:
1.
Return the Matcher that is the result of evaluating
Atom
with argument
direction
The production
Term
::
Atom
Quantifier
evaluates as follows:
1.
Evaluate
Atom
with argument
direction
to obtain a Matcher
2.
Evaluate
Quantifier
to obtain the three results: a non-negative
integer
min
, a non-negative
integer
(or +∞)
max
, and Boolean
greedy
3.
Assert
min
max
4.
Let
parenIndex
be the number of left-capturing parentheses in the entire regular expression that occur to the left of this
Term
. This is the total number of
Atom
::
GroupSpecifier
Disjunction
Parse Nodes prior to or enclosing this
Term
5.
Let
parenCount
be the number of left-capturing parentheses in
Atom
. This is the total number of
Atom
::
GroupSpecifier
Disjunction
Parse Nodes enclosed by
Atom
6.
Return a new Matcher with parameters (
) that captures
min
max
greedy
parenIndex
, and
parenCount
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Return !
RepeatMatcher
min
max
greedy
parenIndex
parenCount
).
22.2.2.5.1
RepeatMatcher (
min
max
greedy
parenIndex
parenCount
The abstract operation RepeatMatcher takes arguments
(a Matcher),
min
(a non-negative
integer
),
max
(a non-negative
integer
or +∞),
greedy
(a Boolean),
(a State),
(a Continuation),
parenIndex
(a non-negative
integer
), and
parenCount
(a non-negative
integer
). It performs the following steps when called:
1.
If
max
= 0, return
).
2.
Let
be a new Continuation with parameters (
) that captures
min
max
greedy
parenIndex
, and
parenCount
and performs the following steps when called:
a.
Assert
is a State.
b.
If
min
= 0 and
's
endIndex
's
endIndex
, return
failure
c.
If
min
= 0, let
min2
be 0; otherwise let
min2
be
min
- 1.
d.
If
max
is +∞, let
max2
be +∞; otherwise let
max2
be
max
- 1.
e.
Return !
RepeatMatcher
min2
max2
greedy
parenIndex
parenCount
).
3.
Let
cap
be a copy of
's
captures
List
4.
For each
integer
such that
parenIndex
and
parenIndex
parenCount
, set
cap
] to
undefined
5.
Let
be
's
endIndex
6.
Let
xr
be the State (
cap
).
7.
If
min
≠ 0, return
xr
).
8.
If
greedy
is
false
, then
a.
Let
be
).
b.
If
is not
failure
, return
c.
Return
xr
).
9.
Let
be
xr
).
10.
If
is not
failure
, return
11.
Return
).
Note 1
An
Atom
followed by a
Quantifier
is repeated the number of times specified by the
Quantifier
. A
Quantifier
can be non-greedy, in which case the
Atom
pattern is repeated as few times as possible while still matching the sequel, or it can be greedy, in which case the
Atom
pattern is repeated as many times as possible while still matching the sequel. The
Atom
pattern is repeated rather than the input character sequence that it matches, so different repetitions of the
Atom
can match different input substrings.
Note 2
If the
Atom
and the sequel of the regular expression all have choice points, the
Atom
is first matched as many (or as few, if non-greedy) times as possible.
All choices in the sequel are tried before moving on to the next choice
in the last repetition of
Atom
. All choices in the last (n
th
) repetition of
Atom
are tried before moving on to the next choice in the next-to-last (n - 1)
st
repetition of
Atom
; at which point it may turn out that more or fewer repetitions of
Atom
are now possible; these are exhausted (again, starting with either as
few or as many as possible) before moving on to the next choice in the
(n - 1)
st
repetition of
Atom
and so on.
Compare
/a[a-z]{
}/.exec(
"abcdefghi"
which returns
"abcde"
with
/a[a-z]{
}?/.exec(
"abcdefghi"
which returns
"abc"
Consider also
/(aa|aabaac|ba|b|c)*/.exec(
"aabaac"
which, by the choice point ordering above, returns the array
"aaba"
"ba"
and not any of:
"aabaac"
"aabaac"
"aabaac"
"c"
The above ordering of choice points can be used to write a
regular expression that calculates the greatest common divisor of two
numbers (represented in unary notation). The following example
calculates the gcd of 10 and 15:
"aaaaaaaaaa,aaaaaaaaaaaaaaa"
.replace(
/^(a+)\1*,\1+$/
"$1"
which returns the gcd in unary notation
"aaaaa"
Note 3
Step
of the RepeatMatcher clears
Atom
's captures each time
Atom
is repeated. We can see its behaviour in the regular expression
/(z)((a+)?(b+)?(c))*/.exec(
"zaacbbbcac"
which returns the array
"zaacbbbcac"
"z"
"ac"
"a"
undefined
"c"
and not
"zaacbbbcac"
"z"
"ac"
"a"
"bbb"
"c"
because each iteration of the outermost
clears all captured Strings contained in the quantified
Atom
, which in this case includes capture Strings numbered 2, 3, 4, and 5.
Note 4
Step
2.b
of the RepeatMatcher states that once the minimum number of repetitions has been satisfied, any more expansions of
Atom
that match the empty character sequence are not considered for further
repetitions. This prevents the regular expression engine from falling
into an infinite loop on patterns such as:
/(a*)*/.exec(
"b"
or the slightly more complicated:
/(a*)b\
+/.exec(
"baaaac"
which returns the array
"b"
""
22.2.2.6
Assertion
The production
Assertion
::
evaluates as follows:
1.
Return a new Matcher with parameters (
) that captures nothing and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
's
endIndex
d.
If
= 0, or if
Multiline
is
true
and the character
Input
- 1] is one of
LineTerminator
, then
i.
Return
).
e.
Return
failure
Note
Even when the
flag is used with a pattern,
always matches only at the beginning of
Input
, or (if
Multiline
is
true
) at the beginning of a line.
The production
Assertion
::
evaluates as follows:
1.
Return a new Matcher with parameters (
) that captures nothing and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
's
endIndex
d.
If
InputLength
, or if
Multiline
is
true
and the character
Input
] is one of
LineTerminator
, then
i.
Return
).
e.
Return
failure
The production
Assertion
::
evaluates as follows:
1.
Return a new Matcher with parameters (
) that captures nothing and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
's
endIndex
d.
Let
be !
IsWordChar
- 1).
e.
Let
be !
IsWordChar
).
f.
If
is
true
and
is
false
, or if
is
false
and
is
true
, return
).
g.
Return
failure
The production
Assertion
::
evaluates as follows:
1.
Return a new Matcher with parameters (
) that captures nothing and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
's
endIndex
d.
Let
be !
IsWordChar
- 1).
e.
Let
be !
IsWordChar
).
f.
If
is
true
and
is
true
, or if
is
false
and
is
false
, return
).
g.
Return
failure
The production
Assertion
::
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with 1 as its
direction
argument to obtain a Matcher
2.
Return a new Matcher with parameters (
) that captures
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be a new Continuation with parameters (
) that captures nothing and performs the following steps when called:
i.
Assert
is a State.
ii.
Return
d.
Let
be
).
e.
If
is
failure
, return
failure
f.
Let
be
's State.
g.
Let
cap
be
's
captures
List
h.
Let
xe
be
's
endIndex
i.
Let
be the State (
xe
cap
).
j.
Return
).
The production
Assertion
::
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with 1 as its
direction
argument to obtain a Matcher
2.
Return a new Matcher with parameters (
) that captures
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be a new Continuation with parameters (
) that captures nothing and performs the following steps when called:
i.
Assert
is a State.
ii.
Return
d.
Let
be
).
e.
If
is not
failure
, return
failure
f.
Return
).
The production
Assertion
::
<=
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with -1 as its
direction
argument to obtain a Matcher
2.
Return a new Matcher with parameters (
) that captures
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be a new Continuation with parameters (
) that captures nothing and performs the following steps when called:
i.
Assert
is a State.
ii.
Return
d.
Let
be
).
e.
If
is
failure
, return
failure
f.
Let
be
's State.
g.
Let
cap
be
's
captures
List
h.
Let
xe
be
's
endIndex
i.
Let
be the State (
xe
cap
).
j.
Return
).
The production
Assertion
::
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with -1 as its
direction
argument to obtain a Matcher
2.
Return a new Matcher with parameters (
) that captures
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be a new Continuation with parameters (
) that captures nothing and performs the following steps when called:
i.
Assert
is a State.
ii.
Return
d.
Let
be
).
e.
If
is not
failure
, return
failure
f.
Return
).
22.2.2.6.1
IsWordChar (
The abstract operation IsWordChar takes argument
(an
integer
). It performs the following steps when called:
1.
If
= -1 or
is
InputLength
, return
false
2.
Let
be the character
Input
].
3.
If
is in
WordCharacters
, return
true
4.
Return
false
22.2.2.7
Quantifier
The production
Quantifier
::
QuantifierPrefix
evaluates as follows:
1.
Evaluate
QuantifierPrefix
to obtain the two results: an
integer
min
and an
integer
(or +∞)
max
2.
Return the three results
min
max
, and
true
The production
Quantifier
::
QuantifierPrefix
evaluates as follows:
1.
Evaluate
QuantifierPrefix
to obtain the two results: an
integer
min
and an
integer
(or +∞)
max
2.
Return the three results
min
max
, and
false
The production
QuantifierPrefix
::
evaluates as follows:
1.
Return the two results 0 and +∞.
The production
QuantifierPrefix
::
evaluates as follows:
1.
Return the two results 1 and +∞.
The production
QuantifierPrefix
::
evaluates as follows:
1.
Return the two results 0 and 1.
The production
QuantifierPrefix
::
DecimalDigits
evaluates as follows:
1.
Let
be the MV of
DecimalDigits
(see
12.8.3
).
2.
Return the two results
and
The production
QuantifierPrefix
::
DecimalDigits
evaluates as follows:
1.
Let
be the MV of
DecimalDigits
2.
Return the two results
and +∞.
The production
QuantifierPrefix
::
DecimalDigits
DecimalDigits
evaluates as follows:
1.
Let
be the MV of the first
DecimalDigits
2.
Let
be the MV of the second
DecimalDigits
3.
Return the two results
and
22.2.2.8
Atom
With parameter
direction
The production
Atom
::
PatternCharacter
evaluates as follows:
1.
Let
ch
be the character matched by
PatternCharacter
2.
Let
be a one-element CharSet containing the character
ch
3.
Return !
CharacterSetMatcher
false
direction
).
The production
Atom
::
evaluates as follows:
1.
Let
be the CharSet of all characters.
2.
If
DotAll
is not
true
, then
a.
Remove from
all characters corresponding to a code point on the right-hand side of the
LineTerminator
production.
3.
Return !
CharacterSetMatcher
false
direction
).
The production
Atom
::
AtomEscape
evaluates as follows:
1.
Return the Matcher that is the result of evaluating
AtomEscape
with argument
direction
The production
Atom
::
CharacterClass
evaluates as follows:
1.
Evaluate
CharacterClass
to obtain a CharSet
and a Boolean
invert
2.
Return !
CharacterSetMatcher
invert
direction
).
The production
Atom
::
GroupSpecifier
Disjunction
evaluates as follows:
1.
Evaluate
Disjunction
with argument
direction
to obtain a Matcher
2.
Let
parenIndex
be the number of left-capturing parentheses in the entire regular expression that occur to the left of this
Atom
. This is the total number of
Atom
::
GroupSpecifier
Disjunction
Parse Nodes prior to or enclosing this
Atom
3.
Return a new Matcher with parameters (
) that captures
direction
, and
parenIndex
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be a new Continuation with parameters (
) that captures
direction
, and
parenIndex
and performs the following steps when called:
i.
Assert
is a State.
ii.
Let
cap
be a copy of
's
captures
List
iii.
Let
xe
be
's
endIndex
iv.
Let
ye
be
's
endIndex
v.
If
direction
= 1, then
1.
Assert
xe
ye
2.
Let
be a
List
whose elements are the characters of
Input
at indices
xe
(inclusive) through
ye
(exclusive).
vi.
Else,
1.
Assert
direction
is -1.
2.
Assert
ye
xe
3.
Let
be a
List
whose elements are the characters of
Input
at indices
ye
(inclusive) through
xe
(exclusive).
vii.
Set
cap
parenIndex
+ 1] to
viii.
Let
be the State (
ye
cap
).
ix.
Return
).
d.
Return
).
The production
Atom
::
Disjunction
evaluates as follows:
1.
Return the Matcher that is the result of evaluating
Disjunction
with argument
direction
22.2.2.8.1
CharacterSetMatcher (
invert
direction
The abstract operation CharacterSetMatcher takes arguments
(a CharSet),
invert
(a Boolean), and
direction
(1 or -1). It performs the following steps when called:
1.
Return a new Matcher with parameters (
) that captures
invert
, and
direction
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
be
's
endIndex
d.
Let
be
direction
e.
If
< 0 or
InputLength
, return
failure
f.
Let
index
be
min
).
g.
Let
ch
be the character
Input
index
].
h.
Let
cc
be
Canonicalize
ch
).
i.
If there exists a member
of
such that
Canonicalize
) is
cc
, let
found
be
true
. Otherwise, let
found
be
false
j.
If
invert
is
false
and
found
is
false
, return
failure
k.
If
invert
is
true
and
found
is
true
, return
failure
l.
Let
cap
be
's
captures
List
m.
Let
be the State (
cap
).
n.
Return
).
22.2.2.8.2
Canonicalize (
ch
The abstract operation Canonicalize takes argument
ch
(a character). It performs the following steps when called:
1.
If
Unicode
is
true
and
IgnoreCase
is
true
, then
a.
If the file CaseFolding.txt of the Unicode Character Database provides a simple or common case folding mapping for
ch
, return the result of applying that mapping to
ch
b.
Return
ch
2.
If
IgnoreCase
is
false
, return
ch
3.
Assert
ch
is a UTF-16 code unit.
4.
Let
cp
be the code point whose numeric value is that of
ch
5.
Let
be the result of toUppercase(«
cp
»), according to the Unicode Default Case Conversion algorithm.
6.
Let
uStr
be !
CodePointsToString
).
7.
If
uStr
does not consist of a single code unit, return
ch
8.
Let
cu
be
uStr
's single code unit element.
9.
If the numeric value of
ch
≥ 128 and the numeric value of
cu
< 128, return
ch
10.
Return
cu
Note 1
Parentheses of the form
Disjunction
serve both to group the components of the
Disjunction
pattern together and to save the result of the match. The result can be used either in a backreference (
followed by a non-zero decimal number), referenced in a replace String,
or returned as part of an array from the regular expression matching
Abstract Closure
. To inhibit the capturing behaviour of parentheses, use the form
(?:
Disjunction
instead.
Note 2
The form
(?=
Disjunction
specifies a zero-width positive lookahead. In order for it to succeed, the pattern inside
Disjunction
must match at the current position, but the current position is not advanced before matching the sequel. If
Disjunction
can match at the current position in several ways, only the first one
is tried. Unlike other regular expression operators, there is no
backtracking into a
(?=
form (this unusual behaviour is inherited from Perl). This only matters when the
Disjunction
contains capturing parentheses and the sequel of the pattern contains backreferences to those captures.
For example,
/(?=(a+))/.exec(
"baaabac"
matches the empty String immediately after the first
and therefore returns the array:
""
"aaa"
To illustrate the lack of backtracking into the lookahead, consider:
/(?=(a+))a*b\
/.exec(
"baaabac"
This expression returns
"aba"
"a"
and not:
"aaaba"
"a"
Note 3
The form
(?!
Disjunction
specifies a zero-width negative lookahead. In order for it to succeed, the pattern inside
Disjunction
must fail to match at the current position. The current position is not advanced before matching the sequel.
Disjunction
can contain capturing parentheses, but backreferences to them only make sense from within
Disjunction
itself. Backreferences to these capturing parentheses from elsewhere in the pattern always return
undefined
because the negative lookahead must fail for the pattern to succeed. For example,
/(.*?)a(?!(a+)b\2c)\
(.*)/.exec(
"baaabaac"
looks for an
not immediately followed by some positive number n of
's, a
, another n
's (specified by the first
\2
) and a
. The second
\2
is outside the negative lookahead, so it matches against
undefined
and therefore always succeeds. The whole expression returns the array:
"baaabaac"
"ba"
undefined
"abaac"
Note 4
In case-insignificant matches when
Unicode
is
true
all characters are implicitly case-folded using the simple mapping
provided by the Unicode standard immediately before they are compared.
The simple mapping always maps to a single code point, so it does not
map, for example,
(U+00DF) to
SS
. It may however map a code point outside the Basic Latin range to a character within, for example,
(U+017F) to
. Such characters are not mapped if
Unicode
is
false
. This prevents Unicode code points such as U+017F and U+212A from matching regular expressions such as
/[a-z]/i
, but they will match
/[a-z]/ui
22.2.2.8.3
UnicodeMatchProperty (
The abstract operation UnicodeMatchProperty takes argument
(a
List
of Unicode code points). It performs the following steps when called:
1.
Assert
is a
List
of Unicode code points that is identical to a
List
of Unicode code points that is a Unicode
property name
or property alias listed in the “
Property name
and aliases” column of
Table 56
or
Table 57
2.
Let
be the canonical
property name
of
as given in the “Canonical
property name
” column of the corresponding row.
3.
Return the
List
of Unicode code points of
Implementations must support the Unicode property names and aliases listed in
Table 56
and
Table 57
. To ensure interoperability, implementations must not support any other property names or aliases.
Note 1
For example,
Script_Extensions
property name
) and
scx
(property alias) are valid, but
script_extensions
or
Scx
aren't.
Note 2
The listed properties form a superset of what
UTS18 RL1.2
requires.
Table 56: Non-binary Unicode property aliases and their canonical property names
Property name
and aliases
Canonical
property name
General_Category
General_Category
gc
Script
Script
sc
Script_Extensions
Script_Extensions
scx
Table 57: Binary Unicode property aliases and their canonical property names
Property name
and aliases
Canonical
property name
ASCII
ASCII
ASCII_Hex_Digit
ASCII_Hex_Digit
AHex
Alphabetic
Alphabetic
Alpha
Any
Any
Assigned
Assigned
Bidi_Control
Bidi_Control
Bidi_C
Bidi_Mirrored
Bidi_Mirrored
Bidi_M
Case_Ignorable
Case_Ignorable
CI
Cased
Cased
Changes_When_Casefolded
Changes_When_Casefolded
CWCF
Changes_When_Casemapped
Changes_When_Casemapped
CWCM
Changes_When_Lowercased
Changes_When_Lowercased
CWL
Changes_When_NFKC_Casefolded
Changes_When_NFKC_Casefolded
CWKCF
Changes_When_Titlecased
Changes_When_Titlecased
CWT
Changes_When_Uppercased
Changes_When_Uppercased
CWU
Dash
Dash
Default_Ignorable_Code_Point
Default_Ignorable_Code_Point
DI
Deprecated
Deprecated
Dep
Diacritic
Diacritic
Dia
Emoji
Emoji
Emoji_Component
Emoji_Component
EComp
Emoji_Modifier
Emoji_Modifier
EMod
Emoji_Modifier_Base
Emoji_Modifier_Base
EBase
Emoji_Presentation
Emoji_Presentation
EPres
Extended_Pictographic
Extended_Pictographic
ExtPict
Extender
Extender
Ext
Grapheme_Base
Grapheme_Base
Gr_Base
Grapheme_Extend
Grapheme_Extend
Gr_Ext
Hex_Digit
Hex_Digit
Hex
IDS_Binary_Operator
IDS_Binary_Operator
IDSB
IDS_Trinary_Operator
IDS_Trinary_Operator
IDST
ID_Continue
ID_Continue
IDC
ID_Start
ID_Start
IDS
Ideographic
Ideographic
Ideo
Join_Control
Join_Control
Join_C
Logical_Order_Exception
Logical_Order_Exception
LOE
Lowercase
Lowercase
Lower
Math
Math
Noncharacter_Code_Point
Noncharacter_Code_Point
NChar
Pattern_Syntax
Pattern_Syntax
Pat_Syn
Pattern_White_Space
Pattern_White_Space
Pat_WS
Quotation_Mark
Quotation_Mark
QMark
Radical
Radical
Regional_Indicator
Regional_Indicator
RI
Sentence_Terminal
Sentence_Terminal
STerm
Soft_Dotted
Soft_Dotted
SD
Terminal_Punctuation
Terminal_Punctuation
Term
Unified_Ideograph
Unified_Ideograph
UIdeo
Uppercase
Uppercase
Upper
Variation_Selector
Variation_Selector
VS
White_Space
White_Space
space
XID_Continue
XID_Continue
XIDC
XID_Start
XID_Start
XIDS
22.2.2.8.4
UnicodeMatchPropertyValue (
The abstract operation UnicodeMatchPropertyValue takes arguments
(a
List
of Unicode code points) and
(a
List
of Unicode code points). It performs the following steps when called:
1.
Assert
is a
List
of Unicode code points that is identical to a
List
of Unicode code points that is a canonical, unaliased Unicode
property name
listed in the “Canonical
property name
” column of
Table 56
2.
Assert
is a
List
of Unicode code points that is identical to a
List
of Unicode code points that is a property value or property value alias for Unicode property
listed in the “Property value and aliases” column of
Table 58
or
Table 59
3.
Let
value
be the canonical property value of
as given in the “Canonical property value” column of the corresponding row.
4.
Return the
List
of Unicode code points of
value
Implementations must support the Unicode property value names and aliases listed in
Table 58
and
Table 59
. To ensure interoperability, implementations must not support any other property value names or aliases.
Note 1
For example,
Xpeo
and
Old_Persian
are valid
Script_Extensions
values, but
xpeo
and
Old Persian
aren't.
Note 2
This algorithm differs from
the matching rules for symbolic values listed in UAX44
: case,
white space
, U+002D (HYPHEN-MINUS), and U+005F (LOW LINE) are not ignored, and the
Is
prefix is not supported.
Table 58: Value aliases and canonical values for the Unicode property
General_Category
Property value and aliases
Canonical property value
Cased_Letter
Cased_Letter
LC
Close_Punctuation
Close_Punctuation
Pe
Connector_Punctuation
Connector_Punctuation
Pc
Control
Control
Cc
cntrl
Currency_Symbol
Currency_Symbol
Sc
Dash_Punctuation
Dash_Punctuation
Pd
Decimal_Number
Decimal_Number
Nd
digit
Enclosing_Mark
Enclosing_Mark
Me
Final_Punctuation
Final_Punctuation
Pf
Format
Format
Cf
Initial_Punctuation
Initial_Punctuation
Pi
Letter
Letter
Letter_Number
Letter_Number
Nl
Line_Separator
Line_Separator
Zl
Lowercase_Letter
Lowercase_Letter
Ll
Mark
Mark
Combining_Mark
Math_Symbol
Math_Symbol
Sm
Modifier_Letter
Modifier_Letter
Lm
Modifier_Symbol
Modifier_Symbol
Sk
Nonspacing_Mark
Nonspacing_Mark
Mn
Number
Number
Open_Punctuation
Open_Punctuation
Ps
Other
Other
Other_Letter
Other_Letter
Lo
Other_Number
Other_Number
No
Other_Punctuation
Other_Punctuation
Po
Other_Symbol
Other_Symbol
So
Paragraph_Separator
Paragraph_Separator
Zp
Private_Use
Private_Use
Co
Punctuation
Punctuation
punct
Separator
Separator
Space_Separator
Space_Separator
Zs
Spacing_Mark
Spacing_Mark
Mc
Surrogate
Surrogate
Cs
Symbol
Symbol
Titlecase_Letter
Titlecase_Letter
Lt
Unassigned
Unassigned
Cn
Uppercase_Letter
Uppercase_Letter
Lu
Table 59: Value aliases and canonical values for the Unicode properties
Script
and
Script_Extensions
Property value and aliases
Canonical property value
Adlam
Adlam
Adlm
Ahom
Ahom
Anatolian_Hieroglyphs
Anatolian_Hieroglyphs
Hluw
Arabic
Arabic
Arab
Armenian
Armenian
Armn
Avestan
Avestan
Avst
Balinese
Balinese
Bali
Bamum
Bamum
Bamu
Bassa_Vah
Bassa_Vah
Bass
Batak
Batak
Batk
Bengali
Bengali
Beng
Bhaiksuki
Bhaiksuki
Bhks
Bopomofo
Bopomofo
Bopo
Brahmi
Brahmi
Brah
Braille
Braille
Brai
Buginese
Buginese
Bugi
Buhid
Buhid
Buhd
Canadian_Aboriginal
Canadian_Aboriginal
Cans
Carian
Carian
Cari
Caucasian_Albanian
Caucasian_Albanian
Aghb
Chakma
Chakma
Cakm
Cham
Cham
Chorasmian
Chorasmian
Chrs
Cherokee
Cherokee
Cher
Common
Common
Zyyy
Coptic
Coptic
Copt
Qaac
Cuneiform
Cuneiform
Xsux
Cypriot
Cypriot
Cprt
Cyrillic
Cyrillic
Cyrl
Deseret
Deseret
Dsrt
Devanagari
Devanagari
Deva
Dives_Akuru
Dives_Akuru
Diak
Dogra
Dogra
Dogr
Duployan
Duployan
Dupl
Egyptian_Hieroglyphs
Egyptian_Hieroglyphs
Egyp
Elbasan
Elbasan
Elba
Elymaic
Elymaic
Elym
Ethiopic
Ethiopic
Ethi
Georgian
Georgian
Geor
Glagolitic
Glagolitic
Glag
Gothic
Gothic
Goth
Grantha
Grantha
Gran
Greek
Greek
Grek
Gujarati
Gujarati
Gujr
Gunjala_Gondi
Gunjala_Gondi
Gong
Gurmukhi
Gurmukhi
Guru
Han
Han
Hani
Hangul
Hangul
Hang
Hanifi_Rohingya
Hanifi_Rohingya
Rohg
Hanunoo
Hanunoo
Hano
Hatran
Hatran
Hatr
Hebrew
Hebrew
Hebr
Hiragana
Hiragana
Hira
Imperial_Aramaic
Imperial_Aramaic
Armi
Inherited
Inherited
Zinh
Qaai
Inscriptional_Pahlavi
Inscriptional_Pahlavi
Phli
Inscriptional_Parthian
Inscriptional_Parthian
Prti
Javanese
Javanese
Java
Kaithi
Kaithi
Kthi
Kannada
Kannada
Knda
Katakana
Katakana
Kana
Kayah_Li
Kayah_Li
Kali
Kharoshthi
Kharoshthi
Khar
Khitan_Small_Script
Khitan_Small_Script
Kits
Khmer
Khmer
Khmr
Khojki
Khojki
Khoj
Khudawadi
Khudawadi
Sind
Lao
Lao
Laoo
Latin
Latin
Latn
Lepcha
Lepcha
Lepc
Limbu
Limbu
Limb
Linear_A
Linear_A
Lina
Linear_B
Linear_B
Linb
Lisu
Lisu
Lycian
Lycian
Lyci
Lydian
Lydian
Lydi
Mahajani
Mahajani
Mahj
Makasar
Makasar
Maka
Malayalam
Malayalam
Mlym
Mandaic
Mandaic
Mand
Manichaean
Manichaean
Mani
Marchen
Marchen
Marc
Medefaidrin
Medefaidrin
Medf
Masaram_Gondi
Masaram_Gondi
Gonm
Meetei_Mayek
Meetei_Mayek
Mtei
Mende_Kikakui
Mende_Kikakui
Mend
Meroitic_Cursive
Meroitic_Cursive
Merc
Meroitic_Hieroglyphs
Meroitic_Hieroglyphs
Mero
Miao
Miao
Plrd
Modi
Modi
Mongolian
Mongolian
Mong
Mro
Mro
Mroo
Multani
Multani
Mult
Myanmar
Myanmar
Mymr
Nabataean
Nabataean
Nbat
Nandinagari
Nandinagari
Nand
New_Tai_Lue
New_Tai_Lue
Talu
Newa
Newa
Nko
Nko
Nkoo
Nushu
Nushu
Nshu
Nyiakeng_Puachue_Hmong
Nyiakeng_Puachue_Hmong
Hmnp
Ogham
Ogham
Ogam
Ol_Chiki
Ol_Chiki
Olck
Old_Hungarian
Old_Hungarian
Hung
Old_Italic
Old_Italic
Ital
Old_North_Arabian
Old_North_Arabian
Narb
Old_Permic
Old_Permic
Perm
Old_Persian
Old_Persian
Xpeo
Old_Sogdian
Old_Sogdian
Sogo
Old_South_Arabian
Old_South_Arabian
Sarb
Old_Turkic
Old_Turkic
Orkh
Oriya
Oriya
Orya
Osage
Osage
Osge
Osmanya
Osmanya
Osma
Pahawh_Hmong
Pahawh_Hmong
Hmng
Palmyrene
Palmyrene
Palm
Pau_Cin_Hau
Pau_Cin_Hau
Pauc
Phags_Pa
Phags_Pa
Phag
Phoenician
Phoenician
Phnx
Psalter_Pahlavi
Psalter_Pahlavi
Phlp
Rejang
Rejang
Rjng
Runic
Runic
Runr
Samaritan
Samaritan
Samr
Saurashtra
Saurashtra
Saur
Sharada
Sharada
Shrd
Shavian
Shavian
Shaw
Siddham
Siddham
Sidd
SignWriting
SignWriting
Sgnw
Sinhala
Sinhala
Sinh
Sogdian
Sogdian
Sogd
Sora_Sompeng
Sora_Sompeng
Sora
Soyombo
Soyombo
Soyo
Sundanese
Sundanese
Sund
Syloti_Nagri
Syloti_Nagri
Sylo
Syriac
Syriac
Syrc
Tagalog
Tagalog
Tglg
Tagbanwa
Tagbanwa
Tagb
Tai_Le
Tai_Le
Tale
Tai_Tham
Tai_Tham
Lana
Tai_Viet
Tai_Viet
Tavt
Takri
Takri
Takr
Tamil
Tamil
Taml
Tangut
Tangut
Tang
Telugu
Telugu
Telu
Thaana
Thaana
Thaa
Thai
Thai
Tibetan
Tibetan
Tibt
Tifinagh
Tifinagh
Tfng
Tirhuta
Tirhuta
Tirh
Ugaritic
Ugaritic
Ugar
Vai
Vai
Vaii
Wancho
Wancho
Wcho
Warang_Citi
Warang_Citi
Wara
Yezidi
Yezidi
Yezi
Yi
Yi
Yiii
Zanabazar_Square
Zanabazar_Square
Zanb
22.2.2.9
AtomEscape
With parameter
direction
The production
AtomEscape
::
DecimalEscape
evaluates as follows:
1.
Evaluate
DecimalEscape
to obtain an
integer
2.
Assert
NcapturingParens
3.
Return !
BackreferenceMatcher
direction
).
The production
AtomEscape
::
CharacterEscape
evaluates as follows:
1.
Evaluate
CharacterEscape
to obtain a character
ch
2.
Let
be a one-element CharSet containing the character
ch
3.
Return !
CharacterSetMatcher
false
direction
).
The production
AtomEscape
::
CharacterClassEscape
evaluates as follows:
1.
Evaluate
CharacterClassEscape
to obtain a CharSet
2.
Return !
CharacterSetMatcher
false
direction
).
Note
An escape sequence of the form
followed by a non-zero decimal number
matches the result of the
th
set of capturing parentheses (
22.2.2.1
). It is an error if the regular expression has fewer than
capturing parentheses. If the regular expression has
or more capturing parentheses but the
th
one is
undefined
because it has not captured anything, then the backreference always succeeds.
The production
AtomEscape
::
GroupName
evaluates as follows:
1.
Search the enclosing
Pattern
for an instance of a
GroupSpecifier
containing a
RegExpIdentifierName
which has a
CapturingGroupName
equal to the
CapturingGroupName
of the
RegExpIdentifierName
contained in
GroupName
2.
Assert
: A unique such
GroupSpecifier
is found.
3.
Let
parenIndex
be the number of left-capturing parentheses in the entire regular expression that occur to the left of the located
GroupSpecifier
. This is the total number of
Atom
::
GroupSpecifier
Disjunction
Parse Nodes prior to or enclosing the located
GroupSpecifier
, including its immediately enclosing
Atom
4.
Return !
BackreferenceMatcher
parenIndex
direction
).
22.2.2.9.1
BackreferenceMatcher (
direction
The abstract operation BackreferenceMatcher takes arguments
(a positive
integer
) and
direction
(1 or -1). It performs the following steps when called:
1.
Assert
≥ 1.
2.
Return a new Matcher with parameters (
) that captures
and
direction
and performs the following steps when called:
a.
Assert
is a State.
b.
Assert
is a Continuation.
c.
Let
cap
be
's
captures
List
d.
Let
be
cap
].
e.
If
is
undefined
, return
).
f.
Let
be
's
endIndex
g.
Let
len
be the number of elements in
h.
Let
be
direction
len
i.
If
< 0 or
InputLength
, return
failure
j.
Let
be
min
).
k.
If there exists an
integer
between 0 (inclusive) and
len
(exclusive) such that
Canonicalize
]) is not the same character value as
Canonicalize
Input
]), return
failure
l.
Let
be the State (
cap
).
m.
Return
).
22.2.2.10
CharacterEscape
The
CharacterEscape
productions evaluate as follows:
CharacterEscape
::
ControlEscape
ControlLetter
[lookahead ∉
DecimalDigit
HexEscapeSequence
RegExpUnicodeEscapeSequence
IdentityEscape
1.
Let
cv
be the
CharacterValue
of this
CharacterEscape
2.
Return the character whose character value is
cv
22.2.2.11
DecimalEscape
The
DecimalEscape
productions evaluate as follows:
DecimalEscape
::
NonZeroDigit
DecimalDigits
opt
1.
Return the
CapturingGroupNumber
of this
DecimalEscape
Note
If
is followed by a decimal number
whose first digit is not
, then the escape sequence is considered to be a backreference. It is an error if
is greater than the total number of left-capturing parentheses in the entire regular expression.
22.2.2.12
CharacterClassEscape
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return the ten-element CharSet containing the characters
through
inclusive.
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return the CharSet containing all characters not in the CharSet returned by
CharacterClassEscape
::
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return the CharSet containing all characters corresponding to a code point on the right-hand side of the
WhiteSpace
or
LineTerminator
productions.
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return the CharSet containing all characters not in the CharSet returned by
CharacterClassEscape
::
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return
WordCharacters
The production
CharacterClassEscape
::
evaluates as follows:
1.
Return the CharSet containing all characters not in the CharSet returned by
CharacterClassEscape
::
The production
CharacterClassEscape
::
p{
UnicodePropertyValueExpression
evaluates as follows:
1.
Return the CharSet containing all Unicode code points included in the CharSet returned by
UnicodePropertyValueExpression
The production
CharacterClassEscape
::
P{
UnicodePropertyValueExpression
evaluates as follows:
1.
Return the CharSet containing all Unicode code points not included in the CharSet returned by
UnicodePropertyValueExpression
The production
UnicodePropertyValueExpression
::
UnicodePropertyName
UnicodePropertyValue
evaluates as follows:
1.
Let
ps
be
SourceText
of
UnicodePropertyName
2.
Let
be !
UnicodeMatchProperty
ps
).
3.
Assert
is a Unicode
property name
or property alias listed in the “
Property name
and aliases” column of
Table 56
4.
Let
vs
be
SourceText
of
UnicodePropertyValue
5.
Let
be !
UnicodeMatchPropertyValue
vs
).
6.
Return the CharSet containing all Unicode code points whose character database definition includes the property
with value
The production
UnicodePropertyValueExpression
::
LoneUnicodePropertyNameOrValue
evaluates as follows:
1.
Let
be
SourceText
of
LoneUnicodePropertyNameOrValue
2.
If !
UnicodeMatchPropertyValue
General_Category
) is identical to a
List
of Unicode code points that is the name of a Unicode general category
or general category alias listed in the “Property value and aliases”
column of
Table 58
, then
a.
Return
the CharSet containing all Unicode code points whose character database
definition includes the property “General_Category” with value
3.
Let
be !
UnicodeMatchProperty
).
4.
Assert
is a binary Unicode property or binary property alias listed in the “
Property name
and aliases” column of
Table 57
5.
Return the CharSet containing all Unicode code points whose character database definition includes the property
with value “True”.
22.2.2.13
CharacterClass
The production
CharacterClass
::
ClassRanges
evaluates as follows:
1.
Evaluate
ClassRanges
to obtain a CharSet
2.
Return the two results
and
false
The production
CharacterClass
::
ClassRanges
evaluates as follows:
1.
Evaluate
ClassRanges
to obtain a CharSet
2.
Return the two results
and
true
22.2.2.14
ClassRanges
The production
ClassRanges
::
[empty]
evaluates as follows:
1.
Return the empty CharSet.
The production
ClassRanges
::
NonemptyClassRanges
evaluates as follows:
1.
Return the CharSet that is the result of evaluating
NonemptyClassRanges
22.2.2.15
NonemptyClassRanges
The production
NonemptyClassRanges
::
ClassAtom
evaluates as follows:
1.
Return the CharSet that is the result of evaluating
ClassAtom
The production
NonemptyClassRanges
::
ClassAtom
NonemptyClassRangesNoDash
evaluates as follows:
1.
Evaluate
ClassAtom
to obtain a CharSet
2.
Evaluate
NonemptyClassRangesNoDash
to obtain a CharSet
3.
Return the union of CharSets
and
The production
NonemptyClassRanges
::
ClassAtom
ClassAtom
ClassRanges
evaluates as follows:
1.
Evaluate the first
ClassAtom
to obtain a CharSet
2.
Evaluate the second
ClassAtom
to obtain a CharSet
3.
Evaluate
ClassRanges
to obtain a CharSet
4.
Let
be !
CharacterRange
).
5.
Return the union of
and
22.2.2.15.1
CharacterRange (
The abstract operation CharacterRange takes arguments
(a CharSet) and
(a CharSet). It performs the following steps when called:
1.
Assert
and
each contain exactly one character.
2.
Let
be the one character in CharSet
3.
Let
be the one character in CharSet
4.
Let
be the character value of character
5.
Let
be the character value of character
6.
Assert
7.
Return the CharSet containing all characters with a character value greater than or equal to
and less than or equal to
22.2.2.16
NonemptyClassRangesNoDash
The production
NonemptyClassRangesNoDash
::
ClassAtom
evaluates as follows:
1.
Return the CharSet that is the result of evaluating
ClassAtom
The production
NonemptyClassRangesNoDash
::
ClassAtomNoDash
NonemptyClassRangesNoDash
evaluates as follows:
1.
Evaluate
ClassAtomNoDash
to obtain a CharSet
2.
Evaluate
NonemptyClassRangesNoDash
to obtain a CharSet
3.
Return the union of CharSets
and
The production
NonemptyClassRangesNoDash
::
ClassAtomNoDash
ClassAtom
ClassRanges
evaluates as follows:
1.
Evaluate
ClassAtomNoDash
to obtain a CharSet
2.
Evaluate
ClassAtom
to obtain a CharSet
3.
Evaluate
ClassRanges
to obtain a CharSet
4.
Let
be !
CharacterRange
).
5.
Return the union of
and
Note 1
ClassRanges
can expand into a single
ClassAtom
and/or ranges of two
ClassAtom
separated by dashes. In the latter case the
ClassRanges
includes all characters between the first
ClassAtom
and the second
ClassAtom
, inclusive; an error occurs if either
ClassAtom
does not represent a single character (for example, if one is \w) or if the first
ClassAtom
's character value is greater than the second
ClassAtom
's character value.
Note 2
Even if the pattern ignores case, the case of the two ends
of a range is significant in determining which characters belong to the
range. Thus, for example, the pattern
/[E-F]/i
matches only the letters
, and
, while the pattern
/[E-f]/i
matches all upper and lower-case letters in the Unicode Basic Latin block as well as the symbols
, and
Note 3
character can be treated literally or it can denote a range. It is treated literally if it is the first or last character of
ClassRanges
, the beginning or end limit of a range specification, or immediately follows a range specification.
22.2.2.17
ClassAtom
The production
ClassAtom
::
evaluates as follows:
1.
Return the CharSet containing the single character
U+002D (HYPHEN-MINUS).
The production
ClassAtom
::
ClassAtomNoDash
evaluates as follows:
1.
Return the CharSet that is the result of evaluating
ClassAtomNoDash
22.2.2.18
ClassAtomNoDash
The production
ClassAtomNoDash
::
SourceCharacter
but not one of
or
or
evaluates as follows:
1.
Return the CharSet containing the character matched by
SourceCharacter
The production
ClassAtomNoDash
::
ClassEscape
evaluates as follows:
1.
Return the CharSet that is the result of evaluating
ClassEscape
22.2.2.19
ClassEscape
The
ClassEscape
productions evaluate as follows:
ClassEscape
::
ClassEscape
::
ClassEscape
::
CharacterEscape
1.
Let
cv
be the
CharacterValue
of this
ClassEscape
2.
Let
be the character whose character value is
cv
3.
Return the CharSet containing the single character
ClassEscape
::
CharacterClassEscape
1.
Return the CharSet that is the result of evaluating
CharacterClassEscape
Note
ClassAtom
can use any of the escape sequences that are allowed in the rest of the regular expression except for
\b
\B
, and backreferences. Inside a
CharacterClass
\b
means the backspace character, while
\B
and backreferences raise errors. Using a backreference inside a
ClassAtom
causes an error.
22.2.3
The RegExp Constructor
The RegExp
constructor
is
%RegExp%
is the initial value of the
"RegExp"
property of the
global object
creates and initializes a new RegExp object when called as a function rather than as a
constructor
. Thus the function call
RegExp(…)
is equivalent to the object creation expression
new RegExp(…)
with the same arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified RegExp behaviour must include a
super
call to the RegExp
constructor
to create and initialize subclass instances with the necessary internal slots.
22.2.3.1
RegExp (
pattern
flags
The following steps are taken:
1.
Let
patternIsRegExp
be ?
IsRegExp
pattern
).
2.
If NewTarget is
undefined
, then
a.
Let
newTarget
be the
active function object
b.
If
patternIsRegExp
is
true
and
flags
is
undefined
, then
i.
Let
patternConstructor
be ?
Get
pattern
"constructor"
).
ii.
If
SameValue
newTarget
patternConstructor
) is
true
, return
pattern
3.
Else, let
newTarget
be NewTarget.
4.
If
Type
pattern
) is Object and
pattern
has a [[RegExpMatcher]] internal slot, then
a.
Let
be
pattern
.[[OriginalSource]].
b.
If
flags
is
undefined
, let
be
pattern
.[[OriginalFlags]].
c.
Else, let
be
flags
5.
Else if
patternIsRegExp
is
true
, then
a.
Let
be ?
Get
pattern
"source"
).
b.
If
flags
is
undefined
, then
i.
Let
be ?
Get
pattern
"flags"
).
c.
Else, let
be
flags
6.
Else,
a.
Let
be
pattern
b.
Let
be
flags
7.
Let
be ?
RegExpAlloc
newTarget
).
8.
Return ?
RegExpInitialize
).
Note
If pattern is supplied using a
StringLiteral
the usual escape sequence substitutions are performed before the String
is processed by RegExp. If pattern must contain an escape sequence to
be recognized by RegExp, any U+005C (REVERSE SOLIDUS) code points must
be escaped within the
StringLiteral
to prevent them being removed when the contents of the
StringLiteral
are formed.
22.2.3.2
Abstract Operations for the RegExp Constructor
22.2.3.2.1
RegExpAlloc (
newTarget
The abstract operation RegExpAlloc takes argument
newTarget
. It performs the following steps when called:
1.
Let
obj
be ?
OrdinaryCreateFromConstructor
newTarget
"%RegExp.prototype%"
, « [[RegExpMatcher]], [[OriginalSource]], [[OriginalFlags]] »).
2.
Perform !
DefinePropertyOrThrow
obj
"lastIndex"
, PropertyDescriptor { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}).
3.
Return
obj
22.2.3.2.2
RegExpInitialize (
obj
pattern
flags
The abstract operation RegExpInitialize takes arguments
obj
pattern
, and
flags
. It performs the following steps when called:
1.
If
pattern
is
undefined
, let
be the empty String.
2.
Else, let
be ?
ToString
pattern
).
3.
If
flags
is
undefined
, let
be the empty String.
4.
Else, let
be ?
ToString
flags
).
5.
If
contains any code unit other than
"g"
"i"
"m"
"s"
"u"
, or
"y"
or if it contains the same code unit more than once, throw a
SyntaxError
exception.
6.
If
contains
"u"
, let
be
true
; else let
be
false
7.
If
is
true
, then
a.
Let
patternText
be !
StringToCodePoints
).
b.
Let
patternCharacters
be a
List
whose elements are the code points of
patternText
8.
Else,
a.
Let
patternText
be the result of interpreting each of
's 16-bit elements as a Unicode BMP code point. UTF-16 decoding is not applied to the elements.
b.
Let
patternCharacters
be a
List
whose elements are the code unit elements of
9.
Let
parseResult
be
ParsePattern
patternText
).
10.
If
parseResult
is a non-empty
List
of
SyntaxError
objects, throw a
SyntaxError
exception.
11.
Assert
parseResult
is a
Parse Node
for
Pattern
12.
Set
obj
.[[OriginalSource]] to
13.
Set
obj
.[[OriginalFlags]] to
14.
Set
obj
.[[RegExpMatcher]] to the
Abstract Closure
that evaluates
parseResult
by applying the semantics provided in
22.2.2
using
patternCharacters
as the pattern's
List
of
SourceCharacter
values and
as the flag parameters.
15.
Perform ?
Set
obj
"lastIndex"
+0
true
).
16.
Return
obj
22.2.3.2.3
Static Semantics: ParsePattern (
patternText
The abstract operation ParsePattern takes arguments
patternText
(a sequence of Unicode code points) and
(a Boolean). It performs the following steps when called:
1.
If
is
true
, then
a.
Let
parseResult
be
ParseText
patternText
Pattern
[+U, +N]
).
2.
Else,
a.
Let
parseResult
be
ParseText
patternText
Pattern
[~U, ~N]
).
b.
If
parseResult
is a
Parse Node
and
parseResult
contains a
GroupName
, then
i.
Set
parseResult
to
ParseText
patternText
Pattern
[~U, +N]
).
3.
Return
parseResult
22.2.3.2.4
RegExpCreate (
The abstract operation RegExpCreate takes arguments
and
. It performs the following steps when called:
1.
Let
obj
be ?
RegExpAlloc
%RegExp%
).
2.
Return ?
RegExpInitialize
obj
).
22.2.3.2.5
EscapeRegExpPattern (
The abstract operation EscapeRegExpPattern takes arguments
and
. It performs the following steps when called:
1.
Let
be a String in the form of a
Pattern
[~U]
Pattern
[+U]
if
contains
"u"
) equivalent to
interpreted as UTF-16 encoded Unicode code points (
6.1.4
), in which certain code points are escaped as described below.
may or may not be identical to
; however, the
Abstract Closure
that would result from evaluating
as a
Pattern
[~U]
Pattern
[+U]
if
contains
"u"
) must behave identically to the
Abstract Closure
given by the constructed object's [[RegExpMatcher]] internal slot.
Multiple calls to this abstract operation using the same values for
and
must produce identical results.
2.
The code points
or any
LineTerminator
occurring in the pattern shall be escaped in
as necessary to ensure that the
string-concatenation
of
"/"
"/"
, and
can be parsed (in an appropriate lexical context) as a
RegularExpressionLiteral
that behaves identically to the constructed regular expression. For example, if
is
"/"
, then
could be
"\/"
or
"\u002F"
, among other possibilities, but not
"/"
, because
///
followed by
would be parsed as a
SingleLineComment
rather than a
RegularExpressionLiteral
. If
is the empty String, this specification can be met by letting
be
"(?:)"
3.
Return
22.2.4
Properties of the RegExp Constructor
The RegExp
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
22.2.4.1
RegExp.prototype
The initial value of
RegExp.prototype
is the
RegExp prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
22.2.4.2
get RegExp [ @@species ]
RegExp[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
RegExp prototype methods normally use their
this
value's
constructor
to create a derived object. However, a subclass
constructor
may over-ride that default behaviour by redefining its
@@species
property.
22.2.5
Properties of the RegExp Prototype Object
The
RegExp prototype object
is
%RegExp.prototype%
is an
ordinary object
is not a RegExp instance and does not have a
[[RegExpMatcher]] internal slot or any of the other internal slots of
RegExp instance objects.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
Note
The RegExp prototype object does not have a
"valueOf"
property of its own; however, it inherits the
"valueOf"
property from the
Object prototype object
22.2.5.1
RegExp.prototype.constructor
The initial value of
RegExp.prototype.constructor
is
%RegExp%
22.2.5.2
RegExp.prototype.exec (
string
Performs a regular expression match of
string
against the regular expression and returns an Array object containing the results of the match, or
null
if
string
did not match.
The String
ToString
string
) is searched for an occurrence of the regular expression pattern as follows:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[RegExpMatcher]]).
3.
Let
be ?
ToString
string
).
4.
Return ?
RegExpBuiltinExec
).
22.2.5.2.1
RegExpExec (
The abstract operation RegExpExec takes arguments
and
. It performs the following steps when called:
1.
Assert
Type
) is Object.
2.
Assert
Type
) is String.
3.
Let
exec
be ?
Get
"exec"
).
4.
If
IsCallable
exec
) is
true
, then
a.
Let
result
be ?
Call
exec
, «
»).
b.
If
Type
result
) is neither Object nor Null, throw a
TypeError
exception.
c.
Return
result
5.
Perform ?
RequireInternalSlot
, [[RegExpMatcher]]).
6.
Return ?
RegExpBuiltinExec
).
Note
If a callable
"exec"
property is not
found this algorithm falls back to attempting to use the built-in RegExp
matching algorithm. This provides compatible behaviour for code written
for prior editions where most built-in algorithms that use regular
expressions did not perform a dynamic property lookup of
"exec"
22.2.5.2.2
RegExpBuiltinExec (
The abstract operation RegExpBuiltinExec takes arguments
and
. It performs the following steps when called:
1.
Assert
is an initialized RegExp instance.
2.
Assert
Type
) is String.
3.
Let
length
be the number of code units in
4.
Let
lastIndex
be
(?
ToLength
(?
Get
"lastIndex"
))).
5.
Let
flags
be
.[[OriginalFlags]].
6.
If
flags
contains
"g"
, let
global
be
true
; else let
global
be
false
7.
If
flags
contains
"y"
, let
sticky
be
true
; else let
sticky
be
false
8.
If
global
is
false
and
sticky
is
false
, set
lastIndex
to 0.
9.
Let
matcher
be
.[[RegExpMatcher]].
10.
If
flags
contains
"u"
, let
fullUnicode
be
true
; else let
fullUnicode
be
false
11.
Let
matchSucceeded
be
false
12.
Repeat, while
matchSucceeded
is
false
a.
If
lastIndex
length
, then
i.
If
global
is
true
or
sticky
is
true
, then
1.
Perform ?
Set
"lastIndex"
+0
true
).
ii.
Return
null
b.
Let
be
matcher
lastIndex
).
c.
If
is
failure
, then
i.
If
sticky
is
true
, then
1.
Perform ?
Set
"lastIndex"
+0
true
).
2.
Return
null
ii.
Set
lastIndex
to
AdvanceStringIndex
lastIndex
fullUnicode
).
d.
Else,
i.
Assert
is a State.
ii.
Set
matchSucceeded
to
true
13.
Let
be
's
endIndex
value.
14.
If
fullUnicode
is
true
, then
a.
is an index into the
Input
character list, derived from
, matched by
matcher
. Let
eUTF
be the smallest index into
that corresponds to the character at element
of
Input
. If
is greater than or equal to the number of elements in
Input
, then
eUTF
is the number of code units in
b.
Set
to
eUTF
15.
If
global
is
true
or
sticky
is
true
, then
a.
Perform ?
Set
"lastIndex"
),
true
).
16.
Let
be the number of elements in
's
captures
List
. (This is the same value as
22.2.2.1
's
NcapturingParens
.)
17.
Assert
< 2
32
- 1.
18.
Let
be !
ArrayCreate
+ 1).
19.
Assert
: The
mathematical value
of
's
"length"
property is
+ 1.
20.
Perform !
CreateDataPropertyOrThrow
"index"
lastIndex
)).
21.
Perform !
CreateDataPropertyOrThrow
"input"
).
22.
Let
matchedSubstr
be the
substring
of
from
lastIndex
to
23.
Perform !
CreateDataPropertyOrThrow
"0"
matchedSubstr
).
24.
If
contains any
GroupName
, then
a.
Let
groups
be !
OrdinaryObjectCreate
null
).
25.
Else,
a.
Let
groups
be
undefined
26.
Perform !
CreateDataPropertyOrThrow
"groups"
groups
).
27.
For each
integer
such that
≥ 1 and
, do
a.
Let
captureI
be
th
element of
's
captures
List
b.
If
captureI
is
undefined
, let
capturedValue
be
undefined
c.
Else if
fullUnicode
is
true
, then
i.
Assert
captureI
is a
List
of code points.
ii.
Let
capturedValue
be !
CodePointsToString
captureI
).
d.
Else,
i.
Assert
fullUnicode
is
false
ii.
Assert
captureI
is a
List
of code units.
iii.
Let
capturedValue
be the String value consisting of the code units of
captureI
e.
Perform !
CreateDataPropertyOrThrow
, !
ToString
)),
capturedValue
).
f.
If the
th
capture of
was defined with a
GroupName
, then
i.
Let
be the
CapturingGroupName
of the corresponding
RegExpIdentifierName
ii.
Perform !
CreateDataPropertyOrThrow
groups
capturedValue
).
28.
Return
22.2.5.2.3
AdvanceStringIndex (
index
unicode
The abstract operation AdvanceStringIndex takes arguments
(a String),
index
(a non-negative
integer
), and
unicode
(a Boolean). It performs the following steps when called:
1.
Assert
index
≤ 2
53
- 1.
2.
If
unicode
is
false
, return
index
+ 1.
3.
Let
length
be the number of code units in
4.
If
index
+ 1 ≥
length
, return
index
+ 1.
5.
Let
cp
be !
CodePointAt
index
).
6.
Return
index
cp
.[[CodeUnitCount]].
22.2.5.3
get RegExp.prototype.dotAll
RegExp.prototype.dotAll
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x0073 (LATIN SMALL LETTER S), return
true
6.
Return
false
22.2.5.4
get RegExp.prototype.flags
RegExp.prototype.flags
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
Let
result
be the empty String.
4.
Let
global
be !
ToBoolean
(?
Get
"global"
)).
5.
If
global
is
true
, append the code unit 0x0067 (LATIN SMALL LETTER G) as the last code unit of
result
6.
Let
ignoreCase
be !
ToBoolean
(?
Get
"ignoreCase"
)).
7.
If
ignoreCase
is
true
, append the code unit 0x0069 (LATIN SMALL LETTER I) as the last code unit of
result
8.
Let
multiline
be !
ToBoolean
(?
Get
"multiline"
)).
9.
If
multiline
is
true
, append the code unit 0x006D (LATIN SMALL LETTER M) as the last code unit of
result
10.
Let
dotAll
be !
ToBoolean
(?
Get
"dotAll"
)).
11.
If
dotAll
is
true
, append the code unit 0x0073 (LATIN SMALL LETTER S) as the last code unit of
result
12.
Let
unicode
be !
ToBoolean
(?
Get
"unicode"
)).
13.
If
unicode
is
true
, append the code unit 0x0075 (LATIN SMALL LETTER U) as the last code unit of
result
14.
Let
sticky
be !
ToBoolean
(?
Get
"sticky"
)).
15.
If
sticky
is
true
, append the code unit 0x0079 (LATIN SMALL LETTER Y) as the last code unit of
result
16.
Return
result
22.2.5.5
get RegExp.prototype.global
RegExp.prototype.global
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x0067 (LATIN SMALL LETTER G), return
true
6.
Return
false
22.2.5.6
get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCase
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x0069 (LATIN SMALL LETTER I), return
true
6.
Return
false
22.2.5.7
RegExp.prototype [ @@match ] (
string
When the
@@match
method is called with argument
string
, the following steps are taken:
1.
Let
rx
be the
this
value.
2.
If
Type
rx
) is not Object, throw a
TypeError
exception.
3.
Let
be ?
ToString
string
).
4.
Let
global
be !
ToBoolean
(?
Get
rx
"global"
)).
5.
If
global
is
false
, then
a.
Return ?
RegExpExec
rx
).
6.
Else,
a.
Assert
global
is
true
b.
Let
fullUnicode
be !
ToBoolean
(?
Get
rx
"unicode"
)).
c.
Perform ?
Set
rx
"lastIndex"
+0
true
).
d.
Let
be !
ArrayCreate
(0).
e.
Let
be 0.
f.
Repeat,
i.
Let
result
be ?
RegExpExec
rx
).
ii.
If
result
is
null
, then
1.
If
= 0, return
null
2.
Return
iii.
Else,
1.
Let
matchStr
be ?
ToString
(?
Get
result
"0"
)).
2.
Perform !
CreateDataPropertyOrThrow
, !
ToString
)),
matchStr
).
3.
If
matchStr
is the empty String, then
a.
Let
thisIndex
be
(?
ToLength
(?
Get
rx
"lastIndex"
))).
b.
Let
nextIndex
be
AdvanceStringIndex
thisIndex
fullUnicode
).
c.
Perform ?
Set
rx
"lastIndex"
nextIndex
),
true
).
4.
Set
to
+ 1.
The value of the
"name"
property of this function is
"[Symbol.match]"
Note
The
@@match
property is used by the
IsRegExp
abstract operation to identify objects that have the basic behaviour of regular expressions. The absence of a
@@match
property or the existence of such a property whose value does not Boolean coerce to
true
indicates that the object is not intended to be used as a regular expression object.
22.2.5.8
RegExp.prototype [ @@matchAll ] (
string
When the
@@matchAll
method is called with argument
string
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
Let
be ?
ToString
string
).
4.
Let
be ?
SpeciesConstructor
%RegExp%
).
5.
Let
flags
be ?
ToString
(?
Get
"flags"
)).
6.
Let
matcher
be ?
Construct
, «
flags
»).
7.
Let
lastIndex
be ?
ToLength
(?
Get
"lastIndex"
)).
8.
Perform ?
Set
matcher
"lastIndex"
lastIndex
true
).
9.
If
flags
contains
"g"
, let
global
be
true
10.
Else, let
global
be
false
11.
If
flags
contains
"u"
, let
fullUnicode
be
true
12.
Else, let
fullUnicode
be
false
13.
Return !
CreateRegExpStringIterator
matcher
global
fullUnicode
).
The value of the
"name"
property of this function is
"[Symbol.matchAll]"
22.2.5.9
get RegExp.prototype.multiline
RegExp.prototype.multiline
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x006D (LATIN SMALL LETTER M), return
true
6.
Return
false
22.2.5.10
RegExp.prototype [ @@replace ] (
string
replaceValue
When the
@@replace
method is called with arguments
string
and
replaceValue
, the following steps are taken:
1.
Let
rx
be the
this
value.
2.
If
Type
rx
) is not Object, throw a
TypeError
exception.
3.
Let
be ?
ToString
string
).
4.
Let
lengthS
be the number of code unit elements in
5.
Let
functionalReplace
be
IsCallable
replaceValue
).
6.
If
functionalReplace
is
false
, then
a.
Set
replaceValue
to ?
ToString
replaceValue
).
7.
Let
global
be !
ToBoolean
(?
Get
rx
"global"
)).
8.
If
global
is
true
, then
a.
Let
fullUnicode
be !
ToBoolean
(?
Get
rx
"unicode"
)).
b.
Perform ?
Set
rx
"lastIndex"
+0
true
).
9.
Let
results
be a new empty
List
10.
Let
done
be
false
11.
Repeat, while
done
is
false
a.
Let
result
be ?
RegExpExec
rx
).
b.
If
result
is
null
, set
done
to
true
c.
Else,
i.
Append
result
to the end of
results
ii.
If
global
is
false
, set
done
to
true
iii.
Else,
1.
Let
matchStr
be ?
ToString
(?
Get
result
"0"
)).
2.
If
matchStr
is the empty String, then
a.
Let
thisIndex
be
(?
ToLength
(?
Get
rx
"lastIndex"
))).
b.
Let
nextIndex
be
AdvanceStringIndex
thisIndex
fullUnicode
).
c.
Perform ?
Set
rx
"lastIndex"
nextIndex
),
true
).
12.
Let
accumulatedResult
be the empty String.
13.
Let
nextSourcePosition
be 0.
14.
For each element
result
of
results
, do
a.
Let
resultLength
be ?
LengthOfArrayLike
result
).
b.
Let
nCaptures
be
max
resultLength
- 1, 0).
c.
Let
matched
be ?
ToString
(?
Get
result
"0"
)).
d.
Let
matchLength
be the number of code units in
matched
e.
Let
position
be ?
ToIntegerOrInfinity
(?
Get
result
"index"
)).
f.
Set
position
to the result of
clamping
position
between 0 and
lengthS
g.
Let
be 1.
h.
Let
captures
be a new empty
List
i.
Repeat, while
nCaptures
i.
Let
capN
be ?
Get
result
, !
ToString
))).
ii.
If
capN
is not
undefined
, then
1.
Set
capN
to ?
ToString
capN
).
iii.
Append
capN
as the last element of
captures
iv.
Set
to
+ 1.
j.
Let
namedCaptures
be ?
Get
result
"groups"
).
k.
If
functionalReplace
is
true
, then
i.
Let
replacerArgs
be «
matched
».
ii.
Append in
List
order the elements of
captures
to the end of the
List
replacerArgs
iii.
Append
position
) and
to
replacerArgs
iv.
If
namedCaptures
is not
undefined
, then
1.
Append
namedCaptures
as the last element of
replacerArgs
v.
Let
replValue
be ?
Call
replaceValue
undefined
replacerArgs
).
vi.
Let
replacement
be ?
ToString
replValue
).
l.
Else,
i.
If
namedCaptures
is not
undefined
, then
1.
Set
namedCaptures
to ?
ToObject
namedCaptures
).
ii.
Let
replacement
be ?
GetSubstitution
matched
position
captures
namedCaptures
replaceValue
).
m.
If
position
nextSourcePosition
, then
i.
NOTE:
position
should not normally move backwards. If it does, it is an indication of
an ill-behaving RegExp subclass or use of an access triggered
side-effect to change the global flag or other characteristics of
rx
. In such cases, the corresponding substitution is ignored.
ii.
Set
accumulatedResult
to the
string-concatenation
of
accumulatedResult
, the
substring
of
from
nextSourcePosition
to
position
, and
replacement
iii.
Set
nextSourcePosition
to
position
matchLength
15.
If
nextSourcePosition
lengthS
, return
accumulatedResult
16.
Return the
string-concatenation
of
accumulatedResult
and the
substring
of
from
nextSourcePosition
The value of the
"name"
property of this function is
"[Symbol.replace]"
22.2.5.11
RegExp.prototype [ @@search ] (
string
When the
@@search
method is called with argument
string
, the following steps are taken:
1.
Let
rx
be the
this
value.
2.
If
Type
rx
) is not Object, throw a
TypeError
exception.
3.
Let
be ?
ToString
string
).
4.
Let
previousLastIndex
be ?
Get
rx
"lastIndex"
).
5.
If
SameValue
previousLastIndex
+0
) is
false
, then
a.
Perform ?
Set
rx
"lastIndex"
+0
true
).
6.
Let
result
be ?
RegExpExec
rx
).
7.
Let
currentLastIndex
be ?
Get
rx
"lastIndex"
).
8.
If
SameValue
currentLastIndex
previousLastIndex
) is
false
, then
a.
Perform ?
Set
rx
"lastIndex"
previousLastIndex
true
).
9.
If
result
is
null
, return
-1
10.
Return ?
Get
result
"index"
).
The value of the
"name"
property of this function is
"[Symbol.search]"
Note
The
"lastIndex"
and
"global"
properties of this RegExp object are ignored when performing the search. The
"lastIndex"
property is left unchanged.
22.2.5.12
get RegExp.prototype.source
RegExp.prototype.source
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalSource]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
"(?:)"
b.
Otherwise, throw a
TypeError
exception.
4.
Assert
has an [[OriginalFlags]] internal slot.
5.
Let
src
be
.[[OriginalSource]].
6.
Let
flags
be
.[[OriginalFlags]].
7.
Return
EscapeRegExpPattern
src
flags
).
22.2.5.13
RegExp.prototype [ @@split ] (
string
limit
Note 1
Returns an Array object into which substrings of the result of converting
string
to a String have been stored. The substrings are determined by searching from left to right for matches of the
this
value regular expression; these occurrences are not part of any String
in the returned array, but serve to divide up the String value.
The
this
value may be an empty regular
expression or a regular expression that can match an empty String. In
this case, the regular expression does not match the empty
substring
at the beginning or end of the input String, nor does it match the empty
substring
at the end of the previous separator match. (For example, if the
regular expression matches the empty String, the String is split up into
individual code unit elements; the length of the result array equals
the length of the String, and each
substring
contains one code unit.) Only the first match at a given index of the
String is considered, even if backtracking could yield a non-empty
substring
match at that index. (For example,
/a*?/[Symbol.split]("ab")
evaluates to the array
["a", "b"]
, while
/a*/[Symbol.split]("ab")
evaluates to the array
["","b"]
.)
If
string
is (or converts to) the empty String,
the result depends on whether the regular expression can match the empty
String. If it can, the result array contains no elements. Otherwise,
the result array contains one element, which is the empty String.
If the regular expression contains capturing parentheses, then each time
separator
is matched the results (including any
undefined
results) of the capturing parentheses are spliced into the output array. For example,
/<(\/)?([^
<>
]+)>/[Symbol.split]("A
bold
and
CODE
coded
CODE
")
evaluates to the array
"A"
undefined
"B"
"bold"
"/"
"B"
"and"
undefined
"CODE"
"coded"
"/"
"CODE"
""
If
limit
is not
undefined
, then the output array is truncated so that it contains no more than
limit
elements.
When the
@@split
method is called, the following steps are taken:
1.
Let
rx
be the
this
value.
2.
If
Type
rx
) is not Object, throw a
TypeError
exception.
3.
Let
be ?
ToString
string
).
4.
Let
be ?
SpeciesConstructor
rx
%RegExp%
).
5.
Let
flags
be ?
ToString
(?
Get
rx
"flags"
)).
6.
If
flags
contains
"u"
, let
unicodeMatching
be
true
7.
Else, let
unicodeMatching
be
false
8.
If
flags
contains
"y"
, let
newFlags
be
flags
9.
Else, let
newFlags
be the
string-concatenation
of
flags
and
"y"
10.
Let
splitter
be ?
Construct
, «
rx
newFlags
»).
11.
Let
be !
ArrayCreate
(0).
12.
Let
lengthA
be 0.
13.
If
limit
is
undefined
, let
lim
be 2
32
- 1; else let
lim
be
(?
ToUint32
limit
)).
14.
If
lim
is 0, return
15.
Let
size
be the length of
16.
If
size
is 0, then
a.
Let
be ?
RegExpExec
splitter
).
b.
If
is not
null
, return
c.
Perform !
CreateDataPropertyOrThrow
"0"
).
d.
Return
17.
Let
be 0.
18.
Let
be
19.
Repeat, while
size
a.
Perform ?
Set
splitter
"lastIndex"
),
true
).
b.
Let
be ?
RegExpExec
splitter
).
c.
If
is
null
, set
to
AdvanceStringIndex
unicodeMatching
).
d.
Else,
i.
Let
be
(?
ToLength
(?
Get
splitter
"lastIndex"
))).
ii.
Set
to
min
size
).
iii.
If
, set
to
AdvanceStringIndex
unicodeMatching
).
iv.
Else,
1.
Let
be the
substring
of
from
to
2.
Perform !
CreateDataPropertyOrThrow
, !
ToString
lengthA
)),
).
3.
Set
lengthA
to
lengthA
+ 1.
4.
If
lengthA
lim
, return
5.
Set
to
6.
Let
numberOfCaptures
be ?
LengthOfArrayLike
).
7.
Set
numberOfCaptures
to
max
numberOfCaptures
- 1, 0).
8.
Let
be 1.
9.
Repeat, while
numberOfCaptures
a.
Let
nextCapture
be ?
Get
, !
ToString
))).
b.
Perform !
CreateDataPropertyOrThrow
, !
ToString
lengthA
)),
nextCapture
).
c.
Set
to
+ 1.
d.
Set
lengthA
to
lengthA
+ 1.
e.
If
lengthA
lim
, return
10.
Set
to
20.
Let
be the
substring
of
from
to
size
21.
Perform !
CreateDataPropertyOrThrow
, !
ToString
lengthA
)),
).
22.
Return
The value of the
"name"
property of this function is
"[Symbol.split]"
Note 2
The
@@split
method ignores the value of the
"global"
and
"sticky"
properties of this RegExp object.
22.2.5.14
get RegExp.prototype.sticky
RegExp.prototype.sticky
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x0079 (LATIN SMALL LETTER Y), return
true
6.
Return
false
22.2.5.15
RegExp.prototype.test (
The following steps are taken:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
Let
string
be ?
ToString
).
4.
Let
match
be ?
RegExpExec
string
).
5.
If
match
is not
null
, return
true
; else return
false
22.2.5.16
RegExp.prototype.toString ( )
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
Let
pattern
be ?
ToString
(?
Get
"source"
)).
4.
Let
flags
be ?
ToString
(?
Get
"flags"
)).
5.
Let
result
be the
string-concatenation
of
"/"
pattern
"/"
, and
flags
6.
Return
result
Note
The returned String has the form of a
RegularExpressionLiteral
that evaluates to another RegExp object with the same behaviour as this object.
22.2.5.17
get RegExp.prototype.unicode
RegExp.prototype.unicode
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, throw a
TypeError
exception.
3.
If
does not have an [[OriginalFlags]] internal slot, then
a.
If
SameValue
%RegExp.prototype%
) is
true
, return
undefined
b.
Otherwise, throw a
TypeError
exception.
4.
Let
flags
be
.[[OriginalFlags]].
5.
If
flags
contains the code unit 0x0075 (LATIN SMALL LETTER U), return
true
6.
Return
false
22.2.6
Properties of RegExp Instances
RegExp instances are ordinary objects that inherit properties from the
RegExp prototype object
RegExp instances have internal slots [[RegExpMatcher]],
[[OriginalSource]], and [[OriginalFlags]]. The value of the
[[RegExpMatcher]] internal slot is an
Abstract Closure
representation of the
Pattern
of the RegExp object.
Note
Prior to ECMAScript 2015, RegExp instances were specified as having the own data properties
"source"
"global"
"ignoreCase"
, and
"multiline"
. Those properties are now specified as accessor properties of
RegExp.prototype
RegExp instances also have the following property:
22.2.6.1
lastIndex
The value of the
"lastIndex"
property specifies the String index at which to start the next match. It is coerced to an
integral Number
when used (see
22.2.5.2.2
). This property shall have the attributes { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
22.2.7
RegExp String Iterator Objects
A RegExp String Iterator is an object, that represents a
specific iteration over some specific String instance object, matching
against some specific RegExp instance object. There is not a named
constructor
for RegExp String Iterator objects. Instead, RegExp String Iterator
objects are created by calling certain methods of RegExp instance
objects.
22.2.7.1
CreateRegExpStringIterator (
global
fullUnicode
The abstract operation CreateRegExpStringIterator takes arguments
global
, and
fullUnicode
. It performs the following steps when called:
1.
Assert
Type
) is String.
2.
Assert
Type
global
) is Boolean.
3.
Assert
Type
fullUnicode
) is Boolean.
4.
Let
closure
be a new
Abstract Closure
with no parameters that captures
global
, and
fullUnicode
and performs the following steps when called:
a.
Repeat,
i.
Let
match
be ?
RegExpExec
).
ii.
If
match
is
null
, return
undefined
iii.
If
global
is
false
, then
1.
Perform ?
Yield
match
).
2.
Return
undefined
iv.
Let
matchStr
be ?
ToString
(?
Get
match
"0"
)).
v.
If
matchStr
is the empty String, then
1.
Let
thisIndex
be
(?
ToLength
(?
Get
"lastIndex"
))).
2.
Let
nextIndex
be !
AdvanceStringIndex
thisIndex
fullUnicode
).
3.
Perform ?
Set
"lastIndex"
nextIndex
),
true
).
vi.
Perform ?
Yield
match
).
5.
Return !
CreateIteratorFromClosure
closure
"%RegExpStringIteratorPrototype%"
%RegExpStringIteratorPrototype%
).
22.2.7.2
The %RegExpStringIteratorPrototype% Object
The
%RegExpStringIteratorPrototype%
object:
has properties that are inherited by all RegExp String Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
has the following properties:
22.2.7.2.1
%RegExpStringIteratorPrototype%.next ( )
1.
Return ?
GeneratorResume
this
value,
empty
"%RegExpStringIteratorPrototype%"
).
22.2.7.2.2
%RegExpStringIteratorPrototype% [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"RegExp String Iterator"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
23
Indexed Collections
23.1
Array Objects
Array objects are exotic objects that give special treatment to a certain class of property names. See
10.4.2
for a definition of this special treatment.
23.1.1
The Array Constructor
The Array
constructor
is
%Array%
is the initial value of the
"Array"
property of the
global object
creates and initializes a new
Array exotic object
when called as a
constructor
also creates and initializes a new Array object when called as a function rather than as a
constructor
. Thus the function call
Array(…)
is equivalent to the object creation expression
new Array(…)
with the same arguments.
is a function whose behaviour differs based upon the number and types of its arguments.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the exotic Array behaviour must include a
super
call to the Array
constructor
to initialize subclass instances that are Array exotic objects. However, most of the
Array.prototype
methods are generic methods that are not dependent upon their
this
value being an
Array exotic object
has a
"length"
property whose value is
23.1.1.1
Array ( ...
values
When the
Array
function is called, the following steps are taken:
1.
If NewTarget is
undefined
, let
newTarget
be the
active function object
; else let
newTarget
be NewTarget.
2.
Let
proto
be ?
GetPrototypeFromConstructor
newTarget
"%Array.prototype%"
).
3.
Let
numberOfArgs
be the number of elements in
values
4.
If
numberOfArgs
= 0, then
a.
Return !
ArrayCreate
(0,
proto
).
5.
Else if
numberOfArgs
= 1, then
a.
Let
len
be
values
[0].
b.
Let
array
be !
ArrayCreate
(0,
proto
).
c.
If
Type
len
) is not Number, then
i.
Perform !
CreateDataPropertyOrThrow
array
"0"
len
).
ii.
Let
intLen
be
d.
Else,
i.
Let
intLen
be !
ToUint32
len
).
ii.
If
intLen
is not the same value as
len
, throw a
RangeError
exception.
e.
Perform !
Set
array
"length"
intLen
true
).
f.
Return
array
6.
Else,
a.
Assert
numberOfArgs
≥ 2.
b.
Let
array
be ?
ArrayCreate
numberOfArgs
proto
).
c.
Let
be 0.
d.
Repeat, while
numberOfArgs
i.
Let
Pk
be !
ToString
)).
ii.
Let
itemK
be
values
].
iii.
Perform !
CreateDataPropertyOrThrow
array
Pk
itemK
).
iv.
Set
to
+ 1.
e.
Assert
: The
mathematical value
of
array
's
"length"
property is
numberOfArgs
f.
Return
array
23.1.2
Properties of the Array Constructor
The Array
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
23.1.2.1
Array.from (
items
[ ,
mapfn
[ ,
thisArg
] ] )
When the
from
method is called with argument
items
and optional arguments
mapfn
and
thisArg
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
mapfn
is
undefined
, let
mapping
be
false
3.
Else,
a.
If
IsCallable
mapfn
) is
false
, throw a
TypeError
exception.
b.
Let
mapping
be
true
4.
Let
usingIterator
be ?
GetMethod
items
@@iterator
).
5.
If
usingIterator
is not
undefined
, then
a.
If
IsConstructor
) is
true
, then
i.
Let
be ?
Construct
).
b.
Else,
i.
Let
be !
ArrayCreate
(0).
c.
Let
iteratorRecord
be ?
GetIterator
items
sync
usingIterator
).
d.
Let
be 0.
e.
Repeat,
i.
If
≥ 2
53
- 1, then
1.
Let
error
be
ThrowCompletion
(a newly created
TypeError
object).
2.
Return ?
IteratorClose
iteratorRecord
error
).
ii.
Let
Pk
be !
ToString
)).
iii.
Let
next
be ?
IteratorStep
iteratorRecord
).
iv.
If
next
is
false
, then
1.
Perform ?
Set
"length"
),
true
).
2.
Return
v.
Let
nextValue
be ?
IteratorValue
next
).
vi.
If
mapping
is
true
, then
1.
Let
mappedValue
be
Call
mapfn
thisArg
, «
nextValue
) »).
2.
If
mappedValue
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
mappedValue
).
3.
Set
mappedValue
to
mappedValue
.[[Value]].
vii.
Else, let
mappedValue
be
nextValue
viii.
Let
defineStatus
be
CreateDataPropertyOrThrow
Pk
mappedValue
).
ix.
If
defineStatus
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
defineStatus
).
x.
Set
to
+ 1.
6.
NOTE:
items
is not an Iterable so assume it is an
array-like object
7.
Let
arrayLike
be !
ToObject
items
).
8.
Let
len
be ?
LengthOfArrayLike
arrayLike
).
9.
If
IsConstructor
) is
true
, then
a.
Let
be ?
Construct
, «
len
) »).
10.
Else,
a.
Let
be ?
ArrayCreate
len
).
11.
Let
be 0.
12.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be ?
Get
arrayLike
Pk
).
c.
If
mapping
is
true
, then
i.
Let
mappedValue
be ?
Call
mapfn
thisArg
, «
kValue
) »).
d.
Else, let
mappedValue
be
kValue
e.
Perform ?
CreateDataPropertyOrThrow
Pk
mappedValue
).
f.
Set
to
+ 1.
13.
Perform ?
Set
"length"
len
),
true
).
14.
Return
Note
The
from
function is an intentionally generic factory method; it does not require that its
this
value be the Array
constructor
. Therefore it can be transferred to or inherited by any other constructors that may be called with a single numeric argument.
23.1.2.2
Array.isArray (
arg
The
isArray
function takes one argument
arg
, and performs the following steps:
1.
Return ?
IsArray
arg
).
23.1.2.3
Array.of ( ...
items
When the
of
method is called with any number of arguments, the following steps are taken:
1.
Let
len
be the number of elements in
items
2.
Let
lenNumber
be
len
).
3.
Let
be the
this
value.
4.
If
IsConstructor
) is
true
, then
a.
Let
be ?
Construct
, «
lenNumber
»).
5.
Else,
a.
Let
be ?
ArrayCreate
len
).
6.
Let
be 0.
7.
Repeat, while
len
a.
Let
kValue
be
items
].
b.
Let
Pk
be !
ToString
)).
c.
Perform ?
CreateDataPropertyOrThrow
Pk
kValue
).
d.
Set
to
+ 1.
8.
Perform ?
Set
"length"
lenNumber
true
).
9.
Return
Note
The
of
function is an intentionally generic factory method; it does not require that its
this
value be the Array
constructor
. Therefore it can be transferred to or inherited by other constructors that may be called with a single numeric argument.
23.1.2.4
Array.prototype
The value of
Array.prototype
is the
Array prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
23.1.2.5
get Array [ @@species ]
Array[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
Array prototype methods normally use their
this
value's
constructor
to create a derived object. However, a subclass
constructor
may over-ride that default behaviour by redefining its
@@species
property.
23.1.3
Properties of the Array Prototype Object
The
Array prototype object
is
%Array.prototype%
is an
Array exotic object
and has the internal methods specified for such objects.
has a
"length"
property whose initial value is
+0
and whose attributes are { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
Note
The Array prototype object is specified to be an
Array exotic object
to ensure compatibility with ECMAScript code that was created prior to the ECMAScript 2015 specification.
23.1.3.1
Array.prototype.concat ( ...
items
When the
concat
method is called with zero or
more arguments, it returns an array containing the array elements of the
object followed by the array elements of each argument.
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
be ?
ArraySpeciesCreate
, 0).
3.
Let
be 0.
4.
Prepend
to
items
5.
For each element
of
items
, do
a.
Let
spreadable
be ?
IsConcatSpreadable
).
b.
If
spreadable
is
true
, then
i.
Let
be 0.
ii.
Let
len
be ?
LengthOfArrayLike
).
iii.
If
len
> 2
53
- 1, throw a
TypeError
exception.
iv.
Repeat, while
len
1.
Let
be !
ToString
)).
2.
Let
exists
be ?
HasProperty
).
3.
If
exists
is
true
, then
a.
Let
subElement
be ?
Get
).
b.
Perform ?
CreateDataPropertyOrThrow
, !
ToString
)),
subElement
).
4.
Set
to
+ 1.
5.
Set
to
+ 1.
c.
Else,
i.
NOTE:
is added as a single item rather than spread.
ii.
If
≥ 2
53
- 1, throw a
TypeError
exception.
iii.
Perform ?
CreateDataPropertyOrThrow
, !
ToString
)),
).
iv.
Set
to
+ 1.
6.
Perform ?
Set
"length"
),
true
).
7.
Return
The
"length"
property of the
concat
method is
Note 1
The explicit setting of the
"length"
property in step
is necessary to ensure that its value is correct in situations where the trailing elements of the result Array are not present.
Note 2
The
concat
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.1.1
IsConcatSpreadable (
The abstract operation IsConcatSpreadable takes argument
. It performs the following steps when called:
1.
If
Type
) is not Object, return
false
2.
Let
spreadable
be ?
Get
@@isConcatSpreadable
).
3.
If
spreadable
is not
undefined
, return !
ToBoolean
spreadable
).
4.
Return ?
IsArray
).
23.1.3.2
Array.prototype.constructor
The initial value of
Array.prototype.constructor
is
%Array%
23.1.3.3
Array.prototype.copyWithin (
target
start
[ ,
end
] )
The
copyWithin
method takes up to three arguments
target
start
and
end
Note 1
The
end
argument is optional with the length of the
this
value as its default value. If
target
is negative, it is treated as
length
target
where
length
is the length of the array. If
start
is negative, it is treated as
length
start
. If
end
is negative, it is treated as
length
end
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
relativeTarget
be ?
ToIntegerOrInfinity
target
).
4.
If
relativeTarget
is -∞, let
to
be 0.
5.
Else if
relativeTarget
< 0, let
to
be
max
len
relativeTarget
, 0).
6.
Else, let
to
be
min
relativeTarget
len
).
7.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
8.
If
relativeStart
is -∞, let
from
be 0.
9.
Else if
relativeStart
< 0, let
from
be
max
len
relativeStart
, 0).
10.
Else, let
from
be
min
relativeStart
len
).
11.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
12.
If
relativeEnd
is -∞, let
final
be 0.
13.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
14.
Else, let
final
be
min
relativeEnd
len
).
15.
Let
count
be
min
final
from
len
to
).
16.
If
from
to
and
to
from
count
, then
a.
Let
direction
be -1.
b.
Set
from
to
from
count
- 1.
c.
Set
to
to
to
count
- 1.
17.
Else,
a.
Let
direction
be 1.
18.
Repeat, while
count
> 0,
a.
Let
fromKey
be !
ToString
from
)).
b.
Let
toKey
be !
ToString
to
)).
c.
Let
fromPresent
be ?
HasProperty
fromKey
).
d.
If
fromPresent
is
true
, then
i.
Let
fromVal
be ?
Get
fromKey
).
ii.
Perform ?
Set
toKey
fromVal
true
).
e.
Else,
i.
Assert
fromPresent
is
false
ii.
Perform ?
DeletePropertyOrThrow
toKey
).
f.
Set
from
to
from
direction
g.
Set
to
to
to
direction
h.
Set
count
to
count
- 1.
19.
Return
Note 2
The
copyWithin
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.4
Array.prototype.entries ( )
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Return
CreateArrayIterator
key+value
).
23.1.3.5
Array.prototype.every (
callbackfn
[ ,
thisArg
] )
Note 1
callbackfn
should be a function that accepts three arguments and returns a value that is coercible to a Boolean value.
every
calls
callbackfn
once for each element present in the array, in ascending order, until it finds one where
callbackfn
returns
false
. If such an element is found,
every
immediately returns
false
. Otherwise, if
callbackfn
returned
true
for all elements,
every
will return
true
callbackfn
is called only for elements of the array which actually exist; it is not called for missing elements of the array.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
every
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
every
is set before the first call to
callbackfn
. Elements which are appended to the array after the call to
every
begins will not be visited by
callbackfn
. If existing elements of the array are changed, their value as passed to
callbackfn
will be the value at the time
every
visits them; elements that are deleted after the call to
every
begins and before being visited are not visited.
every
acts like the "for all" quantifier in mathematics. In particular, for an empty array, it returns
true
When the
every
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Let
testResult
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
iii.
If
testResult
is
false
, return
false
d.
Set
to
+ 1.
6.
Return
true
Note 2
The
every
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.6
Array.prototype.fill (
value
[ ,
start
[ ,
end
] ] )
The
fill
method takes up to three arguments
value
start
and
end
Note 1
The
start
and
end
arguments are optional with default values of 0 and the length of the
this
value. If
start
is negative, it is treated as
length
start
where
length
is the length of the array. If
end
is negative, it is treated as
length
end
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
4.
If
relativeStart
is -∞, let
be 0.
5.
Else if
relativeStart
< 0, let
be
max
len
relativeStart
, 0).
6.
Else, let
be
min
relativeStart
len
).
7.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
8.
If
relativeEnd
is -∞, let
final
be 0.
9.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
10.
Else, let
final
be
min
relativeEnd
len
).
11.
Repeat, while
final
a.
Let
Pk
be !
ToString
)).
b.
Perform ?
Set
Pk
value
true
).
c.
Set
to
+ 1.
12.
Return
Note 2
The
fill
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.7
Array.prototype.filter (
callbackfn
[ ,
thisArg
] )
Note 1
callbackfn
should be a function that accepts three arguments and returns a value that is coercible to a Boolean value.
filter
calls
callbackfn
once for each element in the array, in ascending order, and constructs a new array of all the values for which
callbackfn
returns
true
callbackfn
is called only for elements of the array which actually exist; it is not called for missing elements of the array.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
filter
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
filter
is set before the first call to
callbackfn
. Elements which are appended to the array after the call to
filter
begins will not be visited by
callbackfn
. If existing elements of the array are changed their value as passed to
callbackfn
will be the value at the time
filter
visits them; elements that are deleted after the call to
filter
begins and before being visited are not visited.
When the
filter
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
be ?
ArraySpeciesCreate
, 0).
5.
Let
be 0.
6.
Let
to
be 0.
7.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Let
selected
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
iii.
If
selected
is
true
, then
1.
Perform ?
CreateDataPropertyOrThrow
, !
ToString
to
)),
kValue
).
2.
Set
to
to
to
+ 1.
d.
Set
to
+ 1.
8.
Return
Note 2
The
filter
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.8
Array.prototype.find (
predicate
[ ,
thisArg
] )
The
find
method is called with one or two arguments,
predicate
and
thisArg
Note 1
predicate
should be a function that accepts three arguments and returns a value that is coercible to a Boolean value.
find
calls
predicate
once for each element of the array, in ascending order, until it finds one where
predicate
returns
true
. If such an element is found,
find
immediately returns that element value. Otherwise,
find
returns
undefined
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
predicate
. If it is not provided,
undefined
is used instead.
predicate
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
find
does not directly mutate the object on which it is called but the object may be mutated by the calls to
predicate
The range of elements processed by
find
is set before the first call to
predicate
. Elements that are appended to the array after the call to
find
begins will not be visited by
predicate
. If existing elements of the array are changed, their value as passed to
predicate
will be the value at the time that
find
visits them; elements that are deleted after the call to
find
begins and before being visited are not visited.
When the
find
method is called, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
predicate
) is
false
, throw a
TypeError
exception.
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be ?
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
predicate
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
true
, return
kValue
e.
Set
to
+ 1.
6.
Return
undefined
Note 2
The
find
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.9
Array.prototype.findIndex (
predicate
[ ,
thisArg
] )
Note 1
predicate
should be a function that accepts three arguments and returns a value that is coercible to a Boolean value.
findIndex
calls
predicate
once for each element of the array, in ascending order, until it finds one where
predicate
returns
true
. If such an element is found,
findIndex
immediately returns the index of that element value. Otherwise,
findIndex
returns -1.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
predicate
. If it is not provided,
undefined
is used instead.
predicate
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
findIndex
does not directly mutate the object on which it is called but the object may be mutated by the calls to
predicate
The range of elements processed by
findIndex
is set before the first call to
predicate
. Elements that are appended to the array after the call to
findIndex
begins will not be visited by
predicate
. If existing elements of the array are changed, their value as passed to
predicate
will be the value at the time that
findIndex
visits them; elements that are deleted after the call to
findIndex
begins and before being visited are not visited.
When the
findIndex
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
predicate
) is
false
, throw a
TypeError
exception.
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be ?
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
predicate
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
true
, return
).
e.
Set
to
+ 1.
6.
Return
-1
Note 2
The
findIndex
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.10
Array.prototype.flat ( [
depth
] )
When the
flat
method is called with zero or one arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
sourceLen
be ?
LengthOfArrayLike
).
3.
Let
depthNum
be 1.
4.
If
depth
is not
undefined
, then
a.
Set
depthNum
to ?
ToIntegerOrInfinity
depth
).
b.
If
depthNum
< 0, set
depthNum
to 0.
5.
Let
be ?
ArraySpeciesCreate
, 0).
6.
Perform ?
FlattenIntoArray
sourceLen
, 0,
depthNum
).
7.
Return
23.1.3.10.1
FlattenIntoArray (
target
source
sourceLen
start
depth
[ ,
mapperFunction
thisArg
] )
The abstract operation FlattenIntoArray takes arguments
target
source
sourceLen
(a non-negative
integer
),
start
(a non-negative
integer
), and
depth
(a non-negative
integer
or +∞) and optional arguments
mapperFunction
and
thisArg
. It performs the following steps when called:
1.
Assert
Type
target
) is Object.
2.
Assert
Type
source
) is Object.
3.
Assert
: If
mapperFunction
is present, then !
IsCallable
mapperFunction
) is
true
thisArg
is present, and
depth
is 1.
4.
Let
targetIndex
be
start
5.
Let
sourceIndex
be
+0
6.
Repeat, while
sourceIndex
) <
sourceLen
a.
Let
be !
ToString
sourceIndex
).
b.
Let
exists
be ?
HasProperty
source
).
c.
If
exists
is
true
, then
i.
Let
element
be ?
Get
source
).
ii.
If
mapperFunction
is present, then
1.
Set
element
to ?
Call
mapperFunction
thisArg
, «
element
sourceIndex
source
»).
iii.
Let
shouldFlatten
be
false
iv.
If
depth
> 0, then
1.
Set
shouldFlatten
to ?
IsArray
element
).
v.
If
shouldFlatten
is
true
, then
1.
If
depth
is +∞, let
newDepth
be +∞.
2.
Else, let
newDepth
be
depth
- 1.
3.
Let
elementLen
be ?
LengthOfArrayLike
element
).
4.
Set
targetIndex
to ?
FlattenIntoArray
target
element
elementLen
targetIndex
newDepth
).
vi.
Else,
1.
If
targetIndex
≥ 2
53
- 1, throw a
TypeError
exception.
2.
Perform ?
CreateDataPropertyOrThrow
target
, !
ToString
targetIndex
)),
element
).
3.
Set
targetIndex
to
targetIndex
+ 1.
d.
Set
sourceIndex
to
sourceIndex
7.
Return
targetIndex
23.1.3.11
Array.prototype.flatMap (
mapperFunction
[ ,
thisArg
] )
When the
flatMap
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
sourceLen
be ?
LengthOfArrayLike
).
3.
If !
IsCallable
mapperFunction
) is
false
, throw a
TypeError
exception.
4.
Let
be ?
ArraySpeciesCreate
, 0).
5.
Perform ?
FlattenIntoArray
sourceLen
, 0, 1,
mapperFunction
thisArg
).
6.
Return
23.1.3.12
Array.prototype.forEach (
callbackfn
[ ,
thisArg
] )
Note 1
callbackfn
should be a function that accepts three arguments.
forEach
calls
callbackfn
once for each element present in the array, in ascending order.
callbackfn
is called only for elements of the array which actually exist; it is not called for missing elements of the array.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
forEach
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
forEach
is set before the first call to
callbackfn
. Elements which are appended to the array after the call to
forEach
begins will not be visited by
callbackfn
. If existing elements of the array are changed, their value as passed to
callbackfn
will be the value at the time
forEach
visits them; elements that are deleted after the call to
forEach
begins and before being visited are not visited.
When the
forEach
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Perform ?
Call
callbackfn
thisArg
, «
kValue
),
»).
d.
Set
to
+ 1.
6.
Return
undefined
Note 2
The
forEach
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.13
Array.prototype.includes (
searchElement
[ ,
fromIndex
] )
Note 1
includes
compares
searchElement
to the elements of the array, in ascending order, using the
SameValueZero
algorithm, and if found at any position, returns
true
; otherwise,
false
is returned.
The optional second argument
fromIndex
defaults to
+0
(i.e. the whole array is searched). If it is greater than or equal to the length of the array,
false
is returned, i.e. the array will not be searched. If it is less than
+0
, it is used as the offset from the end of the array to compute
fromIndex
. If the computed index is less than
+0
, the whole array will be searched.
When the
includes
method is called, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
len
is 0, return
false
4.
Let
be ?
ToIntegerOrInfinity
fromIndex
).
5.
Assert
: If
fromIndex
is
undefined
, then
is 0.
6.
If
is +∞, return
false
7.
Else if
is -∞, set
to 0.
8.
If
≥ 0, then
a.
Let
be
9.
Else,
a.
Let
be
len
b.
If
< 0, set
to 0.
10.
Repeat, while
len
a.
Let
elementK
be ?
Get
, !
ToString
))).
b.
If
SameValueZero
searchElement
elementK
) is
true
, return
true
c.
Set
to
+ 1.
11.
Return
false
Note 2
The
includes
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
Note 3
The
includes
method intentionally differs from the similar
indexOf
method in two ways. First, it uses the
SameValueZero
algorithm, instead of
Strict Equality Comparison
, allowing it to detect
NaN
array elements. Second, it does not skip missing array elements, instead treating them as
undefined
23.1.3.14
Array.prototype.indexOf (
searchElement
[ ,
fromIndex
] )
Note 1
indexOf
compares
searchElement
to the elements of the array, in ascending order, using the
Strict Equality Comparison
algorithm, and if found at one or more indices, returns the smallest such index; otherwise,
-1
is returned.
The optional second argument
fromIndex
defaults to
+0
(i.e. the whole array is searched). If it is greater than or equal to the length of the array,
-1
is returned, i.e. the array will not be searched. If it is less than
+0
, it is used as the offset from the end of the array to compute
fromIndex
. If the computed index is less than
+0
, the whole array will be searched.
When the
indexOf
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
len
is 0, return
-1
4.
Let
be ?
ToIntegerOrInfinity
fromIndex
).
5.
Assert
: If
fromIndex
is
undefined
, then
is 0.
6.
If
is +∞, return
-1
7.
Else if
is -∞, set
to 0.
8.
If
≥ 0, then
a.
Let
be
9.
Else,
a.
Let
be
len
b.
If
< 0, set
to 0.
10.
Repeat, while
len
a.
Let
kPresent
be ?
HasProperty
, !
ToString
))).
b.
If
kPresent
is
true
, then
i.
Let
elementK
be ?
Get
, !
ToString
))).
ii.
Let
same
be the result of performing
Strict Equality Comparison
searchElement
===
elementK
iii.
If
same
is
true
, return
).
c.
Set
to
+ 1.
11.
Return
-1
Note 2
The
indexOf
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.15
Array.prototype.join (
separator
Note 1
The elements of the array are converted to Strings, and these Strings are then concatenated, separated by occurrences of the
separator
. If no separator is provided, a single comma is used as the separator.
The
join
method takes one argument,
separator
, and performs the following steps:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
separator
is
undefined
, let
sep
be the single-element String
","
4.
Else, let
sep
be ?
ToString
separator
).
5.
Let
be the empty String.
6.
Let
be 0.
7.
Repeat, while
len
a.
If
> 0, set
to the
string-concatenation
of
and
sep
b.
Let
element
be ?
Get
, !
ToString
))).
c.
If
element
is
undefined
or
null
, let
next
be the empty String; otherwise, let
next
be ?
ToString
element
).
d.
Set
to the
string-concatenation
of
and
next
e.
Set
to
+ 1.
8.
Return
Note 2
The
join
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore, it can be transferred to other kinds of objects for use as a method.
23.1.3.16
Array.prototype.keys ( )
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Return
CreateArrayIterator
key
).
23.1.3.17
Array.prototype.lastIndexOf (
searchElement
[ ,
fromIndex
] )
Note 1
lastIndexOf
compares
searchElement
to the elements of the array in descending order using the
Strict Equality Comparison
algorithm, and if found at one or more indices, returns the largest such index; otherwise,
-1
is returned.
The optional second argument
fromIndex
defaults
to the array's length minus one (i.e. the whole array is searched). If
it is greater than or equal to the length of the array, the whole array
will be searched. If it is less than
+0
, it is used as the offset from the end of the array to compute
fromIndex
. If the computed index is less than
+0
-1
is returned.
When the
lastIndexOf
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
len
is 0, return
-1
4.
If
fromIndex
is present, let
be ?
ToIntegerOrInfinity
fromIndex
); else let
be
len
- 1.
5.
If
is -∞, return
-1
6.
If
≥ 0, then
a.
Let
be
min
len
- 1).
7.
Else,
a.
Let
be
len
8.
Repeat, while
≥ 0,
a.
Let
kPresent
be ?
HasProperty
, !
ToString
))).
b.
If
kPresent
is
true
, then
i.
Let
elementK
be ?
Get
, !
ToString
))).
ii.
Let
same
be the result of performing
Strict Equality Comparison
searchElement
===
elementK
iii.
If
same
is
true
, return
).
c.
Set
to
- 1.
9.
Return
-1
Note 2
The
lastIndexOf
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.18
Array.prototype.map (
callbackfn
[ ,
thisArg
] )
Note 1
callbackfn
should be a function that accepts three arguments.
map
calls
callbackfn
once for each element in the array, in ascending order, and constructs a new Array from the results.
callbackfn
is called only for elements of the array which actually exist; it is not called for missing elements of the array.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
map
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
map
is set before the first call to
callbackfn
. Elements which are appended to the array after the call to
map
begins will not be visited by
callbackfn
. If existing elements of the array are changed, their value as passed to
callbackfn
will be the value at the time
map
visits them; elements that are deleted after the call to
map
begins and before being visited are not visited.
When the
map
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
be ?
ArraySpeciesCreate
len
).
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Let
mappedValue
be ?
Call
callbackfn
thisArg
, «
kValue
),
»).
iii.
Perform ?
CreateDataPropertyOrThrow
Pk
mappedValue
).
d.
Set
to
+ 1.
7.
Return
Note 2
The
map
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.19
Array.prototype.pop ( )
Note 1
The last element of the array is removed from the array and returned.
When the
pop
method is called, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
len
= 0, then
a.
Perform ?
Set
"length"
+0
true
).
b.
Return
undefined
4.
Else,
a.
Assert
len
> 0.
b.
Let
newLen
be
len
- 1).
c.
Let
index
be !
ToString
newLen
).
d.
Let
element
be ?
Get
index
).
e.
Perform ?
DeletePropertyOrThrow
index
).
f.
Perform ?
Set
"length"
newLen
true
).
g.
Return
element
Note 2
The
pop
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.20
Array.prototype.push ( ...
items
Note 1
The arguments are appended to the end of the array, in the
order in which they appear. The new length of the array is returned as
the result of the call.
When the
push
method is called with zero or more arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
argCount
be the number of elements in
items
4.
If
len
argCount
> 2
53
- 1, throw a
TypeError
exception.
5.
For each element
of
items
, do
a.
Perform ?
Set
, !
ToString
len
)),
true
).
b.
Set
len
to
len
+ 1.
6.
Perform ?
Set
"length"
len
),
true
).
7.
Return
len
).
The
"length"
property of the
push
method is
Note 2
The
push
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.21
Array.prototype.reduce (
callbackfn
[ ,
initialValue
] )
Note 1
callbackfn
should be a function that takes four arguments.
reduce
calls the callback, as a function, once for each element after the first element present in the array, in ascending order.
callbackfn
is called with four arguments: the
previousValue
(value from the previous call to
callbackfn
), the
currentValue
(value of the current element), the
currentIndex
, and the object being traversed. The first time that callback is called, the
previousValue
and
currentValue
can be one of two values. If an
initialValue
was supplied in the call to
reduce
, then
previousValue
will be equal to
initialValue
and
currentValue
will be equal to the first value in the array. If no
initialValue
was supplied, then
previousValue
will be equal to the first value in the array and
currentValue
will be equal to the second. It is a
TypeError
if the array contains no elements and
initialValue
is not provided.
reduce
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
reduce
is set before the first call to
callbackfn
. Elements that are appended to the array after the call to
reduce
begins will not be visited by
callbackfn
. If existing elements of the array are changed, their value as passed to
callbackfn
will be the value at the time
reduce
visits them; elements that are deleted after the call to
reduce
begins and before being visited are not visited.
When the
reduce
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
If
len
= 0 and
initialValue
is not present, throw a
TypeError
exception.
5.
Let
be 0.
6.
Let
accumulator
be
undefined
7.
If
initialValue
is present, then
a.
Set
accumulator
to
initialValue
8.
Else,
a.
Let
kPresent
be
false
b.
Repeat, while
kPresent
is
false
and
len
i.
Let
Pk
be !
ToString
)).
ii.
Set
kPresent
to ?
HasProperty
Pk
).
iii.
If
kPresent
is
true
, then
1.
Set
accumulator
to ?
Get
Pk
).
iv.
Set
to
+ 1.
c.
If
kPresent
is
false
, throw a
TypeError
exception.
9.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Set
accumulator
to ?
Call
callbackfn
undefined
, «
accumulator
kValue
),
»).
d.
Set
to
+ 1.
10.
Return
accumulator
Note 2
The
reduce
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.22
Array.prototype.reduceRight (
callbackfn
[ ,
initialValue
] )
Note 1
callbackfn
should be a function that takes four arguments.
reduceRight
calls the callback, as a function, once for each element after the first element present in the array, in descending order.
callbackfn
is called with four arguments: the
previousValue
(value from the previous call to
callbackfn
), the
currentValue
(value of the current element), the
currentIndex
, and the object being traversed. The first time the function is called, the
previousValue
and
currentValue
can be one of two values. If an
initialValue
was supplied in the call to
reduceRight
, then
previousValue
will be equal to
initialValue
and
currentValue
will be equal to the last value in the array. If no
initialValue
was supplied, then
previousValue
will be equal to the last value in the array and
currentValue
will be equal to the second-to-last value. It is a
TypeError
if the array contains no elements and
initialValue
is not provided.
reduceRight
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
reduceRight
is set before the first call to
callbackfn
. Elements that are appended to the array after the call to
reduceRight
begins will not be visited by
callbackfn
. If existing elements of the array are changed by
callbackfn
, their value as passed to
callbackfn
will be the value at the time
reduceRight
visits them; elements that are deleted after the call to
reduceRight
begins and before being visited are not visited.
When the
reduceRight
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
If
len
is 0 and
initialValue
is not present, throw a
TypeError
exception.
5.
Let
be
len
- 1.
6.
Let
accumulator
be
undefined
7.
If
initialValue
is present, then
a.
Set
accumulator
to
initialValue
8.
Else,
a.
Let
kPresent
be
false
b.
Repeat, while
kPresent
is
false
and
≥ 0,
i.
Let
Pk
be !
ToString
)).
ii.
Set
kPresent
to ?
HasProperty
Pk
).
iii.
If
kPresent
is
true
, then
1.
Set
accumulator
to ?
Get
Pk
).
iv.
Set
to
- 1.
c.
If
kPresent
is
false
, throw a
TypeError
exception.
9.
Repeat, while
≥ 0,
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Set
accumulator
to ?
Call
callbackfn
undefined
, «
accumulator
kValue
),
»).
d.
Set
to
- 1.
10.
Return
accumulator
Note 2
The
reduceRight
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.23
Array.prototype.reverse ( )
Note 1
The elements of the array are rearranged so as to reverse their order. The object is returned as the result of the call.
When the
reverse
method is called, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
middle
be
floor
len
/ 2).
4.
Let
lower
be 0.
5.
Repeat, while
lower
middle
a.
Let
upper
be
len
lower
- 1.
b.
Let
upperP
be !
ToString
upper
)).
c.
Let
lowerP
be !
ToString
lower
)).
d.
Let
lowerExists
be ?
HasProperty
lowerP
).
e.
If
lowerExists
is
true
, then
i.
Let
lowerValue
be ?
Get
lowerP
).
f.
Let
upperExists
be ?
HasProperty
upperP
).
g.
If
upperExists
is
true
, then
i.
Let
upperValue
be ?
Get
upperP
).
h.
If
lowerExists
is
true
and
upperExists
is
true
, then
i.
Perform ?
Set
lowerP
upperValue
true
).
ii.
Perform ?
Set
upperP
lowerValue
true
).
i.
Else if
lowerExists
is
false
and
upperExists
is
true
, then
i.
Perform ?
Set
lowerP
upperValue
true
).
ii.
Perform ?
DeletePropertyOrThrow
upperP
).
j.
Else if
lowerExists
is
true
and
upperExists
is
false
, then
i.
Perform ?
DeletePropertyOrThrow
lowerP
).
ii.
Perform ?
Set
upperP
lowerValue
true
).
k.
Else,
i.
Assert
lowerExists
and
upperExists
are both
false
ii.
No action is required.
l.
Set
lower
to
lower
+ 1.
6.
Return
Note 2
The
reverse
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore, it can be transferred to other kinds of objects for use as a method.
23.1.3.24
Array.prototype.shift ( )
Note 1
The first element of the array is removed from the array and returned.
When the
shift
method is called, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
len
= 0, then
a.
Perform ?
Set
"length"
+0
true
).
b.
Return
undefined
4.
Let
first
be ?
Get
"0"
).
5.
Let
be 1.
6.
Repeat, while
len
a.
Let
from
be !
ToString
)).
b.
Let
to
be !
ToString
- 1)).
c.
Let
fromPresent
be ?
HasProperty
from
).
d.
If
fromPresent
is
true
, then
i.
Let
fromVal
be ?
Get
from
).
ii.
Perform ?
Set
to
fromVal
true
).
e.
Else,
i.
Assert
fromPresent
is
false
ii.
Perform ?
DeletePropertyOrThrow
to
).
f.
Set
to
+ 1.
7.
Perform ?
DeletePropertyOrThrow
, !
ToString
len
- 1))).
8.
Perform ?
Set
"length"
len
- 1),
true
).
9.
Return
first
Note 2
The
shift
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.25
Array.prototype.slice (
start
end
Note 1
The
slice
method takes two arguments,
start
and
end
, and returns an array containing the elements of the array from element
start
up to, but not including, element
end
(or through the end of the array if
end
is
undefined
). If
start
is negative, it is treated as
length
start
where
length
is the length of the array. If
end
is negative, it is treated as
length
end
where
length
is the length of the array.
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
4.
If
relativeStart
is -∞, let
be 0.
5.
Else if
relativeStart
< 0, let
be
max
len
relativeStart
, 0).
6.
Else, let
be
min
relativeStart
len
).
7.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
8.
If
relativeEnd
is -∞, let
final
be 0.
9.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
10.
Else, let
final
be
min
relativeEnd
len
).
11.
Let
count
be
max
final
, 0).
12.
Let
be ?
ArraySpeciesCreate
count
).
13.
Let
be 0.
14.
Repeat, while
final
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Perform ?
CreateDataPropertyOrThrow
, !
ToString
)),
kValue
).
d.
Set
to
+ 1.
e.
Set
to
+ 1.
15.
Perform ?
Set
"length"
),
true
).
16.
Return
Note 2
The explicit setting of the
"length"
property of the result Array in step
15
was necessary in previous editions of ECMAScript to ensure that its
length was correct in situations where the trailing elements of the
result Array were not present. Setting
"length"
became unnecessary starting in ES2015 when the result Array was
initialized to its proper length rather than an empty Array but is
carried forward to preserve backward compatibility.
Note 3
The
slice
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.26
Array.prototype.some (
callbackfn
[ ,
thisArg
] )
Note 1
callbackfn
should be a function that accepts three arguments and returns a value that is coercible to a Boolean value.
some
calls
callbackfn
once for each element present in the array, in ascending order, until it finds one where
callbackfn
returns
true
. If such an element is found,
some
immediately returns
true
. Otherwise,
some
returns
false
callbackfn
is called only for elements of the array which actually exist; it is not called for missing elements of the array.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the element, the index of the element, and the object being traversed.
some
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
The range of elements processed by
some
is set before the first call to
callbackfn
. Elements that are appended to the array after the call to
some
begins will not be visited by
callbackfn
. If existing elements of the array are changed, their value as passed to
callbackfn
will be the value at the time that
some
visits them; elements that are deleted after the call to
some
begins and before being visited are not visited.
some
acts like the "exists" quantifier in mathematics. In particular, for an empty array, it returns
false
When the
some
method is called with one or two arguments, the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
Pk
).
ii.
Let
testResult
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
iii.
If
testResult
is
true
, return
true
d.
Set
to
+ 1.
6.
Return
false
Note 2
The
some
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.27
Array.prototype.sort (
comparefn
The elements of this array are sorted. The sort must be
stable (that is, elements that compare equal must remain in their
original order). If
comparefn
is not
undefined
, it should be a function that accepts two arguments
and
and returns a negative value if
, zero if
, or a positive value if
The following steps are taken:
1.
If
comparefn
is not
undefined
and
IsCallable
comparefn
) is
false
, throw a
TypeError
exception.
2.
Let
obj
be ?
ToObject
this
value).
3.
Let
len
be ?
LengthOfArrayLike
obj
).
4.
Let
items
be a new empty
List
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kPresent
be ?
HasProperty
obj
Pk
).
c.
If
kPresent
is
true
, then
i.
Let
kValue
be ?
Get
obj
Pk
).
ii.
Append
kValue
to
items
d.
Set
to
+ 1.
7.
Let
itemCount
be the number of elements in
items
8.
Sort
items
using an
implementation-defined
sequence of calls to
SortCompare
. If any such call returns an
abrupt completion
, stop before performing any further calls to
SortCompare
or steps in this algorithm and return that completion.
9.
Let
be 0.
10.
Repeat, while
itemCount
a.
Perform ?
Set
obj
, !
ToString
)),
items
],
true
).
b.
Set
to
+ 1.
11.
Repeat, while
len
a.
Perform ?
DeletePropertyOrThrow
obj
, !
ToString
))).
b.
Set
to
+ 1.
12.
Return
obj
The
sort order
is the ordering, after completion of this function, of the
integer-indexed
property values of
obj
whose
integer
indexes are less than
len
. The result of the
sort
function is then determined as follows:
The sort order is
implementation-defined
if any of the following conditions is true:
If
comparefn
is not
undefined
and is not a consistent comparison function for the elements of
items
(see below).
If
comparefn
is
undefined
and
SortCompare
does not act as a consistent comparison function.
If
comparefn
is
undefined
and all applications of
ToString
, to any specific value passed as an argument to
SortCompare
, do not produce the same result.
Unless the sort order is specified above to be
implementation-defined
items
must satisfy all of the following conditions after executing step
of the algorithm above:
There must be some mathematical permutation π of the non-negative integers less than
itemCount
, such that for every non-negative
integer
less than
itemCount
, the element
old[
is exactly the same as
new[π(
)]
Then for all non-negative integers
and
, each less than
itemCount
, if
SortCompare
(old[
], old[
]) < 0
(see
SortCompare
below), then
π(
) < π(
Here the notation
old[
is used to refer to
items
before step
is executed, and the notation
new[
to refer to
items
after step
has been executed.
A function
comparefn
is a consistent comparison function for a set of values
if all of the requirements below are met for all values
, and
(possibly the same value) in the set
: The notation
CF
means
comparefn
) < 0
CF
means
comparefn
) = 0
(of either sign); and
CF
means
comparefn
) > 0
Calling
comparefn
) always returns the same value
when given a specific pair of values
and
as its two arguments. Furthermore,
Type
) is Number, and
is not
NaN
. Note that this implies that exactly one of
CF
CF
, and
CF
will be true for a given pair of
and
Calling
comparefn
) does not modify
obj
or any object on
obj
's prototype chain.
CF
(reflexivity)
If
CF
, then
CF
(symmetry)
If
CF
and
CF
, then
CF
(transitivity of =
CF
If
CF
and
CF
, then
CF
(transitivity of <
CF
If
CF
and
CF
, then
CF
(transitivity of >
CF
Note 1
The above conditions are necessary and sufficient to ensure that
comparefn
divides the set
into equivalence classes and that these equivalence classes are totally ordered.
Note 2
The
sort
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore, it can be transferred to other kinds of objects for use as a method.
23.1.3.27.1
SortCompare (
The abstract operation SortCompare takes arguments
and
. It also has access to the
comparefn
argument passed to the current invocation of the
sort
method. It performs the following steps when called:
1.
If
and
are both
undefined
, return
+0
2.
If
is
undefined
, return
3.
If
is
undefined
, return
-1
4.
If
comparefn
is not
undefined
, then
a.
Let
be ?
ToNumber
(?
Call
comparefn
undefined
, «
»)).
b.
If
is
NaN
, return
+0
c.
Return
5.
Let
xString
be ?
ToString
).
6.
Let
yString
be ?
ToString
).
7.
Let
xSmaller
be the result of performing
Abstract Relational Comparison
xString
yString
8.
If
xSmaller
is
true
, return
-1
9.
Let
ySmaller
be the result of performing
Abstract Relational Comparison
yString
xString
10.
If
ySmaller
is
true
, return
11.
Return
+0
Note 1
Because non-existent property values always compare greater than
undefined
property values, and
undefined
always compares greater than any other value,
undefined
property values always sort to the end of the result, followed by non-existent property values.
Note 2
Method calls performed by the
ToString
abstract operations
in steps
and
have the potential to cause SortCompare to not behave as a consistent comparison function.
23.1.3.28
Array.prototype.splice (
start
deleteCount
, ...
items
Note 1
When the
splice
method is called with two or more arguments
start
deleteCount
and zero or more
items
, the
deleteCount
elements of the array starting at
integer index
start
are replaced by the elements of
items
. An Array object containing the deleted elements (if any) is returned.
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
4.
If
relativeStart
is -∞, let
actualStart
be 0.
5.
Else if
relativeStart
< 0, let
actualStart
be
max
len
relativeStart
, 0).
6.
Else, let
actualStart
be
min
relativeStart
len
).
7.
If
start
is not present, then
a.
Let
insertCount
be 0.
b.
Let
actualDeleteCount
be 0.
8.
Else if
deleteCount
is not present, then
a.
Let
insertCount
be 0.
b.
Let
actualDeleteCount
be
len
actualStart
9.
Else,
a.
Let
insertCount
be the number of elements in
items
b.
Let
dc
be ?
ToIntegerOrInfinity
deleteCount
).
c.
Let
actualDeleteCount
be the result of
clamping
dc
between 0 and
len
actualStart
10.
If
len
insertCount
actualDeleteCount
> 2
53
- 1, throw a
TypeError
exception.
11.
Let
be ?
ArraySpeciesCreate
actualDeleteCount
).
12.
Let
be 0.
13.
Repeat, while
actualDeleteCount
a.
Let
from
be !
ToString
actualStart
)).
b.
Let
fromPresent
be ?
HasProperty
from
).
c.
If
fromPresent
is
true
, then
i.
Let
fromValue
be ?
Get
from
).
ii.
Perform ?
CreateDataPropertyOrThrow
, !
ToString
)),
fromValue
).
d.
Set
to
+ 1.
14.
Perform ?
Set
"length"
actualDeleteCount
),
true
).
15.
Let
itemCount
be the number of elements in
items
16.
If
itemCount
actualDeleteCount
, then
a.
Set
to
actualStart
b.
Repeat, while
< (
len
actualDeleteCount
),
i.
Let
from
be !
ToString
actualDeleteCount
)).
ii.
Let
to
be !
ToString
itemCount
)).
iii.
Let
fromPresent
be ?
HasProperty
from
).
iv.
If
fromPresent
is
true
, then
1.
Let
fromValue
be ?
Get
from
).
2.
Perform ?
Set
to
fromValue
true
).
v.
Else,
1.
Assert
fromPresent
is
false
2.
Perform ?
DeletePropertyOrThrow
to
).
vi.
Set
to
+ 1.
c.
Set
to
len
d.
Repeat, while
> (
len
actualDeleteCount
itemCount
),
i.
Perform ?
DeletePropertyOrThrow
, !
ToString
- 1))).
ii.
Set
to
- 1.
17.
Else if
itemCount
actualDeleteCount
, then
a.
Set
to (
len
actualDeleteCount
).
b.
Repeat, while
actualStart
i.
Let
from
be !
ToString
actualDeleteCount
- 1)).
ii.
Let
to
be !
ToString
itemCount
- 1)).
iii.
Let
fromPresent
be ?
HasProperty
from
).
iv.
If
fromPresent
is
true
, then
1.
Let
fromValue
be ?
Get
from
).
2.
Perform ?
Set
to
fromValue
true
).
v.
Else,
1.
Assert
fromPresent
is
false
2.
Perform ?
DeletePropertyOrThrow
to
).
vi.
Set
to
- 1.
18.
Set
to
actualStart
19.
For each element
of
items
, do
a.
Perform ?
Set
, !
ToString
)),
true
).
b.
Set
to
+ 1.
20.
Perform ?
Set
"length"
len
actualDeleteCount
itemCount
),
true
).
21.
Return
Note 2
The explicit setting of the
"length"
property of the result Array in step
20
was necessary in previous editions of ECMAScript to ensure that its
length was correct in situations where the trailing elements of the
result Array were not present. Setting
"length"
became unnecessary starting in ES2015 when the result Array was
initialized to its proper length rather than an empty Array but is
carried forward to preserve backward compatibility.
Note 3
The
splice
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.29
Array.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
An ECMAScript implementation that includes the ECMA-402 Internationalization API must implement the
Array.prototype.toLocaleString
method as specified in the ECMA-402 specification. If an ECMAScript
implementation does not include the ECMA-402 API the following
specification of the
toLocaleString
method is used.
Note 1
The first edition of ECMA-402 did not include a replacement specification for the
Array.prototype.toLocaleString
method.
The meanings of the optional parameters to this method are
defined in the ECMA-402 specification; implementations that do not
include ECMA-402 support must not use those parameter positions for
anything else.
The following steps are taken:
1.
Let
array
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
array
).
3.
Let
separator
be the String value for the list-separator String appropriate for the
host environment
's current locale (this is derived in an
implementation-defined
way).
4.
Let
be the empty String.
5.
Let
be 0.
6.
Repeat, while
len
a.
If
> 0, then
i.
Set
to the
string-concatenation
of
and
separator
b.
Let
nextElement
be ?
Get
array
, !
ToString
))).
c.
If
nextElement
is not
undefined
or
null
, then
i.
Let
be ?
ToString
(?
Invoke
nextElement
"toLocaleString"
)).
ii.
Set
to the
string-concatenation
of
and
d.
Set
to
+ 1.
7.
Return
Note 2
The elements of the array are converted to Strings using their
toLocaleString
methods, and these Strings are then concatenated, separated by occurrences of a separator String that has been derived in an
implementation-defined
locale-specific way. The result of calling this function is intended to be analogous to the result of
toString
, except that the result of this function is intended to be locale-specific.
Note 3
The
toLocaleString
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.30
Array.prototype.toString ( )
When the
toString
method is called, the following steps are taken:
1.
Let
array
be ?
ToObject
this
value).
2.
Let
func
be ?
Get
array
"join"
).
3.
If
IsCallable
func
) is
false
, set
func
to the intrinsic function %Object.prototype.toString%.
4.
Return ?
Call
func
array
).
Note
The
toString
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.31
Array.prototype.unshift ( ...
items
Note 1
The arguments are prepended to the start of the array, such
that their order within the array is the same as the order in which
they appear in the argument list.
When the
unshift
method is called with zero or more arguments
item1
item2
, etc., the following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Let
len
be ?
LengthOfArrayLike
).
3.
Let
argCount
be the number of elements in
items
4.
If
argCount
> 0, then
a.
If
len
argCount
> 2
53
- 1, throw a
TypeError
exception.
b.
Let
be
len
c.
Repeat, while
> 0,
i.
Let
from
be !
ToString
- 1)).
ii.
Let
to
be !
ToString
argCount
- 1)).
iii.
Let
fromPresent
be ?
HasProperty
from
).
iv.
If
fromPresent
is
true
, then
1.
Let
fromValue
be ?
Get
from
).
2.
Perform ?
Set
to
fromValue
true
).
v.
Else,
1.
Assert
fromPresent
is
false
2.
Perform ?
DeletePropertyOrThrow
to
).
vi.
Set
to
- 1.
d.
Let
be
+0
e.
For each element
of
items
, do
i.
Perform ?
Set
, !
ToString
),
true
).
ii.
Set
to
5.
Perform ?
Set
"length"
len
argCount
),
true
).
6.
Return
len
argCount
).
The
"length"
property of the
unshift
method is
Note 2
The
unshift
function is intentionally generic; it does not require that its
this
value be an Array object. Therefore it can be transferred to other kinds of objects for use as a method.
23.1.3.32
Array.prototype.values ( )
The following steps are taken:
1.
Let
be ?
ToObject
this
value).
2.
Return
CreateArrayIterator
value
).
23.1.3.33
Array.prototype [ @@iterator ] ( )
The initial value of the
@@iterator
property is the same
function object
as the initial value of the
Array.prototype.values
property.
23.1.3.34
Array.prototype [ @@unscopables ]
The initial value of the
@@unscopables
data property
is an object created by the following steps:
1.
Let
unscopableList
be !
OrdinaryObjectCreate
null
).
2.
Perform !
CreateDataPropertyOrThrow
unscopableList
"copyWithin"
true
).
3.
Perform !
CreateDataPropertyOrThrow
unscopableList
"entries"
true
).
4.
Perform !
CreateDataPropertyOrThrow
unscopableList
"fill"
true
).
5.
Perform !
CreateDataPropertyOrThrow
unscopableList
"find"
true
).
6.
Perform !
CreateDataPropertyOrThrow
unscopableList
"findIndex"
true
).
7.
Perform !
CreateDataPropertyOrThrow
unscopableList
"flat"
true
).
8.
Perform !
CreateDataPropertyOrThrow
unscopableList
"flatMap"
true
).
9.
Perform !
CreateDataPropertyOrThrow
unscopableList
"includes"
true
).
10.
Perform !
CreateDataPropertyOrThrow
unscopableList
"keys"
true
).
11.
Perform !
CreateDataPropertyOrThrow
unscopableList
"values"
true
).
12.
Return
unscopableList
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
Note
The own property names of this object are property names that were not included as standard properties of
Array.prototype
prior to the ECMAScript 2015 specification. These names are ignored for
with
statement binding purposes in order to preserve the behaviour of
existing code that might use one of these names as a binding in an outer
scope that is shadowed by a
with
statement whose binding object is an Array object.
23.1.4
Properties of Array Instances
Array instances are Array exotic objects and have the internal
methods specified for such objects. Array instances inherit properties
from the
Array prototype object
Array instances have a
"length"
property, and a set of enumerable properties with
array index
names.
23.1.4.1
length
The
"length"
property of an Array instance is a
data property
whose value is always numerically greater than the name of every configurable own property whose name is an
array index
The
"length"
property initially has the attributes { [[Writable]]:
true
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
Note
Reducing the value of the
"length"
property has the side-effect of deleting own array elements whose
array index
is between the old and new length values. However, non-configurable properties can not be deleted. Attempting to set the
"length"
property of an Array object to a value that is numerically less than or equal to the largest numeric own
property name
of an existing non-configurable
array-indexed
property of the array will result in the length being set to a numeric
value that is one greater than that non-configurable numeric own
property name
. See
10.4.2.1
23.1.5
Array Iterator Objects
An Array Iterator is an object, that represents a specific
iteration over some specific Array instance object. There is not a named
constructor
for Array Iterator objects. Instead, Array iterator objects are created by calling certain methods of Array instance objects.
23.1.5.1
CreateArrayIterator (
array
kind
The abstract operation CreateArrayIterator takes arguments
array
and
kind
This operation is used to create iterator objects for Array methods
that return such iterators. It performs the following steps when called:
1.
Assert
Type
array
) is Object.
2.
Assert
kind
is
key+value
key
, or
value
3.
Let
closure
be a new
Abstract Closure
with no parameters that captures
kind
and
array
and performs the following steps when called:
a.
Let
index
be 0.
b.
Repeat,
i.
If
array
has a [[TypedArrayName]] internal slot, then
1.
If
IsDetachedBuffer
array
.[[ViewedArrayBuffer]]) is
true
, throw a
TypeError
exception.
2.
Let
len
be
array
.[[ArrayLength]].
ii.
Else,
1.
Let
len
be ?
LengthOfArrayLike
array
).
iii.
If
index
len
, return
undefined
iv.
If
kind
is
key
, perform ?
Yield
index
)).
v.
Else,
1.
Let
elementKey
be !
ToString
index
)).
2.
Let
elementValue
be ?
Get
array
elementKey
).
3.
If
kind
is
value
, perform ?
Yield
elementValue
).
4.
Else,
a.
Assert
kind
is
key+value
b.
Perform ?
Yield
(!
CreateArrayFromList
(«
index
),
elementValue
»)).
vi.
Set
index
to
index
+ 1.
4.
Return !
CreateIteratorFromClosure
closure
"%ArrayIteratorPrototype%"
%ArrayIteratorPrototype%
).
23.1.5.2
The %ArrayIteratorPrototype% Object
The
%ArrayIteratorPrototype%
object:
has properties that are inherited by all Array Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
has the following properties:
23.1.5.2.1
%ArrayIteratorPrototype%.next ( )
1.
Return ?
GeneratorResume
this
value,
empty
"%ArrayIteratorPrototype%"
).
23.1.5.2.2
%ArrayIteratorPrototype% [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Array Iterator"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
23.2
TypedArray Objects
TypedArray
objects present an array-like view of an underlying binary data buffer (
25.1
). A
TypedArray element type
is the underlying binary scalar data type that all elements of a
TypedArray
instance have. There is a distinct
TypedArray
constructor
, listed in
Table 60
, for each of the supported element types. Each
constructor
in
Table 60
has a corresponding distinct prototype object.
Table 60: The TypedArray Constructors
Constructor
Name and Intrinsic
Element Type
Element Size
Conversion Operation
Description
Int8Array
%Int8Array%
Int8
ToInt8
8-bit two's complement signed
integer
Uint8Array
%Uint8Array%
Uint8
ToUint8
8-bit unsigned
integer
Uint8ClampedArray
%Uint8ClampedArray%
Uint8C
ToUint8Clamp
8-bit unsigned
integer
(clamped conversion)
Int16Array
%Int16Array%
Int16
ToInt16
16-bit two's complement signed
integer
Uint16Array
%Uint16Array%
Uint16
ToUint16
16-bit unsigned
integer
Int32Array
%Int32Array%
Int32
ToInt32
32-bit two's complement signed
integer
Uint32Array
%Uint32Array%
Uint32
ToUint32
32-bit unsigned
integer
BigInt64Array
%BigInt64Array%
BigInt64
ToBigInt64
64-bit two's complement signed
integer
BigUint64Array
%BigUint64Array%
BigUint64
ToBigUint64
64-bit unsigned
integer
Float32Array
%Float32Array%
Float32
32-bit IEEE floating point
Float64Array
%Float64Array%
Float64
64-bit IEEE floating point
In the definitions below, references to
TypedArray
should be replaced with the appropriate
constructor
name from the above table.
23.2.1
The %TypedArray% Intrinsic Object
The
%TypedArray%
intrinsic object:
is a
constructor
function object
that all of the
TypedArray
constructor
objects inherit from.
along with its corresponding prototype object, provides common properties that are inherited by all
TypedArray
constructors and their instances.
does not have a global name or appear as a property of the
global object
acts as the abstract superclass of the various
TypedArray
constructors.
will throw an error when invoked, because it is an abstract class
constructor
. The
TypedArray
constructors do not perform a
super
call to it.
23.2.1.1
%TypedArray% ( )
The
%TypedArray%
constructor
performs the following steps:
1.
Throw a
TypeError
exception.
The
"length"
property of the
%TypedArray%
constructor
function is
+0
23.2.2
Properties of the %TypedArray% Intrinsic Object
The
%TypedArray%
intrinsic object:
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has a
"name"
property whose value is
"TypedArray"
has the following properties:
23.2.2.1
%TypedArray%.from (
source
[ ,
mapfn
[ ,
thisArg
] ] )
When the
from
method is called with argument
source
, and optional arguments
mapfn
and
thisArg
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
IsConstructor
) is
false
, throw a
TypeError
exception.
3.
If
mapfn
is
undefined
, let
mapping
be
false
4.
Else,
a.
If
IsCallable
mapfn
) is
false
, throw a
TypeError
exception.
b.
Let
mapping
be
true
5.
Let
usingIterator
be ?
GetMethod
source
@@iterator
).
6.
If
usingIterator
is not
undefined
, then
a.
Let
values
be ?
IterableToList
source
usingIterator
).
b.
Let
len
be the number of elements in
values
c.
Let
targetObj
be ?
TypedArrayCreate
, «
len
) »).
d.
Let
be 0.
e.
Repeat, while
len
i.
Let
Pk
be !
ToString
)).
ii.
Let
kValue
be the first element of
values
and remove that element from
values
iii.
If
mapping
is
true
, then
1.
Let
mappedValue
be ?
Call
mapfn
thisArg
, «
kValue
) »).
iv.
Else, let
mappedValue
be
kValue
v.
Perform ?
Set
targetObj
Pk
mappedValue
true
).
vi.
Set
to
+ 1.
f.
Assert
values
is now an empty
List
g.
Return
targetObj
7.
NOTE:
source
is not an Iterable so assume it is already an
array-like object
8.
Let
arrayLike
be !
ToObject
source
).
9.
Let
len
be ?
LengthOfArrayLike
arrayLike
).
10.
Let
targetObj
be ?
TypedArrayCreate
, «
len
) »).
11.
Let
be 0.
12.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be ?
Get
arrayLike
Pk
).
c.
If
mapping
is
true
, then
i.
Let
mappedValue
be ?
Call
mapfn
thisArg
, «
kValue
) »).
d.
Else, let
mappedValue
be
kValue
e.
Perform ?
Set
targetObj
Pk
mappedValue
true
).
f.
Set
to
+ 1.
13.
Return
targetObj
23.2.2.2
%TypedArray%.of ( ...
items
When the
of
method is called with any number of arguments, the following steps are taken:
1.
Let
len
be the number of elements in
items
2.
Let
be the
this
value.
3.
If
IsConstructor
) is
false
, throw a
TypeError
exception.
4.
Let
newObj
be ?
TypedArrayCreate
, «
len
) »).
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
kValue
be
items
].
b.
Let
Pk
be !
ToString
)).
c.
Perform ?
Set
newObj
Pk
kValue
true
).
d.
Set
to
+ 1.
7.
Return
newObj
23.2.2.3
%TypedArray%.prototype
The initial value of
%TypedArray%
.prototype
is the
%TypedArray% prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
23.2.2.4
get %TypedArray% [ @@species ]
%TypedArray%
[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
%TypedArray.prototype%
methods normally use their
this
value's
constructor
to create a derived object. However, a subclass
constructor
may over-ride that default behaviour by redefining its
@@species
property.
23.2.3
Properties of the %TypedArray% Prototype Object
The
%TypedArray% prototype object
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is
%TypedArray.prototype%
is an
ordinary object
does not have a [[ViewedArrayBuffer]] or any other of the internal slots that are specific to
TypedArray
instance objects.
23.2.3.1
get %TypedArray%.prototype.buffer
%TypedArray%
.prototype.buffer
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
Return
buffer
23.2.3.2
get %TypedArray%.prototype.byteLength
%TypedArray%
.prototype.byteLength
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
If
IsDetachedBuffer
buffer
) is
true
, return
+0
6.
Let
size
be
.[[ByteLength]].
7.
Return
size
).
23.2.3.3
get %TypedArray%.prototype.byteOffset
%TypedArray%
.prototype.byteOffset
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
If
IsDetachedBuffer
buffer
) is
true
, return
+0
6.
Let
offset
be
.[[ByteOffset]].
7.
Return
offset
).
23.2.3.4
%TypedArray%.prototype.constructor
The initial value of
%TypedArray%
.prototype.constructor
is the
%TypedArray%
intrinsic object.
23.2.3.5
%TypedArray%.prototype.copyWithin (
target
start
[ ,
end
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.copyWithin
are the same as for
Array.prototype.copyWithin
as defined in
23.1.3.3
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
Let
relativeTarget
be ?
ToIntegerOrInfinity
target
).
5.
If
relativeTarget
is -∞, let
to
be 0.
6.
Else if
relativeTarget
< 0, let
to
be
max
len
relativeTarget
, 0).
7.
Else, let
to
be
min
relativeTarget
len
).
8.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
9.
If
relativeStart
is -∞, let
from
be 0.
10.
Else if
relativeStart
< 0, let
from
be
max
len
relativeStart
, 0).
11.
Else, let
from
be
min
relativeStart
len
).
12.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
13.
If
relativeEnd
is -∞, let
final
be 0.
14.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
15.
Else, let
final
be
min
relativeEnd
len
).
16.
Let
count
be
min
final
from
len
to
).
17.
If
count
> 0, then
a.
NOTE: The copying must be performed in a manner that preserves the bit-level encoding of the source data.
b.
Let
buffer
be
.[[ViewedArrayBuffer]].
c.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
d.
Let
typedArrayName
be the String value of
.[[TypedArrayName]].
e.
Let
elementSize
be the Element Size value specified in
Table 60
for
typedArrayName
f.
Let
byteOffset
be
.[[ByteOffset]].
g.
Let
toByteIndex
be
to
elementSize
byteOffset
h.
Let
fromByteIndex
be
from
elementSize
byteOffset
i.
Let
countBytes
be
count
elementSize
j.
If
fromByteIndex
toByteIndex
and
toByteIndex
fromByteIndex
countBytes
, then
i.
Let
direction
be -1.
ii.
Set
fromByteIndex
to
fromByteIndex
countBytes
- 1.
iii.
Set
toByteIndex
to
toByteIndex
countBytes
- 1.
k.
Else,
i.
Let
direction
be 1.
l.
Repeat, while
countBytes
> 0,
i.
Let
value
be
GetValueFromBuffer
buffer
fromByteIndex
Uint8
true
Unordered
).
ii.
Perform
SetValueInBuffer
buffer
toByteIndex
Uint8
value
true
Unordered
).
iii.
Set
fromByteIndex
to
fromByteIndex
direction
iv.
Set
toByteIndex
to
toByteIndex
direction
v.
Set
countBytes
to
countBytes
- 1.
18.
Return
23.2.3.6
%TypedArray%.prototype.entries ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Return
CreateArrayIterator
key+value
).
23.2.3.7
%TypedArray%.prototype.every (
callbackfn
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.every
are the same as for
Array.prototype.every
as defined in
23.1.3.5
When the
every
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
false
, return
false
e.
Set
to
+ 1.
7.
Return
true
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.8
%TypedArray%.prototype.fill (
value
[ ,
start
[ ,
end
] ] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.fill
are the same as for
Array.prototype.fill
as defined in
23.1.3.6
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
.[[ContentType]] is
BigInt
, set
value
to ?
ToBigInt
value
).
5.
Otherwise, set
value
to ?
ToNumber
value
).
6.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
7.
If
relativeStart
is -∞, let
be 0.
8.
Else if
relativeStart
< 0, let
be
max
len
relativeStart
, 0).
9.
Else, let
be
min
relativeStart
len
).
10.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
11.
If
relativeEnd
is -∞, let
final
be 0.
12.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
13.
Else, let
final
be
min
relativeEnd
len
).
14.
If
IsDetachedBuffer
.[[ViewedArrayBuffer]]) is
true
, throw a
TypeError
exception.
15.
Repeat, while
final
a.
Let
Pk
be !
ToString
)).
b.
Perform !
Set
Pk
value
true
).
c.
Set
to
+ 1.
16.
Return
23.2.3.9
%TypedArray%.prototype.filter (
callbackfn
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.filter
are the same as for
Array.prototype.filter
as defined in
23.1.3.7
When the
filter
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
Let
kept
be a new empty
List
6.
Let
be 0.
7.
Let
captured
be 0.
8.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
selected
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
d.
If
selected
is
true
, then
i.
Append
kValue
to the end of
kept
ii.
Set
captured
to
captured
+ 1.
e.
Set
to
+ 1.
9.
Let
be ?
TypedArraySpeciesCreate
, «
captured
) »).
10.
Let
be 0.
11.
For each element
of
kept
, do
a.
Perform !
Set
, !
ToString
)),
true
).
b.
Set
to
+ 1.
12.
Return
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.10
%TypedArray%.prototype.find (
predicate
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.find
are the same as for
Array.prototype.find
as defined in
23.1.3.8
When the
find
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
predicate
) is
false
, throw a
TypeError
exception.
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
predicate
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
true
, return
kValue
e.
Set
to
+ 1.
7.
Return
undefined
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.11
%TypedArray%.prototype.findIndex (
predicate
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.findIndex
are the same as for
Array.prototype.findIndex
as defined in
23.1.3.9
When the
findIndex
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
predicate
) is
false
, throw a
TypeError
exception.
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
predicate
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
true
, return
).
e.
Set
to
+ 1.
7.
Return
-1
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.12
%TypedArray%.prototype.forEach (
callbackfn
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.forEach
are the same as for
Array.prototype.forEach
as defined in
23.1.3.12
When the
forEach
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Perform ?
Call
callbackfn
thisArg
, «
kValue
),
»).
d.
Set
to
+ 1.
7.
Return
undefined
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.13
%TypedArray%.prototype.includes (
searchElement
[ ,
fromIndex
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.includes
are the same as for
Array.prototype.includes
as defined in
23.1.3.13
When the
includes
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
len
is 0, return
false
5.
Let
be ?
ToIntegerOrInfinity
fromIndex
).
6.
Assert
: If
fromIndex
is
undefined
, then
is 0.
7.
If
is +∞, return
false
8.
Else if
is -∞, set
to 0.
9.
If
≥ 0, then
a.
Let
be
10.
Else,
a.
Let
be
len
b.
If
< 0, set
to 0.
11.
Repeat, while
len
a.
Let
elementK
be !
Get
, !
ToString
))).
b.
If
SameValueZero
searchElement
elementK
) is
true
, return
true
c.
Set
to
+ 1.
12.
Return
false
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.14
%TypedArray%.prototype.indexOf (
searchElement
[ ,
fromIndex
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.indexOf
are the same as for
Array.prototype.indexOf
as defined in
23.1.3.14
When the
indexOf
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
len
is 0, return
-1
5.
Let
be ?
ToIntegerOrInfinity
fromIndex
).
6.
Assert
: If
fromIndex
is
undefined
, then
is 0.
7.
If
is +∞, return
-1
8.
Else if
is -∞, set
to 0.
9.
If
≥ 0, then
a.
Let
be
10.
Else,
a.
Let
be
len
b.
If
< 0, set
to 0.
11.
Repeat, while
len
a.
Let
kPresent
be !
HasProperty
, !
ToString
))).
b.
If
kPresent
is
true
, then
i.
Let
elementK
be !
Get
, !
ToString
))).
ii.
Let
same
be the result of performing
Strict Equality Comparison
searchElement
===
elementK
iii.
If
same
is
true
, return
).
c.
Set
to
+ 1.
12.
Return
-1
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.15
%TypedArray%.prototype.join (
separator
The interpretation and use of the arguments of
%TypedArray%
.prototype.join
are the same as for
Array.prototype.join
as defined in
23.1.3.15
When the
join
method is called with one argument
separator
, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
separator
is
undefined
, let
sep
be the single-element String
","
5.
Else, let
sep
be ?
ToString
separator
).
6.
Let
be the empty String.
7.
Let
be 0.
8.
Repeat, while
len
a.
If
> 0, set
to the
string-concatenation
of
and
sep
b.
Let
element
be !
Get
, !
ToString
))).
c.
If
element
is
undefined
, let
next
be the empty String; otherwise, let
next
be !
ToString
element
).
d.
Set
to the
string-concatenation
of
and
next
e.
Set
to
+ 1.
9.
Return
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.16
%TypedArray%.prototype.keys ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Return
CreateArrayIterator
key
).
23.2.3.17
%TypedArray%.prototype.lastIndexOf (
searchElement
[ ,
fromIndex
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.lastIndexOf
are the same as for
Array.prototype.lastIndexOf
as defined in
23.1.3.17
When the
lastIndexOf
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
len
is 0, return
-1
5.
If
fromIndex
is present, let
be ?
ToIntegerOrInfinity
fromIndex
); else let
be
len
- 1.
6.
If
is -∞, return
-1
7.
If
≥ 0, then
a.
Let
be
min
len
- 1).
8.
Else,
a.
Let
be
len
9.
Repeat, while
≥ 0,
a.
Let
kPresent
be !
HasProperty
, !
ToString
))).
b.
If
kPresent
is
true
, then
i.
Let
elementK
be !
Get
, !
ToString
))).
ii.
Let
same
be the result of performing
Strict Equality Comparison
searchElement
===
elementK
iii.
If
same
is
true
, return
).
c.
Set
to
- 1.
10.
Return
-1
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.18
get %TypedArray%.prototype.length
%TypedArray%
.prototype.length
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
3.
Assert
has [[ViewedArrayBuffer]] and [[ArrayLength]] internal slots.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
If
IsDetachedBuffer
buffer
) is
true
, return
+0
6.
Let
length
be
.[[ArrayLength]].
7.
Return
length
).
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.19
%TypedArray%.prototype.map (
callbackfn
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.map
are the same as for
Array.prototype.map
as defined in
23.1.3.18
When the
map
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
Let
be ?
TypedArraySpeciesCreate
, «
len
) »).
6.
Let
be 0.
7.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
mappedValue
be ?
Call
callbackfn
thisArg
, «
kValue
),
»).
d.
Perform ?
Set
Pk
mappedValue
true
).
e.
Set
to
+ 1.
8.
Return
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.20
%TypedArray%.prototype.reduce (
callbackfn
[ ,
initialValue
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.reduce
are the same as for
Array.prototype.reduce
as defined in
23.1.3.21
When the
reduce
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
If
len
= 0 and
initialValue
is not present, throw a
TypeError
exception.
6.
Let
be 0.
7.
Let
accumulator
be
undefined
8.
If
initialValue
is present, then
a.
Set
accumulator
to
initialValue
9.
Else,
a.
Let
Pk
be !
ToString
)).
b.
Set
accumulator
to !
Get
Pk
).
c.
Set
to
+ 1.
10.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Set
accumulator
to ?
Call
callbackfn
undefined
, «
accumulator
kValue
),
»).
d.
Set
to
+ 1.
11.
Return
accumulator
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.21
%TypedArray%.prototype.reduceRight (
callbackfn
[ ,
initialValue
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.reduceRight
are the same as for
Array.prototype.reduceRight
as defined in
23.1.3.22
When the
reduceRight
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
If
len
is 0 and
initialValue
is not present, throw a
TypeError
exception.
6.
Let
be
len
- 1.
7.
Let
accumulator
be
undefined
8.
If
initialValue
is present, then
a.
Set
accumulator
to
initialValue
9.
Else,
a.
Let
Pk
be !
ToString
)).
b.
Set
accumulator
to !
Get
Pk
).
c.
Set
to
- 1.
10.
Repeat, while
≥ 0,
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Set
accumulator
to ?
Call
callbackfn
undefined
, «
accumulator
kValue
),
»).
d.
Set
to
- 1.
11.
Return
accumulator
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.22
%TypedArray%.prototype.reverse ( )
The interpretation and use of the arguments of
%TypedArray%
.prototype.reverse
are the same as for
Array.prototype.reverse
as defined in
23.1.3.23
When the
reverse
method is called, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
Let
middle
be
floor
len
/ 2).
5.
Let
lower
be 0.
6.
Repeat, while
lower
middle
a.
Let
upper
be
len
lower
- 1.
b.
Let
upperP
be !
ToString
upper
)).
c.
Let
lowerP
be !
ToString
lower
)).
d.
Let
lowerValue
be !
Get
lowerP
).
e.
Let
upperValue
be !
Get
upperP
).
f.
Perform !
Set
lowerP
upperValue
true
).
g.
Perform !
Set
upperP
lowerValue
true
).
h.
Set
lower
to
lower
+ 1.
7.
Return
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.23
%TypedArray%.prototype.set (
source
[ ,
offset
] )
%TypedArray%
.prototype.set
is a function whose behaviour differs based upon the type of its first argument.
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
Sets multiple values in this
TypedArray
, reading the values from
source
. The optional
offset
value indicates the first element index in this
TypedArray
where values are written. If omitted, it is assumed to be 0.
1.
Let
target
be the
this
value.
2.
Perform ?
RequireInternalSlot
target
, [[TypedArrayName]]).
3.
Assert
target
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
targetOffset
be ?
ToIntegerOrInfinity
offset
).
5.
If
targetOffset
< 0, throw a
RangeError
exception.
6.
If
source
is an Object that has a [[TypedArrayName]] internal slot, then
a.
Perform ?
SetTypedArrayFromTypedArray
target
targetOffset
source
).
7.
Else,
a.
Perform ?
SetTypedArrayFromArrayLike
target
targetOffset
source
).
8.
Return
undefined
23.2.3.23.1
SetTypedArrayFromTypedArray (
target
targetOffset
source
The abstract operation SetTypedArrayFromTypedArray takes arguments
target
(a TypedArray object),
targetOffset
(a non-negative
integer
or +∞), and
source
(a TypedArray object). It sets multiple values in
target
, starting at index
targetOffset
, reading the values from
source
. It performs the following steps when called:
1.
Assert
source
is an Object that has a [[TypedArrayName]] internal slot.
2.
Let
targetBuffer
be
target
.[[ViewedArrayBuffer]].
3.
If
IsDetachedBuffer
targetBuffer
) is
true
, throw a
TypeError
exception.
4.
Let
targetLength
be
target
.[[ArrayLength]].
5.
Let
srcBuffer
be
source
.[[ViewedArrayBuffer]].
6.
If
IsDetachedBuffer
srcBuffer
) is
true
, throw a
TypeError
exception.
7.
Let
targetName
be the String value of
target
.[[TypedArrayName]].
8.
Let
targetType
be the Element Type value in
Table 60
for
targetName
9.
Let
targetElementSize
be the Element Size value specified in
Table 60
for
targetName
10.
Let
targetByteOffset
be
target
.[[ByteOffset]].
11.
Let
srcName
be the String value of
source
.[[TypedArrayName]].
12.
Let
srcType
be the Element Type value in
Table 60
for
srcName
13.
Let
srcElementSize
be the Element Size value specified in
Table 60
for
srcName
14.
Let
srcLength
be
source
.[[ArrayLength]].
15.
Let
srcByteOffset
be
source
.[[ByteOffset]].
16.
If
targetOffset
is +∞, throw a
RangeError
exception.
17.
If
srcLength
targetOffset
targetLength
, throw a
RangeError
exception.
18.
If
target
.[[ContentType]] ≠
source
.[[ContentType]], throw a
TypeError
exception.
19.
If both
IsSharedArrayBuffer
srcBuffer
) and
IsSharedArrayBuffer
targetBuffer
) are
true
, then
a.
If
srcBuffer
.[[ArrayBufferData]] and
targetBuffer
.[[ArrayBufferData]] are the same
Shared Data Block
values, let
same
be
true
; else let
same
be
false
20.
Else, let
same
be
SameValue
srcBuffer
targetBuffer
).
21.
If
same
is
true
, then
a.
Let
srcByteLength
be
source
.[[ByteLength]].
b.
Set
srcBuffer
to ?
CloneArrayBuffer
srcBuffer
srcByteOffset
srcByteLength
%ArrayBuffer%
).
c.
NOTE:
%ArrayBuffer%
is used to clone
srcBuffer
because is it known to not have any observable side-effects.
d.
Let
srcByteIndex
be 0.
22.
Else, let
srcByteIndex
be
srcByteOffset
23.
Let
targetByteIndex
be
targetOffset
targetElementSize
targetByteOffset
24.
Let
limit
be
targetByteIndex
targetElementSize
srcLength
25.
If
srcType
is the same as
targetType
, then
a.
NOTE: If
srcType
and
targetType
are the same, the transfer must be performed in a manner that preserves the bit-level encoding of the source data.
b.
Repeat, while
targetByteIndex
limit
i.
Let
value
be
GetValueFromBuffer
srcBuffer
srcByteIndex
Uint8
true
Unordered
).
ii.
Perform
SetValueInBuffer
targetBuffer
targetByteIndex
Uint8
value
true
Unordered
).
iii.
Set
srcByteIndex
to
srcByteIndex
+ 1.
iv.
Set
targetByteIndex
to
targetByteIndex
+ 1.
26.
Else,
a.
Repeat, while
targetByteIndex
limit
i.
Let
value
be
GetValueFromBuffer
srcBuffer
srcByteIndex
srcType
true
Unordered
).
ii.
Perform
SetValueInBuffer
targetBuffer
targetByteIndex
targetType
value
true
Unordered
).
iii.
Set
srcByteIndex
to
srcByteIndex
srcElementSize
iv.
Set
targetByteIndex
to
targetByteIndex
targetElementSize
23.2.3.23.2
SetTypedArrayFromArrayLike (
target
targetOffset
source
The abstract operation SetTypedArrayFromArrayLike takes arguments
target
(a TypedArray object),
targetOffset
(a non-negative
integer
or +∞), and
source
(an ECMAScript value other than a TypedArray object). It sets multiple values in
target
, starting at index
targetOffset
, reading the values from
source
. It performs the following steps when called:
1.
Assert
source
is any
ECMAScript language value
other than an Object with a [[TypedArrayName]] internal slot.
2.
Let
targetBuffer
be
target
.[[ViewedArrayBuffer]].
3.
If
IsDetachedBuffer
targetBuffer
) is
true
, throw a
TypeError
exception.
4.
Let
targetLength
be
target
.[[ArrayLength]].
5.
Let
targetName
be the String value of
target
.[[TypedArrayName]].
6.
Let
targetElementSize
be the Element Size value specified in
Table 60
for
targetName
7.
Let
targetType
be the Element Type value in
Table 60
for
targetName
8.
Let
targetByteOffset
be
target
.[[ByteOffset]].
9.
Let
src
be ?
ToObject
source
).
10.
Let
srcLength
be ?
LengthOfArrayLike
src
).
11.
If
targetOffset
is +∞, throw a
RangeError
exception.
12.
If
srcLength
targetOffset
targetLength
, throw a
RangeError
exception.
13.
Let
targetByteIndex
be
targetOffset
targetElementSize
targetByteOffset
14.
Let
be 0.
15.
Let
limit
be
targetByteIndex
targetElementSize
srcLength
16.
Repeat, while
targetByteIndex
limit
a.
Let
Pk
be !
ToString
)).
b.
Let
value
be ?
Get
src
Pk
).
c.
If
target
.[[ContentType]] is
BigInt
, set
value
to ?
ToBigInt
value
).
d.
Otherwise, set
value
to ?
ToNumber
value
).
e.
If
IsDetachedBuffer
targetBuffer
) is
true
, throw a
TypeError
exception.
f.
Perform
SetValueInBuffer
targetBuffer
targetByteIndex
targetType
value
true
Unordered
).
g.
Set
to
+ 1.
h.
Set
targetByteIndex
to
targetByteIndex
targetElementSize
23.2.3.24
%TypedArray%.prototype.slice (
start
end
The interpretation and use of the arguments of
%TypedArray%
.prototype.slice
are the same as for
Array.prototype.slice
as defined in
23.1.3.25
. The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
5.
If
relativeStart
is -∞, let
be 0.
6.
Else if
relativeStart
< 0, let
be
max
len
relativeStart
, 0).
7.
Else, let
be
min
relativeStart
len
).
8.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
9.
If
relativeEnd
is -∞, let
final
be 0.
10.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
11.
Else, let
final
be
min
relativeEnd
len
).
12.
Let
count
be
max
final
, 0).
13.
Let
be ?
TypedArraySpeciesCreate
, «
count
) »).
14.
If
count
> 0, then
a.
If
IsDetachedBuffer
.[[ViewedArrayBuffer]]) is
true
, throw a
TypeError
exception.
b.
Let
srcName
be the String value of
.[[TypedArrayName]].
c.
Let
srcType
be the Element Type value in
Table 60
for
srcName
d.
Let
targetName
be the String value of
.[[TypedArrayName]].
e.
Let
targetType
be the Element Type value in
Table 60
for
targetName
f.
If
srcType
is different from
targetType
, then
i.
Let
be 0.
ii.
Repeat, while
final
1.
Let
Pk
be !
ToString
)).
2.
Let
kValue
be !
Get
Pk
).
3.
Perform !
Set
, !
ToString
)),
kValue
true
).
4.
Set
to
+ 1.
5.
Set
to
+ 1.
g.
Else,
i.
Let
srcBuffer
be
.[[ViewedArrayBuffer]].
ii.
Let
targetBuffer
be
.[[ViewedArrayBuffer]].
iii.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
srcType
iv.
NOTE: If
srcType
and
targetType
are the same, the transfer must be performed in a manner that preserves the bit-level encoding of the source data.
v.
Let
srcByteOffset
be
.[[ByteOffset]].
vi.
Let
targetByteIndex
be
.[[ByteOffset]].
vii.
Let
srcByteIndex
be (
elementSize
) +
srcByteOffset
viii.
Let
limit
be
targetByteIndex
count
elementSize
ix.
Repeat, while
targetByteIndex
limit
1.
Let
value
be
GetValueFromBuffer
srcBuffer
srcByteIndex
Uint8
true
Unordered
).
2.
Perform
SetValueInBuffer
targetBuffer
targetByteIndex
Uint8
value
true
Unordered
).
3.
Set
srcByteIndex
to
srcByteIndex
+ 1.
4.
Set
targetByteIndex
to
targetByteIndex
+ 1.
15.
Return
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.25
%TypedArray%.prototype.some (
callbackfn
[ ,
thisArg
] )
The interpretation and use of the arguments of
%TypedArray%
.prototype.some
are the same as for
Array.prototype.some
as defined in
23.1.3.26
When the
some
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Let
len
be
.[[ArrayLength]].
4.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
5.
Let
be 0.
6.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be !
Get
Pk
).
c.
Let
testResult
be !
ToBoolean
(?
Call
callbackfn
thisArg
, «
kValue
),
»)).
d.
If
testResult
is
true
, return
true
e.
Set
to
+ 1.
7.
Return
false
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.26
%TypedArray%.prototype.sort (
comparefn
%TypedArray%
.prototype.sort
is a distinct function that, except as described below, implements the same requirements as those of
Array.prototype.sort
as defined in
23.1.3.27
. The implementation of the
%TypedArray%
.prototype.sort
specification may be optimized with the knowledge that the
this
value is an object that has a fixed length and whose
integer-indexed
properties are not sparse.
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
Upon entry, the following steps are performed to initialize evaluation of the
sort
function. These steps are used instead of steps
in
23.1.3.27
1.
If
comparefn
is not
undefined
and
IsCallable
comparefn
) is
false
, throw a
TypeError
exception.
2.
Let
obj
be the
this
value.
3.
Let
buffer
be ?
ValidateTypedArray
obj
).
4.
Let
len
be
obj
.[[ArrayLength]].
The following version of
SortCompare
is used by
%TypedArray%
.prototype.sort
. It performs a numeric comparison rather than the string comparison used in
23.1.3.27
The abstract operation TypedArraySortCompare takes arguments
and
. It also has access to the
comparefn
and
buffer
values of the current invocation of the
sort
method. It performs the following steps when called:
1.
Assert
: Both
Type
) and
Type
) are Number or both are BigInt.
2.
If
comparefn
is not
undefined
, then
a.
Let
be ?
ToNumber
(?
Call
comparefn
undefined
, «
»)).
b.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
c.
If
is
NaN
, return
+0
d.
Return
3.
If
and
are both
NaN
, return
+0
4.
If
is
NaN
, return
5.
If
is
NaN
, return
-1
6.
If
, return
-1
7.
If
, return
8.
If
is
-0
and
is
+0
, return
-1
9.
If
is
+0
and
is
-0
, return
10.
Return
+0
Note
Because
NaN
always compares greater than any other value,
NaN
property values always sort to the end of the result when
comparefn
is not provided.
23.2.3.27
%TypedArray%.prototype.subarray (
begin
end
Returns a new
TypedArray
object whose element type is the same as this
TypedArray
and whose ArrayBuffer is the same as the ArrayBuffer of this
TypedArray
, referencing the elements at
begin
, inclusive, up to
end
, exclusive. If either
begin
or
end
is negative, it refers to an index from the end of the array, as opposed to from the beginning.
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
Let
srcLength
be
.[[ArrayLength]].
6.
Let
relativeBegin
be ?
ToIntegerOrInfinity
begin
).
7.
If
relativeBegin
is -∞, let
beginIndex
be 0.
8.
Else if
relativeBegin
< 0, let
beginIndex
be
max
srcLength
relativeBegin
, 0).
9.
Else, let
beginIndex
be
min
relativeBegin
srcLength
).
10.
If
end
is
undefined
, let
relativeEnd
be
srcLength
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
11.
If
relativeEnd
is -∞, let
endIndex
be 0.
12.
Else if
relativeEnd
< 0, let
endIndex
be
max
srcLength
relativeEnd
, 0).
13.
Else, let
endIndex
be
min
relativeEnd
srcLength
).
14.
Let
newLength
be
max
endIndex
beginIndex
, 0).
15.
Let
constructorName
be the String value of
.[[TypedArrayName]].
16.
Let
elementSize
be the Element Size value specified in
Table 60
for
constructorName
17.
Let
srcByteOffset
be
.[[ByteOffset]].
18.
Let
beginByteOffset
be
srcByteOffset
beginIndex
elementSize
19.
Let
argumentsList
be «
buffer
beginByteOffset
),
newLength
) ».
20.
Return ?
TypedArraySpeciesCreate
argumentsList
).
This function is not generic. The
this
value must be an object with a [[TypedArrayName]] internal slot.
23.2.3.28
%TypedArray%.prototype.toLocaleString ( [
reserved1
[ ,
reserved2
] ] )
%TypedArray%
.prototype.toLocaleString
is a distinct function that implements the same algorithm as
Array.prototype.toLocaleString
as defined in
23.1.3.29
except that the
this
value's [[ArrayLength]] internal slot is accessed in place of performing a [[Get]] of
"length"
. The implementation of the algorithm may be optimized with the knowledge that the
this
value is an object that has a fixed length and whose
integer-indexed
properties are not sparse. However, such optimization must not
introduce any observable changes in the specified behaviour of the
algorithm.
This function is not generic.
ValidateTypedArray
is applied to the
this
value prior to evaluating the algorithm. If its result is an
abrupt completion
that exception is thrown instead of evaluating the algorithm.
Note
If the ECMAScript implementation includes the ECMA-402 Internationalization API this function is based upon the algorithm for
Array.prototype.toLocaleString
that is in the ECMA-402 specification.
23.2.3.29
%TypedArray%.prototype.toString ( )
The initial value of the
%TypedArray%
.prototype.toString
data property
is the same built-in
function object
as the
Array.prototype.toString
method defined in
23.1.3.30
23.2.3.30
%TypedArray%.prototype.values ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
ValidateTypedArray
).
3.
Return
CreateArrayIterator
value
).
23.2.3.31
%TypedArray%.prototype [ @@iterator ] ( )
The initial value of the
@@iterator
property is the same
function object
as the initial value of the
%TypedArray%
.prototype.values
property.
23.2.3.32
get %TypedArray%.prototype [ @@toStringTag ]
%TypedArray%
.prototype[@@toStringTag]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
If
Type
) is not Object, return
undefined
3.
If
does not have a [[TypedArrayName]] internal slot, return
undefined
4.
Let
name
be
.[[TypedArrayName]].
5.
Assert
Type
name
) is String.
6.
Return
name
This property has the attributes { [[Enumerable]]:
false
, [[Configurable]]:
true
}.
The initial value of the
"name"
property of this function is
"get [Symbol.toStringTag]"
23.2.4
Abstract Operations for TypedArray Objects
23.2.4.1
TypedArraySpeciesCreate (
exemplar
argumentList
The abstract operation TypedArraySpeciesCreate takes arguments
exemplar
and
argumentList
. It is used to specify the creation of a new TypedArray object using a
constructor
function that is derived from
exemplar
. It performs the following steps when called:
1.
Assert
exemplar
is an Object that has [[TypedArrayName]] and [[ContentType]] internal slots.
2.
Let
defaultConstructor
be the intrinsic object listed in column one of
Table 60
for
exemplar
.[[TypedArrayName]].
3.
Let
constructor
be ?
SpeciesConstructor
exemplar
defaultConstructor
).
4.
Let
result
be ?
TypedArrayCreate
constructor
argumentList
).
5.
Assert
result
has [[TypedArrayName]] and [[ContentType]] internal slots.
6.
If
result
.[[ContentType]] ≠
exemplar
.[[ContentType]], throw a
TypeError
exception.
7.
Return
result
23.2.4.2
TypedArrayCreate (
constructor
argumentList
The abstract operation TypedArrayCreate takes arguments
constructor
and
argumentList
. It is used to specify the creation of a new TypedArray object using a
constructor
function. It performs the following steps when called:
1.
Let
newTypedArray
be ?
Construct
constructor
argumentList
).
2.
Perform ?
ValidateTypedArray
newTypedArray
).
3.
If
argumentList
is a
List
of a single Number, then
a.
If
newTypedArray
.[[ArrayLength]] <
argumentList
[0]), throw a
TypeError
exception.
4.
Return
newTypedArray
23.2.4.3
ValidateTypedArray (
The abstract operation ValidateTypedArray takes argument
. It performs the following steps when called:
1.
Perform ?
RequireInternalSlot
, [[TypedArrayName]]).
2.
Assert
has a [[ViewedArrayBuffer]] internal slot.
3.
Let
buffer
be
.[[ViewedArrayBuffer]].
4.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
5.
Return
buffer
23.2.5
The
TypedArray
Constructors
Each
TypedArray
constructor
is an intrinsic object that has the structure described below, differing only in the name used as the
constructor
name instead of
TypedArray
, in
Table 60
is a function whose behaviour differs based upon the number and types of its arguments. The actual behaviour of a call of
TypedArray
depends upon the number and kind of arguments that are passed to it.
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified
TypedArray
behaviour must include a
super
call to the
TypedArray
constructor
to create and initialize the subclass instance with the internal state necessary to support the
%TypedArray%
.prototype
built-in methods.
has a
"length"
property whose value is
23.2.5.1
TypedArray
( ...
args
Each
TypedArray
constructor
performs the following steps when called:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
constructorName
be the String value of the
Constructor
Name value specified in
Table 60
for this
TypedArray
constructor
3.
Let
proto
be
"%
TypedArray
.prototype%"
4.
Let
numberOfArgs
be the number of elements in
args
5.
If
numberOfArgs
= 0, then
a.
Return ?
AllocateTypedArray
constructorName
, NewTarget,
proto
, 0).
6.
Else,
a.
Let
firstArgument
be
args
[0].
b.
If
Type
firstArgument
) is Object, then
i.
Let
be ?
AllocateTypedArray
constructorName
, NewTarget,
proto
).
ii.
If
firstArgument
has a [[TypedArrayName]] internal slot, then
1.
Perform ?
InitializeTypedArrayFromTypedArray
firstArgument
).
iii.
Else if
firstArgument
has an [[ArrayBufferData]] internal slot, then
1.
If
numberOfArgs
> 1, let
byteOffset
be
args
[1]; else let
byteOffset
be
undefined
2.
If
numberOfArgs
> 2, let
length
be
args
[2]; else let
length
be
undefined
3.
Perform ?
InitializeTypedArrayFromArrayBuffer
firstArgument
byteOffset
length
).
iv.
Else,
1.
Assert
Type
firstArgument
) is Object and
firstArgument
does not have either a [[TypedArrayName]] or an [[ArrayBufferData]] internal slot.
2.
Let
usingIterator
be ?
GetMethod
firstArgument
@@iterator
).
3.
If
usingIterator
is not
undefined
, then
a.
Let
values
be ?
IterableToList
firstArgument
usingIterator
).
b.
Perform ?
InitializeTypedArrayFromList
values
).
4.
Else,
a.
NOTE:
firstArgument
is not an Iterable so assume it is already an
array-like object
b.
Perform ?
InitializeTypedArrayFromArrayLike
firstArgument
).
v.
Return
c.
Else,
i.
Assert
firstArgument
is not an Object.
ii.
Let
elementLength
be ?
ToIndex
firstArgument
).
iii.
Return ?
AllocateTypedArray
constructorName
, NewTarget,
proto
elementLength
).
23.2.5.1.1
AllocateTypedArray (
constructorName
newTarget
defaultProto
[ ,
length
] )
The abstract operation AllocateTypedArray takes arguments
constructorName
(a String which is the name of a TypedArray
constructor
in
Table 60
),
newTarget
, and
defaultProto
and optional argument
length
(a non-negative
integer
). It is used to validate and create an instance of a TypedArray
constructor
. If the
length
argument is passed, an ArrayBuffer of that length is also allocated and
associated with the new TypedArray instance. AllocateTypedArray
provides common semantics that is used by
TypedArray
. It performs the following steps when called:
1.
Let
proto
be ?
GetPrototypeFromConstructor
newTarget
defaultProto
).
2.
Let
obj
be !
IntegerIndexedObjectCreate
proto
).
3.
Assert
obj
.[[ViewedArrayBuffer]] is
undefined
4.
Set
obj
.[[TypedArrayName]] to
constructorName
5.
If
constructorName
is
"BigInt64Array"
or
"BigUint64Array"
, set
obj
.[[ContentType]] to
BigInt
6.
Otherwise, set
obj
.[[ContentType]] to
Number
7.
If
length
is not present, then
a.
Set
obj
.[[ByteLength]] to 0.
b.
Set
obj
.[[ByteOffset]] to 0.
c.
Set
obj
.[[ArrayLength]] to 0.
8.
Else,
a.
Perform ?
AllocateTypedArrayBuffer
obj
length
).
9.
Return
obj
23.2.5.1.2
InitializeTypedArrayFromTypedArray (
srcArray
The abstract operation InitializeTypedArrayFromTypedArray takes arguments
(a TypedArray object) and
srcArray
(a TypedArray object). It performs the following steps when called:
1.
Assert
is an Object that has a [[TypedArrayName]] internal slot.
2.
Assert
srcArray
is an Object that has a [[TypedArrayName]] internal slot.
3.
Let
srcData
be
srcArray
.[[ViewedArrayBuffer]].
4.
If
IsDetachedBuffer
srcData
) is
true
, throw a
TypeError
exception.
5.
Let
constructorName
be the String value of
.[[TypedArrayName]].
6.
Let
elementType
be the Element Type value in
Table 60
for
constructorName
7.
Let
elementLength
be
srcArray
.[[ArrayLength]].
8.
Let
srcName
be the String value of
srcArray
.[[TypedArrayName]].
9.
Let
srcType
be the Element Type value in
Table 60
for
srcName
10.
Let
srcElementSize
be the Element Size value specified in
Table 60
for
srcName
11.
Let
srcByteOffset
be
srcArray
.[[ByteOffset]].
12.
Let
elementSize
be the Element Size value specified in
Table 60
for
constructorName
13.
Let
byteLength
be
elementSize
elementLength
14.
If
IsSharedArrayBuffer
srcData
) is
false
, then
a.
Let
bufferConstructor
be ?
SpeciesConstructor
srcData
%ArrayBuffer%
).
15.
Else,
a.
Let
bufferConstructor
be
%ArrayBuffer%
16.
If
elementType
is the same as
srcType
, then
a.
Let
data
be ?
CloneArrayBuffer
srcData
srcByteOffset
byteLength
bufferConstructor
).
17.
Else,
a.
Let
data
be ?
AllocateArrayBuffer
bufferConstructor
byteLength
).
b.
If
IsDetachedBuffer
srcData
) is
true
, throw a
TypeError
exception.
c.
If
srcArray
.[[ContentType]] ≠
.[[ContentType]], throw a
TypeError
exception.
d.
Let
srcByteIndex
be
srcByteOffset
e.
Let
targetByteIndex
be 0.
f.
Let
count
be
elementLength
g.
Repeat, while
count
> 0,
i.
Let
value
be
GetValueFromBuffer
srcData
srcByteIndex
srcType
true
Unordered
).
ii.
Perform
SetValueInBuffer
data
targetByteIndex
elementType
value
true
Unordered
).
iii.
Set
srcByteIndex
to
srcByteIndex
srcElementSize
iv.
Set
targetByteIndex
to
targetByteIndex
elementSize
v.
Set
count
to
count
- 1.
18.
Set
.[[ViewedArrayBuffer]] to
data
19.
Set
.[[ByteLength]] to
byteLength
20.
Set
.[[ByteOffset]] to 0.
21.
Set
.[[ArrayLength]] to
elementLength
23.2.5.1.3
InitializeTypedArrayFromArrayBuffer (
buffer
byteOffset
length
The abstract operation InitializeTypedArrayFromArrayBuffer takes arguments
(a TypedArray object),
buffer
(an ArrayBuffer object),
byteOffset
(an
ECMAScript language value
), and
length
(an
ECMAScript language value
). It performs the following steps when called:
1.
Assert
is an Object that has a [[TypedArrayName]] internal slot.
2.
Assert
buffer
is an Object that has an [[ArrayBufferData]] internal slot.
3.
Let
constructorName
be the String value of
.[[TypedArrayName]].
4.
Let
elementSize
be the Element Size value specified in
Table 60
for
constructorName
5.
Let
offset
be ?
ToIndex
byteOffset
).
6.
If
offset
modulo
elementSize
≠ 0, throw a
RangeError
exception.
7.
If
length
is not
undefined
, then
a.
Let
newLength
be ?
ToIndex
length
).
8.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
9.
Let
bufferByteLength
be
buffer
.[[ArrayBufferByteLength]].
10.
If
length
is
undefined
, then
a.
If
bufferByteLength
modulo
elementSize
≠ 0, throw a
RangeError
exception.
b.
Let
newByteLength
be
bufferByteLength
offset
c.
If
newByteLength
< 0, throw a
RangeError
exception.
11.
Else,
a.
Let
newByteLength
be
newLength
elementSize
b.
If
offset
newByteLength
bufferByteLength
, throw a
RangeError
exception.
12.
Set
.[[ViewedArrayBuffer]] to
buffer
13.
Set
.[[ByteLength]] to
newByteLength
14.
Set
.[[ByteOffset]] to
offset
15.
Set
.[[ArrayLength]] to
newByteLength
elementSize
23.2.5.1.4
InitializeTypedArrayFromList (
values
The abstract operation InitializeTypedArrayFromList takes arguments
(a TypedArray object) and
values
(a
List
of ECMAScript language values). It performs the following steps when called:
1.
Assert
is an Object that has a [[TypedArrayName]] internal slot.
2.
Let
len
be the number of elements in
values
3.
Perform ?
AllocateTypedArrayBuffer
len
).
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be the first element of
values
and remove that element from
values
c.
Perform ?
Set
Pk
kValue
true
).
d.
Set
to
+ 1.
6.
Assert
values
is now an empty
List
23.2.5.1.5
InitializeTypedArrayFromArrayLike (
arrayLike
The abstract operation InitializeTypedArrayFromArrayLike takes arguments
(a TypedArray object) and
arrayLike
(an Object that is neither a TypedArray object nor an ArrayBuffer object). It performs the following steps when called:
1.
Assert
is an Object that has a [[TypedArrayName]] internal slot.
2.
Let
len
be ?
LengthOfArrayLike
arrayLike
).
3.
Perform ?
AllocateTypedArrayBuffer
len
).
4.
Let
be 0.
5.
Repeat, while
len
a.
Let
Pk
be !
ToString
)).
b.
Let
kValue
be ?
Get
arrayLike
Pk
).
c.
Perform ?
Set
Pk
kValue
true
).
d.
Set
to
+ 1.
23.2.5.1.6
AllocateTypedArrayBuffer (
length
The abstract operation AllocateTypedArrayBuffer takes arguments
(a TypedArray object) and
length
(a non-negative
integer
). It allocates and associates an ArrayBuffer with
. It performs the following steps when called:
1.
Assert
is an Object that has a [[ViewedArrayBuffer]] internal slot.
2.
Assert
.[[ViewedArrayBuffer]] is
undefined
3.
Let
constructorName
be the String value of
.[[TypedArrayName]].
4.
Let
elementSize
be the Element Size value specified in
Table 60
for
constructorName
5.
Let
byteLength
be
elementSize
length
6.
Let
data
be ?
AllocateArrayBuffer
%ArrayBuffer%
byteLength
).
7.
Set
.[[ViewedArrayBuffer]] to
data
8.
Set
.[[ByteLength]] to
byteLength
9.
Set
.[[ByteOffset]] to 0.
10.
Set
.[[ArrayLength]] to
length
11.
Return
23.2.6
Properties of the
TypedArray
Constructors
Each
TypedArray
constructor
has a [[Prototype]] internal slot whose value is
%TypedArray%
has a
"name"
property whose value is the String value of the
constructor
name specified for it in
Table 60
has the following properties:
23.2.6.1
TypedArray
.BYTES_PER_ELEMENT
The value of
TypedArray
.BYTES_PER_ELEMENT
is the Element Size value specified in
Table 60
for
TypedArray
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
23.2.6.2
TypedArray
.prototype
The initial value of
TypedArray
.prototype
is the corresponding
TypedArray
prototype intrinsic object (
23.2.7
).
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
23.2.7
Properties of the
TypedArray
Prototype Objects
Each
TypedArray
prototype object:
has a [[Prototype]] internal slot whose value is
%TypedArray.prototype%
is an
ordinary object
does not have a [[ViewedArrayBuffer]] or any other of the internal slots that are specific to
TypedArray
instance objects.
23.2.7.1
TypedArray
.prototype.BYTES_PER_ELEMENT
The value of
TypedArray
.prototype.BYTES_PER_ELEMENT
is the Element Size value specified in
Table 60
for
TypedArray
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
23.2.7.2
TypedArray
.prototype.constructor
The initial value of a
TypedArray
.prototype.constructor
is the corresponding
%TypedArray%
intrinsic object.
23.2.8
Properties of
TypedArray
Instances
TypedArray
instances are
Integer-Indexed exotic objects
. Each
TypedArray
instance inherits properties from the corresponding
TypedArray
prototype object. Each
TypedArray
instance has the following internal slots: [[TypedArrayName]],
[[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]], and
[[ArrayLength]].
24
Keyed Collections
24.1
Map Objects
Map objects are collections of key/value pairs where both the
keys and values may be arbitrary ECMAScript language values. A distinct
key value may only occur in one key/value pair within the Map's
collection. Distinct key values are discriminated using the
SameValueZero
comparison algorithm.
Map object must be implemented using either hash tables or other
mechanisms that, on average, provide access times that are sublinear on
the number of elements in the collection. The data structures used in
this Map objects specification is only intended to describe the required
observable semantics of Map objects. It is not intended to be a viable
implementation model.
24.1.1
The Map Constructor
The Map
constructor
is
%Map%
is the initial value of the
"Map"
property of the
global object
creates and initializes a new Map object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value in an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Map behaviour must include a
super
call to the Map
constructor
to create and initialize the subclass instance with the internal state necessary to support the
Map.prototype
built-in methods.
24.1.1.1
Map ( [
iterable
] )
When the
Map
function is called with optional argument
iterable
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
map
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Map.prototype%"
, « [[MapData]] »).
3.
Set
map
.[[MapData]] to a new empty
List
4.
If
iterable
is either
undefined
or
null
, return
map
5.
Let
adder
be ?
Get
map
"set"
).
6.
Return ?
AddEntriesFromIterable
map
iterable
adder
).
Note
If the parameter
iterable
is present, it is expected to be an object that implements an
@@iterator
method that returns an iterator object that produces a two element
array-like object
whose first element is a value that will be used as a Map key and whose second element is the value to associate with that key.
24.1.1.2
AddEntriesFromIterable (
target
iterable
adder
The abstract operation AddEntriesFromIterable takes arguments
target
iterable
, and
adder
(a
function object
).
adder
will be invoked, with
target
as the receiver. It performs the following steps when called:
1.
If
IsCallable
adder
) is
false
, throw a
TypeError
exception.
2.
Assert
iterable
is present, and is neither
undefined
nor
null
3.
Let
iteratorRecord
be ?
GetIterator
iterable
).
4.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
target
c.
Let
nextItem
be ?
IteratorValue
next
).
d.
If
Type
nextItem
) is not Object, then
i.
Let
error
be
ThrowCompletion
(a newly created
TypeError
object).
ii.
Return ?
IteratorClose
iteratorRecord
error
).
e.
Let
be
Get
nextItem
"0"
).
f.
If
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
).
g.
Let
be
Get
nextItem
"1"
).
h.
If
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
).
i.
Let
status
be
Call
adder
target
, «
.[[Value]],
.[[Value]] »).
j.
If
status
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
status
).
Note
The parameter
iterable
is expected to be an object that implements an
@@iterator
method that returns an iterator object that produces a two element
array-like object
whose first element is a value that will be used as a Map key and whose second element is the value to associate with that key.
24.1.2
Properties of the Map Constructor
The Map
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
24.1.2.1
Map.prototype
The initial value of
Map.prototype
is the
Map prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
24.1.2.2
get Map [ @@species ]
Map[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
Methods that create derived collection objects should call
@@species
to determine the
constructor
to use to create the derived objects. Subclass
constructor
may over-ride
@@species
to change the default
constructor
assignment.
24.1.3
Properties of the Map Prototype Object
The
Map prototype object
is
%Map.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[MapData]] internal slot.
24.1.3.1
Map.prototype.clear ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
Set
.[[Key]] to
empty
b.
Set
.[[Value]] to
empty
5.
Return
undefined
Note
The existing [[MapData]]
List
is preserved because there may be existing Map Iterator objects that are suspended midway through iterating over that
List
24.1.3.2
Map.prototype.constructor
The initial value of
Map.prototype.constructor
is
%Map%
24.1.3.3
Map.prototype.delete (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValueZero
.[[Key]],
key
) is
true
, then
i.
Set
.[[Key]] to
empty
ii.
Set
.[[Value]] to
empty
iii.
Return
true
5.
Return
false
Note
The value
empty
is used as a
specification device to indicate that an entry has been deleted. Actual
implementations may take other actions such as physically removing the
entry from internal data structures.
24.1.3.4
Map.prototype.entries ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
CreateMapIterator
key+value
).
24.1.3.5
Map.prototype.forEach (
callbackfn
[ ,
thisArg
] )
When the
forEach
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
entries
be the
List
that is
.[[MapData]].
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
, then
i.
Perform ?
Call
callbackfn
thisArg
, «
.[[Value]],
.[[Key]],
»).
6.
Return
undefined
Note
callbackfn
should be a function that accepts three arguments.
forEach
calls
callbackfn
once for each key/value pair present in the map object, in key insertion order.
callbackfn
is called only for keys of the map which actually exist; it is not called for keys that have been deleted from the map.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the value of the item, the key of the item, and the Map object being traversed.
forEach
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
. Each entry of a map's [[MapData]] is only visited once. New keys added after the call to
forEach
begins are visited. A key will be revisited if it is deleted after it has been visited and then re-added before the
forEach
call completes. Keys that are deleted after the call to
forEach
begins and before being visited are not visited unless the key is added again before the
forEach
call completes.
24.1.3.6
Map.prototype.get (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValueZero
.[[Key]],
key
) is
true
, return
.[[Value]].
5.
Return
undefined
24.1.3.7
Map.prototype.has (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValueZero
.[[Key]],
key
) is
true
, return
true
5.
Return
false
24.1.3.8
Map.prototype.keys ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
CreateMapIterator
key
).
24.1.3.9
Map.prototype.set (
key
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValueZero
.[[Key]],
key
) is
true
, then
i.
Set
.[[Value]] to
value
ii.
Return
5.
If
key
is
-0
, set
key
to
+0
6.
Let
be the
Record
{ [[Key]]:
key
, [[Value]]:
value
}.
7.
Append
as the last element of
entries
8.
Return
24.1.3.10
get Map.prototype.size
Map.prototype.size
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[MapData]]).
3.
Let
entries
be the
List
that is
.[[MapData]].
4.
Let
count
be 0.
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
, set
count
to
count
+ 1.
6.
Return
count
).
24.1.3.11
Map.prototype.values ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
CreateMapIterator
value
).
24.1.3.12
Map.prototype [ @@iterator ] ( )
The initial value of the
@@iterator
property is the same
function object
as the initial value of the
"entries"
property.
24.1.3.13
Map.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Map"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.1.4
Properties of Map Instances
Map instances are ordinary objects that inherit properties from
the Map prototype. Map instances also have a [[MapData]] internal slot.
24.1.5
Map Iterator Objects
A Map Iterator is an object, that represents a specific iteration over some specific Map instance object. There is not a named
constructor
for Map Iterator objects. Instead, map iterator objects are created by calling certain methods of Map instance objects.
24.1.5.1
CreateMapIterator (
map
kind
The abstract operation CreateMapIterator takes arguments
map
and
kind
This operation is used to create iterator objects for Map methods that
return such iterators. It performs the following steps when called:
1.
Assert
kind
is
key+value
key
, or
value
2.
Perform ?
RequireInternalSlot
map
, [[MapData]]).
3.
Let
closure
be a new
Abstract Closure
with no parameters that captures
map
and
kind
and performs the following steps when called:
a.
Let
entries
be the
List
that is
map
.[[MapData]].
b.
Let
index
be 0.
c.
Let
numEntries
be the number of elements of
entries
d.
Repeat, while
index
numEntries
i.
Let
be the
Record
{ [[Key]], [[Value]] } that is the value of
entries
index
].
ii.
Set
index
to
index
+ 1.
iii.
If
.[[Key]] is not
empty
, then
1.
If
kind
is
key
, let
result
be
.[[Key]].
2.
Else if
kind
is
value
, let
result
be
.[[Value]].
3.
Else,
a.
Assert
kind
is
key+value
b.
Let
result
be !
CreateArrayFromList
(«
.[[Key]],
.[[Value]] »).
4.
Perform ?
Yield
result
).
5.
NOTE: the number of elements in
entries
may have changed while execution of this abstract operation was paused by
Yield
6.
Set
numEntries
to the number of elements of
entries
e.
Return
undefined
4.
Return !
CreateIteratorFromClosure
closure
"%MapIteratorPrototype%"
%MapIteratorPrototype%
).
24.1.5.2
The %MapIteratorPrototype% Object
The
%MapIteratorPrototype%
object:
has properties that are inherited by all Map Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
has the following properties:
24.1.5.2.1
%MapIteratorPrototype%.next ( )
1.
Return ?
GeneratorResume
this
value,
empty
"%MapIteratorPrototype%"
).
24.1.5.2.2
%MapIteratorPrototype% [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Map Iterator"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.2
Set Objects
Set objects are collections of ECMAScript language values. A
distinct value may only occur once as an element of a Set's collection.
Distinct values are discriminated using the
SameValueZero
comparison algorithm.
Set objects must be implemented using either hash tables or other
mechanisms that, on average, provide access times that are sublinear on
the number of elements in the collection. The data structures used in
this Set objects specification is only intended to describe the required
observable semantics of Set objects. It is not intended to be a viable
implementation model.
24.2.1
The Set Constructor
The Set
constructor
is
%Set%
is the initial value of the
"Set"
property of the
global object
creates and initializes a new Set object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value in an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified Set behaviour must include a
super
call to the Set
constructor
to create and initialize the subclass instance with the internal state necessary to support the
Set.prototype
built-in methods.
24.2.1.1
Set ( [
iterable
] )
When the
Set
function is called with optional argument
iterable
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
set
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%Set.prototype%"
, « [[SetData]] »).
3.
Set
set
.[[SetData]] to a new empty
List
4.
If
iterable
is either
undefined
or
null
, return
set
5.
Let
adder
be ?
Get
set
"add"
).
6.
If
IsCallable
adder
) is
false
, throw a
TypeError
exception.
7.
Let
iteratorRecord
be ?
GetIterator
iterable
).
8.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
set
c.
Let
nextValue
be ?
IteratorValue
next
).
d.
Let
status
be
Call
adder
set
, «
nextValue
»).
e.
If
status
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
status
).
24.2.2
Properties of the Set Constructor
The Set
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
24.2.2.1
Set.prototype
The initial value of
Set.prototype
is the
Set prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
24.2.2.2
get Set [ @@species ]
Set[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
Methods that create derived collection objects should call
@@species
to determine the
constructor
to use to create the derived objects. Subclass
constructor
may over-ride
@@species
to change the default
constructor
assignment.
24.2.3
Properties of the Set Prototype Object
The
Set prototype object
is
%Set.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[SetData]] internal slot.
24.2.3.1
Set.prototype.add (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
Let
entries
be the
List
that is
.[[SetData]].
4.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValueZero
value
) is
true
, then
i.
Return
5.
If
value
is
-0
, set
value
to
+0
6.
Append
value
as the last element of
entries
7.
Return
24.2.3.2
Set.prototype.clear ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
Let
entries
be the
List
that is
.[[SetData]].
4.
For each element
of
entries
, do
a.
Replace the element of
entries
whose value is
with an element whose value is
empty
5.
Return
undefined
Note
The existing [[SetData]]
List
is preserved because there may be existing Set Iterator objects that are suspended midway through iterating over that
List
24.2.3.3
Set.prototype.constructor
The initial value of
Set.prototype.constructor
is
%Set%
24.2.3.4
Set.prototype.delete (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
Let
entries
be the
List
that is
.[[SetData]].
4.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValueZero
value
) is
true
, then
i.
Replace the element of
entries
whose value is
with an element whose value is
empty
ii.
Return
true
5.
Return
false
Note
The value
empty
is used as a
specification device to indicate that an entry has been deleted. Actual
implementations may take other actions such as physically removing the
entry from internal data structures.
24.2.3.5
Set.prototype.entries ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
CreateSetIterator
key+value
).
Note
For iteration purposes, a Set appears similar to a Map where each entry has the same value for its key and value.
24.2.3.6
Set.prototype.forEach (
callbackfn
[ ,
thisArg
] )
When the
forEach
method is called with one or two arguments, the following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
If
IsCallable
callbackfn
) is
false
, throw a
TypeError
exception.
4.
Let
entries
be the
List
that is
.[[SetData]].
5.
For each element
of
entries
, do
a.
If
is not
empty
, then
i.
Perform ?
Call
callbackfn
thisArg
, «
»).
6.
Return
undefined
Note
callbackfn
should be a function that accepts three arguments.
forEach
calls
callbackfn
once for each value present in the set object, in value insertion order.
callbackfn
is called only for values of the Set which actually exist; it is not called for keys that have been deleted from the set.
If a
thisArg
parameter is provided, it will be used as the
this
value for each invocation of
callbackfn
. If it is not provided,
undefined
is used instead.
callbackfn
is called with three arguments: the
first two arguments are a value contained in the Set. The same value is
passed for both arguments. The Set object being traversed is passed as
the third argument.
The
callbackfn
is called with three arguments to be consistent with the call back functions used by
forEach
methods for Map and Array. For Sets, each item value is considered to be both the key and the value.
forEach
does not directly mutate the object on which it is called but the object may be mutated by the calls to
callbackfn
Each value is normally visited only once. However, a value
will be revisited if it is deleted after it has been visited and then
re-added before the
forEach
call completes. Values that are deleted after the call to
forEach
begins and before being visited are not visited unless the value is added again before the
forEach
call completes. New values added after the call to
forEach
begins are visited.
24.2.3.7
Set.prototype.has (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
Let
entries
be the
List
that is
.[[SetData]].
4.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValueZero
value
) is
true
, return
true
5.
Return
false
24.2.3.8
Set.prototype.keys ( )
The initial value of the
"keys"
property is the same
function object
as the initial value of the
"values"
property.
Note
For iteration purposes, a Set appears similar to a Map where each entry has the same value for its key and value.
24.2.3.9
get Set.prototype.size
Set.prototype.size
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[SetData]]).
3.
Let
entries
be the
List
that is
.[[SetData]].
4.
Let
count
be 0.
5.
For each element
of
entries
, do
a.
If
is not
empty
, set
count
to
count
+ 1.
6.
Return
count
).
24.2.3.10
Set.prototype.values ( )
The following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
CreateSetIterator
value
).
24.2.3.11
Set.prototype [ @@iterator ] ( )
The initial value of the
@@iterator
property is the same
function object
as the initial value of the
"values"
property.
24.2.3.12
Set.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Set"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.2.4
Properties of Set Instances
Set instances are ordinary objects that inherit properties from
the Set prototype. Set instances also have a [[SetData]] internal slot.
24.2.5
Set Iterator Objects
A Set Iterator is an
ordinary object
with the structure defined below, that represents a specific iteration
over some specific Set instance object. There is not a named
constructor
for Set Iterator objects. Instead, set iterator objects are created by calling certain methods of Set instance objects.
24.2.5.1
CreateSetIterator (
set
kind
The abstract operation CreateSetIterator takes arguments
set
and
kind
This operation is used to create iterator objects for Set methods that
return such iterators. It performs the following steps when called:
1.
Assert
kind
is
key+value
or
value
2.
Perform ?
RequireInternalSlot
set
, [[SetData]]).
3.
Let
closure
be a new
Abstract Closure
with no parameters that captures
set
and
kind
and performs the following steps when called:
a.
Let
index
be 0.
b.
Let
entries
be the
List
that is
set
.[[SetData]].
c.
Let
numEntries
be the number of elements of
entries
d.
Repeat, while
index
numEntries
i.
Let
be
entries
index
].
ii.
Set
index
to
index
+ 1.
iii.
If
is not
empty
, then
1.
If
kind
is
key+value
, then
a.
Perform ?
Yield
(!
CreateArrayFromList
(«
»)).
2.
Else,
a.
Assert
kind
is
value
b.
Perform ?
Yield
).
3.
NOTE: the number of elements in
entries
may have changed while execution of this abstract operation was paused by
Yield
4.
Set
numEntries
to the number of elements of
entries
e.
Return
undefined
4.
Return !
CreateIteratorFromClosure
closure
"%SetIteratorPrototype%"
%SetIteratorPrototype%
).
24.2.5.2
The %SetIteratorPrototype% Object
The
%SetIteratorPrototype%
object:
has properties that are inherited by all Set Iterator Objects.
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%IteratorPrototype%
has the following properties:
24.2.5.2.1
%SetIteratorPrototype%.next ( )
1.
Return ?
GeneratorResume
this
value,
empty
"%SetIteratorPrototype%"
).
24.2.5.2.2
%SetIteratorPrototype% [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Set Iterator"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.3
WeakMap Objects
WeakMap objects are collections of key/value pairs where the keys
are objects and values may be arbitrary ECMAScript language values. A
WeakMap may be queried to see if it contains a key/value pair with a
specific key, but no mechanism is provided for enumerating the objects
it holds as keys. In certain conditions, objects which are not
live
are removed as WeakMap keys, as described in
9.9.3
An implementation may impose an arbitrarily determined latency
between the time a key/value pair of a WeakMap becomes inaccessible and
the time when the key/value pair is removed from the WeakMap. If this
latency was observable to ECMAScript program, it would be a source of
indeterminacy that could impact program execution. For that reason, an
ECMAScript implementation must not provide any means to observe a key of
a WeakMap that does not require the observer to present the observed
key.
WeakMap objects must be implemented using either hash tables or
other mechanisms that, on average, provide access times that are
sublinear on the number of key/value pairs in the collection. The data
structure used in this WeakMap objects specification are only intended
to describe the required observable semantics of WeakMap objects. It is
not intended to be a viable implementation model.
Note
WeakMap and WeakSets are intended to provide mechanisms for
dynamically associating state with an object in a manner that does not
“leak” memory resources if, in the absence of the WeakMap or WeakSet,
the object otherwise became inaccessible and subject to resource
reclamation by the implementation's garbage collection mechanisms. This
characteristic can be achieved by using an inverted per-object mapping
of weak map instances to keys. Alternatively each weak map may
internally store its key to value mappings but this approach requires
coordination between the WeakMap or WeakSet implementation and the
garbage collector. The following references describe mechanism that may
be useful to implementations of WeakMap and WeakSets:
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In
Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97)
, A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183,
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in
Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no.
21, pp. 3481-3497, 2008,
24.3.1
The WeakMap Constructor
The WeakMap
constructor
is
%WeakMap%
is the initial value of the
"WeakMap"
property of the
global object
creates and initializes a new WeakMap object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value in an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified WeakMap behaviour must include a
super
call to the WeakMap
constructor
to create and initialize the subclass instance with the internal state necessary to support the
WeakMap.prototype
built-in methods.
24.3.1.1
WeakMap ( [
iterable
] )
When the
WeakMap
function is called with optional argument
iterable
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
map
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%WeakMap.prototype%"
, « [[WeakMapData]] »).
3.
Set
map
.[[WeakMapData]] to a new empty
List
4.
If
iterable
is either
undefined
or
null
, return
map
5.
Let
adder
be ?
Get
map
"set"
).
6.
Return ?
AddEntriesFromIterable
map
iterable
adder
).
Note
If the parameter
iterable
is present, it is expected to be an object that implements an
@@iterator
method that returns an iterator object that produces a two element
array-like object
whose first element is a value that will be used as a WeakMap key and
whose second element is the value to associate with that key.
24.3.2
Properties of the WeakMap Constructor
The WeakMap
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
24.3.2.1
WeakMap.prototype
The initial value of
WeakMap.prototype
is the
WeakMap prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
24.3.3
Properties of the WeakMap Prototype Object
The
WeakMap prototype object
is
%WeakMap.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[WeakMapData]] internal slot.
24.3.3.1
WeakMap.prototype.constructor
The initial value of
WeakMap.prototype.constructor
is
%WeakMap%
24.3.3.2
WeakMap.prototype.delete (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakMapData]]).
3.
Let
entries
be the
List
that is
.[[WeakMapData]].
4.
If
Type
key
) is not Object, return
false
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValue
.[[Key]],
key
) is
true
, then
i.
Set
.[[Key]] to
empty
ii.
Set
.[[Value]] to
empty
iii.
Return
true
6.
Return
false
Note
The value
empty
is used as a
specification device to indicate that an entry has been deleted. Actual
implementations may take other actions such as physically removing the
entry from internal data structures.
24.3.3.3
WeakMap.prototype.get (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakMapData]]).
3.
Let
entries
be the
List
that is
.[[WeakMapData]].
4.
If
Type
key
) is not Object, return
undefined
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValue
.[[Key]],
key
) is
true
, return
.[[Value]].
6.
Return
undefined
24.3.3.4
WeakMap.prototype.has (
key
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakMapData]]).
3.
Let
entries
be the
List
that is
.[[WeakMapData]].
4.
If
Type
key
) is not Object, return
false
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValue
.[[Key]],
key
) is
true
, return
true
6.
Return
false
24.3.3.5
WeakMap.prototype.set (
key
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakMapData]]).
3.
Let
entries
be the
List
that is
.[[WeakMapData]].
4.
If
Type
key
) is not Object, throw a
TypeError
exception.
5.
For each
Record
{ [[Key]], [[Value]] }
of
entries
, do
a.
If
.[[Key]] is not
empty
and
SameValue
.[[Key]],
key
) is
true
, then
i.
Set
.[[Value]] to
value
ii.
Return
6.
Let
be the
Record
{ [[Key]]:
key
, [[Value]]:
value
}.
7.
Append
as the last element of
entries
8.
Return
24.3.3.6
WeakMap.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"WeakMap"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.3.4
Properties of WeakMap Instances
WeakMap instances are ordinary objects that inherit properties
from the WeakMap prototype. WeakMap instances also have a
[[WeakMapData]] internal slot.
24.4
WeakSet Objects
WeakSet objects are collections of objects. A distinct object may
only occur once as an element of a WeakSet's collection. A WeakSet may
be queried to see if it contains a specific object, but no mechanism is
provided for enumerating the objects it holds. In certain conditions,
objects which are not
live
are removed as WeakSet elements, as described in
9.9.3
An implementation may impose an arbitrarily determined latency
between the time an object contained in a WeakSet becomes inaccessible
and the time when the object is removed from the WeakSet. If this
latency was observable to ECMAScript program, it would be a source of
indeterminacy that could impact program execution. For that reason, an
ECMAScript implementation must not provide any means to determine if a
WeakSet contains a particular object that does not require the observer
to present the observed object.
WeakSet objects must be implemented using either hash tables or
other mechanisms that, on average, provide access times that are
sublinear on the number of elements in the collection. The data
structure used in this WeakSet objects specification is only intended to
describe the required observable semantics of WeakSet objects. It is
not intended to be a viable implementation model.
Note
See the NOTE in
24.3
24.4.1
The WeakSet Constructor
The WeakSet
constructor
is
%WeakSet%
is the initial value of the
"WeakSet"
property of the
global object
creates and initializes a new WeakSet object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value in an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified WeakSet behaviour must include a
super
call to the WeakSet
constructor
to create and initialize the subclass instance with the internal state necessary to support the
WeakSet.prototype
built-in methods.
24.4.1.1
WeakSet ( [
iterable
] )
When the
WeakSet
function is called with optional argument
iterable
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
set
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%WeakSet.prototype%"
, « [[WeakSetData]] »).
3.
Set
set
.[[WeakSetData]] to a new empty
List
4.
If
iterable
is either
undefined
or
null
, return
set
5.
Let
adder
be ?
Get
set
"add"
).
6.
If
IsCallable
adder
) is
false
, throw a
TypeError
exception.
7.
Let
iteratorRecord
be ?
GetIterator
iterable
).
8.
Repeat,
a.
Let
next
be ?
IteratorStep
iteratorRecord
).
b.
If
next
is
false
, return
set
c.
Let
nextValue
be ?
IteratorValue
next
).
d.
Let
status
be
Call
adder
set
, «
nextValue
»).
e.
If
status
is an
abrupt completion
, return ?
IteratorClose
iteratorRecord
status
).
24.4.2
Properties of the WeakSet Constructor
The WeakSet
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
24.4.2.1
WeakSet.prototype
The initial value of
WeakSet.prototype
is the
WeakSet prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
24.4.3
Properties of the WeakSet Prototype Object
The
WeakSet prototype object
is
%WeakSet.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[WeakSetData]] internal slot.
24.4.3.1
WeakSet.prototype.add (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakSetData]]).
3.
If
Type
value
) is not Object, throw a
TypeError
exception.
4.
Let
entries
be the
List
that is
.[[WeakSetData]].
5.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValue
value
) is
true
, then
i.
Return
6.
Append
value
as the last element of
entries
7.
Return
24.4.3.2
WeakSet.prototype.constructor
The initial value of
WeakSet.prototype.constructor
is the
%WeakSet%
intrinsic object.
24.4.3.3
WeakSet.prototype.delete (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakSetData]]).
3.
If
Type
value
) is not Object, return
false
4.
Let
entries
be the
List
that is
.[[WeakSetData]].
5.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValue
value
) is
true
, then
i.
Replace the element of
entries
whose value is
with an element whose value is
empty
ii.
Return
true
6.
Return
false
Note
The value
empty
is used as a
specification device to indicate that an entry has been deleted. Actual
implementations may take other actions such as physically removing the
entry from internal data structures.
24.4.3.4
WeakSet.prototype.has (
value
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[WeakSetData]]).
3.
Let
entries
be the
List
that is
.[[WeakSetData]].
4.
If
Type
value
) is not Object, return
false
5.
For each element
of
entries
, do
a.
If
is not
empty
and
SameValue
value
) is
true
, return
true
6.
Return
false
24.4.3.5
WeakSet.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"WeakSet"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
24.4.4
Properties of WeakSet Instances
WeakSet instances are ordinary objects that inherit properties
from the WeakSet prototype. WeakSet instances also have a
[[WeakSetData]] internal slot.
25
Structured Data
25.1
ArrayBuffer Objects
25.1.1
Notation
The descriptions below in this section,
25.4
, and
29
use the read-modify-write modification function internal data structure.
read-modify-write modification function
is a
mathematical function that is notationally represented as an abstract
closure that takes two Lists of byte values as arguments and returns a
List
of byte values. These abstract closures satisfy all of the following properties:
They perform all their algorithm steps atomically.
Their individual algorithm steps are not observable.
Note
To aid verifying that a read-modify-write modification
function's algorithm steps constitute a pure, mathematical function, the
following editorial conventions are recommended:
They do not access, directly or transitively via invoked
abstract operations
and abstract closures, any language or specification values except their parameters and captured values.
They do not return completion values.
25.1.2
Abstract Operations For ArrayBuffer Objects
25.1.2.1
AllocateArrayBuffer (
constructor
byteLength
The abstract operation AllocateArrayBuffer takes arguments
constructor
and
byteLength
(a non-negative
integer
). It is used to create an ArrayBuffer object. It performs the following steps when called:
1.
Let
obj
be ?
OrdinaryCreateFromConstructor
constructor
"%ArrayBuffer.prototype%"
, « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] »).
2.
Let
block
be ?
CreateByteDataBlock
byteLength
).
3.
Set
obj
.[[ArrayBufferData]] to
block
4.
Set
obj
.[[ArrayBufferByteLength]] to
byteLength
5.
Return
obj
25.1.2.2
IsDetachedBuffer (
arrayBuffer
The abstract operation IsDetachedBuffer takes argument
arrayBuffer
. It performs the following steps when called:
1.
Assert
Type
arrayBuffer
) is Object and it has an [[ArrayBufferData]] internal slot.
2.
If
arrayBuffer
.[[ArrayBufferData]] is
null
, return
true
3.
Return
false
25.1.2.3
DetachArrayBuffer (
arrayBuffer
[ ,
key
] )
The abstract operation DetachArrayBuffer takes argument
arrayBuffer
and optional argument
key
. It performs the following steps when called:
1.
Assert
Type
arrayBuffer
) is Object and it has [[ArrayBufferData]], [[ArrayBufferByteLength]], and [[ArrayBufferDetachKey]] internal slots.
2.
Assert
IsSharedArrayBuffer
arrayBuffer
) is
false
3.
If
key
is not present, set
key
to
undefined
4.
If
SameValue
arrayBuffer
.[[ArrayBufferDetachKey]],
key
) is
false
, throw a
TypeError
exception.
5.
Set
arrayBuffer
.[[ArrayBufferData]] to
null
6.
Set
arrayBuffer
.[[ArrayBufferByteLength]] to 0.
7.
Return
NormalCompletion
null
).
Note
Detaching an ArrayBuffer instance disassociates the
Data Block
used as its backing store from the instance and sets the byte length of
the buffer to 0. No operations defined by this specification use the
DetachArrayBuffer abstract operation. However, an ECMAScript
host
or implementation may define such operations.
25.1.2.4
CloneArrayBuffer (
srcBuffer
srcByteOffset
srcLength
cloneConstructor
The abstract operation CloneArrayBuffer takes arguments
srcBuffer
(an ArrayBuffer object),
srcByteOffset
(a non-negative
integer
),
srcLength
(a non-negative
integer
), and
cloneConstructor
(a
constructor
). It creates a new ArrayBuffer whose data is a copy of
srcBuffer
's data over the range starting at
srcByteOffset
and continuing for
srcLength
bytes. It performs the following steps when called:
1.
Assert
Type
srcBuffer
) is Object and it has an [[ArrayBufferData]] internal slot.
2.
Assert
IsConstructor
cloneConstructor
) is
true
3.
Let
targetBuffer
be ?
AllocateArrayBuffer
cloneConstructor
srcLength
).
4.
If
IsDetachedBuffer
srcBuffer
) is
true
, throw a
TypeError
exception.
5.
Let
srcBlock
be
srcBuffer
.[[ArrayBufferData]].
6.
Let
targetBlock
be
targetBuffer
.[[ArrayBufferData]].
7.
Perform
CopyDataBlockBytes
targetBlock
, 0,
srcBlock
srcByteOffset
srcLength
).
8.
Return
targetBuffer
25.1.2.5
IsUnsignedElementType (
type
The abstract operation IsUnsignedElementType takes argument
type
. It verifies if the argument
type
is an unsigned
TypedArray element type
. It performs the following steps when called:
1.
If
type
is
Uint8
Uint8C
Uint16
Uint32
, or
BigUint64
, return
true
2.
Return
false
25.1.2.6
IsUnclampedIntegerElementType (
type
The abstract operation IsUnclampedIntegerElementType takes argument
type
. It verifies if the argument
type
is an
Integer
TypedArray element type
not including
Uint8C
. It performs the following steps when called:
1.
If
type
is
Int8
Uint8
Int16
Uint16
Int32
, or
Uint32
, return
true
2.
Return
false
25.1.2.7
IsBigIntElementType (
type
The abstract operation IsBigIntElementType takes argument
type
. It verifies if the argument
type
is a BigInt
TypedArray element type
. It performs the following steps when called:
1.
If
type
is
BigUint64
or
BigInt64
, return
true
2.
Return
false
25.1.2.8
IsNoTearConfiguration (
type
order
The abstract operation IsNoTearConfiguration takes arguments
type
and
order
. It performs the following steps when called:
1.
If !
IsUnclampedIntegerElementType
type
) is
true
, return
true
2.
If !
IsBigIntElementType
type
) is
true
and
order
is not
Init
or
Unordered
, return
true
3.
Return
false
25.1.2.9
RawBytesToNumeric (
type
rawBytes
isLittleEndian
The abstract operation RawBytesToNumeric takes arguments
type
(a
TypedArray element type
),
rawBytes
(a
List
), and
isLittleEndian
(a Boolean). It performs the following steps when called:
1.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
2.
If
isLittleEndian
is
false
, reverse the order of the elements of
rawBytes
3.
If
type
is
Float32
, then
a.
Let
value
be the byte elements of
rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
IEEE 754-2019
binary32 value.
b.
If
value
is an
IEEE 754-2019
binary32 NaN value, return the
NaN
Number value
c.
Return the
Number value
that corresponds to
value
4.
If
type
is
Float64
, then
a.
Let
value
be the byte elements of
rawBytes
concatenated and interpreted as a little-endian bit string encoding of an
IEEE 754-2019
binary64 value.
b.
If
value
is an
IEEE 754-2019
binary64 NaN value, return the
NaN
Number value
c.
Return the
Number value
that corresponds to
value
5.
If !
IsUnsignedElementType
type
) is
true
, then
a.
Let
intValue
be the byte elements of
rawBytes
concatenated and interpreted as a bit string encoding of an unsigned little-endian binary number.
6.
Else,
a.
Let
intValue
be the byte elements of
rawBytes
concatenated and interpreted as a bit string encoding of a binary little-endian two's complement number of bit length
elementSize
× 8.
7.
If !
IsBigIntElementType
type
) is
true
, return the BigInt value that corresponds to
intValue
8.
Otherwise, return the
Number value
that corresponds to
intValue
25.1.2.10
GetValueFromBuffer (
arrayBuffer
byteIndex
type
isTypedArray
order
[ ,
isLittleEndian
] )
The abstract operation GetValueFromBuffer takes arguments
arrayBuffer
(an ArrayBuffer or SharedArrayBuffer),
byteIndex
(a non-negative
integer
),
type
(a
TypedArray element type
),
isTypedArray
(a Boolean), and
order
(either
SeqCst
or
Unordered
) and optional argument
isLittleEndian
(a Boolean). It performs the following steps when called:
1.
Assert
IsDetachedBuffer
arrayBuffer
) is
false
2.
Assert
: There are sufficient bytes in
arrayBuffer
starting at
byteIndex
to represent a value of
type
3.
Let
block
be
arrayBuffer
.[[ArrayBufferData]].
4.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
5.
If
IsSharedArrayBuffer
arrayBuffer
) is
true
, then
a.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
b.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
c.
If
isTypedArray
is
true
and
IsNoTearConfiguration
type
order
) is
true
, let
noTear
be
true
; otherwise let
noTear
be
false
d.
Let
rawValue
be a
List
of length
elementSize
whose elements are nondeterministically chosen byte values.
e.
NOTE: In implementations,
rawValue
is the result of a non-atomic or atomic read instruction on the
underlying hardware. The nondeterminism is a semantic prescription of
the
memory model
to describe observable behaviour of hardware with weak consistency.
f.
Let
readEvent
be
ReadSharedMemory
{ [[Order]]:
order
, [[NoTear]]:
noTear
, [[Block]]:
block
, [[ByteIndex]]:
byteIndex
, [[ElementSize]]:
elementSize
}.
g.
Append
readEvent
to
eventList
h.
Append
Chosen Value Record
{ [[Event]]:
readEvent
, [[ChosenValue]]:
rawValue
} to
execution
.[[ChosenValues]].
6.
Else, let
rawValue
be a
List
whose elements are bytes from
block
at indices
byteIndex
(inclusive) through
byteIndex
elementSize
(exclusive).
7.
Assert
: The number of elements in
rawValue
is
elementSize
8.
If
isLittleEndian
is not present, set
isLittleEndian
to the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
9.
Return
RawBytesToNumeric
type
rawValue
isLittleEndian
).
25.1.2.11
NumericToRawBytes (
type
value
isLittleEndian
The abstract operation NumericToRawBytes takes arguments
type
(a
TypedArray element type
),
value
(a BigInt or a Number), and
isLittleEndian
(a Boolean). It performs the following steps when called:
1.
If
type
is
Float32
, then
a.
Let
rawBytes
be a
List
whose elements are the 4 bytes that are the result of converting
value
to
IEEE 754-2019
binary32 format using roundTiesToEven mode. If
isLittleEndian
is
false
, the bytes are arranged in big endian order. Otherwise, the bytes are arranged in little endian order. If
value
is
NaN
rawBytes
may be set to any implementation chosen
IEEE 754-2019
binary32 format Not-a-Number encoding. An implementation must always
choose the same encoding for each implementation distinguishable
NaN
value.
2.
Else if
type
is
Float64
, then
a.
Let
rawBytes
be a
List
whose elements are the 8 bytes that are the
IEEE 754-2019
binary64 format encoding of
value
. If
isLittleEndian
is
false
, the bytes are arranged in big endian order. Otherwise, the bytes are arranged in little endian order. If
value
is
NaN
rawBytes
may be set to any implementation chosen
IEEE 754-2019
binary64 format Not-a-Number encoding. An implementation must always
choose the same encoding for each implementation distinguishable
NaN
value.
3.
Else,
a.
Let
be the Element Size value specified in
Table 60
for Element Type
type
b.
Let
convOp
be the abstract operation named in the Conversion Operation column in
Table 60
for Element Type
type
c.
Let
intValue
be
convOp
value
)).
d.
If
intValue
≥ 0, then
i.
Let
rawBytes
be a
List
whose elements are the
-byte binary encoding of
intValue
. If
isLittleEndian
is
false
, the bytes are ordered in big endian order. Otherwise, the bytes are ordered in little endian order.
e.
Else,
i.
Let
rawBytes
be a
List
whose elements are the
-byte binary two's complement encoding of
intValue
. If
isLittleEndian
is
false
, the bytes are ordered in big endian order. Otherwise, the bytes are ordered in little endian order.
4.
Return
rawBytes
25.1.2.12
SetValueInBuffer (
arrayBuffer
byteIndex
type
value
isTypedArray
order
[ ,
isLittleEndian
] )
The abstract operation SetValueInBuffer takes arguments
arrayBuffer
(an ArrayBuffer or SharedArrayBuffer),
byteIndex
(a non-negative
integer
),
type
(a
TypedArray element type
),
value
(a Number or a BigInt),
isTypedArray
(a Boolean), and
order
(one of
SeqCst
Unordered
, or
Init
) and optional argument
isLittleEndian
(a Boolean). It performs the following steps when called:
1.
Assert
IsDetachedBuffer
arrayBuffer
) is
false
2.
Assert
: There are sufficient bytes in
arrayBuffer
starting at
byteIndex
to represent a value of
type
3.
Assert
Type
value
) is BigInt if !
IsBigIntElementType
type
) is
true
; otherwise,
Type
value
) is Number.
4.
Let
block
be
arrayBuffer
.[[ArrayBufferData]].
5.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
6.
If
isLittleEndian
is not present, set
isLittleEndian
to the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
7.
Let
rawBytes
be
NumericToRawBytes
type
value
isLittleEndian
).
8.
If
IsSharedArrayBuffer
arrayBuffer
) is
true
, then
a.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
b.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
c.
If
isTypedArray
is
true
and
IsNoTearConfiguration
type
order
) is
true
, let
noTear
be
true
; otherwise let
noTear
be
false
d.
Append
WriteSharedMemory
{ [[Order]]:
order
, [[NoTear]]:
noTear
, [[Block]]:
block
, [[ByteIndex]]:
byteIndex
, [[ElementSize]]:
elementSize
, [[Payload]]:
rawBytes
} to
eventList
9.
Else, store the individual bytes of
rawBytes
into
block
, starting at
block
byteIndex
].
10.
Return
NormalCompletion
undefined
).
25.1.2.13
GetModifySetValueInBuffer (
arrayBuffer
byteIndex
type
value
op
[ ,
isLittleEndian
] )
The abstract operation GetModifySetValueInBuffer takes arguments
arrayBuffer
(an ArrayBuffer object or a SharedArrayBuffer object),
byteIndex
(a non-negative
integer
),
type
(a
TypedArray element type
),
value
(a Number or a BigInt), and
op
(a
read-modify-write modification function
) and optional argument
isLittleEndian
(a Boolean). It performs the following steps when called:
1.
Assert
IsDetachedBuffer
arrayBuffer
) is
false
2.
Assert
: There are sufficient bytes in
arrayBuffer
starting at
byteIndex
to represent a value of
type
3.
Assert
Type
value
) is BigInt if !
IsBigIntElementType
type
) is
true
; otherwise,
Type
value
) is Number.
4.
Let
block
be
arrayBuffer
.[[ArrayBufferData]].
5.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
6.
If
isLittleEndian
is not present, set
isLittleEndian
to the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
7.
Let
rawBytes
be
NumericToRawBytes
type
value
isLittleEndian
).
8.
If
IsSharedArrayBuffer
arrayBuffer
) is
true
, then
a.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
b.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
c.
Let
rawBytesRead
be a
List
of length
elementSize
whose elements are nondeterministically chosen byte values.
d.
NOTE: In implementations,
rawBytesRead
is the result of a load-link, of a load-exclusive, or of an operand of a
read-modify-write instruction on the underlying hardware. The
nondeterminism is a semantic prescription of the
memory model
to describe observable behaviour of hardware with weak consistency.
e.
Let
rmwEvent
be
ReadModifyWriteSharedMemory
{ [[Order]]:
SeqCst
, [[NoTear]]:
true
, [[Block]]:
block
, [[ByteIndex]]:
byteIndex
, [[ElementSize]]:
elementSize
, [[Payload]]:
rawBytes
, [[ModifyOp]]:
op
}.
f.
Append
rmwEvent
to
eventList
g.
Append
Chosen Value Record
{ [[Event]]:
rmwEvent
, [[ChosenValue]]:
rawBytesRead
} to
execution
.[[ChosenValues]].
9.
Else,
a.
Let
rawBytesRead
be a
List
of length
elementSize
whose elements are the sequence of
elementSize
bytes starting with
block
byteIndex
].
b.
Let
rawBytesModified
be
op
rawBytesRead
rawBytes
).
c.
Store the individual bytes of
rawBytesModified
into
block
, starting at
block
byteIndex
].
10.
Return
RawBytesToNumeric
type
rawBytesRead
isLittleEndian
).
25.1.3
The ArrayBuffer Constructor
The ArrayBuffer
constructor
is
%ArrayBuffer%
is the initial value of the
"ArrayBuffer"
property of the
global object
creates and initializes a new ArrayBuffer object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified ArrayBuffer behaviour must include a
super
call to the ArrayBuffer
constructor
to create and initialize subclass instances with the internal state necessary to support the
ArrayBuffer.prototype
built-in methods.
25.1.3.1
ArrayBuffer (
length
When the
ArrayBuffer
function is called with argument
length
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
byteLength
be ?
ToIndex
length
).
3.
Return ?
AllocateArrayBuffer
(NewTarget,
byteLength
).
25.1.4
Properties of the ArrayBuffer Constructor
The ArrayBuffer
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
25.1.4.1
ArrayBuffer.isView (
arg
The
isView
function takes one argument
arg
, and performs the following steps:
1.
If
Type
arg
) is not Object, return
false
2.
If
arg
has a [[ViewedArrayBuffer]] internal slot, return
true
3.
Return
false
25.1.4.2
ArrayBuffer.prototype
The initial value of
ArrayBuffer.prototype
is the
ArrayBuffer prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
25.1.4.3
get ArrayBuffer [ @@species ]
ArrayBuffer[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
Note
ArrayBuffer prototype methods normally use their
this
value's
constructor
to create a derived object. However, a subclass
constructor
may over-ride that default behaviour by redefining its
@@species
property.
25.1.5
Properties of the ArrayBuffer Prototype Object
The
ArrayBuffer prototype object
is
%ArrayBuffer.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have an [[ArrayBufferData]] or [[ArrayBufferByteLength]] internal slot.
25.1.5.1
get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLength
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[ArrayBufferData]]).
3.
If
IsSharedArrayBuffer
) is
true
, throw a
TypeError
exception.
4.
If
IsDetachedBuffer
) is
true
, return
+0
5.
Let
length
be
.[[ArrayBufferByteLength]].
6.
Return
length
).
25.1.5.2
ArrayBuffer.prototype.constructor
The initial value of
ArrayBuffer.prototype.constructor
is
%ArrayBuffer%
25.1.5.3
ArrayBuffer.prototype.slice (
start
end
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[ArrayBufferData]]).
3.
If
IsSharedArrayBuffer
) is
true
, throw a
TypeError
exception.
4.
If
IsDetachedBuffer
) is
true
, throw a
TypeError
exception.
5.
Let
len
be
.[[ArrayBufferByteLength]].
6.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
7.
If
relativeStart
is -∞, let
first
be 0.
8.
Else if
relativeStart
< 0, let
first
be
max
len
relativeStart
, 0).
9.
Else, let
first
be
min
relativeStart
len
).
10.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
11.
If
relativeEnd
is -∞, let
final
be 0.
12.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
13.
Else, let
final
be
min
relativeEnd
len
).
14.
Let
newLen
be
max
final
first
, 0).
15.
Let
ctor
be ?
SpeciesConstructor
%ArrayBuffer%
).
16.
Let
new
be ?
Construct
ctor
, «
newLen
) »).
17.
Perform ?
RequireInternalSlot
new
, [[ArrayBufferData]]).
18.
If
IsSharedArrayBuffer
new
) is
true
, throw a
TypeError
exception.
19.
If
IsDetachedBuffer
new
) is
true
, throw a
TypeError
exception.
20.
If
SameValue
new
) is
true
, throw a
TypeError
exception.
21.
If
new
.[[ArrayBufferByteLength]] <
newLen
, throw a
TypeError
exception.
22.
NOTE: Side-effects of the above steps may have detached
23.
If
IsDetachedBuffer
) is
true
, throw a
TypeError
exception.
24.
Let
fromBuf
be
.[[ArrayBufferData]].
25.
Let
toBuf
be
new
.[[ArrayBufferData]].
26.
Perform
CopyDataBlockBytes
toBuf
, 0,
fromBuf
first
newLen
).
27.
Return
new
25.1.5.4
ArrayBuffer.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"ArrayBuffer"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
25.1.6
Properties of ArrayBuffer Instances
ArrayBuffer instances inherit properties from the
ArrayBuffer prototype object
ArrayBuffer instances each have an [[ArrayBufferData]] internal slot,
an [[ArrayBufferByteLength]] internal slot, and an
[[ArrayBufferDetachKey]] internal slot.
ArrayBuffer instances whose [[ArrayBufferData]] is
null
are considered to be detached and all operators to access or modify data contained in the ArrayBuffer instance will fail.
ArrayBuffer instances whose [[ArrayBufferDetachKey]] is set to a value other than
undefined
need to have all
DetachArrayBuffer
calls passing that same "detach key" as an argument, otherwise a
TypeError will result. This internal slot is only ever set by certain
embedding environments, not by algorithms in this specification.
25.2
SharedArrayBuffer Objects
25.2.1
Abstract Operations for SharedArrayBuffer Objects
25.2.1.1
AllocateSharedArrayBuffer (
constructor
byteLength
The abstract operation AllocateSharedArrayBuffer takes arguments
constructor
and
byteLength
(a non-negative
integer
). It is used to create a SharedArrayBuffer object. It performs the following steps when called:
1.
Let
obj
be ?
OrdinaryCreateFromConstructor
constructor
"%SharedArrayBuffer.prototype%"
, « [[ArrayBufferData]], [[ArrayBufferByteLength]] »).
2.
Let
block
be ?
CreateSharedByteDataBlock
byteLength
).
3.
Set
obj
.[[ArrayBufferData]] to
block
4.
Set
obj
.[[ArrayBufferByteLength]] to
byteLength
5.
Return
obj
25.2.1.2
IsSharedArrayBuffer (
obj
The abstract operation IsSharedArrayBuffer takes argument
obj
It tests whether an object is an ArrayBuffer, a SharedArrayBuffer, or a
subtype of either. It performs the following steps when called:
1.
Assert
Type
obj
) is Object and it has an [[ArrayBufferData]] internal slot.
2.
Let
bufferData
be
obj
.[[ArrayBufferData]].
3.
If
bufferData
is
null
, return
false
4.
If
bufferData
is a
Data Block
, return
false
5.
Assert
bufferData
is a
Shared Data Block
6.
Return
true
25.2.2
The SharedArrayBuffer Constructor
The SharedArrayBuffer
constructor
is
%SharedArrayBuffer%
is the initial value of the
"SharedArrayBuffer"
property of the
global object
, if that property is present (see below).
creates and initializes a new SharedArrayBuffer object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to
inherit the specified SharedArrayBuffer behaviour must include a
super
call to the SharedArrayBuffer
constructor
to create and initialize subclass instances with the internal state necessary to support the
SharedArrayBuffer.prototype
built-in methods.
Whenever a
host
does not provide concurrent access to SharedArrayBuffer objects it may omit the
"SharedArrayBuffer"
property of the
global object
Note
Unlike an
ArrayBuffer
, a
SharedArrayBuffer
cannot become detached, and its internal [[ArrayBufferData]] slot is never
null
25.2.2.1
SharedArrayBuffer ( [
length
] )
When the
SharedArrayBuffer
function is called with optional argument
length
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Let
byteLength
be ?
ToIndex
length
).
3.
Return ?
AllocateSharedArrayBuffer
(NewTarget,
byteLength
).
25.2.3
Properties of the SharedArrayBuffer Constructor
The SharedArrayBuffer
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
25.2.3.1
SharedArrayBuffer.prototype
The initial value of
SharedArrayBuffer.prototype
is the
SharedArrayBuffer prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
25.2.3.2
get SharedArrayBuffer [ @@species ]
SharedArrayBuffer[@@species]
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Return the
this
value.
The value of the
"name"
property of this function is
"get [Symbol.species]"
25.2.4
Properties of the SharedArrayBuffer Prototype Object
The
SharedArrayBuffer prototype object
is
%SharedArrayBuffer.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have an [[ArrayBufferData]] or [[ArrayBufferByteLength]] internal slot.
25.2.4.1
get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLength
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[ArrayBufferData]]).
3.
If
IsSharedArrayBuffer
) is
false
, throw a
TypeError
exception.
4.
Let
length
be
.[[ArrayBufferByteLength]].
5.
Return
length
).
25.2.4.2
SharedArrayBuffer.prototype.constructor
The initial value of
SharedArrayBuffer.prototype.constructor
is
%SharedArrayBuffer%
25.2.4.3
SharedArrayBuffer.prototype.slice (
start
end
The following steps are taken:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[ArrayBufferData]]).
3.
If
IsSharedArrayBuffer
) is
false
, throw a
TypeError
exception.
4.
Let
len
be
.[[ArrayBufferByteLength]].
5.
Let
relativeStart
be ?
ToIntegerOrInfinity
start
).
6.
If
relativeStart
is -∞, let
first
be 0.
7.
Else if
relativeStart
< 0, let
first
be
max
len
relativeStart
, 0).
8.
Else, let
first
be
min
relativeStart
len
).
9.
If
end
is
undefined
, let
relativeEnd
be
len
; else let
relativeEnd
be ?
ToIntegerOrInfinity
end
).
10.
If
relativeEnd
is -∞, let
final
be 0.
11.
Else if
relativeEnd
< 0, let
final
be
max
len
relativeEnd
, 0).
12.
Else, let
final
be
min
relativeEnd
len
).
13.
Let
newLen
be
max
final
first
, 0).
14.
Let
ctor
be ?
SpeciesConstructor
%SharedArrayBuffer%
).
15.
Let
new
be ?
Construct
ctor
, «
newLen
) »).
16.
Perform ?
RequireInternalSlot
new
, [[ArrayBufferData]]).
17.
If
IsSharedArrayBuffer
new
) is
false
, throw a
TypeError
exception.
18.
If
new
.[[ArrayBufferData]] and
.[[ArrayBufferData]] are the same
Shared Data Block
values, throw a
TypeError
exception.
19.
If
new
.[[ArrayBufferByteLength]] <
newLen
, throw a
TypeError
exception.
20.
Let
fromBuf
be
.[[ArrayBufferData]].
21.
Let
toBuf
be
new
.[[ArrayBufferData]].
22.
Perform
CopyDataBlockBytes
toBuf
, 0,
fromBuf
first
newLen
).
23.
Return
new
25.2.4.4
SharedArrayBuffer.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"SharedArrayBuffer"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
25.2.5
Properties of SharedArrayBuffer Instances
SharedArrayBuffer instances inherit properties from the
SharedArrayBuffer prototype object
. SharedArrayBuffer instances each have an [[ArrayBufferData]] internal slot and an [[ArrayBufferByteLength]] internal slot.
Note
SharedArrayBuffer instances, unlike ArrayBuffer instances, are never detached.
25.3
DataView Objects
25.3.1
Abstract Operations For DataView Objects
25.3.1.1
GetViewValue (
view
requestIndex
isLittleEndian
type
The abstract operation GetViewValue takes arguments
view
requestIndex
isLittleEndian
, and
type
It is used by functions on DataView instances to retrieve values from
the view's buffer. It performs the following steps when called:
1.
Perform ?
RequireInternalSlot
view
, [[DataView]]).
2.
Assert
view
has a [[ViewedArrayBuffer]] internal slot.
3.
Let
getIndex
be ?
ToIndex
requestIndex
).
4.
Set
isLittleEndian
to !
ToBoolean
isLittleEndian
).
5.
Let
buffer
be
view
.[[ViewedArrayBuffer]].
6.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
7.
Let
viewOffset
be
view
.[[ByteOffset]].
8.
Let
viewSize
be
view
.[[ByteLength]].
9.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
10.
If
getIndex
elementSize
viewSize
, throw a
RangeError
exception.
11.
Let
bufferIndex
be
getIndex
viewOffset
12.
Return
GetValueFromBuffer
buffer
bufferIndex
type
false
Unordered
isLittleEndian
).
25.3.1.2
SetViewValue (
view
requestIndex
isLittleEndian
type
value
The abstract operation SetViewValue takes arguments
view
requestIndex
isLittleEndian
type
, and
value
It is used by functions on DataView instances to store values into the
view's buffer. It performs the following steps when called:
1.
Perform ?
RequireInternalSlot
view
, [[DataView]]).
2.
Assert
view
has a [[ViewedArrayBuffer]] internal slot.
3.
Let
getIndex
be ?
ToIndex
requestIndex
).
4.
If !
IsBigIntElementType
type
) is
true
, let
numberValue
be ?
ToBigInt
value
).
5.
Otherwise, let
numberValue
be ?
ToNumber
value
).
6.
Set
isLittleEndian
to !
ToBoolean
isLittleEndian
).
7.
Let
buffer
be
view
.[[ViewedArrayBuffer]].
8.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
9.
Let
viewOffset
be
view
.[[ByteOffset]].
10.
Let
viewSize
be
view
.[[ByteLength]].
11.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
type
12.
If
getIndex
elementSize
viewSize
, throw a
RangeError
exception.
13.
Let
bufferIndex
be
getIndex
viewOffset
14.
Return
SetValueInBuffer
buffer
bufferIndex
type
numberValue
false
Unordered
isLittleEndian
).
25.3.2
The DataView Constructor
The DataView
constructor
is
%DataView%
is the initial value of the
"DataView"
property of the
global object
creates and initializes a new DataView object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value of an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified DataView behaviour must include a
super
call to the DataView
constructor
to create and initialize subclass instances with the internal state necessary to support the
DataView.prototype
built-in methods.
25.3.2.1
DataView (
buffer
[ ,
byteOffset
[ ,
byteLength
] ] )
When the
DataView
function is called with at least one argument
buffer
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
Perform ?
RequireInternalSlot
buffer
, [[ArrayBufferData]]).
3.
Let
offset
be ?
ToIndex
byteOffset
).
4.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
5.
Let
bufferByteLength
be
buffer
.[[ArrayBufferByteLength]].
6.
If
offset
bufferByteLength
, throw a
RangeError
exception.
7.
If
byteLength
is
undefined
, then
a.
Let
viewByteLength
be
bufferByteLength
offset
8.
Else,
a.
Let
viewByteLength
be ?
ToIndex
byteLength
).
b.
If
offset
viewByteLength
bufferByteLength
, throw a
RangeError
exception.
9.
Let
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%DataView.prototype%"
, « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] »).
10.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
11.
Set
.[[ViewedArrayBuffer]] to
buffer
12.
Set
.[[ByteLength]] to
viewByteLength
13.
Set
.[[ByteOffset]] to
offset
14.
Return
25.3.3
Properties of the DataView Constructor
The DataView
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
25.3.3.1
DataView.prototype
The initial value of
DataView.prototype
is the
DataView prototype object
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
25.3.4
Properties of the DataView Prototype Object
The
DataView prototype object
is
%DataView.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], or [[ByteOffset]] internal slot.
25.3.4.1
get DataView.prototype.buffer
DataView.prototype.buffer
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[DataView]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
Return
buffer
25.3.4.2
get DataView.prototype.byteLength
DataView.prototype.byteLength
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[DataView]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
6.
Let
size
be
.[[ByteLength]].
7.
Return
size
).
25.3.4.3
get DataView.prototype.byteOffset
DataView.prototype.byteOffset
is an
accessor property
whose set accessor function is
undefined
. Its get accessor function performs the following steps:
1.
Let
be the
this
value.
2.
Perform ?
RequireInternalSlot
, [[DataView]]).
3.
Assert
has a [[ViewedArrayBuffer]] internal slot.
4.
Let
buffer
be
.[[ViewedArrayBuffer]].
5.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
6.
Let
offset
be
.[[ByteOffset]].
7.
Return
offset
).
25.3.4.4
DataView.prototype.constructor
The initial value of
DataView.prototype.constructor
is
%DataView%
25.3.4.5
DataView.prototype.getBigInt64 (
byteOffset
[ ,
littleEndian
] )
When the
getBigInt64
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
GetViewValue
byteOffset
littleEndian
BigInt64
).
25.3.4.6
DataView.prototype.getBigUint64 (
byteOffset
[ ,
littleEndian
] )
When the
getBigUint64
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
GetViewValue
byteOffset
littleEndian
BigUint64
).
25.3.4.7
DataView.prototype.getFloat32 (
byteOffset
[ ,
littleEndian
] )
When the
getFloat32
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Float32
).
25.3.4.8
DataView.prototype.getFloat64 (
byteOffset
[ ,
littleEndian
] )
When the
getFloat64
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Float64
).
25.3.4.9
DataView.prototype.getInt8 (
byteOffset
When the
getInt8
method is called with argument
byteOffset
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
GetViewValue
byteOffset
true
Int8
).
25.3.4.10
DataView.prototype.getInt16 (
byteOffset
[ ,
littleEndian
] )
When the
getInt16
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Int16
).
25.3.4.11
DataView.prototype.getInt32 (
byteOffset
[ ,
littleEndian
] )
When the
getInt32
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Int32
).
25.3.4.12
DataView.prototype.getUint8 (
byteOffset
When the
getUint8
method is called with argument
byteOffset
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
GetViewValue
byteOffset
true
Uint8
).
25.3.4.13
DataView.prototype.getUint16 (
byteOffset
[ ,
littleEndian
] )
When the
getUint16
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Uint16
).
25.3.4.14
DataView.prototype.getUint32 (
byteOffset
[ ,
littleEndian
] )
When the
getUint32
method is called with argument
byteOffset
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
GetViewValue
byteOffset
littleEndian
Uint32
).
25.3.4.15
DataView.prototype.setBigInt64 (
byteOffset
value
[ ,
littleEndian
] )
When the
setBigInt64
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
SetViewValue
byteOffset
littleEndian
BigInt64
value
).
25.3.4.16
DataView.prototype.setBigUint64 (
byteOffset
value
[ ,
littleEndian
] )
When the
setBigUint64
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
SetViewValue
byteOffset
littleEndian
BigUint64
value
).
25.3.4.17
DataView.prototype.setFloat32 (
byteOffset
value
[ ,
littleEndian
] )
When the
setFloat32
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Float32
value
).
25.3.4.18
DataView.prototype.setFloat64 (
byteOffset
value
[ ,
littleEndian
] )
When the
setFloat64
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Float64
value
).
25.3.4.19
DataView.prototype.setInt8 (
byteOffset
value
When the
setInt8
method is called with arguments
byteOffset
and
value
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
SetViewValue
byteOffset
true
Int8
value
).
25.3.4.20
DataView.prototype.setInt16 (
byteOffset
value
[ ,
littleEndian
] )
When the
setInt16
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Int16
value
).
25.3.4.21
DataView.prototype.setInt32 (
byteOffset
value
[ ,
littleEndian
] )
When the
setInt32
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Int32
value
).
25.3.4.22
DataView.prototype.setUint8 (
byteOffset
value
When the
setUint8
method is called with arguments
byteOffset
and
value
, the following steps are taken:
1.
Let
be the
this
value.
2.
Return ?
SetViewValue
byteOffset
true
Uint8
value
).
25.3.4.23
DataView.prototype.setUint16 (
byteOffset
value
[ ,
littleEndian
] )
When the
setUint16
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Uint16
value
).
25.3.4.24
DataView.prototype.setUint32 (
byteOffset
value
[ ,
littleEndian
] )
When the
setUint32
method is called with arguments
byteOffset
and
value
and optional argument
littleEndian
, the following steps are taken:
1.
Let
be the
this
value.
2.
If
littleEndian
is not present, set
littleEndian
to
false
3.
Return ?
SetViewValue
byteOffset
littleEndian
Uint32
value
).
25.3.4.25
DataView.prototype [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"DataView"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
25.3.5
Properties of DataView Instances
DataView instances are ordinary objects that inherit properties from the
DataView prototype object
. DataView instances each have [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], and [[ByteOffset]] internal slots.
Note
The value of the [[DataView]] internal slot is not used
within this specification. The simple presence of that internal slot is
used within the specification to identify objects created using the
DataView
constructor
25.4
The Atomics Object
The Atomics object:
is
%Atomics%
is the initial value of the
"Atomics"
property of the
global object
is an
ordinary object
has a [[Prototype]] internal slot whose value is
%Object.prototype%
does not have a [[Construct]] internal method; it cannot be used as a
constructor
with the
new
operator.
does not have a [[Call]] internal method; it cannot be invoked as a function.
The Atomics object provides functions that operate indivisibly
(atomically) on shared memory array cells as well as functions that let
agents wait for and dispatch primitive events. When used with
discipline, the Atomics functions allow multi-
agent
programs that communicate through shared memory to execute in a
well-understood order even on parallel CPUs. The rules that govern
shared-memory communication are provided by the
memory model
, defined below.
Note
For informative guidelines for programming and implementing shared memory in ECMAScript, please see the notes at the end of the
memory model
section.
25.4.1
Abstract Operations for Atomics
25.4.1.1
ValidateIntegerTypedArray (
typedArray
[ ,
waitable
] )
The abstract operation ValidateIntegerTypedArray takes argument
typedArray
and optional argument
waitable
(a Boolean). It performs the following steps when called:
1.
If
waitable
is not present, set
waitable
to
false
2.
Let
buffer
be ?
ValidateTypedArray
typedArray
).
3.
Let
typeName
be
typedArray
.[[TypedArrayName]].
4.
Let
type
be the Element Type value in
Table 60
for
typeName
5.
If
waitable
is
true
, then
a.
If
typeName
is not
"Int32Array"
or
"BigInt64Array"
, throw a
TypeError
exception.
6.
Else,
a.
If !
IsUnclampedIntegerElementType
type
) is
false
and !
IsBigIntElementType
type
) is
false
, throw a
TypeError
exception.
7.
Return
buffer
25.4.1.2
ValidateAtomicAccess (
typedArray
requestIndex
The abstract operation ValidateAtomicAccess takes arguments
typedArray
and
requestIndex
. It performs the following steps when called:
1.
Assert
typedArray
is an Object that has a [[ViewedArrayBuffer]] internal slot.
2.
Let
length
be
typedArray
.[[ArrayLength]].
3.
Let
accessIndex
be ?
ToIndex
requestIndex
).
4.
Assert
accessIndex
≥ 0.
5.
If
accessIndex
length
, throw a
RangeError
exception.
6.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
7.
Let
elementSize
be the Element Size value specified in
Table 60
for
arrayTypeName
8.
Let
offset
be
typedArray
.[[ByteOffset]].
9.
Return (
accessIndex
elementSize
) +
offset
25.4.1.3
GetWaiterList (
block
WaiterList
is a semantic object that contains an ordered list of those agents that are waiting on a location (
block
) in shared memory;
block
is a
Shared Data Block
and
a byte offset into the memory of
block
. A WaiterList object also optionally contains a
Synchronize event
denoting the previous leaving of its critical section.
Initially a WaiterList object has an empty list and no
Synchronize event
The
agent cluster
has a store of WaiterList objects; the store is indexed by (
block
). WaiterLists are
agent
-independent: a lookup in the store of WaiterLists by (
block
) will result in the same WaiterList object in any
agent
in the
agent cluster
Each WaiterList has a
critical section
that controls exclusive access to that WaiterList during evaluation. Only a single
agent
may enter a WaiterList's critical section at one time. Entering and
leaving a WaiterList's critical section is controlled by the
abstract operations
EnterCriticalSection
and
LeaveCriticalSection
Operations on a WaiterList—adding and removing waiting agents,
traversing the list of agents, suspending and notifying agents on the
list, setting and retrieving the
Synchronize event
—may only be performed by agents that have entered the WaiterList's critical section.
The abstract operation GetWaiterList takes arguments
block
(a
Shared Data Block
) and
(a non-negative
integer
). It performs the following steps when called:
1.
Assert
block
is a
Shared Data Block
2.
Assert
and
+ 3 are valid byte offsets within the memory of
block
3.
Assert
is divisible by 4.
4.
Return the
WaiterList
that is referenced by the pair (
block
).
25.4.1.4
EnterCriticalSection (
WL
The abstract operation EnterCriticalSection takes argument
WL
(a
WaiterList
). It performs the following steps when called:
1.
Assert
: The calling
agent
is not in the
critical section
for any
WaiterList
2.
Wait until no
agent
is in the
critical section
for
WL
, then enter the
critical section
for
WL
(without allowing any other
agent
to enter).
3.
If
WL
has a
Synchronize event
, then
a.
NOTE: A
WL
whose
critical section
has been entered at least once has a
Synchronize event
set by
LeaveCriticalSection
b.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
c.
Let
eventsRecord
be the
Agent Events Record
in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
d.
Let
entererEventList
be
eventsRecord
.[[EventList]].
e.
Let
enterEvent
be a new
Synchronize event
f.
Append
enterEvent
to
entererEventList
g.
Let
leaveEvent
be the
Synchronize event
in
WL
h.
Append (
leaveEvent
enterEvent
) to
eventsRecord
.[[AgentSynchronizesWith]].
EnterCriticalSection has
contention
when an
agent
attempting to enter the
critical section
must wait for another
agent
to leave it. When there is no contention, FIFO order of
EnterCriticalSection calls is observable. When there is contention, an
implementation may choose an arbitrary order but may not cause an
agent
to wait indefinitely.
25.4.1.5
LeaveCriticalSection (
WL
The abstract operation LeaveCriticalSection takes argument
WL
(a
WaiterList
). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Let
execution
be the [[CandidateExecution]] field of the calling surrounding's
Agent Record
3.
Let
eventsRecord
be the
Agent Events Record
in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
4.
Let
leaverEventList
be
eventsRecord
.[[EventList]].
5.
Let
leaveEvent
be a new
Synchronize event
6.
Append
leaveEvent
to
leaverEventList
7.
Set the
Synchronize event
in
WL
to
leaveEvent
8.
Leave the
critical section
for
WL
25.4.1.6
AddWaiter (
WL
The abstract operation AddWaiter takes arguments
WL
(a
WaiterList
) and
(an
agent
signifier). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Assert
is not on the list of waiters in any
WaiterList
3.
Add
to the end of the list of waiters in
WL
25.4.1.7
RemoveWaiter (
WL
The abstract operation RemoveWaiter takes arguments
WL
(a
WaiterList
) and
(an
agent
signifier). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Assert
is on the list of waiters in
WL
3.
Remove
from the list of waiters in
WL
25.4.1.8
RemoveWaiters (
WL
The abstract operation RemoveWaiters takes arguments
WL
(a
WaiterList
) and
(a non-negative
integer
or +∞). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Let
be a new empty
List
3.
Let
be a reference to the list of waiters in
WL
4.
Repeat, while
> 0 and
is not an empty
List
a.
Let
be the first waiter in
b.
Add
to the end of
c.
Remove
from
d.
If
is finite, set
to
- 1.
5.
Return
25.4.1.9
SuspendAgent (
WL
timeout
The abstract operation SuspendAgent takes arguments
WL
(a
WaiterList
),
(an
agent
signifier), and
timeout
(a non-negative
integer
). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Assert
is equivalent to
AgentSignifier
().
3.
Assert
is on the list of waiters in
WL
4.
Assert
AgentCanSuspend
() is
true
5.
Perform
LeaveCriticalSection
WL
) and suspend
for up to
timeout
milliseconds, performing the combined operation in such a way that a notification that arrives after the
critical section
is exited but before the suspension takes effect is not lost.
can notify either because the timeout expired or because it was notified explicitly by another
agent
calling
NotifyWaiter
WL
), and not for any other reasons at all.
6.
Perform
EnterCriticalSection
WL
).
7.
If
was notified explicitly by another
agent
calling
NotifyWaiter
WL
), return
true
8.
Return
false
25.4.1.10
NotifyWaiter (
WL
The abstract operation NotifyWaiter takes arguments
WL
(a
WaiterList
) and
(an
agent
signifier). It performs the following steps when called:
1.
Assert
: The calling
agent
is in the
critical section
for
WL
2.
Notify the
agent
Note
The embedding may delay notifying
, e.g. for resource management reasons, but
must eventually be notified in order to guarantee forward progress.
25.4.1.11
AtomicReadModifyWrite (
typedArray
index
value
op
The abstract operation AtomicReadModifyWrite takes arguments
typedArray
index
value
, and
op
(a
read-modify-write modification function
).
op
takes two
List
of byte values arguments and returns a
List
of byte values. This operation atomically loads a value, combines it
with another value, and stores the result of the combination. It returns
the loaded value. It performs the following steps when called:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
).
2.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
3.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
4.
If
typedArray
.[[ContentType]] is
BigInt
, let
be ?
ToBigInt
value
).
5.
Otherwise, let
be
(?
ToIntegerOrInfinity
value
)).
6.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
7.
NOTE: The above check is not redundant with the check in
ValidateIntegerTypedArray
because the call to
ToBigInt
or
ToIntegerOrInfinity
on the preceding lines can have arbitrary side effects, which could cause the buffer to become detached.
8.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
9.
Return
GetModifySetValueInBuffer
buffer
indexedPosition
elementType
op
).
25.4.1.12
ByteListBitwiseOp (
op
xBytes
yBytes
The abstract operation ByteListBitwiseOp takes arguments
op
(a sequence of Unicode code points),
xBytes
(a
List
of byte values), and
yBytes
(a
List
of byte values). The operation atomically performs a bitwise operation on all byte values of the arguments and returns a
List
of byte values. It performs the following steps when called:
1.
Assert
op
is
, or
2.
Assert
xBytes
and
yBytes
have the same number of elements.
3.
Let
result
be a new empty
List
4.
Let
be 0.
5.
For each element
xByte
of
xBytes
, do
a.
Let
yByte
be
yBytes
].
b.
If
op
is
, let
resultByte
be the result of applying the bitwise AND operation to
xByte
and
yByte
c.
Else if
op
is
, let
resultByte
be the result of applying the bitwise exclusive OR (XOR) operation to
xByte
and
yByte
d.
Else,
op
is
. Let
resultByte
be the result of applying the bitwise inclusive OR operation to
xByte
and
yByte
e.
Set
to
+ 1.
f.
Append
resultByte
to the end of
result
6.
Return
result
25.4.1.13
ByteListEqual (
xBytes
yBytes
The abstract operation ByteListEqual takes arguments
xBytes
(a
List
of byte values) and
yBytes
(a
List
of byte values). It performs the following steps when called:
1.
If
xBytes
and
yBytes
do not have the same number of elements, return
false
2.
Let
be 0.
3.
For each element
xByte
of
xBytes
, do
a.
Let
yByte
be
yBytes
].
b.
If
xByte
yByte
, return
false
c.
Set
to
+ 1.
4.
Return
true
25.4.2
Atomics.add (
typedArray
index
value
The following steps are taken:
1.
Let
type
be the Element Type value in
Table 60
for
typedArray
.[[TypedArrayName]].
2.
Let
isLittleEndian
be the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
3.
Let
add
be a new
read-modify-write modification function
with parameters (
xBytes
yBytes
) that captures
type
and
isLittleEndian
and performs the following steps atomically when called:
a.
Let
be
RawBytesToNumeric
type
xBytes
isLittleEndian
).
b.
Let
be
RawBytesToNumeric
type
yBytes
isLittleEndian
).
c.
Let
be
Type
).
d.
Let
sum
be
::add(
).
e.
Let
sumBytes
be
NumericToRawBytes
type
sum
isLittleEndian
).
f.
Assert
sumBytes
xBytes
, and
yBytes
have the same number of elements.
g.
Return
sumBytes
4.
Return ?
AtomicReadModifyWrite
typedArray
index
value
add
).
25.4.3
Atomics.and (
typedArray
index
value
The following steps are taken:
1.
Let
and
be a new
read-modify-write modification function
with parameters (
xBytes
yBytes
) that captures nothing and performs the following steps atomically when called:
a.
Return
ByteListBitwiseOp
xBytes
yBytes
).
2.
Return ?
AtomicReadModifyWrite
typedArray
index
value
and
).
25.4.4
Atomics.compareExchange (
typedArray
index
expectedValue
replacementValue
The following steps are taken:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
).
2.
Let
block
be
buffer
.[[ArrayBufferData]].
3.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
4.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
5.
If
typedArray
.[[ContentType]] is
BigInt
, then
a.
Let
expected
be ?
ToBigInt
expectedValue
).
b.
Let
replacement
be ?
ToBigInt
replacementValue
).
6.
Else,
a.
Let
expected
be
(?
ToIntegerOrInfinity
expectedValue
)).
b.
Let
replacement
be
(?
ToIntegerOrInfinity
replacementValue
)).
7.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
8.
NOTE: The above check is not redundant with the check in
ValidateIntegerTypedArray
because the call to
ToBigInt
or
ToIntegerOrInfinity
on the preceding lines can have arbitrary side effects, which could cause the buffer to become detached.
9.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
10.
Let
elementSize
be the Element Size value specified in
Table 60
for Element Type
elementType
11.
Let
isLittleEndian
be the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
12.
Let
expectedBytes
be
NumericToRawBytes
elementType
expected
isLittleEndian
).
13.
Let
replacementBytes
be
NumericToRawBytes
elementType
replacement
isLittleEndian
).
14.
If
IsSharedArrayBuffer
buffer
) is
true
, then
a.
Let
execution
be the [[CandidateExecution]] field of the
surrounding agent
's
Agent Record
b.
Let
eventList
be the [[EventList]] field of the element in
execution
.[[EventsRecords]] whose [[AgentSignifier]] is
AgentSignifier
().
c.
Let
rawBytesRead
be a
List
of length
elementSize
whose elements are nondeterministically chosen byte values.
d.
NOTE: In implementations,
rawBytesRead
is the result of a load-link, of a load-exclusive, or of an operand of a
read-modify-write instruction on the underlying hardware. The
nondeterminism is a semantic prescription of the
memory model
to describe observable behaviour of hardware with weak consistency.
e.
NOTE: The comparison of the expected value and the read value is performed outside of the
read-modify-write modification function
to avoid needlessly strong synchronization when the expected value is not equal to the read value.
f.
If
ByteListEqual
rawBytesRead
expectedBytes
) is
true
, then
i.
Let
second
be a new
read-modify-write modification function
with parameters (
oldBytes
newBytes
) that captures nothing and performs the following steps atomically when called:
1.
Return
newBytes
ii.
Let
event
be
ReadModifyWriteSharedMemory
{ [[Order]]:
SeqCst
, [[NoTear]]:
true
, [[Block]]:
block
, [[ByteIndex]]:
indexedPosition
, [[ElementSize]]:
elementSize
, [[Payload]]:
replacementBytes
, [[ModifyOp]]:
second
}.
g.
Else,
i.
Let
event
be
ReadSharedMemory
{ [[Order]]:
SeqCst
, [[NoTear]]:
true
, [[Block]]:
block
, [[ByteIndex]]:
indexedPosition
, [[ElementSize]]:
elementSize
}.
h.
Append
event
to
eventList
i.
Append
Chosen Value Record
{ [[Event]]:
event
, [[ChosenValue]]:
rawBytesRead
} to
execution
.[[ChosenValues]].
15.
Else,
a.
Let
rawBytesRead
be a
List
of length
elementSize
whose elements are the sequence of
elementSize
bytes starting with
block
indexedPosition
].
b.
If
ByteListEqual
rawBytesRead
expectedBytes
) is
true
, then
i.
Store the individual bytes of
replacementBytes
into
block
, starting at
block
indexedPosition
].
16.
Return
RawBytesToNumeric
elementType
rawBytesRead
isLittleEndian
).
25.4.5
Atomics.exchange (
typedArray
index
value
The following steps are taken:
1.
Let
second
be a new
read-modify-write modification function
with parameters (
oldBytes
newBytes
) that captures nothing and performs the following steps atomically when called:
a.
Return
newBytes
2.
Return ?
AtomicReadModifyWrite
typedArray
index
value
second
).
25.4.6
Atomics.isLockFree (
size
The following steps are taken:
1.
Let
be ?
ToIntegerOrInfinity
size
).
2.
Let
AR
be the
Agent Record
of the
surrounding agent
3.
If
= 1, return
AR
.[[IsLockFree1]].
4.
If
= 2, return
AR
.[[IsLockFree2]].
5.
If
= 4, return
true
6.
If
= 8, return
AR
.[[IsLockFree8]].
7.
Return
false
Note
Atomics.isLockFree
() is an optimization primitive. The intuition is that if the atomic step of an atomic primitive (
compareExchange
load
store
add
sub
and
or
xor
, or
exchange
) on a datum of size
bytes will be performed without the calling
agent
acquiring a lock outside the
bytes comprising the datum, then
Atomics.isLockFree
) will return
true
. High-performance algorithms will use
Atomics.isLockFree
to determine whether to use locks or atomic operations in critical
sections. If an atomic primitive is not lock-free then it is often more
efficient for an algorithm to provide its own locking.
Atomics.isLockFree
(4) always returns
true
as that can be supported on all known relevant hardware. Being able to assume this will generally simplify programs.
Regardless of the value of
Atomics.isLockFree
all atomic operations are guaranteed to be atomic. For example, they
will never have a visible operation take place in the middle of the
operation (e.g., "tearing").
25.4.7
Atomics.load (
typedArray
index
The following steps are taken:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
).
2.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
3.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
4.
NOTE: The above check is not redundant with the check in
ValidateIntegerTypedArray
because the call to
ValidateAtomicAccess
on the preceding line can have arbitrary side effects, which could cause the buffer to become detached.
5.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
6.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
7.
Return
GetValueFromBuffer
buffer
indexedPosition
elementType
true
SeqCst
).
25.4.8
Atomics.or (
typedArray
index
value
The following steps are taken:
1.
Let
or
be a new
read-modify-write modification function
with parameters (
xBytes
yBytes
) that captures nothing and performs the following steps atomically when called:
a.
Return
ByteListBitwiseOp
xBytes
yBytes
).
2.
Return ?
AtomicReadModifyWrite
typedArray
index
value
or
).
25.4.9
Atomics.store (
typedArray
index
value
The following steps are taken:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
).
2.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
3.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
4.
If
arrayTypeName
is
"BigUint64Array"
or
"BigInt64Array"
, let
be ?
ToBigInt
value
).
5.
Otherwise, let
be
(?
ToIntegerOrInfinity
value
)).
6.
If
IsDetachedBuffer
buffer
) is
true
, throw a
TypeError
exception.
7.
NOTE: The above check is not redundant with the check in
ValidateIntegerTypedArray
because the call to
ToBigInt
or
ToIntegerOrInfinity
on the preceding lines can have arbitrary side effects, which could cause the buffer to become detached.
8.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
9.
Perform
SetValueInBuffer
buffer
indexedPosition
elementType
true
SeqCst
).
10.
Return
25.4.10
Atomics.sub (
typedArray
index
value
The following steps are taken:
1.
Let
type
be the Element Type value in
Table 60
for
typedArray
.[[TypedArrayName]].
2.
Let
isLittleEndian
be the value of the [[LittleEndian]] field of the
surrounding agent
's
Agent Record
3.
Let
subtract
be a new
read-modify-write modification function
with parameters (
xBytes
yBytes
) that captures
type
and
isLittleEndian
and performs the following steps atomically when called:
a.
Let
be
RawBytesToNumeric
type
xBytes
isLittleEndian
).
b.
Let
be
RawBytesToNumeric
type
yBytes
isLittleEndian
).
c.
Let
be
Type
).
d.
Let
difference
be
::subtract(
).
e.
Let
differenceBytes
be
NumericToRawBytes
type
difference
isLittleEndian
).
f.
Assert
differenceBytes
xBytes
, and
yBytes
have the same number of elements.
g.
Return
differenceBytes
4.
Return ?
AtomicReadModifyWrite
typedArray
index
value
subtract
).
25.4.11
Atomics.wait (
typedArray
index
value
timeout
Atomics.wait
puts the calling
agent
in a wait queue and puts it to sleep until it is notified or the sleep times out. The following steps are taken:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
true
).
2.
If
IsSharedArrayBuffer
buffer
) is
false
, throw a
TypeError
exception.
3.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
4.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
5.
If
arrayTypeName
is
"BigInt64Array"
, let
be ?
ToBigInt64
value
).
6.
Otherwise, let
be ?
ToInt32
value
).
7.
Let
be ?
ToNumber
timeout
).
8.
If
is
NaN
or
+∞
, let
be +∞; else if
is
-∞
, let
be 0; else let
be
max
), 0).
9.
Let
be
AgentCanSuspend
().
10.
If
is
false
, throw a
TypeError
exception.
11.
Let
block
be
buffer
.[[ArrayBufferData]].
12.
Let
WL
be
GetWaiterList
block
indexedPosition
).
13.
Perform
EnterCriticalSection
WL
).
14.
Let
elementType
be the Element Type value in
Table 60
for
arrayTypeName
15.
Let
be !
GetValueFromBuffer
buffer
indexedPosition
elementType
true
SeqCst
).
16.
If
, then
a.
Perform
LeaveCriticalSection
WL
).
b.
Return the String
"not-equal"
17.
Let
be
AgentSignifier
().
18.
Perform
AddWaiter
WL
).
19.
Let
notified
be
SuspendAgent
WL
).
20.
If
notified
is
true
, then
a.
Assert
is not on the list of waiters in
WL
21.
Else,
a.
Perform
RemoveWaiter
WL
).
22.
Perform
LeaveCriticalSection
WL
).
23.
If
notified
is
true
, return the String
"ok"
24.
Return the String
"timed-out"
25.4.12
Atomics.notify (
typedArray
index
count
Atomics.notify
notifies some agents that are sleeping in the wait queue. The following steps are taken:
1.
Let
buffer
be ?
ValidateIntegerTypedArray
typedArray
true
).
2.
Let
indexedPosition
be ?
ValidateAtomicAccess
typedArray
index
).
3.
If
count
is
undefined
, let
be +∞.
4.
Else,
a.
Let
intCount
be ?
ToIntegerOrInfinity
count
).
b.
Let
be
max
intCount
, 0).
5.
Let
block
be
buffer
.[[ArrayBufferData]].
6.
Let
arrayTypeName
be
typedArray
.[[TypedArrayName]].
7.
If
IsSharedArrayBuffer
buffer
) is
false
, return
+0
8.
Let
WL
be
GetWaiterList
block
indexedPosition
).
9.
Let
be 0.
10.
Perform
EnterCriticalSection
WL
).
11.
Let
be
RemoveWaiters
WL
).
12.
Repeat, while
is not an empty
List
a.
Let
be the first
agent
in
b.
Remove
from the front of
c.
Perform
NotifyWaiter
WL
).
d.
Set
to
+ 1.
13.
Perform
LeaveCriticalSection
WL
).
14.
Return
).
25.4.13
Atomics.xor (
typedArray
index
value
The following steps are taken:
1.
Let
xor
be a new
read-modify-write modification function
with parameters (
xBytes
yBytes
) that captures nothing and performs the following steps atomically when called:
a.
Return
ByteListBitwiseOp
xBytes
yBytes
).
2.
Return ?
AtomicReadModifyWrite
typedArray
index
value
xor
).
25.4.14
Atomics [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"Atomics"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
25.5
The JSON Object
The JSON object:
is
%JSON%
is the initial value of the
"JSON"
property of the
global object
is an
ordinary object
contains two functions,
parse
and
stringify
, that are used to parse and construct JSON texts.
has a [[Prototype]] internal slot whose value is
%Object.prototype%
does not have a [[Construct]] internal method; it cannot be used as a
constructor
with the
new
operator.
does not have a [[Call]] internal method; it cannot be invoked as a function.
The JSON Data Interchange Format is defined in ECMA-404. The JSON
interchange format used in this specification is exactly that described
by ECMA-404. Conforming implementations of
JSON.parse
and
JSON.stringify
must support the exact interchange format described in the ECMA-404
specification without any deletions or extensions to the format.
25.5.1
JSON.parse (
text
[ ,
reviver
] )
The
parse
function parses a JSON text (a
JSON-formatted String) and produces an ECMAScript value. The JSON format
represents literals, arrays, and objects with a syntax similar to the
syntax for ECMAScript literals, Array Initializers, and Object
Initializers. After parsing, JSON objects are realized as ECMAScript
objects. JSON arrays are realized as ECMAScript Array instances. JSON
strings, numbers, booleans, and null are realized as ECMAScript Strings,
Numbers, Booleans, and
null
The optional
reviver
parameter is a function that takes two parameters,
key
and
value
. It can filter and transform the results. It is called with each of the
key
value
pairs produced by the parse, and its return value is used instead of
the original value. If it returns what it received, the structure is not
modified. If it returns
undefined
then the property is deleted from the result.
1.
Let
jsonString
be ?
ToString
text
).
2.
Parse !
StringToCodePoints
jsonString
) as a JSON text as specified in ECMA-404. Throw a
SyntaxError
exception if it is not a valid JSON text as defined in that specification.
3.
Let
scriptString
be the
string-concatenation
of
"("
jsonString
, and
");"
4.
Let
script
be
ParseText
(!
StringToCodePoints
scriptString
),
Script
).
5.
Assert
script
is a
Parse Node
6.
Let
completion
be the result of evaluating
script
. The extended
PropertyDefinitionEvaluation
semantics defined in
B.3.1
must not be used during the evaluation.
7.
Let
unfiltered
be
completion
.[[Value]].
8.
Assert
unfiltered
is either a String, Number, Boolean, Null, or an Object that is defined by either an
ArrayLiteral
or an
ObjectLiteral
9.
If
IsCallable
reviver
) is
true
, then
a.
Let
root
be !
OrdinaryObjectCreate
%Object.prototype%
).
b.
Let
rootName
be the empty String.
c.
Perform !
CreateDataPropertyOrThrow
root
rootName
unfiltered
).
d.
Return ?
InternalizeJSONProperty
root
rootName
reviver
).
10.
Else,
a.
Return
unfiltered
The
"length"
property of the
parse
function is
Note
Valid JSON text is a subset of the ECMAScript
PrimaryExpression
syntax. Step
verifies that
jsonString
conforms to that subset, and step
asserts that that parsing and evaluation returns a value of an appropriate type.
However, because
B.3.1
applies when evaluating ECMAScript source text and does not apply during
JSON.parse
, the same source text can produce different results when evaluated as a
PrimaryExpression
rather than as JSON. Furthermore, the Early Error for duplicate
"__proto__"
properties in object literals, which likewise does not apply during
JSON.parse
, means that not all texts accepted by
JSON.parse
are valid as a
PrimaryExpression
, despite matching the grammar.
25.5.1.1
InternalizeJSONProperty (
holder
name
reviver
The abstract operation InternalizeJSONProperty takes arguments
holder
(an Object),
name
(a String), and
reviver
(a
function object
). It performs the following steps when called:
Note 1
This algorithm intentionally does not throw an exception if either [[Delete]] or
CreateDataProperty
return
false
1.
Let
val
be ?
Get
holder
name
).
2.
If
Type
val
) is Object, then
a.
Let
isArray
be ?
IsArray
val
).
b.
If
isArray
is
true
, then
i.
Let
be 0.
ii.
Let
len
be ?
LengthOfArrayLike
val
).
iii.
Repeat, while
len
1.
Let
prop
be !
ToString
)).
2.
Let
newElement
be ?
InternalizeJSONProperty
val
prop
reviver
).
3.
If
newElement
is
undefined
, then
a.
Perform ?
val
.[[Delete]](
prop
).
4.
Else,
a.
Perform ?
CreateDataProperty
val
prop
newElement
).
5.
Set
to
+ 1.
c.
Else,
i.
Let
keys
be ?
EnumerableOwnPropertyNames
val
key
).
ii.
For each String
of
keys
, do
1.
Let
newElement
be ?
InternalizeJSONProperty
val
reviver
).
2.
If
newElement
is
undefined
, then
a.
Perform ?
val
.[[Delete]](
).
3.
Else,
a.
Perform ?
CreateDataProperty
val
newElement
).
3.
Return ?
Call
reviver
holder
, «
name
val
»).
It is not permitted for a conforming implementation of
JSON.parse
to extend the JSON grammars. If an implementation wishes to support a
modified or extended JSON interchange format it must do so by defining a
different parse function.
Note 2
In the case where there are duplicate name Strings within
an object, lexically preceding values for the same key shall be
overwritten.
25.5.2
JSON.stringify (
value
[ ,
replacer
[ ,
space
] ] )
The
stringify
function returns a String in UTF-16 encoded JSON format representing an ECMAScript value, or
undefined
. It can take three parameters. The
value
parameter is an ECMAScript value, which is usually an object or array, although it can also be a String, Boolean, Number or
null
. The optional
replacer
parameter is either a function that alters the way objects and arrays
are stringified, or an array of Strings and Numbers that acts as an
inclusion list for selecting the object properties that will be
stringified. The optional
space
parameter is a String or Number that allows the result to have white space injected into it to improve human readability.
These are the steps in stringifying an object:
1.
Let
stack
be a new empty
List
2.
Let
indent
be the empty String.
3.
Let
PropertyList
and
ReplacerFunction
be
undefined
4.
If
Type
replacer
) is Object, then
a.
If
IsCallable
replacer
) is
true
, then
i.
Set
ReplacerFunction
to
replacer
b.
Else,
i.
Let
isArray
be ?
IsArray
replacer
).
ii.
If
isArray
is
true
, then
1.
Set
PropertyList
to a new empty
List
2.
Let
len
be ?
LengthOfArrayLike
replacer
).
3.
Let
be 0.
4.
Repeat, while
len
a.
Let
prop
be !
ToString
)).
b.
Let
be ?
Get
replacer
prop
).
c.
Let
item
be
undefined
d.
If
Type
) is String, set
item
to
e.
Else if
Type
) is Number, set
item
to !
ToString
).
f.
Else if
Type
) is Object, then
i.
If
has a [[StringData]] or [[NumberData]] internal slot, set
item
to ?
ToString
).
g.
If
item
is not
undefined
and
item
is not currently an element of
PropertyList
, then
i.
Append
item
to the end of
PropertyList
h.
Set
to
+ 1.
5.
If
Type
space
) is Object, then
a.
If
space
has a [[NumberData]] internal slot, then
i.
Set
space
to ?
ToNumber
space
).
b.
Else if
space
has a [[StringData]] internal slot, then
i.
Set
space
to ?
ToString
space
).
6.
If
Type
space
) is Number, then
a.
Let
spaceMV
be !
ToIntegerOrInfinity
space
).
b.
Set
spaceMV
to
min
(10,
spaceMV
).
c.
If
spaceMV
< 1, let
gap
be the empty String; otherwise let
gap
be the String value containing
spaceMV
occurrences of the code unit 0x0020 (SPACE).
7.
Else if
Type
space
) is String, then
a.
If the length of
space
is 10 or less, let
gap
be
space
; otherwise let
gap
be the
substring
of
space
from 0 to 10.
8.
Else,
a.
Let
gap
be the empty String.
9.
Let
wrapper
be !
OrdinaryObjectCreate
%Object.prototype%
).
10.
Perform !
CreateDataPropertyOrThrow
wrapper
, the empty String,
value
).
11.
Let
state
be the
Record
{ [[ReplacerFunction]]:
ReplacerFunction
, [[Stack]]:
stack
, [[Indent]]:
indent
, [[Gap]]:
gap
, [[PropertyList]]:
PropertyList
}.
12.
Return ?
SerializeJSONProperty
state
, the empty String,
wrapper
).
The
"length"
property of the
stringify
function is
Note 1
JSON structures are allowed to be nested to any depth, but they must be acyclic. If
value
is or contains a cyclic structure, then the stringify function must throw a
TypeError
exception. This is an example of a value that cannot be stringified:
a = [];
a[
] = a;
my_text =
JSON
.stringify(a);
// This must throw a TypeError.
Note 2
Symbolic primitive values are rendered as follows:
The
null
value is rendered in JSON text as the String
"null"
The
undefined
value is not rendered.
The
true
value is rendered in JSON text as the String
"true"
The
false
value is rendered in JSON text as the String
"false"
Note 3
String values are wrapped in QUOTATION MARK (
) code units. The code units
and
are escaped with
prefixes. Control characters code units are replaced with escape sequences
\u
HHHH, or with the shorter forms,
\b
(BACKSPACE),
\f
(FORM FEED),
\n
(LINE FEED),
\r
(CARRIAGE RETURN),
\t
(CHARACTER TABULATION).
Note 4
Finite numbers are stringified as if by calling
ToString
number
).
NaN
and
Infinity
regardless of sign are represented as the String
"null"
Note 5
Values that do not have a JSON representation (such as
undefined
and functions) do not produce a String. Instead they produce the
undefined
value. In arrays these values are represented as the String
"null"
. In objects an unrepresentable value causes the property to be excluded from stringification.
Note 6
An object is rendered as U+007B (LEFT CURLY BRACKET) followed
by zero or more properties, separated with a U+002C (COMMA), closed
with a U+007D (RIGHT CURLY BRACKET). A property is a quoted String
representing the key or
property name
a U+003A (COLON), and then the stringified property value. An array is
rendered as an opening U+005B (LEFT SQUARE BRACKET followed by zero or
more values, separated with a U+002C (COMMA), closed with a U+005D
(RIGHT SQUARE BRACKET).
25.5.2.1
SerializeJSONProperty (
state
key
holder
The abstract operation SerializeJSONProperty takes arguments
state
key
, and
holder
. It performs the following steps when called:
1.
Let
value
be ?
Get
holder
key
).
2.
If
Type
value
) is Object or BigInt, then
a.
Let
toJSON
be ?
GetV
value
"toJSON"
).
b.
If
IsCallable
toJSON
) is
true
, then
i.
Set
value
to ?
Call
toJSON
value
, «
key
»).
3.
If
state
.[[ReplacerFunction]] is not
undefined
, then
a.
Set
value
to ?
Call
state
.[[ReplacerFunction]],
holder
, «
key
value
»).
4.
If
Type
value
) is Object, then
a.
If
value
has a [[NumberData]] internal slot, then
i.
Set
value
to ?
ToNumber
value
).
b.
Else if
value
has a [[StringData]] internal slot, then
i.
Set
value
to ?
ToString
value
).
c.
Else if
value
has a [[BooleanData]] internal slot, then
i.
Set
value
to
value
.[[BooleanData]].
d.
Else if
value
has a [[BigIntData]] internal slot, then
i.
Set
value
to
value
.[[BigIntData]].
5.
If
value
is
null
, return
"null"
6.
If
value
is
true
, return
"true"
7.
If
value
is
false
, return
"false"
8.
If
Type
value
) is String, return
QuoteJSONString
value
).
9.
If
Type
value
) is Number, then
a.
If
value
is finite, return !
ToString
value
).
b.
Return
"null"
10.
If
Type
value
) is BigInt, throw a
TypeError
exception.
11.
If
Type
value
) is Object and
IsCallable
value
) is
false
, then
a.
Let
isArray
be ?
IsArray
value
).
b.
If
isArray
is
true
, return ?
SerializeJSONArray
state
value
).
c.
Return ?
SerializeJSONObject
state
value
).
12.
Return
undefined
25.5.2.2
QuoteJSONString (
value
The abstract operation QuoteJSONString takes argument
value
. It wraps
value
in 0x0022 (QUOTATION MARK) code units and escapes certain other code units within it. This operation interprets
value
as a sequence of UTF-16 encoded code points, as described in
6.1.4
. It performs the following steps when called:
1.
Let
product
be the String value consisting solely of the code unit 0x0022 (QUOTATION MARK).
2.
For each code point
of !
StringToCodePoints
value
), do
a.
If
is listed in the “Code Point” column of
Table 61
, then
i.
Set
product
to the
string-concatenation
of
product
and the escape sequence for
as specified in the “Escape Sequence” column of the corresponding row.
b.
Else if
has a numeric value less than 0x0020 (SPACE), or if
has the same numeric value as a
leading surrogate
or
trailing surrogate
, then
i.
Let
unit
be the code unit whose numeric value is that of
ii.
Set
product
to the
string-concatenation
of
product
and
UnicodeEscape
unit
).
c.
Else,
i.
Set
product
to the
string-concatenation
of
product
and !
UTF16EncodeCodePoint
).
3.
Set
product
to the
string-concatenation
of
product
and the code unit 0x0022 (QUOTATION MARK).
4.
Return
product
Table 61: JSON Single Character Escape Sequences
Code Point
Unicode Character Name
Escape Sequence
U+0008
BACKSPACE
\b
U+0009
CHARACTER TABULATION
\t
U+000A
LINE FEED (LF)
\n
U+000C
FORM FEED (FF)
\f
U+000D
CARRIAGE RETURN (CR)
\r
U+0022
QUOTATION MARK
\"
U+005C
REVERSE SOLIDUS
\\
25.5.2.3
UnicodeEscape (
The abstract operation UnicodeEscape takes argument
(a code unit). It represents
as a Unicode escape sequence. It performs the following steps when called:
1.
Let
be the numeric value of
2.
Assert
≤ 0xFFFF.
3.
Return the
string-concatenation
of:
the code unit 0x005C (REVERSE SOLIDUS)
"u"
the String representation of
, formatted as a four-digit lowercase hexadecimal number, padded to the left with zeroes if necessary
25.5.2.4
SerializeJSONObject (
state
value
The abstract operation SerializeJSONObject takes arguments
state
and
value
. It serializes an object. It performs the following steps when called:
1.
If
state
.[[Stack]] contains
value
, throw a
TypeError
exception because the structure is cyclical.
2.
Append
value
to
state
.[[Stack]].
3.
Let
stepback
be
state
.[[Indent]].
4.
Set
state
.[[Indent]] to the
string-concatenation
of
state
.[[Indent]] and
state
.[[Gap]].
5.
If
state
.[[PropertyList]] is not
undefined
, then
a.
Let
be
state
.[[PropertyList]].
6.
Else,
a.
Let
be ?
EnumerableOwnPropertyNames
value
key
).
7.
Let
partial
be a new empty
List
8.
For each element
of
, do
a.
Let
strP
be ?
SerializeJSONProperty
state
value
).
b.
If
strP
is not
undefined
, then
i.
Let
member
be
QuoteJSONString
).
ii.
Set
member
to the
string-concatenation
of
member
and
":"
iii.
If
state
.[[Gap]] is not the empty String, then
1.
Set
member
to the
string-concatenation
of
member
and the code unit 0x0020 (SPACE).
iv.
Set
member
to the
string-concatenation
of
member
and
strP
v.
Append
member
to
partial
9.
If
partial
is empty, then
a.
Let
final
be
"{}"
10.
Else,
a.
If
state
.[[Gap]] is the empty String, then
i.
Let
properties
be the String value formed by concatenating all the element Strings of
partial
with each adjacent pair of Strings separated with the code unit 0x002C
(COMMA). A comma is not inserted either before the first String or after
the last String.
ii.
Let
final
be the
string-concatenation
of
"{"
properties
, and
"}"
b.
Else,
i.
Let
separator
be the
string-concatenation
of the code unit 0x002C (COMMA), the code unit 0x000A (LINE FEED), and
state
.[[Indent]].
ii.
Let
properties
be the String value formed by concatenating all the element Strings of
partial
with each adjacent pair of Strings separated with
separator
. The
separator
String is not inserted either before the first String or after the last String.
iii.
Let
final
be the
string-concatenation
of
"{"
, the code unit 0x000A (LINE FEED),
state
.[[Indent]],
properties
, the code unit 0x000A (LINE FEED),
stepback
, and
"}"
11.
Remove the last element of
state
.[[Stack]].
12.
Set
state
.[[Indent]] to
stepback
13.
Return
final
25.5.2.5
SerializeJSONArray (
state
value
The abstract operation SerializeJSONArray takes arguments
state
and
value
. It serializes an array. It performs the following steps when called:
1.
If
state
.[[Stack]] contains
value
, throw a
TypeError
exception because the structure is cyclical.
2.
Append
value
to
state
.[[Stack]].
3.
Let
stepback
be
state
.[[Indent]].
4.
Set
state
.[[Indent]] to the
string-concatenation
of
state
.[[Indent]] and
state
.[[Gap]].
5.
Let
partial
be a new empty
List
6.
Let
len
be ?
LengthOfArrayLike
value
).
7.
Let
index
be 0.
8.
Repeat, while
index
len
a.
Let
strP
be ?
SerializeJSONProperty
state
, !
ToString
index
)),
value
).
b.
If
strP
is
undefined
, then
i.
Append
"null"
to
partial
c.
Else,
i.
Append
strP
to
partial
d.
Set
index
to
index
+ 1.
9.
If
partial
is empty, then
a.
Let
final
be
"[]"
10.
Else,
a.
If
state
.[[Gap]] is the empty String, then
i.
Let
properties
be the String value formed by concatenating all the element Strings of
partial
with each adjacent pair of Strings separated with the code unit 0x002C
(COMMA). A comma is not inserted either before the first String or after
the last String.
ii.
Let
final
be the
string-concatenation
of
"["
properties
, and
"]"
b.
Else,
i.
Let
separator
be the
string-concatenation
of the code unit 0x002C (COMMA), the code unit 0x000A (LINE FEED), and
state
.[[Indent]].
ii.
Let
properties
be the String value formed by concatenating all the element Strings of
partial
with each adjacent pair of Strings separated with
separator
. The
separator
String is not inserted either before the first String or after the last String.
iii.
Let
final
be the
string-concatenation
of
"["
, the code unit 0x000A (LINE FEED),
state
.[[Indent]],
properties
, the code unit 0x000A (LINE FEED),
stepback
, and
"]"
11.
Remove the last element of
state
.[[Stack]].
12.
Set
state
.[[Indent]] to
stepback
13.
Return
final
Note
The representation of arrays includes only the elements between zero and
array.length
- 1
inclusive. Properties whose keys are not
array indexes
are excluded from the stringification. An array is stringified as an
opening LEFT SQUARE BRACKET, elements separated by COMMA, and a closing
RIGHT SQUARE BRACKET.
25.5.3
JSON [ @@toStringTag ]
The initial value of the
@@toStringTag
property is the String value
"JSON"
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
26
Managing Memory
26.1
WeakRef Objects
WeakRef
is an object that is used to refer to a target object without
preserving it from garbage collection. WeakRefs can be dereferenced to
allow access to the target object, if the target object hasn't been
reclaimed by garbage collection.
26.1.1
The WeakRef Constructor
The
WeakRef
constructor
is
%WeakRef%
is the initial value of the
"WeakRef"
property of the
global object
creates and initializes a new WeakRef object when called as a
constructor
is not intended to be called as a function and will throw an exception when called in that manner.
is designed to be subclassable. It may be used as the value in an
extends
clause of a class definition. Subclass constructors that intend to inherit the specified
WeakRef
behaviour must include a
super
call to the
WeakRef
constructor
to create and initialize the subclass instance with the internal state necessary to support the
WeakRef.prototype
built-in methods.
26.1.1.1
WeakRef (
target
When the
WeakRef
function is called with argument
target
, the following steps are taken:
1.
If NewTarget is
undefined
, throw a
TypeError
exception.
2.
If
Type
target
) is not Object, throw a
TypeError
exception.
3.
Let
weakRef
be ?
OrdinaryCreateFromConstructor
(NewTarget,
"%WeakRef.prototype%"
, « [[WeakRefTarget]] »).
4.
Perform !
AddToKeptObjects
target
).
5.
Set
weakRef
.[[WeakRefTarget]] to
target
6.
Return
weakRef
26.1.2
Properties of the WeakRef Constructor
The
WeakRef
constructor
has a [[Prototype]] internal slot whose value is
%Function.prototype%
has the following properties:
26.1.2.1
WeakRef.prototype
The initial value of
WeakRef.prototype
is the
WeakRef prototype
object.
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
false
}.
26.1.3
Properties of the WeakRef Prototype Object
The
WeakRef prototype
object:
is
%WeakRef.prototype%
has a [[Prototype]] internal slot whose value is
%Object.prototype%
is an
ordinary object
does not have a [[WeakRefTarget]] internal slot.
Normative Optional
26.1.3.1
WeakRef.prototype.constructor
The initial value of
WeakRef.prototype.constructor
is
%WeakRef%
This property has the attributes { [[Writable]]:
false
, [[Enumerable]]:
false
, [[Configurable]]:
true
}.
26.1.3.2
WeakRef.prototype.deref ( )
The following steps are taken:
1.
Let
weakRef
be the
this
value.
2.
Perform ?
RequireInternalSlot
weakRef
, [[WeakRefTarget]]).
3.
Return !
WeakRefDeref
weakRef
).
Note
If the
WeakRef
returns a
target
Object that is not
undefined
, then this
target
object should not be garbage collected until the current execution of ECMAScript code has completed. The
AddToKeptObjects
operation makes sure read consistency is maintained.
target = {
foo
function
{} };
let
weakRef =
new
WeakRef(target);