Types

object Types
class Object
trait Matchable
class Any

Type members

Classlikes

case
object AnyType extends Type

Any type (the top type of this type system). A variable of this type can contain any value, including undefined and null and any JS value. This type supports a very limited set of Scala operations, the ones common to all values. Basically only reference equality tests and instance tests. It also supports all JavaScript operations, since all Scala objects are also genuine JavaScript objects. The type java.lang.Object in the back-end maps to AnyType because it can hold JS values (not only instances of Scala.js classes).

Any type (the top type of this type system). A variable of this type can contain any value, including undefined and null and any JS value. This type supports a very limited set of Scala operations, the ones common to all values. Basically only reference equality tests and instance tests. It also supports all JavaScript operations, since all Scala objects are also genuine JavaScript objects. The type java.lang.Object in the back-end maps to AnyType because it can hold JS values (not only instances of Scala.js classes).

final case
class ArrayType(arrayTypeRef: ArrayTypeRef) extends Type

Array type.

Array type.

final case
class ArrayTypeRef(base: NonArrayTypeRef, dimensions: Int) extends TypeRef

Array type.

Array type.

Companion
object
Companion
class
case

Boolean type. It does not accept null nor undefined.

Boolean type. It does not accept null nor undefined.

case
object ByteType extends PrimTypeWithRef

8-bit signed integer type. It does not accept null nor undefined.

8-bit signed integer type. It does not accept null nor undefined.

case
object CharType extends PrimTypeWithRef

Char type, a 16-bit UTF-16 code unit. It does not accept null nor undefined.

Char type, a 16-bit UTF-16 code unit. It does not accept null nor undefined.

final case
class ClassRef(className: ClassName) extends NonArrayTypeRef

Class (or interface) type.

Class (or interface) type.

final case
class ClassType(className: ClassName) extends Type

Class (or interface) type.

Class (or interface) type.

case

Double type (64-bit). It does not accept null nor undefined.

Double type (64-bit). It does not accept null nor undefined.

case
object FloatType extends PrimTypeWithRef

Float type (32-bit). It does not accept null nor undefined.

Float type (32-bit). It does not accept null nor undefined.

case
object IntType extends PrimTypeWithRef

32-bit signed integer type. It does not accept null nor undefined.

32-bit signed integer type. It does not accept null nor undefined.

case
object LongType extends PrimTypeWithRef

64-bit signed integer type. It does not accept null nor undefined.

64-bit signed integer type. It does not accept null nor undefined.

case
object NoType extends PrimTypeWithRef

No type.

No type.

sealed abstract
class NonArrayTypeRef extends TypeRef
case

Nothing type (the bottom type of this type system). Expressions from which one can never come back are typed as Nothing. For example, throw and return.

Nothing type (the bottom type of this type system). Expressions from which one can never come back are typed as Nothing. For example, throw and return.

case
object NullType extends PrimTypeWithRef

The type of null. It does not accept undefined. The null type is a subtype of all class types and array types.

The type of null. It does not accept undefined. The null type is a subtype of all class types and array types.

final case
class PrimRef extends NonArrayTypeRef

Primitive type reference.

Primitive type reference.

sealed abstract
class PrimType extends Type
sealed abstract
final case
class RecordType(fields: List[Field]) extends Type

Record type. Used by the optimizer to inline classes as records with multiple fields. They are desugared as several local variables by JSDesugaring. Record types cannot cross method boundaries, so they cannot appear as the type of fields or parameters, nor as result types of methods. The compiler itself never generates record types.

Record type. Used by the optimizer to inline classes as records with multiple fields. They are desugared as several local variables by JSDesugaring. Record types cannot cross method boundaries, so they cannot appear as the type of fields or parameters, nor as result types of methods. The compiler itself never generates record types.

Companion
object
object RecordType
Companion
class
case
object ShortType extends PrimTypeWithRef

16-bit signed integer type. It does not accept null nor undefined.

16-bit signed integer type. It does not accept null nor undefined.

case
object StringType extends PrimType

String type. It does not accept null nor undefined.

String type. It does not accept null nor undefined.

sealed abstract
class Type

Type of a term (expression or statement) in the IR.

Type of a term (expression or statement) in the IR.

There is a many-to-one relationship from TypeRefs to Types, because java.lang.Object and JS types all collapse to AnyType.

In fact, there are two Types that do not have any real equivalent in type refs: StringType and UndefType, as they refer to the non-null variants of java.lang.String and java.lang.Void, respectively.

sealed abstract
class TypeRef

Type reference (allowed for classOf[], is/asInstanceOf[]).

Type reference (allowed for classOf[], is/asInstanceOf[]).

A TypeRef has exactly the same level of precision as a JVM type. There is a one-to-one relationship between a TypeRef and an instance of java.lang.Class at run-time. This means that:

  • All primitive types have their TypeRef (including scala.Byte and scala.Short), and they are different from their boxed versions.
  • JS types are not erased to any
  • Array types are like on the JVM

A TypeRef therefore uniquely identifies a classOf[T]. It is also the type refs that are used in method signatures, and which therefore dictate JVM/IR overloading.

case
object UndefType extends PrimType

The type of undefined.

The type of undefined.

Value members

Concrete methods

def isSubtype(lhs: Type, rhs: Type)(isSubclass: (ClassName, ClassName) => Boolean): Boolean

Tests whether a type lhs is a subtype of rhs (or equal).

Tests whether a type lhs is a subtype of rhs (or equal).

Value Params
isSubclass

A function testing whether a class/interface is a subclass of another class/interface.

def zeroOf(tpe: Type)(implicit pos: Position): Tree

Generates a literal zero of the given type.

Generates a literal zero of the given type.

Concrete fields

final
final
final
final
final
final
final
final
final
final
final