scala3-compiler-bootstrapped
DocsAPI
Generated with
Copyright (c) 2002-2025, LAMP/EPFL
Copyright (c) 2002-2025, LAMP/EPFL
scala3-compiler-bootstrapped/dotty.tools/dotty.tools.sjs.ir/Trees

Trees

dotty.tools.sjs.ir.Trees
object Trees

Attributes

Graph
Supertypes
class Object
trait Matchable
class Any
Self type
Trees.type

Members list

Type members

Classlikes

sealed abstract class AnyFieldDef extends MemberDef

Attributes

Supertypes
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Known subtypes
class FieldDef
class JSFieldDef
sealed case class Apply(flags: ApplyFlags, receiver: Tree, method: MethodIdent, args: List[Tree])(tpe: Type)(implicit pos: Position) extends Tree

Apply an instance method with dynamic dispatch (the default).

Apply an instance method with dynamic dispatch (the default).

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ApplyDynamicImport(flags: ApplyFlags, className: ClassName, method: MethodIdent, args: List[Tree])(implicit pos: Position) extends Tree

Apply a static method via dynamic import.

Apply a static method via dynamic import.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
final class ApplyFlags extends AnyVal

Attributes

Companion
object
Supertypes
class AnyVal
trait Matchable
class Any
object ApplyFlags

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
ApplyFlags.type
sealed case class ApplyStatic(flags: ApplyFlags, className: ClassName, method: MethodIdent, args: List[Tree])(tpe: Type)(implicit pos: Position) extends Tree

Apply a static method.

Apply a static method.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ApplyStatically(flags: ApplyFlags, receiver: Tree, className: ClassName, method: MethodIdent, args: List[Tree])(tpe: Type)(implicit pos: Position) extends Tree

Apply an instance method with static dispatch (e.g., super calls).

Apply an instance method with static dispatch (e.g., super calls).

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ApplyTypedClosure(flags: ApplyFlags, fun: Tree, args: List[Tree])(implicit pos: Position) extends Tree

Apply a typed closure

Apply a typed closure

The given fun must have a closure type.

The arguments' types must match (be subtypes of) the parameter types of the closure type.

The tpe of this node is the result type of the closure type, or nothing if the latter is nothing.

