/*

* Copyright (C) 2008-2021 Apple Inc. All rights reserved.

* Copyright (C) 2008 Cameron Zwarich <cwzwarich@uwaterloo.ca>

* Copyright (C) 2012 Igalia, S.L.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

*

* 1. Redistributions of source code must retain the above copyright

* notice, this list of conditions and the following disclaimer.

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in the

* documentation and/or other materials provided with the distribution.

* 3. Neither the name of Apple Inc. ("Apple") nor the names of

* its contributors may be used to endorse or promote products derived

* from this software without specific prior written permission.

*

* THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY

* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

* DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY

* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF

* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

#pragma once

#include "BytecodeGeneratorBase.h"

#include "BytecodeStructs.h"

#include "CodeBlock.h"

#include "Instruction.h"

#include "Interpreter.h"

#include "JSAsyncGenerator.h"

#include "JSBigInt.h"

#include "JSGenerator.h"

#include "JSTemplateObjectDescriptor.h"

#include "Label.h"

#include "LabelScope.h"

#include "LinkTimeConstant.h"

#include "Nodes.h"

#include "ParserError.h"

#include "ProfileTypeBytecodeFlag.h"

#include "RegisterID.h"

#include "StaticPropertyAnalyzer.h"

#include "SymbolTable.h"

#include "UnlinkedCodeBlock.h"

#include "UnlinkedCodeBlockGenerator.h"

#include <functional>

#include <wtf/CheckedArithmetic.h>

#include <wtf/HashFunctions.h>

#include <wtf/SegmentedVector.h>

#include <wtf/SetForScope.h>

#include <wtf/Vector.h>

namespace JSC {

class JSImmutableButterfly;

class Identifier;

class ForInContext;

enum ExpectedFunction {

NoExpectedFunction,

ExpectObjectConstructor,

ExpectArrayConstructor

};

enum class EmitAwait { Yes, No };

enum class DebuggableCall { Yes, No };

enum class ThisResolutionType { Local, Scoped };

enum class InvalidPrototypeMode : uint8_t { Throw, Ignore };

enum class LinkTimeConstant : int32_t;

class CallArguments {

public:

CallArguments(BytecodeGenerator&, ArgumentsNode*, unsigned additionalArguments = 0);

RegisterID* thisRegister() { return m_argv[0].get(); }

RegisterID* argumentRegister(unsigned i) { return m_argv[i + 1].get(); }

unsigned stackOffset() { return -m_argv[0]->index() + CallFrame::headerSizeInRegisters; }

unsigned argumentCountIncludingThis() { return m_argv.size() - m_padding; }

ArgumentsNode* argumentsNode() { return m_argumentsNode; }

private:

ArgumentsNode* m_argumentsNode;

Vector<RefPtr<RegisterID>, 8, UnsafeVectorOverflow> m_argv;

unsigned m_padding;

};

class Variable {

public:

enum VariableKind { NormalVariable, SpecialVariable };

Variable() = default;

Variable(const Identifier& ident)

: m_ident(ident)

, m_local(nullptr)

, m_attributes(0)

, m_kind(NormalVariable) // This is somewhat meaningless here for this kind of Variable.

, m_symbolTableConstantIndex(0) // This is meaningless here for this kind of Variable.

, m_isLexicallyScoped(false)

{

}

Variable(const Identifier& ident, VarOffset offset, RegisterID* local, unsigned attributes, VariableKind kind, int symbolTableConstantIndex, bool isLexicallyScoped)

: m_ident(ident)

, m_offset(offset)

, m_local(local)

, m_attributes(attributes)

, m_kind(kind)

, m_symbolTableConstantIndex(symbolTableConstantIndex)

, m_isLexicallyScoped(isLexicallyScoped)

{

}

// If it's unset, then it is a non-locally-scoped variable. If it is set, then it could be

// a stack variable, a scoped variable in a local scope, or a variable captured in the

// direct arguments object.

bool isResolved() const { return !!m_offset; }

int symbolTableConstantIndex() const { ASSERT(isResolved() && !isSpecial()); return m_symbolTableConstantIndex; }

const Identifier& ident() const { return m_ident; }

VarOffset offset() const { return m_offset; }

bool isLocal() const { return m_offset.isStack(); }

RegisterID* local() const { return m_local; }

bool isReadOnly() const { return m_attributes & PropertyAttribute::ReadOnly; }

bool isSpecial() const { return m_kind != NormalVariable; }

bool isConst() const { return isReadOnly() && m_isLexicallyScoped; }

void setIsReadOnly() { m_attributes |= PropertyAttribute::ReadOnly; }

void dump(PrintStream&) const;

bool operator==(const Variable& other) const

{

return m_ident == other.m_ident

&& m_offset == other.m_offset

&& m_local == other.m_local

&& m_attributes == other.m_attributes

&& m_kind == other.m_kind

&& m_symbolTableConstantIndex == other.m_symbolTableConstantIndex

&& m_isLexicallyScoped == other.m_isLexicallyScoped;

}

private:

Identifier m_ident;

VarOffset m_offset { };

RegisterID* m_local { nullptr };

unsigned m_attributes { 0 };

VariableKind m_kind { NormalVariable };

int m_symbolTableConstantIndex { 0 }; // This is meaningless here for this default NormalVariable kind of Variable.

bool m_isLexicallyScoped { false };

};

// https://tc39.github.io/ecma262/#sec-completion-record-specification-type

//

// For the Break and Continue cases, instead of using the Break and Continue enum values

// below, we use the unique jumpID of the break and continue statement as the encoding

// for the CompletionType value. emitFinallyCompletion() uses this jumpID value later

// to determine the appropriate jump target to jump to after executing the relevant finally

// blocks. The jumpID is computed as:

// jumpID = bytecodeOffset (of the break/continue node) + CompletionType::NumberOfTypes.

// Hence, there won't be any collision between jumpIDs and CompletionType enums.

enum class CompletionType : int {

Normal,

Throw,

Return,

NumberOfTypes

};

inline CompletionType bytecodeOffsetToJumpID(unsigned offset)

{

int jumpIDAsInt = offset + static_cast<int>(CompletionType::NumberOfTypes);

ASSERT(jumpIDAsInt >= static_cast<int>(CompletionType::NumberOfTypes));

return static_cast<CompletionType>(jumpIDAsInt);

}

struct FinallyJump {

FinallyJump(CompletionType jumpID, int targetLexicalScopeIndex, Label& targetLabel)

: jumpID(jumpID)

, targetLexicalScopeIndex(targetLexicalScopeIndex)

, targetLabel(targetLabel)

{ }

CompletionType jumpID;

int targetLexicalScopeIndex;

Ref<Label> targetLabel;

};

class FinallyContext {

public:

FinallyContext() { }

FinallyContext(BytecodeGenerator&, Label& finallyLabel);

FinallyContext* outerContext() const { return m_outerContext; }

Label* finallyLabel() const { return m_finallyLabel; }

RegisterID* completionTypeRegister() const { return m_completionRecord.typeRegister.get(); }

RegisterID* completionValueRegister() const { return m_completionRecord.valueRegister.get(); }

uint32_t numberOfBreaksOrContinues() const { return m_numberOfBreaksOrContinues; }

void incNumberOfBreaksOrContinues() { m_numberOfBreaksOrContinues++; }

bool handlesReturns() const { return m_handlesReturns; }

void setHandlesReturns() { m_handlesReturns = true; }

void registerJump(CompletionType jumpID, int lexicalScopeIndex, Label& targetLabel)

{

m_jumps.append(FinallyJump(jumpID, lexicalScopeIndex, targetLabel));

}

size_t numberOfJumps() const { return m_jumps.size(); }

FinallyJump& jumps(size_t i) { return m_jumps[i]; }

private:

FinallyContext* m_outerContext { nullptr };

Label* m_finallyLabel { nullptr };

Checked<uint32_t, WTF::CrashOnOverflow> m_numberOfBreaksOrContinues;

bool m_handlesReturns { false };

Vector<FinallyJump> m_jumps;

struct {

RefPtr<RegisterID> typeRegister;

RefPtr<RegisterID> valueRegister;

} m_completionRecord;

};

struct ControlFlowScope {

typedef uint8_t Type;

enum {

Label,

Finally

};

ControlFlowScope(Type type, int lexicalScopeIndex, FinallyContext* finallyContext = nullptr)

: type(type)

, lexicalScopeIndex(lexicalScopeIndex)

, finallyContext(finallyContext)

{ }

bool isLabelScope() const { return type == Label; }

bool isFinallyScope() const { return type == Finally; }

Type type;

int lexicalScopeIndex;

FinallyContext* finallyContext;

};

class ForInContext : public RefCounted<ForInContext> {

WTF_MAKE_FAST_ALLOCATED;

WTF_MAKE_NONCOPYABLE(ForInContext);

public:

using GetInst = std::tuple<unsigned, int>;

using InInst = GetInst;

using HasOwnPropertyJumpInst = std::tuple<unsigned, unsigned>;

bool isValid() const { return m_isValid; }

void invalidate() { m_isValid = false; }

RegisterID* local() const { return m_localRegister.get(); }

RegisterID* propertyName() const { return m_propertyName.get(); }

RegisterID* propertyOffset() const { return m_propertyOffset.get(); }

RegisterID* enumerator() const { return m_enumerator.get(); }

RegisterID* mode() const { return m_mode.get(); }

const std::optional<Variable>& baseVariable() const { return m_baseVariable; }

void addGetInst(unsigned instIndex, int propertyRegIndex)

{

m_getInsts.append(GetInst { instIndex, propertyRegIndex });

}

void addInInst(unsigned instIndex, int propertyRegIndex)

{

m_inInsts.append(InInst { instIndex, propertyRegIndex });

}

void addHasOwnPropertyJump(unsigned branchInstIndex, unsigned genericPathTarget)

{

m_hasOwnPropertyJumpInsts.append(HasOwnPropertyJumpInst { branchInstIndex, genericPathTarget });

}

ForInContext(RegisterID* localRegister, RegisterID* propertyName, RegisterID* propertyOffset, RegisterID* enumerator, RegisterID* mode, std::optional<Variable> baseVariable, unsigned bodyBytecodeStartOffset)

: m_localRegister(localRegister)

, m_propertyName(propertyName)

, m_propertyOffset(propertyOffset)

, m_enumerator(enumerator)

, m_mode(mode)

, m_baseVariable(baseVariable)

, m_bodyBytecodeStartOffset(bodyBytecodeStartOffset)

{ }

unsigned bodyBytecodeStartOffset() const { return m_bodyBytecodeStartOffset; }

void finalize(BytecodeGenerator&, UnlinkedCodeBlockGenerator*, unsigned bodyBytecodeEndOffset);

private:

RefPtr<RegisterID> m_localRegister;

RefPtr<RegisterID> m_propertyName;

RefPtr<RegisterID> m_propertyOffset;

RefPtr<RegisterID> m_enumerator;

RefPtr<RegisterID> m_mode;

std::optional<Variable> m_baseVariable;

bool m_isValid { true };

unsigned m_bodyBytecodeStartOffset;

Vector<InInst> m_inInsts;

Vector<GetInst> m_getInsts;

Vector<HasOwnPropertyJumpInst> m_hasOwnPropertyJumpInsts;

};

struct TryData {

Ref<Label> target;

HandlerType handlerType;

};

struct TryContext {

Ref<Label> start;

TryData* tryData;

};

struct TryRange {

Ref<Label> start;

Ref<Label> end;

TryData* tryData;

};

struct JSGeneratorTraits {

using OpcodeTraits = JSOpcodeTraits;

using OpcodeID = ::JSC::OpcodeID;

using OpNop = ::JSC::OpNop;

using CodeBlock = std::unique_ptr<UnlinkedCodeBlockGenerator>;

using InstructionType = JSInstruction;

static constexpr OpcodeID opcodeForDisablingOptimizations = op_end;

};

class BytecodeGenerator : public BytecodeGeneratorBase<JSGeneratorTraits> {

WTF_MAKE_FAST_ALLOCATED;

WTF_MAKE_NONCOPYABLE(BytecodeGenerator);

friend class FinallyContext;

friend class ForInContext;

friend class StrictModeScope;

template <typename OldOpType, typename NewOpType, typename TupleType>

friend void rewriteOp(BytecodeGenerator&, TupleType&);

public:

typedef DeclarationStacks::FunctionStack FunctionStack;

BytecodeGenerator(VM&, ProgramNode*, UnlinkedProgramCodeBlock*, OptionSet<CodeGenerationMode>, const RefPtr<TDZEnvironmentLink>&, const PrivateNameEnvironment*);

BytecodeGenerator(VM&, FunctionNode*, UnlinkedFunctionCodeBlock*, OptionSet<CodeGenerationMode>, const RefPtr<TDZEnvironmentLink>&, const PrivateNameEnvironment*);

BytecodeGenerator(VM&, EvalNode*, UnlinkedEvalCodeBlock*, OptionSet<CodeGenerationMode>, const RefPtr<TDZEnvironmentLink>&, const PrivateNameEnvironment*);

BytecodeGenerator(VM&, ModuleProgramNode*, UnlinkedModuleProgramCodeBlock*, OptionSet<CodeGenerationMode>, const RefPtr<TDZEnvironmentLink>&, const PrivateNameEnvironment*);

~BytecodeGenerator();

VM& vm() const { return m_vm; }

ParserArena& parserArena() const { return m_scopeNode->parserArena(); }

const CommonIdentifiers& propertyNames() const { return *m_vm.propertyNames; }

bool isConstructor() const { return m_codeBlock->isConstructor(); }

DerivedContextType derivedContextType() const { return m_derivedContextType; }

bool usesArrowFunction() const { return m_scopeNode->usesArrowFunction(); }

bool needsToUpdateArrowFunctionContext() const { return m_needsToUpdateArrowFunctionContext; }

bool usesEval() const { return m_scopeNode->usesEval(); }

bool usesThis() const { return m_scopeNode->usesThis(); }

LexicalScopeFeatures lexicalScopeFeatures() const { return m_scopeNode->lexicalScopeFeatures(); }

PrivateBrandRequirement privateBrandRequirement() const { return m_codeBlock->privateBrandRequirement(); }

ConstructorKind constructorKind() const { return m_codeBlock->constructorKind(); }

SuperBinding superBinding() const { return m_codeBlock->superBinding(); }

JSParserScriptMode scriptMode() const { return m_codeBlock->scriptMode(); }

NeedsClassFieldInitializer needsClassFieldInitializer() const { return m_codeBlock->needsClassFieldInitializer(); }

template<typename Node, typename UnlinkedCodeBlock>

static ParserError generate(VM& vm, Node* node, const SourceCode& sourceCode, UnlinkedCodeBlock* unlinkedCodeBlock, OptionSet<CodeGenerationMode> codeGenerationMode, const RefPtr<TDZEnvironmentLink>& parentScopeTDZVariables, const PrivateNameEnvironment* privateNameEnvironment)

{

MonotonicTime before;

if (UNLIKELY(Options::reportBytecodeCompileTimes()))

before = MonotonicTime::now();

DeferGC deferGC(vm);

auto bytecodeGenerator = makeUnique<BytecodeGenerator>(vm, node, unlinkedCodeBlock, codeGenerationMode, parentScopeTDZVariables, privateNameEnvironment);

unsigned size;

auto result = bytecodeGenerator->generate(size);

if (UNLIKELY(Options::reportBytecodeCompileTimes())) {

MonotonicTime after = MonotonicTime::now();

dataLogLn(result.isValid() ? "Failed to compile #" : "Compiled #", CodeBlockHash(sourceCode, unlinkedCodeBlock->isConstructor() ? CodeForConstruct : CodeForCall), " into bytecode ", size, " instructions in ", (after - before).milliseconds(), " ms.");

}

return result;

}

bool isArgumentNumber(const Identifier&, int);

Variable variable(const Identifier&, ThisResolutionType = ThisResolutionType::Local);

enum ExistingVariableMode { VerifyExisting, IgnoreExisting };

void createVariable(const Identifier&, VarKind, SymbolTable*, ExistingVariableMode = VerifyExisting); // Creates the variable, or asserts that the already-created variable is sufficiently compatible.

// Returns the register storing "this"

RegisterID* thisRegister() { return &m_thisRegister; }

RegisterID* argumentsRegister() { return m_argumentsRegister; }

RegisterID* newTarget()

{

ASSERT(m_newTargetRegister);

return m_newTargetRegister;

}

RegisterID* scopeRegister() { return m_scopeRegister; }

RegisterID* generatorRegister() { return m_generatorRegister; }

RegisterID* promiseRegister() { return m_promiseRegister; }

// The same as newTemporary(), but this function returns "suggestion" if

// "suggestion" is a temporary. This function is helpful in situations

// where you've put "suggestion" in a RefPtr, but you'd like to allow

// the next instruction to overwrite it anyway.

RegisterID* newTemporaryOr(RegisterID* suggestion) { return suggestion->isTemporary() ? suggestion : newTemporary(); }

// Functions for handling of dst register

RegisterID* ignoredResult() { return &m_ignoredResultRegister; }

// This will be allocated in the temporary region of registers, but it will

// not be marked as a temporary. This will ensure that finalDestination() does

// not overwrite a block scope variable that it mistakes as a temporary. These

// registers can be (and are) reclaimed when the lexical scope they belong to

// is no longer on the symbol table stack.

RegisterID* newBlockScopeVariable();

// Returns a place to write intermediate values of an operation

// which reuses dst if it is safe to do so.

RegisterID* tempDestination(RegisterID* dst)

{

return (dst && dst != ignoredResult() && dst->isTemporary()) ? dst : newTemporary();

}

// Returns the place to write the final output of an operation.

RegisterID* finalDestination(RegisterID* originalDst, RegisterID* tempDst = nullptr)

{

if (originalDst && originalDst != ignoredResult())

return originalDst;

ASSERT(tempDst != ignoredResult());

if (tempDst && tempDst->isTemporary())

return tempDst;

return newTemporary();

}

RegisterID* destinationForAssignResult(RegisterID* dst)

{

if (dst && dst != ignoredResult())

return dst->isTemporary() ? dst : newTemporary();

return nullptr;

}

// Moves src to dst if dst is not null and is different from src, otherwise just returns src.

RegisterID* move(RegisterID* dst, RegisterID* src)

{

return dst == ignoredResult() ? nullptr : (dst && dst != src) ? emitMove(dst, src) : src;

}

Ref<LabelScope> newLabelScope(LabelScope::Type, const Identifier* = nullptr);

void emitNode(RegisterID* dst, StatementNode* n)

{

SetForScope tailPositionPoisoner(m_inTailPosition, false);

return emitNodeInTailPosition(dst, n);

}

void emitNodeInTailPosition(RegisterID* dst, StatementNode* n)

{

// Node::emitCode assumes that dst, if provided, is either a local or a referenced temporary.

ASSERT(!dst || dst == ignoredResult() || !dst->isTemporary() || dst->refCount());

if (UNLIKELY(!m_vm.isSafeToRecurse())) {

emitThrowExpressionTooDeepException();

return;

}

if (UNLIKELY(n->needsDebugHook()))

emitDebugHook(n);

n->emitBytecode(*this, dst);

}

ALWAYS_INLINE unsigned addMetadataFor(OpcodeID opcodeID)

{

return m_codeBlock->metadata().addEntry(opcodeID);

}

void emitNode(StatementNode* n)

{

emitNode(nullptr, n);

}

void emitNodeInTailPosition(StatementNode* n)

{

emitNodeInTailPosition(nullptr, n);

}

RegisterID* emitNode(RegisterID* dst, ExpressionNode* n)

{

SetForScope tailPositionPoisoner(m_inTailPosition, false);

return emitNodeInTailPosition(dst, n);

}

RegisterID* emitNodeInTailPosition(RegisterID* dst, ExpressionNode* n)

{

// Node::emitCode assumes that dst, if provided, is either a local or a referenced temporary.

ASSERT(!dst || dst == ignoredResult() || !dst->isTemporary() || dst->refCount());

if (UNLIKELY(!m_vm.isSafeToRecurse()))

return emitThrowExpressionTooDeepException();

if (UNLIKELY(n->needsDebugHook()))

emitDebugHook(n);

return n->emitBytecode(*this, dst);

}

RegisterID* emitNode(ExpressionNode* n)

{

return emitNode(nullptr, n);

}

RegisterID* emitNodeInTailPosition(ExpressionNode* n)

{

return emitNodeInTailPosition(nullptr, n);

}

RegisterID* emitDefineClassElements(PropertyListNode* n, RegisterID* constructor, RegisterID* prototype, Vector<JSTextPosition>& instanceFieldLocations, Vector<JSTextPosition>& staticFieldLocations)

{

ASSERT(constructor->refCount() && prototype->refCount());

if (UNLIKELY(!m_vm.isSafeToRecurse()))

return emitThrowExpressionTooDeepException();

if (UNLIKELY(n->needsDebugHook()))

emitDebugHook(n);

return n->emitBytecode(*this, constructor, prototype, &instanceFieldLocations, &staticFieldLocations);

}

RegisterID* emitNodeForProperty(RegisterID* dst, ExpressionNode* node)

{

if (node->isString()) {

if (std::optional<uint32_t> index = parseIndex(static_cast<StringNode*>(node)->value()))

return emitLoad(dst, jsNumber(index.value()));

}

return emitNode(dst, node);

}

RegisterID* emitNodeForProperty(ExpressionNode* n)

{

return emitNodeForProperty(nullptr, n);

}

void emitNodeInConditionContext(ExpressionNode* n, Label& trueTarget, Label& falseTarget, FallThroughMode fallThroughMode)

{

if (UNLIKELY(!m_vm.isSafeToRecurse())) {

emitThrowExpressionTooDeepException();

return;

}

n->emitBytecodeInConditionContext(*this, trueTarget, falseTarget, fallThroughMode);

}

void emitExpressionInfo(const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd)

{

ASSERT(divot.offset >= divotStart.offset);

ASSERT(divotEnd.offset >= divot.offset);

if (m_isBuiltinFunction)

return;

int sourceOffset = m_scopeNode->source().startOffset();

unsigned firstLine = m_scopeNode->source().firstLine().oneBasedInt();

int divotOffset = divot.offset - sourceOffset;

int startOffset = divot.offset - divotStart.offset;

int endOffset = divotEnd.offset - divot.offset;

unsigned line = divot.line;

ASSERT(line >= firstLine);

line -= firstLine;

int lineStart = divot.lineStartOffset;

if (lineStart > sourceOffset)

lineStart -= sourceOffset;

else

lineStart = 0;

if (divotOffset < lineStart)

return;

unsigned column = divotOffset - lineStart;

unsigned instructionOffset = instructions().size();

m_codeBlock->addExpressionInfo(instructionOffset, divotOffset, startOffset, endOffset, line, column);

}

ALWAYS_INLINE bool leftHandSideNeedsCopy(bool rightHasAssignments, bool rightIsPure)

{

return (m_codeType != FunctionCode || rightHasAssignments) && !rightIsPure;

}

ALWAYS_INLINE RefPtr<RegisterID> emitNodeForLeftHandSide(ExpressionNode* n, bool rightHasAssignments, bool rightIsPure)

{

if (leftHandSideNeedsCopy(rightHasAssignments, rightIsPure)) {

RefPtr<RegisterID> dst = newTemporary();

emitNode(dst.get(), n);

return dst;

}

return emitNode(n);

}

ALWAYS_INLINE RefPtr<RegisterID> emitNodeForLeftHandSideForProperty(ExpressionNode* n, bool rightHasAssignments, bool rightIsPure)

{

if (leftHandSideNeedsCopy(rightHasAssignments, rightIsPure)) {

RefPtr<RegisterID> dst = newTemporary();

emitNodeForProperty(dst.get(), n);

return dst;

}

return emitNodeForProperty(n);

}

void hoistSloppyModeFunctionIfNecessary(const Identifier& functionName);

ForInContext* findForInContext(RegisterID* property);

private:

void emitTypeProfilerExpressionInfo(const JSTextPosition& startDivot, const JSTextPosition& endDivot);

public:

// This doesn't emit expression info. If using this, make sure you shouldn't be emitting text offset.

void emitProfileType(RegisterID* registerToProfile, ProfileTypeBytecodeFlag);

// These variables are associated with variables in a program. They could be Locals, ResolvedClosureVar, or ClosureVar.

void emitProfileType(RegisterID* registerToProfile, const Variable&, const JSTextPosition& startDivot, const JSTextPosition& endDivot);

void emitProfileType(RegisterID* registerToProfile, ProfileTypeBytecodeFlag, const JSTextPosition& startDivot, const JSTextPosition& endDivot);

// These are not associated with variables and don't have a global id.

void emitProfileType(RegisterID* registerToProfile, const JSTextPosition& startDivot, const JSTextPosition& endDivot);

void emitProfileControlFlow(int);

RegisterID* emitLoadArrowFunctionLexicalEnvironment(const Identifier&);

RegisterID* ensureThis();

void emitLoadThisFromArrowFunctionLexicalEnvironment();

RegisterID* emitLoadNewTargetFromArrowFunctionLexicalEnvironment();

unsigned addConstantIndex();

RegisterID* emitLoad(RegisterID* dst, bool);

RegisterID* emitLoad(RegisterID* dst, const Identifier&);

RegisterID* emitLoad(RegisterID* dst, JSValue, SourceCodeRepresentation = SourceCodeRepresentation::Other);

RegisterID* emitLoad(RegisterID* dst, IdentifierSet&& excludedList);

template<typename UnaryOp, typename = std::enable_if_t<UnaryOp::opcodeID != op_negate>>

RegisterID* emitUnaryOp(RegisterID* dst, RegisterID* src)

{

UnaryOp::emit(this, dst, src);

return dst;

}

RegisterID* emitUnaryOp(OpcodeID, RegisterID* dst, RegisterID* src, ResultType);

template<typename BinaryOp>

std::enable_if_t<

BinaryOp::opcodeID != op_add

&& BinaryOp::opcodeID != op_mul

&& BinaryOp::opcodeID != op_sub

&& BinaryOp::opcodeID != op_div,

RegisterID*>

emitBinaryOp(RegisterID* dst, RegisterID* src1, RegisterID* src2, OperandTypes = OperandTypes())

{

BinaryOp::emit(this, dst, src1, src2);

return dst;

}

template<typename BinaryOp>

std::enable_if_t<

BinaryOp::opcodeID == op_add

|| BinaryOp::opcodeID == op_mul

|| BinaryOp::opcodeID == op_sub

|| BinaryOp::opcodeID == op_div,

RegisterID*>

emitBinaryOp(RegisterID* dst, RegisterID* src1, RegisterID* src2, OperandTypes types)

{

BinaryOp::emit(this, dst, src1, src2, m_codeBlock->addBinaryArithProfile(), types);

return dst;

}

RegisterID* emitBinaryOp(OpcodeID, RegisterID* dst, RegisterID* src1, RegisterID* src2, OperandTypes);

template<typename EqOp>

RegisterID* emitEqualityOp(RegisterID* dst, RegisterID* src1, RegisterID* src2)

{

static_assert(EqOp::opcodeID == op_eq || EqOp::opcodeID == op_stricteq);

if (!emitEqualityOpImpl(dst, src1, src2))

EqOp::emit(this, dst, src1, src2);

return dst;

}

bool emitEqualityOpImpl(RegisterID* dst, RegisterID* src1, RegisterID* src2);

RegisterID* emitCreateThis(RegisterID* dst);

RegisterID* emitCreatePromise(RegisterID* dst, RegisterID* newTarget, bool isInternalPromise);

RegisterID* emitCreateGenerator(RegisterID* dst, RegisterID* newTarget);

RegisterID* emitCreateAsyncGenerator(RegisterID* dst, RegisterID* newTarget);

RegisterID* emitCreateArgumentsButterfly(RegisterID* dst);

RegisterID* emitInstanceFieldInitializationIfNeeded(RegisterID* dst, RegisterID* constructor, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd);

void emitTDZCheck(RegisterID* target);

bool needsTDZCheck(const Variable&);

void emitTDZCheckIfNecessary(const Variable&, RegisterID* target, RegisterID* scope);

void liftTDZCheckIfPossible(const Variable&);

RegisterID* emitNewObject(RegisterID* dst);

RegisterID* emitNewPromise(RegisterID* dst, bool isInternalPromise);

RegisterID* emitNewGenerator(RegisterID* dst);

RegisterID* emitNewArray(RegisterID* dst, ElementNode*, unsigned length, IndexingType recommendedIndexingType); // stops at first elision

RegisterID* emitNewArrayBuffer(RegisterID* dst, JSImmutableButterfly*, IndexingType recommendedIndexingType);

// FIXME: new_array_with_spread should use an array allocation profile and take a recommendedIndexingType

RegisterID* emitNewArrayWithSpread(RegisterID* dst, ElementNode*);

RegisterID* emitNewArrayWithSize(RegisterID* dst, RegisterID* length);

RegisterID* emitNewArrayWithSpecies(RegisterID* dst, RegisterID* length, RegisterID* array);

RegisterID* emitNewFunction(RegisterID* dst, FunctionMetadataNode*);

RegisterID* emitNewFunctionExpression(RegisterID* dst, FuncExprNode*);

RegisterID* emitNewDefaultConstructor(RegisterID* dst, ConstructorKind, const Identifier& name, const Identifier& ecmaName, const SourceCode& classSource, NeedsClassFieldInitializer, PrivateBrandRequirement);

RegisterID* emitNewClassFieldInitializerFunction(RegisterID* dst, Vector<JSTextPosition>&& classFieldLocations, bool isDerived);

RegisterID* emitNewArrowFunctionExpression(RegisterID*, ArrowFuncExprNode*);

RegisterID* emitNewMethodDefinition(RegisterID* dst, MethodDefinitionNode*);

RegisterID* emitNewRegExp(RegisterID* dst, RegExp*);

bool shouldSetFunctionName(ExpressionNode*);

void emitSetFunctionName(RegisterID* value, RegisterID* name);

void emitSetFunctionName(RegisterID* value, const Identifier&);

RegisterID* moveLinkTimeConstant(RegisterID* dst, LinkTimeConstant);

RegisterID* moveEmptyValue(RegisterID* dst);

RegisterID* emitToNumber(RegisterID* dst, RegisterID* src);

RegisterID* emitToNumeric(RegisterID* dst, RegisterID* src);

RegisterID* emitToString(RegisterID* dst, RegisterID* src);

RegisterID* emitToObject(RegisterID* dst, RegisterID* src, const Identifier& message);

RegisterID* emitInc(RegisterID* srcDst);

RegisterID* emitDec(RegisterID* srcDst);

RegisterID* emitOverridesHasInstance(RegisterID* dst, RegisterID* constructor, RegisterID* hasInstanceValue);

RegisterID* emitInstanceOf(RegisterID* dst, RegisterID* value, RegisterID* basePrototype);

RegisterID* emitInstanceOfCustom(RegisterID* dst, RegisterID* value, RegisterID* constructor, RegisterID* hasInstanceValue);

RegisterID* emitTypeOf(RegisterID* dst, RegisterID* src);

RegisterID* emitInByVal(RegisterID* dst, RegisterID* property, RegisterID* base);

RegisterID* emitInById(RegisterID* dst, RegisterID* base, const Identifier& property);

RegisterID* emitTryGetById(RegisterID* dst, RegisterID* base, const Identifier& property);

RegisterID* emitGetById(RegisterID* dst, RegisterID* base, const Identifier& property);

RegisterID* emitGetById(RegisterID* dst, RegisterID* base, RegisterID* thisVal, const Identifier& property);

RegisterID* emitDirectGetById(RegisterID* dst, RegisterID* base, const Identifier& property);

RegisterID* emitPutById(RegisterID* base, const Identifier& property, RegisterID* value);

RegisterID* emitPutById(RegisterID* base, RegisterID* thisValue, const Identifier& property, RegisterID* value);

RegisterID* emitDirectPutById(RegisterID* base, const Identifier& property, RegisterID* value);

RegisterID* emitDeleteById(RegisterID* dst, RegisterID* base, const Identifier&);

RegisterID* emitGetByVal(RegisterID* dst, RegisterID* base, RegisterID* property);

RegisterID* emitGetByVal(RegisterID* dst, RegisterID* base, RegisterID* thisValue, RegisterID* property);

RegisterID* emitGetPrototypeOf(RegisterID* dst, RegisterID* value);

template<InvalidPrototypeMode mode>

RegisterID* emitDirectSetPrototypeOf(RegisterID* base, RegisterID* prototype, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd)

{

RefPtr<RegisterID> setPrototypeDirect = moveLinkTimeConstant(nullptr, mode == InvalidPrototypeMode::Throw ? LinkTimeConstant::setPrototypeDirectOrThrow : LinkTimeConstant::setPrototypeDirect);

CallArguments args(*this, nullptr, 1);

move(args.thisRegister(), base);

move(args.argumentRegister(0), prototype);

emitCall(newTemporary(), setPrototypeDirect.get(), NoExpectedFunction, args, divot, divotStart, divotEnd, DebuggableCall::No);

return base;

}

RegisterID* emitPutByVal(RegisterID* base, RegisterID* property, RegisterID* value);

RegisterID* emitPutByVal(RegisterID* base, RegisterID* thisValue, RegisterID* property, RegisterID* value);

RegisterID* emitDirectPutByVal(RegisterID* base, RegisterID* property, RegisterID* value);

RegisterID* emitDeleteByVal(RegisterID* dst, RegisterID* base, RegisterID* property);

RegisterID* emitGetInternalField(RegisterID* dst, RegisterID* base, unsigned index);

RegisterID* emitPutInternalField(RegisterID* base, unsigned index, RegisterID* value);

RegisterID* emitDefinePrivateField(RegisterID* base, RegisterID* property, RegisterID* value);

RegisterID* emitPrivateFieldPut(RegisterID* base, RegisterID* property, RegisterID* value);

RegisterID* emitGetPrivateName(RegisterID* dst, RegisterID* base, RegisterID* property);

RegisterID* emitHasPrivateName(RegisterID* dst, RegisterID* base, RegisterID* property);

void emitCreatePrivateBrand(const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd);

void emitInstallPrivateBrand(RegisterID* target);

void emitInstallPrivateClassBrand(RegisterID* target);

RegisterID* emitGetPrivateBrand(RegisterID* dst, RegisterID* scope, bool isStatic);

RegisterID* emitHasPrivateBrand(RegisterID* dst, RegisterID* base, RegisterID* brand, bool isStatic);

void emitCheckPrivateBrand(RegisterID* base, RegisterID* brand, bool isStatic);

void emitSuperSamplerBegin();

void emitSuperSamplerEnd();

RegisterID* emitIdWithProfile(RegisterID* src, SpeculatedType profile);

void emitUnreachable();

void emitPutGetterById(RegisterID* base, const Identifier& property, unsigned propertyDescriptorOptions, RegisterID* getter);

void emitPutSetterById(RegisterID* base, const Identifier& property, unsigned propertyDescriptorOptions, RegisterID* setter);

void emitPutGetterSetter(RegisterID* base, const Identifier& property, unsigned attributes, RegisterID* getter, RegisterID* setter);

void emitPutGetterByVal(RegisterID* base, RegisterID* property, unsigned propertyDescriptorOptions, RegisterID* getter);

void emitPutSetterByVal(RegisterID* base, RegisterID* property, unsigned propertyDescriptorOptions, RegisterID* setter);

RegisterID* emitGetArgument(RegisterID* dst, int32_t index);

// Initialize object with generator fields (@generatorThis, @generatorNext, @generatorState, @generatorFrame)

void emitPutGeneratorFields(RegisterID* nextFunction);

void emitPutAsyncGeneratorFields(RegisterID* nextFunction);

ExpectedFunction expectedFunctionForIdentifier(const Identifier&);

RegisterID* emitCall(RegisterID* dst, RegisterID* func, ExpectedFunction, CallArguments&, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

RegisterID* emitCallInTailPosition(RegisterID* dst, RegisterID* func, ExpectedFunction, CallArguments&, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

RegisterID* emitCallDirectEval(RegisterID* dst, RegisterID* func, CallArguments&, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

RegisterID* emitCallVarargs(RegisterID* dst, RegisterID* func, RegisterID* thisRegister, RegisterID* arguments, RegisterID* firstFreeRegister, int32_t firstVarArgOffset, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

RegisterID* emitCallVarargsInTailPosition(RegisterID* dst, RegisterID* func, RegisterID* thisRegister, RegisterID* arguments, RegisterID* firstFreeRegister, int32_t firstVarArgOffset, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

RegisterID* emitCallForwardArgumentsInTailPosition(RegisterID* dst, RegisterID* func, RegisterID* thisRegister, RegisterID* firstFreeRegister, int32_t firstVarArgOffset, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd, DebuggableCall);

enum PropertyDescriptorOption {

PropertyConfigurable = 1,

PropertyWritable = 1 << 1,

PropertyEnumerable = 1 << 2,

};

void emitCallDefineProperty(RegisterID* newObj, RegisterID* propertyNameRegister,

RegisterID* valueRegister, RegisterID* getterRegister, RegisterID* setterRegister, unsigned options, const JSTextPosition&);

void emitGenericEnumeration(ThrowableExpressionData* enumerationNode, ExpressionNode* subjectNode, const ScopedLambda<void(BytecodeGenerator&, RegisterID*)>& callBack, ForOfNode* = nullptr, RegisterID* forLoopSymbolTable = nullptr);

void emitEnumeration(ThrowableExpressionData* enumerationNode, ExpressionNode* subjectNode, const ScopedLambda<void(BytecodeGenerator&, RegisterID*)>& callBack, ForOfNode* = nullptr, RegisterID* forLoopSymbolTable = nullptr);

RegisterID* emitGetTemplateObject(RegisterID* dst, TaggedTemplateNode*);

RegisterID* emitGetGlobalPrivate(RegisterID* dst, const Identifier& property);

enum class ReturnFrom { Normal, Finally };

RegisterID* emitReturn(RegisterID* src, ReturnFrom = ReturnFrom::Normal);

RegisterID* emitEnd(RegisterID* src);

RegisterID* emitConstruct(RegisterID* dst, RegisterID* func, RegisterID* lazyThis, ExpectedFunction, CallArguments&, const JSTextPosition& divot, const JSTextPosition& divotStart, const JSTextPosition& divotEnd);

RegisterID* emitStrcat(RegisterID* dst, RegisterID* src, int count);

void emitToPrimitive(RegisterID* dst, RegisterID* src);

RegisterID* emitToPropertyKey(RegisterID* dst, RegisterID* src);

ResolveType resolveType();

RegisterID* emitResolveConstantLocal(RegisterID* dst, const Variable&);

RegisterID* emitResolveScope(RegisterID* dst, const Variable&);

RegisterID* emitGetFromScope(RegisterID* dst, RegisterID* scope, const Variable&, ResolveMode);

RegisterID* emitPutToScope(RegisterID* scope, const Variable&, RegisterID* value, ResolveMode, InitializationMode);

RegisterID* emitResolveScopeForHoistingFuncDeclInEval(RegisterID* dst, const Identifier&);

RegisterID* initializeVariable(const Variable&, RegisterID* value);

void emitLoopHint();

void emitJump(Label& target);

void emitJumpIfTrue(RegisterID* cond, Label& target);

void emitJumpIfFalse(RegisterID* cond, Label& target);

void emitJumpIfNotFunctionCall(RegisterID* cond, Label& target);

void emitJumpIfNotFunctionApply(RegisterID* cond, Label& target);

void emitJumpIfEmptyPropertyNameEnumerator(RegisterID* cond, Label& target);

void emitJumpIfSentinelString(RegisterID* cond, Label& target);

unsigned emitWideJumpIfNotFunctionHasOwnProperty(RegisterID* cond, Label& target);

void recordHasOwnPropertyInForInLoop(ForInContext&, unsigned branchOffset, Label& genericPath);

template<typename BinOp, typename JmpOp>

bool fuseCompareAndJump(RegisterID* cond, Label& target, bool swapOperands = false);

template<typename UnaryOp, typename JmpOp>

bool fuseTestAndJmp(RegisterID* cond, Label& target);

void emitEnter();

void emitCheckTraps();

RegisterID* emitGetPropertyEnumerator(RegisterID* dst, RegisterID* base);

void emitEnumeratorNext(RegisterID* propertyName, RegisterID* mode, RegisterID* index, RegisterID* base, RegisterID* enumerator);

RegisterID* emitEnumeratorHasOwnProperty(RegisterID* dst, RegisterID* base, RegisterID* mode, RegisterID* propertyName, RegisterID* index, RegisterID* enumerator);

RegisterID* emitIsCellWithType(RegisterID* dst, RegisterID* src, JSType);

RegisterID* emitIsGenerator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSGeneratorType); }

RegisterID* emitIsAsyncGenerator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSAsyncGeneratorType); }

RegisterID* emitIsJSArray(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, ArrayType); }

RegisterID* emitIsPromise(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSPromiseType); }

RegisterID* emitIsProxyObject(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, ProxyObjectType); }

RegisterID* emitIsRegExpObject(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, RegExpObjectType); }

RegisterID* emitIsMap(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSMapType); }

RegisterID* emitIsSet(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSSetType); }

RegisterID* emitIsShadowRealm(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, ShadowRealmType); }

RegisterID* emitIsStringIterator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSStringIteratorType); }

RegisterID* emitIsArrayIterator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSArrayIteratorType); }

RegisterID* emitIsMapIterator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSMapIteratorType); }

RegisterID* emitIsSetIterator(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, JSSetIteratorType); }

RegisterID* emitIsObject(RegisterID* dst, RegisterID* src);

RegisterID* emitIsCallable(RegisterID* dst, RegisterID* src);

RegisterID* emitIsConstructor(RegisterID* dst, RegisterID* src);

RegisterID* emitIsNumber(RegisterID* dst, RegisterID* src);

RegisterID* emitIsNull(RegisterID* dst, RegisterID* src) { return emitEqualityOp<OpStricteq>(dst, src, emitLoad(nullptr, jsNull())); }

RegisterID* emitIsUndefined(RegisterID* dst, RegisterID* src) { return emitEqualityOp<OpStricteq>(dst, src, emitLoad(nullptr, jsUndefined())); }

RegisterID* emitIsUndefinedOrNull(RegisterID* dst, RegisterID* src);

RegisterID* emitIsEmpty(RegisterID* dst, RegisterID* src);

RegisterID* emitIsDerivedArray(RegisterID* dst, RegisterID* src) { return emitIsCellWithType(dst, src, DerivedArrayType); }

void emitRequireObjectCoercible(RegisterID* value, ASCIILiteral error);

void emitIteratorOpen(RegisterID* iterator, RegisterID* nextOrIndex, RegisterID* symbolIterator, CallArguments& iterable, const ThrowableExpressionData*);

void emitIteratorNext(RegisterID* done, RegisterID* value, RegisterID* iterable, RegisterID* nextOrIndex, CallArguments& iterator, const ThrowableExpressionData*);

RegisterID* emitGetGenericIterator(RegisterID*, ThrowableExpressionData*);

RegisterID* emitGetAsyncIterator(RegisterID*, ThrowableExpressionData*);

RegisterID* emitIteratorGenericNext(RegisterID* dst, RegisterID* nextMethod, RegisterID* iterator, const ThrowableExpressionData* node, JSC::EmitAwait = JSC::EmitAwait::No);

RegisterID* emitIteratorGenericNextWithValue(RegisterID* dst, RegisterID* nextMethod, RegisterID* iterator, RegisterID* value, const ThrowableExpressionData* node);

void emitIteratorGenericClose(RegisterID* iterator, const ThrowableExpressionData* node, EmitAwait = EmitAwait::No);

RegisterID* emitRestParameter(RegisterID* result, unsigned numParametersToSkip);

bool emitReadOnlyExceptionIfNeeded(const Variable&);

// Start a try block. 'start' must have been emitted.

TryData* pushTry(Label& start, Label& handlerLabel, HandlerType);

// End a try block. 'end' must have been emitted.

void popTry(TryData*, Label& end);

void emitOutOfLineCatchHandler(RegisterID* thrownValueRegister, RegisterID* completionTypeRegister, TryData*);

void emitOutOfLineFinallyHandler(RegisterID* exceptionRegister, RegisterID* completionTypeRegister, TryData*);

void pushClassHeadLexicalScope(VariableEnvironment&);

void popClassHeadLexicalScope(VariableEnvironment&);

private:

static constexpr int CurrentLexicalScopeIndex = -2;

static constexpr int OutermostLexicalScopeIndex = -1;

int currentLexicalScopeIndex() const

{

int size = static_cast<int>(m_lexicalScopeStack.size());

ASSERT(static_cast<size_t>(size) == m_lexicalScopeStack.size());

ASSERT(size >= 0);

if (!size)

return OutermostLexicalScopeIndex;

return size - 1;

}

void emitOutOfLineExceptionHandler(RegisterID* exceptionRegister, RegisterID* thrownValueRegister, RegisterID* completionTypeRegister, TryData*);

public:

void restoreScopeRegister();

void restoreScopeRegister(int lexicalScopeIndex);

int labelScopeDepthToLexicalScopeIndex(int labelScopeDepth);

void emitThrow(RegisterID*);

RegisterID* emitArgumentCount(RegisterID*);

void emitThrowStaticError(ErrorTypeWithExtension, RegisterID*);

void emitThrowStaticError(ErrorTypeWithExtension, const Identifier& message);

void emitThrowReferenceError(ASCIILiteral message);

void emitThrowTypeError(ASCIILiteral message);

void emitThrowTypeError(const Identifier& message);

void emitThrowRangeError(const Identifier& message);

void emitThrowOutOfMemoryError();

void emitPushCatchScope(VariableEnvironment&);

void emitPopCatchScope(VariableEnvironment&);

void emitAwait(RegisterID*);

void emitGetScope();

RegisterID* emitPushWithScope(RegisterID* objectScope);

void emitPopWithScope();

void emitPutThisToArrowFunctionContextScope();

void emitPutNewTargetToArrowFunctionContextScope();

void emitPutDerivedConstructorToArrowFunctionContextScope();

RegisterID* emitLoadDerivedConstructorFromArrowFunctionLexicalEnvironment();

RegisterID* emitLoadDerivedConstructor();

void emitDebugHook(DebugHookType, const JSTextPosition&);

void emitDebugHook(DebugHookType, unsigned line, unsigned charOffset, unsigned lineStart);

void emitDebugHook(StatementNode*);

void emitDebugHook(ExpressionNode*);

void emitWillLeaveCallFrameDebugHook();

RegisterID* emitLoad(RegisterID* dst, CompletionType type) { return emitLoad(dst, jsNumber(static_cast<int32_t>(type))); }

RegisterID* emitLoad(RegisterID* dst, JSGenerator::ResumeMode mode) { return emitLoad(dst, jsNumber(static_cast<int32_t>(mode))); }

bool emitJumpViaFinallyIfNeeded(int targetLabelScopeDepth, Label& jumpTarget);

bool emitReturnViaFinallyIfNeeded(RegisterID* returnRegister);

void emitFinallyCompletion(FinallyContext&, Label& normalCompletionLabel);

public:

void pushFinallyControlFlowScope(FinallyContext&);

void popFinallyControlFlowScope();

void pushOptionalChainTarget();

void popOptionalChainTarget();

void popOptionalChainTarget(RegisterID* dst, bool isDelete);

void emitOptionalCheck(RegisterID* src);

void pushForInScope(RegisterID* local, RegisterID* propertyName, RegisterID* propertyOffset, RegisterID* enumerator, RegisterID* mode, std::optional<Variable> base);