js - scala.scalajs.js

Type Members

trait Any extends AnyRef

Root of the hierarchy of JavaScript types.
class Array[A] extends Object with Iterable[A]

Arrays are list-like objects whose prototype has methods to perform traversal and mutation operations.
final class ArrayOps[A] extends ArrayLike[A, Array[A]] with Builder[A, Array[A]]

Equivalent of scm.
final class ConstructorTag[T <: Any] extends AnyVal

Stores the JS constructor function of a JS class.
class Date extends Object

Creates a JavaScript Date instance that represents a single moment in time.
sealed trait Dictionary[A] extends Any

Dictionary "view" of a JavaScript value.
sealed trait Dynamic extends Any with scala.Dynamic

Dynamically typed JavaScript value.
class Error extends Object

Annotations
@RawJSType() @native() @JSGlobal()
class EvalError extends Error

An instance representing an error that occurs regarding the global function eval()
class Function extends Object

The Function constructor creates a new Function object.
trait Function0[+R] extends Function

Annotations
@RawJSType() @native()
trait Function1[-T1, +R] extends Function

Annotations
@RawJSType() @native()
trait Function2[-T1, -T2, +R] extends Function

Annotations
@RawJSType() @native()
trait Iterable[+A] extends Object

ECMAScript 6 JavaScript Iterable.
final class IterableOps[+A] extends collection.Iterable[A]

Adapts a JavaScript Iterable to a Scala Iterable
trait Iterator[+A] extends Object

ECMAScript 6 JavaScript Iterator.
trait JSArrayOps[A] extends Object

Discouraged native JavaScript Array methods.
sealed abstract class JSConvertersLowPrioImplicits extends AnyRef
trait JSNumberOps extends Any

Operations on JavaScript numbers.
trait JSStringOps extends Any

Operations on JavaScript strings.
case class JavaScriptException(exception: scala.Any) extends RuntimeException with Product with Serializable
trait LowPrioAnyImplicits extends LowestPrioAnyImplicits
sealed trait LowestPrioAnyImplicits extends AnyRef
class Object extends Any

Base class of all JavaScript objects.
class Promise[+A] extends Object with Thenable[A]

ECMAScript 6 Promise of an asynchronous result.
trait PropertyDescriptor extends Object

Annotations
@RawJSType() @native()
class RangeError extends Error

An instance representing an error that occurs when a numeric variable or parameter is outside of its valid range.
class ReferenceError extends Error

Represents an error when a non-existent variable is referenced.
class RegExp extends Object

The RegExp constructor creates a regular expression object for matching text with a pattern.
sealed trait Symbol extends Any

ECMAScript 6 JavaScript Symbol.
class SyntaxError extends Error

Represents an error when trying to interpret syntactically invalid code.
trait Thenable[+A] extends Object

A thing on which one can call the then method.
trait ThisFunction extends Function

A JavaScript function where this is considered as a first parameter.
trait ThisFunction0[-T0, +R] extends Function with ThisFunction

Annotations
@RawJSType() @native()
trait ThisFunction1[-T0, -T1, +R] extends Function with ThisFunction

Annotations
@RawJSType() @native()
trait ThisFunction2[-T0, -T1, -T2, +R] extends Function with ThisFunction

Annotations
@RawJSType() @native()
sealed trait Tuple2[+T1, +T2] extends Object

A tuple "view" of 2 elements of a JavaScript Array.
sealed trait Tuple3[+T1, +T2, +T3] extends Object

A tuple "view" of 3 elements of a JavaScript Array.
class TypeError extends Error

Represents an error when a value is not of the expected type.
class URIError extends Error

Represents an error when a malformed URI is encountered.
sealed trait UndefOr[+A] extends AnyRef

Value of type A or the JS undefined value.
sealed abstract class UndefOrLowPrioImplicits extends AnyRef
final class UndefOrOps[A] extends AnyVal
sealed trait UnicodeNormalizationForm extends Any

A Unicode Normalization Form.
final class Using[A] extends AnyVal

Helper for syntactic sugar of js.use.
final class WrappedArray[A] extends AbstractBuffer[A] with GenericTraversableTemplate[A, WrappedArray] with collection.mutable.IndexedSeq[A] with BufferLike[A, WrappedArray[A]] with ArrayLike[A, WrappedArray[A]] with Builder[A, WrappedArray[A]]

Equivalent of scm.
class WrappedDictionary[A] extends AbstractMap[String, A] with Map[String, A] with MapLike[String, A, WrappedDictionary[A]]

Wrapper to use a js.
class native extends Annotation with StaticAnnotation

Marks the annotated class, trait or object as a native JS entity.
sealed trait |[A, B] extends AnyRef

Value of type A or B (union type).
trait GlobalScope extends Any