Evaluation steps are as follows:

  1. Let funV be the result of evaluating fun.
  2. If funV is nullClosure, trigger an NPE undefined behavior.
  3. Let argsV be the result of evaluating args, in order.
  4. Invoke funV with arguments argsV, and return the result.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ArraySelect(array: Tree, index: Tree)(tpe: Type)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ArrayValue(typeRef: ArrayTypeRef, elems: List[Tree])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class AsInstanceOf(expr: Tree, tpe: Type)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Assign(lhs: AssignLhs, rhs: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed trait AssignLhs extends Tree

Attributes

Supertypes
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
Known subtypes
class ArraySelect
class JSGlobalRef
class JSSelect
class RecordSelect
class Select
class SelectStatic
class VarRef
Show all
sealed case class BinaryOp(op: Code, lhs: Tree, rhs: Tree)(implicit pos: Position) extends Tree

Binary operation.

Binary operation.

All binary operations follow common evaluation steps:

  1. Let lhsValue be the result of evaluating lhs.
  2. Let rhsValue be the result of evaluating rhs.
  3. Perform an operation that depends on op, lhsValue and rhsValue.

Unless lhsValue throws, rhsValue will therefore always be evaluated, even if the operation op would throw based only on lhsValue.

The integer dividing operators (Int_/, Int_%, Long_/ and Long_%) throw an ArithmeticException when their right-hand-side is 0. That exception is not subject to undefined behavior.

String_charAt throws a StringIndexOutOfBoundsException.

The Class_x operations take a jl.Class! as lhs, i.e., a non-nullable jl.Class. Class_isAssignableFrom also takes a jl.Class! as rhs.

  • Class_isInstance and Class_isAssignableFrom are pure.
  • Class_cast throws a CCE if its second argument is non-null and not an instance of the class represented by its first argument.
  • Class_newArray throws a NegativeArraySizeException if its second argument is negative and an IllegalArgumentException if its first argument is classOf[Unit].

Otherwise, binary operations preserve pureness.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object BinaryOp

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
BinaryOp.type
sealed class Block extends Tree

Attributes

Companion
object
Supertypes
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object Block

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
Block.type
sealed case class BooleanLiteral(value: Boolean)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ByteLiteral(value: Byte)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class CharLiteral(value: Char)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
final class ClassDef(val name: ClassIdent, val originalName: OriginalName, val kind: ClassKind, val jsClassCaptures: Option[List[ParamDef]], val superClass: Option[ClassIdent], val interfaces: List[ClassIdent], val jsSuperClass: Option[Tree], val jsNativeLoadSpec: Option[JSNativeLoadSpec], val fields: List[AnyFieldDef], val methods: List[MethodDef], val jsConstructor: Option[JSConstructorDef], val jsMethodProps: List[JSMethodPropDef], val jsNativeMembers: List[JSNativeMemberDef], val topLevelExportDefs: List[TopLevelExportDef])(val optimizerHints: OptimizerHints)(implicit val pos: Position) extends IRNode

Attributes

Companion
object
Supertypes
class IRNode
class Object
trait Matchable
class Any
object ClassDef

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
ClassDef.type
sealed case class ClassIdent(name: ClassName)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ClassOf(typeRef: TypeRef)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Closure(flags: ClosureFlags, captureParams: List[ParamDef], params: List[ParamDef], restParam: Option[ParamDef], resultType: Type, body: Tree, captureValues: List[Tree])(implicit pos: Position) extends Tree

Closure with explicit captures.

Closure with explicit captures.

If flags.typed is true, this is a typed closure with a ClosureType. In that case, flags.arrow must be true, and restParam must be None. Typed closures cannot be passed to JavaScript code. This is enforced at the type system level, since ClosureTypes are not subtypes of AnyType. The only meaningful operation one can perform on a typed closure is to call it using ApplyTypedClosure.

If flags.typed is false, this is a JavaScript closure with type AnyNotNullType. In that case, the ptpe or all params and resultType must all be AnyType.

If flags.arrow is true, the closure is an Arrow Function (=>), which does not have a this parameter, and cannot be constructed (called with new). If false, it is a regular Function (function), which does have a this parameter of type AnyType. Typed closures are always Arrow functions, since they do not have a this parameter.

If flags.async is true, it is an async closure. Async closures return a Promise of their body, and can contain JSAwait nodes. flags.typed and flags.async cannot both be true.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
final class ClosureFlags extends AnyVal

Attributes

Companion
object
Supertypes
class AnyVal
trait Matchable
class Any
object ClosureFlags

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed case class CreateJSClass(className: ClassName, captureValues: List[Tree])(implicit pos: Position) extends Tree

Creates a JavaScript class value.

Creates a JavaScript class value.

Value parameters

captureValues

Actual values for the captured parameters (in the ClassDef's jsClassCaptures.get)

className

Reference to the ClassDef for the class definition, which must have jsClassCaptures.nonEmpty

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Debugger()(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class DoubleLiteral(value: Double)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class FieldDef(flags: MemberFlags, name: FieldIdent, originalName: OriginalName, ftpe: Type)(implicit pos: Position) extends AnyFieldDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class AnyFieldDef
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class FieldIdent(name: FieldName)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class FloatLiteral(value: Float)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ForIn(obj: Tree, keyVar: LocalIdent, keyVarOriginalName: OriginalName, body: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed abstract class IRNode

Base class for all nodes in the IR.

Base class for all nodes in the IR.

Usually, one of the direct subclasses of IRNode should be used instead.

Attributes

Supertypes
class Object
trait Matchable
class Any
Known subtypes
class ClassDef
class ClassIdent
class FieldIdent
class JSSpread
class LocalIdent
class MemberDef
class AnyFieldDef
class FieldDef
class JSFieldDef
class JSMethodDef
class MethodDef
class MethodIdent
class ParamDef
class Tree
class Apply
class ApplyStatic
class ArrayValue
class AsInstanceOf
class Assign
trait AssignLhs
class ArraySelect
class JSGlobalRef
class JSSelect
class RecordSelect
class Select
class SelectStatic
class VarRef
class BinaryOp
class Block
class Closure
class Debugger
class ForIn
class If
class IsInstanceOf
class JSAwait
class JSBinaryOp
class JSDelete
class JSImportCall
class JSImportMeta
class JSNew
class JSNewTarget
class JSUnaryOp
class Labeled
trait Literal
class ByteLiteral
class CharLiteral
class ClassOf
class FloatLiteral
class LongLiteral
class IntLiteral
class Null
class ShortLiteral
class Undefined
class LoadJSModule
class LoadModule
class Match
class New
class NewArray
class NewLambda
class RecordValue
class Return
class Skip
class StoreModule
class Transient
class TryCatch
class TryFinally
class UnaryOp
class VarDef
class While
Show all
sealed case class If(cond: Tree, thenp: Tree, elsep: Tree)(tpe: Type)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class IntLiteral(value: Int)(implicit pos: Position) extends MatchableLiteral

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class IsInstanceOf(expr: Tree, testType: Type)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSArrayConstr(items: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSAwait(arg: Tree)(implicit pos: Position) extends Tree

await arg.

await arg.

This is directly equivalent to a JavaScript await expression.

If used directly within a Closure node with the async flag, this node is always valid. However, when used anywhere else, it is an "orphan" await. Orphan awaits only link when targeting WebAssembly.

This is not a UnaryOp because of the above strict scoping rule. For example, unless it is orphan to begin with, it is not safe to pull this node out of or into an intervening closure, contrary to UnaryOps.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSBinaryOp(op: Code, lhs: Tree, rhs: Tree)(implicit pos: Position) extends Tree

JavaScript binary operation.

JavaScript binary operation.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object JSBinaryOp

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
JSBinaryOp.type
sealed case class JSConstructorBody(beforeSuper: List[Tree], superCall: JSSuperConstructorCall, afterSuper: List[Tree])(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSConstructorDef(flags: MemberFlags, args: List[ParamDef], restParam: Option[ParamDef], body: JSConstructorBody)(optimizerHints: OptimizerHints, version: Version)(implicit pos: Position) extends VersionedMemberDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSDelete(qualifier: Tree, item: Tree)(implicit pos: Position) extends Tree

delete qualifier[item]

delete qualifier[item]

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSFieldDef(flags: MemberFlags, name: Tree, ftpe: Type)(implicit pos: Position) extends AnyFieldDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class AnyFieldDef
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSFunctionApply(fun: Tree, args: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSGlobalRef(name: String)(implicit pos: Position) extends AssignLhs

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object JSGlobalRef

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed case class JSImportCall(arg: Tree)(implicit pos: Position) extends Tree

JavaScript dynamic import of the form import(arg).

JavaScript dynamic import of the form import(arg).

This form is its own node, rather than using something like

JSFunctionApply(JSImport())

because import is not a first-class term in JavaScript. ImportCall is a dedicated syntactic form that cannot be dissociated.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSImportMeta()(implicit pos: Position) extends Tree

JavaScript meta-property import.meta.

JavaScript meta-property import.meta.

This form is its own node, rather than using something like

JSSelect(JSImport(), StringLiteral("meta"))

because import is not a first-class term in JavaScript. import.meta is a dedicated syntactic form that cannot be dissociated.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSMethodApply(receiver: Tree, method: Tree, args: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSMethodDef(flags: MemberFlags, name: Tree, args: List[ParamDef], restParam: Option[ParamDef], body: Tree)(optimizerHints: OptimizerHints, version: Version)(implicit pos: Position) extends JSMethodPropDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed abstract class JSMethodPropDef extends VersionedMemberDef

Attributes

Supertypes
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
Known subtypes
class JSMethodDef
sealed abstract class JSNativeLoadSpec

Loading specification for a native JS class or object.

Loading specification for a native JS class or object.

Attributes

Companion
object
Supertypes
class Object
trait Matchable
class Any
Known subtypes
class Global
class Import
object JSNativeLoadSpec

Attributes

Companion
class
Supertypes
trait Sum
trait Mirror
class Object
trait Matchable
class Any
Self type
sealed case class JSNativeMemberDef(flags: MemberFlags, name: MethodIdent, jsNativeLoadSpec: JSNativeLoadSpec)(implicit pos: Position) extends MemberDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSNew(ctor: Tree, args: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSNewTarget()(implicit pos: Position) extends Tree

JavaScript meta-property new.target.

JavaScript meta-property new.target.

This form is its own node, rather than using something like

JSSelect(JSNew(), StringLiteral("target"))

because new is not a first-class term in JavaScript. new.target is a dedicated syntactic form that cannot be dissociated.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSObjectConstr(fields: List[(Tree, Tree)])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSPrivateSelect(qualifier: Tree, field: FieldIdent)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSPropertyDef(flags: MemberFlags, name: Tree, getterBody: Option[Tree], setterArgAndBody: Option[(ParamDef, Tree)])(version: Version)(implicit pos: Position) extends JSMethodPropDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSSelect(qualifier: Tree, item: Tree)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSSpread(items: Tree)(implicit pos: Position) extends IRNode, TreeOrJSSpread

...items, the "spread" operator of ECMAScript 6.

...items, the "spread" operator of ECMAScript 6.

Value parameters

items

An Array whose items will be spread (not an arbitrary iterable)

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSSuperConstructorCall(args: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Super constructor call in the constructor of a non-native JS class.

Super constructor call in the constructor of a non-native JS class.

Exactly one such node must appear in the constructor of a non-native JS class, at the top-level (possibly as a direct child of a top-level Block). Any other use of this node is invalid.

Statements before this node, as well as the args, cannot contain any This() node. Statements after this node can use This().

After the execution of this node, it is guaranteed that all fields declared in the current class have been created and initialized. Up to that point, accessing any field declared in this class (e.g., through an overridden method called from the super constructor) is undefined behavior.

All in all, the shape of a constructor is therefore:

{
  statementsNotUsingThis();
  JSSuperConstructorCall(...argsNotUsingThis);
  statementsThatMayUseThis()
}

which currently translates to something of the following shape:

{
  statementsNotUsingThis();
  super(...argsNotUsingThis);
  this.privateField1 = 0;
  this["publicField2"] = false;
  statementsThatMayUseThis()
}

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSSuperMethodCall(superClass: Tree, receiver: Tree, method: Tree, args: List[TreeOrJSSpread])(implicit pos: Position) extends Tree

Calls a method inherited from the given superClass on receiver.

Calls a method inherited from the given superClass on receiver.

Intuitively, this corresponds to

superClass.prototype[method].call(receiver, ...args)

but retains more structure at the IR level than using an explicit encoding of the above expression.

Given the non-native JS classes

class Bar extends js.Object
class Foo extends Bar

The node

JSSuperBrackerCall(LoadJSConstructor(ClassName("Bar")), receiver, method, args)

which is printed as

super(constructorOf[Bar])::receiver[method](...args)

has the following semantics:

Bar.prototype[method].call(receiver, ...args)

If this happens to be located in an instance method of Foo, and receiver happens to be This(), this is equivalent to the ES6 statement

super[method](...args)

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSSuperSelect(superClass: Tree, receiver: Tree, item: Tree)(implicit pos: Position) extends AssignLhs

Selects a property inherited from the given superClass on receiver.

Selects a property inherited from the given superClass on receiver.

Given the non-native JS classes

class Bar extends js.Object
class Foo extends Bar

The node

JSSuperBrackerSelect(LoadJSConstructor(ClassName("Bar")), qualifier, item)

which is printed as

super(constructorOf[Bar])::qualifier[item]

has the semantics of an ES6 super reference

super[item]

as if it were in an instance method of Foo with qualifier as the this value.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSTypeOfGlobalRef(globalRef: JSGlobalRef)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class JSUnaryOp(op: Code, lhs: Tree)(implicit pos: Position) extends Tree

JavaScript unary operation.

JavaScript unary operation.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object JSUnaryOp

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
JSUnaryOp.type
sealed case class Labeled(label: LabelName, tpe: Type, body: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class LinkTimeProperty(name: String)(tpe: Type)(implicit pos: Position) extends Tree

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object LinkTimeProperty

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed trait Literal extends Tree

Marker for literals. Literals are always pure.

Marker for literals. Literals are always pure.

All Literals can be compared for equality. The equality does not take the pos into account.

Attributes

Supertypes
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
Known subtypes
class ByteLiteral
class CharLiteral
class ClassOf
class FloatLiteral
class LongLiteral
class IntLiteral
class Null
class ShortLiteral
class Undefined
Show all
sealed case class LoadJSConstructor(className: ClassName)(implicit pos: Position) extends Tree

Loads the constructor of a JS class (native or not).

Loads the constructor of a JS class (native or not).

className must represent a non-trait JS class (native or not).

This is used typically to instantiate a JS class, and most importantly if it is a non-native JS class. Given the class

class Foo(x: Int) extends js.Object

The instantiation new Foo(1) would be represented as

JSNew(LoadJSConstructor(ClassName("Foo")), List(IntLiteral(1)))

This node is also useful to encode o.isInstanceOf[Foo]:

JSBinaryOp(instanceof, o, LoadJSConstructor(ClassName("Foo")))

If Foo is non-native, the presence of this node makes it instantiable, and therefore reachable.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class LoadJSModule(className: ClassName)(implicit pos: Position) extends Tree

Like LoadModule but for a JS module class.

Like LoadModule but for a JS module class.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class LoadModule(className: ClassName)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class LocalIdent(name: LocalName)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class LongLiteral(value: Long)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Match(selector: Tree, cases: List[(List[MatchableLiteral], Tree)], default: Tree)(tpe: Type)(implicit pos: Position) extends Tree

A break-free switch (without fallthrough behavior).

A break-free switch (without fallthrough behavior).

Unlike a JavaScript switch, it can be used in expression position. It supports alternatives explicitly (hence the List[MatchableLiteral] in cases), whereas in a switch one would use the fallthrough behavior to implement alternatives. (This is not a pattern matching construct like in Scala.)

The selector must be either an int (IntType) or a java.lang.String. The cases can be any MatchableLiteral, even if they do not make sense for the type of the selecter (they simply will never match).

Because +0.0 === -0.0 in JavaScript, and because those semantics are used in a JS switch, we have to prevent the selector from ever being -0.0. Otherwise, it would be matched by a case IntLiteral(0). At the same time, we must allow at least int and java.lang.String to support all switchable matches from Scala. Since the latter two have no common super type that does not allow -0.0, we really have to special-case those two types.

This is also why we restrict MatchableLiterals to IntLiteral, StringLiteral and Null. Allowing more cases would only make IR checking more complicated, without bringing any added value.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed trait MatchableLiteral extends Literal

Marker for literals that can be used in a Match case.

Marker for literals that can be used in a Match case.

Matchable literals are:

  • IntLiteral
  • StringLiteral
  • Null

See Match for the rationale about that specific set.

Attributes

Supertypes
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
Known subtypes
class IntLiteral
class Null
sealed abstract class MemberDef extends IRNode

Any member of a ClassDef.

Any member of a ClassDef.

Partitioned into AnyFieldDef, MethodDef, JSConstructorDef and JSMethodPropDef.

Attributes

Supertypes
class IRNode
class Object
trait Matchable
class Any
Known subtypes
class AnyFieldDef
class FieldDef
class JSFieldDef
class JSMethodDef
class MethodDef
Show all
final class MemberFlags extends AnyVal

Attributes

Companion
object
Supertypes
class AnyVal
trait Matchable
class Any
object MemberFlags

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
final class MemberNamespace extends AnyVal

Attributes

Companion
object
Supertypes
class AnyVal
trait Matchable
class Any
object MemberNamespace

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed case class MethodDef(flags: MemberFlags, name: MethodIdent, originalName: OriginalName, args: List[ParamDef], resultType: Type, body: Option[Tree])(optimizerHints: OptimizerHints, version: Version)(implicit pos: Position) extends VersionedMemberDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class MethodIdent(name: MethodName)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class New(className: ClassName, ctor: MethodIdent, args: List[Tree])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class NewArray(typeRef: ArrayTypeRef, length: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class NewLambda(descriptor: Descriptor, fun: Tree)(tpe: Type)(implicit pos: Position) extends Tree

New lambda instance of a SAM class.

New lambda instance of a SAM class.

Functionally, a NewLambda is equivalent to an instance of an anonymous class with the following shape:

val funV: ((...Ts) => R)! = fun;
(new superClass with interfaces {
  def <this>() = this.superClass::<init>()
  def methodName(...args: Ts): R = funV(...args)
}): tpe

where superClass, interfaces, methodName, Ts and R are taken from the descriptor. Ts and R are the paramTypes and resultType of the descriptor. They are required because there is no one-to-one mapping between TypeRefs and Types, and we want the shape of the class to be a deterministic function of the descriptor.

The fun must have type ((...Ts) => R)!.

Intuitively, tpe must be a supertype of superClass! & ...interfaces!. Since our type system does not have intersection types, in practice this means that there must exist C ∈ { superClass } ∪ interfaces such that tpe is a supertype of C!.

The uniqueness of the anonymous class and its run-time class name are not guaranteed.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object NewLambda

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
NewLambda.type
sealed case class Null()(implicit pos: Position) extends MatchableLiteral

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
final class OptimizerHints extends AnyVal

Attributes

Companion
object
Supertypes
class AnyVal
trait Matchable
class Any
object OptimizerHints

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed case class ParamDef(name: LocalIdent, originalName: OriginalName, ptpe: Type, mutable: Boolean)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class RecordSelect(record: Tree, field: SimpleFieldIdent)(tpe: Type)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class RecordValue(tpe: RecordType, elems: List[Tree])(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Return(expr: Tree, label: LabelName)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Select(qualifier: Tree, field: FieldIdent)(tpe: Type)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class SelectJSNativeMember(className: ClassName, member: MethodIdent)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class SelectStatic(field: FieldIdent)(tpe: Type)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class ShortLiteral(value: Short)(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class SimpleFieldIdent(name: SimpleFieldName)(implicit pos: Position) extends IRNode

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Skip()(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class StoreModule()(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class StringLiteral(value: String)(implicit pos: Position) extends MatchableLiteral

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object This

Convenience constructor and extractor for VarRefs representing this bindings.

Convenience constructor and extractor for VarRefs representing this bindings.

Attributes

Supertypes
class Object
trait Matchable
class Any
Self type
This.type
sealed abstract class TopLevelExportDef extends IRNode

Attributes

Companion
object
Supertypes
class IRNode
class Object
trait Matchable
class Any
Known subtypes
object TopLevelExportDef

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
sealed case class TopLevelFieldExportDef(moduleID: String, exportName: String, field: FieldIdent)(implicit pos: Position) extends TopLevelExportDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class TopLevelJSClassExportDef(moduleID: String, exportName: String)(implicit pos: Position) extends TopLevelExportDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class TopLevelMethodExportDef(moduleID: String, methodDef: JSMethodDef)(implicit pos: Position) extends TopLevelExportDef

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class TopLevelModuleExportDef(moduleID: String, exportName: String)(implicit pos: Position) extends TopLevelExportDef

Export for a top-level object.

Export for a top-level object.

This exports the singleton instance of the containing module class. The instance is initialized during ES module instantiation.

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class Transient(value: Value)(implicit pos: Position) extends Tree

A transient node for custom purposes.

A transient node for custom purposes.

A transient node is never a valid input to the Serializers nor to the linker, but can be used in a transient state for internal purposes.

Value parameters

value

The payload of the transient node, without any specified meaning.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object Transient

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
Transient.type
sealed abstract class Tree extends IRNode, TreeOrJSSpread

Node for a statement or expression in the IR.

Node for a statement or expression in the IR.

Attributes

Supertypes
class IRNode
class Object
trait Matchable
class Any
Known subtypes
class Apply
class ApplyStatic
class ArrayValue
class AsInstanceOf
class Assign
trait AssignLhs
class ArraySelect
class JSGlobalRef
class JSSelect
class RecordSelect
class Select
class SelectStatic
class VarRef
class BinaryOp
class Block
class Closure
class Debugger
class ForIn
class If
class IsInstanceOf
class JSAwait
class JSBinaryOp
class JSDelete
class JSImportCall
class JSImportMeta
class JSNew
class JSNewTarget
class JSUnaryOp
class Labeled
trait Literal
class ByteLiteral
class CharLiteral
class ClassOf
class FloatLiteral
class LongLiteral
class IntLiteral
class Null
class ShortLiteral
class Undefined
class LoadJSModule
class LoadModule
class Match
class New
class NewArray
class NewLambda
class RecordValue
class Return
class Skip
class StoreModule
class Transient
class TryCatch
class TryFinally
class UnaryOp
class VarDef
class While
Show all
sealed trait TreeOrJSSpread extends IRNode

Either a Tree or a JSSpread.

Either a Tree or a JSSpread.

This is the type of actual arguments to JS applications.

Attributes

Supertypes
class IRNode
class Object
trait Matchable
class Any
Known subtypes
class JSSpread
class Tree
class Apply
class ApplyStatic
class ArrayValue
class AsInstanceOf
class Assign
trait AssignLhs
class ArraySelect
class JSGlobalRef
class JSSelect
class RecordSelect
class Select
class SelectStatic
class VarRef
class BinaryOp
class Block
class Closure
class Debugger
class ForIn
class If
class IsInstanceOf
class JSAwait
class JSBinaryOp
class JSDelete
class JSImportCall
class JSImportMeta
class JSNew
class JSNewTarget
class JSUnaryOp
class Labeled
trait Literal
class ByteLiteral
class CharLiteral
class ClassOf
class FloatLiteral
class LongLiteral
class IntLiteral
class Null
class ShortLiteral
class Undefined
class LoadJSModule
class LoadModule
class Match
class New
class NewArray
class NewLambda
class RecordValue
class Return
class Skip
class StoreModule
class Transient
class TryCatch
class TryFinally
class UnaryOp
class VarDef
class While
Show all
sealed case class TryCatch(block: Tree, errVar: LocalIdent, errVarOriginalName: OriginalName, handler: Tree)(tpe: Type)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class TryFinally(block: Tree, finalizer: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class UnaryOp(op: Code, lhs: Tree)(implicit pos: Position) extends Tree

Unary operation.

Unary operation.

All unary operations follow common evaluation steps:

  1. Let lhsValue be the result of evaluating lhs.
  2. Perform an operation that depends on op and lhsValue.

The Class_x operations take a jl.Class! argument, i.e., a non-nullable jl.Class.

Likewise, Array_length, GetClass, Clone and UnwrapFromThrowable take arguments of non-nullable types.

CheckNotNull throws NPEs subject to UB.

Throw always throws, obviously.

Clone and WrapAsThrowable are side-effect-free but not pure.

Otherwise, unary operations preserve pureness.

Attributes

Companion
object
Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
object UnaryOp

Attributes

Companion
class
Supertypes
class Object
trait Matchable
class Any
Self type
UnaryOp.type
sealed case class Undefined()(implicit pos: Position) extends Literal

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait Literal
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class VarDef(name: LocalIdent, originalName: OriginalName, vtpe: Type, mutable: Boolean, rhs: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed case class VarRef(name: LocalName)(tpe: Type)(implicit pos: Position) extends AssignLhs

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
trait AssignLhs
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all
sealed trait VersionedMemberDef extends MemberDef

Attributes

Supertypes
class MemberDef
class IRNode
class Object
trait Matchable
class Any
Known subtypes
class JSMethodDef
class MethodDef
sealed case class While(cond: Tree, body: Tree)(implicit pos: Position) extends Tree

Attributes

Supertypes
trait Serializable
trait Product
trait Equals
class Tree
class IRNode
class Object
trait Matchable
class Any
Show all

Value members

Concrete methods

def isJSIdentifierName(name: String): Boolean

Tests whether the given name is a valid JavaScript identifier name.

Tests whether the given name is a valid JavaScript identifier name.

This test does not exclude keywords.

Attributes

Generated with
Copyright (c) 2002-2025, LAMP/EPFL
Copyright (c) 2002-2025, LAMP/EPFL