Marker trait for top-level objects representing the JS global scope.
trait JSApp extends AnyRef

Old-style base class for top-level, entry point main objects.

Value Members

object Any extends LowPrioAnyImplicits

Provides implicit conversions from Scala values to JavaScript values.
object Array extends Object

Factory for js.Array objects.
object ArrayOps
object ConstructorTag
object Date extends Object

Factory for js.Date objects.
object Dictionary

Factory for Dictionary instances.
object Dynamic

Factory for dynamically typed JavaScript values.
object DynamicImplicits

Provides implicit conversions and operations to write in JavaScript style with js.Dynamic.
object Error extends Object

Annotations
@native() @JSGlobal()
object EvalError extends Object

Annotations
@native() @JSGlobal()
object Function extends Object

Annotations
@native() @JSGlobal()
object Iterator
object JSArrayOps
object JSConverters extends JSConvertersLowPrioImplicits

A collection of decorators that allow converting Scala types to corresponding JS facade types
object JSNumberOps
object JSON extends Object

The JSON object contains methods for converting values to JavaScript Object Notation (JSON) and for converting JSON to values.
object JSStringOps
object Math extends Object

Math is a built-in object that has properties and methods for mathematical constants and functions.
object Object extends Object

The top-level Object JavaScript object.
object Promise extends Object

Annotations
@native() @JSGlobal()
object RangeError extends Object

Annotations
@native() @JSGlobal()
object ReferenceError extends Object

Annotations
@native() @JSGlobal()
object RegExp extends Object

Annotations
@native() @JSGlobal()
object Symbol extends Object

ECMAScript 6 Factory for js.Symbols and well-known symbols.
object SyntaxError extends Object

Annotations
@native() @JSGlobal()
object Thenable
object ThisFunction
object Tuple2
object Tuple3
object TypeError extends Object

Annotations
@native() @JSGlobal()
object URIError extends Object

Annotations
@native() @JSGlobal()
object URIUtils extends Object

Methods related to URIs, provided by ECMAScript 5.
object UndefOr extends UndefOrLowPrioImplicits
object UndefOrOps
object UnicodeNormalizationForm
object WrappedArray extends SeqFactory[WrappedArray]

Factory for WrappedArray.
object WrappedDictionary
package annotation
def constructorOf[T <: Any]: Dynamic

Returns the constructor function of a JavaScript class.
Returns the constructor function of a JavaScript class.
The specified type parameter T must be a class type (i.e., valid for classOf[T]) and represent a class extending js.Any (not a trait nor an object).
def constructorTag[T <: Any](implicit tag: ConstructorTag[T]): ConstructorTag[T]

Makes explicit an implicitly available ConstructorTag[T].
object defined
def eval(x: String): Any

Evaluates JavaScript code and returns the result.
Evaluates JavaScript code and returns the result.

Annotations
@inline()
def isUndefined(v: scala.Any): Boolean

Tests whether the given value is undefined.
Tests whether the given value is undefined.

Annotations
@inline()
def native: Nothing

Denotes a method body as native JavaScript.
Denotes a method body as native JavaScript. For use in facade types:
```
class MyJSClass extends js.Object {
def myMethod(x: String): Int = js.native
}
```
package timers

Non-Standard Non-standard, but in general well supported methods to schedule asynchronous exeuction.
def typeOf(x: Any): String

Returns the type of x as identified by typeof x in JavaScript.
package typedarray

ECMAScript 6 The typdearray package provides facade types for JavaScript ArrayBuffer, TypeArrays and DataView.
def undefined: UndefOr[Nothing]

The undefined value.
The undefined value.

Annotations
@inline()

def use[A](x: A): Using[A]

Allows to cast a value to a facade trait in a type-safe way.

Use as follows:

js.use(x).as[MyFacade]

Note that the method calls are only syntactic sugar. There is no overhead at runtime for such an operation. Using use(x).as[T] is strictly equivalent to x.asInstanceOf[T] if the compile time check does not fail.

This method supports both Scala classes with exports and facade types which are structurally equivalent.

Examples

Given the following facade type:

trait MyFacade extends js.Object {
def foo(x: Int): String = js.native
val bar: Int = js.native
}

We show a couple of examples:

class MyClass1 {
  @JSExport
  def foo(x: Int): String = x.toString

  @JSExport
  val bar: Int = 1
}

val x1 = new MyClass1
js.use(x1).as[MyFacade] // OK

Note that JS conventions apply: The val bar can be implemented with a def.

class MyClass2 {
  @JSExport
  def foo(x: Int): String = x.toString

  @JSExport
  def bar: Int = 1 // def instead of val
}

val x2 = new MyClass2
js.use(x2).as[MyFacade] // OK

Missing methods or methods with wrong types will cause a compile-time failure.

class MyClass3 {
  @JSExport
  def foo(x: String): String = x.toString // wrong type signature

  // bar is missing
}

val x3 = new MyClass3
js.use(x2).as[MyFacade] // Fails: bar is missing and foo has wrong type

Methods must be exported, otherwise they are not taken into consideration.

class MyClass4 {
  def foo(x: Int): String = x.toString

  @JSExport
  def bar: Int = 1 // def instead of val
}

val x4 = new MyClass4
js.use(x4).as[MyFacade] // Fails, foo is missing

Other facade types can also be used

trait MyOtherFacade extends js.Object {
  def foo(x: Any): String = js.native
  val bar: Int = js.native
  def otherMethod(): Unit = js.native
}

val x5: MyOtherFacade = // ...
js.use(x5).as[MyFacade] // OK

Restrictions

Facade types may only be traits and not have any class ancestors
Polymorphic methods are currently not supported
Facade types defining an apply method cannot used (this is a JavaScript restriction).

object |

Deprecated Value Members

def debugger(): Unit

Invokes any available debugging functionality.
Invokes any available debugging functionality. If no debugging functionality is available, this statement has no effect.
MDN
Browser support:
- Has no effect in Rhino nor, apparently, in Firefox
- In Chrome, it has no effect unless the developer tools are opened beforehand.
Annotations
@deprecated @inline()
Deprecated
(Since version 0.6.17) Use scala.scalajs.js.sepcial.debugger instead

js

package js

Guide

Overview

Type Members

trait Any extends AnyRef

class Array[A] extends Object with Iterable[A]

final class ArrayOps[A] extends ArrayLike[A, Array[A]] with Builder[A, Array[A]]

final class ConstructorTag[T <: Any] extends AnyVal

class Date extends Object

sealed trait Dictionary[A] extends Any

sealed trait Dynamic extends Any with scala.Dynamic

class Error extends Object

class EvalError extends Error

class Function extends Object

trait Function0[+R] extends Function

trait Function1[-T1, +R] extends Function

trait Function2[-T1, -T2, +R] extends Function

trait Iterable[+A] extends Object

final class IterableOps[+A] extends collection.Iterable[A]

trait Iterator[+A] extends Object

trait JSArrayOps[A] extends Object

sealed abstract class JSConvertersLowPrioImplicits extends AnyRef

trait JSNumberOps extends Any

trait JSStringOps extends Any

case class JavaScriptException(exception: scala.Any) extends RuntimeException with Product with Serializable

trait LowPrioAnyImplicits extends LowestPrioAnyImplicits

sealed trait LowestPrioAnyImplicits extends AnyRef

class Object extends Any

class Promise[+A] extends Object with Thenable[A]

trait PropertyDescriptor extends Object

class RangeError extends Error

class ReferenceError extends Error

class RegExp extends Object

sealed trait Symbol extends Any

class SyntaxError extends Error

trait Thenable[+A] extends Object

trait ThisFunction extends Function

trait ThisFunction0[-T0, +R] extends Function with ThisFunction

trait ThisFunction1[-T0, -T1, +R] extends Function with ThisFunction

trait ThisFunction2[-T0, -T1, -T2, +R] extends Function with ThisFunction

sealed trait Tuple2[+T1, +T2] extends Object

sealed trait Tuple3[+T1, +T2, +T3] extends Object

class TypeError extends Error

class URIError extends Error

sealed trait UndefOr[+A] extends AnyRef

sealed abstract class UndefOrLowPrioImplicits extends AnyRef

final class UndefOrOps[A] extends AnyVal

sealed trait UnicodeNormalizationForm extends Any

final class Using[A] extends AnyVal

final class WrappedArray[A] extends AbstractBuffer[A] with GenericTraversableTemplate[A, WrappedArray] with collection.mutable.IndexedSeq[A] with BufferLike[A, WrappedArray[A]] with ArrayLike[A, WrappedArray[A]] with Builder[A, WrappedArray[A]]

class WrappedDictionary[A] extends AbstractMap[String, A] with Map[String, A] with MapLike[String, A, WrappedDictionary[A]]

class native extends Annotation with StaticAnnotation

sealed trait |[A, B] extends AnyRef

trait GlobalScope extends Any

trait JSApp extends AnyRef

Value Members

object Any extends LowPrioAnyImplicits

object Array extends Object

object ArrayOps

object ConstructorTag

object Date extends Object

object Dictionary

object Dynamic

object DynamicImplicits

object Error extends Object

object EvalError extends Object

object Function extends Object

object Iterator

object JSArrayOps

object JSConverters extends JSConvertersLowPrioImplicits

object JSNumberOps

object JSON extends Object

object JSStringOps

object Math extends Object

object Object extends Object

object Promise extends Object

object RangeError extends Object

object ReferenceError extends Object

object RegExp extends Object