Import the JS Envs projects from the Scala.js core repository.

.gitignore

@@ -0,0 +1 @@
+target/

.travis.yml

@@ -0,0 +1,31 @@
+sudo: false
+language: scala
+script:
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs/test
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs/doc
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs/mimaReportBinaryIssues
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs/headerCheck scalajs-js-envs/test:headerCheck
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs-test-kit/test
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs-test-kit/doc
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs-test-kit/mimaReportBinaryIssues
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-js-envs-test-kit/headerCheck scalajs-js-envs-test-kit/test:headerCheck
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-env-nodejs/test
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-env-nodejs/doc
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-env-nodejs/mimaReportBinaryIssues
+  - sbt ++$TRAVIS_SCALA_VERSION scalajs-env-nodejs/headerCheck scalajs-env-nodejs/test:headerCheck
+scala:
+  - 2.11.12
+  - 2.12.11
+  - 2.13.2
+jdk:
+  - openjdk8
+
+cache:
+  directories:
+    - "$HOME/.cache/coursier"
+    - "$HOME/.ivy2/cache"
+    - "$HOME/.sbt"
+before_cache:
+  - rm -fv $HOME/.ivy2/.sbt.ivy.lock
+  - find $HOME/.ivy2/cache -name "ivydata-*.properties" -print -delete
+  - find $HOME/.sbt -name "*.lock" -print -delete

build.sbt

@@ -0,0 +1,143 @@
+val previousVersion: Option[String] = Some("1.1.0")
+val newScalaBinaryVersionsInThisRelease: Set[String] = Set()
+
+inThisBuild(Def.settings(
+  version := "1.1.1-SNAPSHOT",
+  organization := "org.scala-js",
+  scalaVersion := "2.12.11",
+  crossScalaVersions := Seq("2.11.12", "2.12.11", "2.13.2"),
+  scalacOptions ++= Seq(
+    "-deprecation",
+    "-feature",
+    "-Xfatal-warnings",
+    "-encoding", "utf-8",
+  ),
+
+  // Licensing
+  homepage := Some(url("https://github.com/scala-js/scala-js-js-envs")),
+  startYear := Some(2013),
+  licenses += (("Apache-2.0", url("https://www.apache.org/licenses/LICENSE-2.0"))),
+  scmInfo := Some(ScmInfo(
+      url("https://github.com/scala-js/scala-js-js-envs"),
+      "scm:git:git@github.com:scala-js/scala-js-js-envs.git",
+      Some("scm:git:git@github.com:scala-js/scala-js-js-envs.git"))),
+
+  // Publishing
+  publishMavenStyle := true,
+  publishTo := {
+    val nexus = "https://oss.sonatype.org/"
+    if (version.value.endsWith("-SNAPSHOT"))
+      Some("snapshots" at nexus + "content/repositories/snapshots")
+    else
+      Some("releases" at nexus + "service/local/staging/deploy/maven2")
+  },
+  pomExtra := (
+    <developers>
+      <developer>
+        <id>sjrd</id>
+        <name>Sébastien Doeraene</name>
+        <url>https://github.com/sjrd/</url>
+      </developer>
+      <developer>
+        <id>gzm0</id>
+        <name>Tobias Schlatter</name>
+        <url>https://github.com/gzm0/</url>
+      </developer>
+      <developer>
+        <id>nicolasstucki</id>
+        <name>Nicolas Stucki</name>
+        <url>https://github.com/nicolasstucki/</url>
+      </developer>
+    </developers>
+  ),
+  pomIncludeRepository := { _ => false },
+))
+
+val commonSettings = Def.settings(
+  // Links to the JavaDoc do not work
+  Compile / doc / scalacOptions -= "-Xfatal-warnings",
+
+  // Scaladoc linking
+  apiURL := {
+    val name = moduleName.value
+    val scalaBinVer = scalaBinaryVersion.value
+    val ver = version.value
+    Some(url(s"https://javadoc.io/doc/org.scala-js/${name}_$scalaBinVer/$ver/"))
+  },
+  autoAPIMappings := true,
+
+  // sbt-header configuration
+  headerLicense := Some(HeaderLicense.Custom(
+    s"""Scala.js JS Envs (${homepage.value.get})
+       |
+       |Copyright EPFL.
+       |
+       |Licensed under Apache License 2.0
+       |(https://www.apache.org/licenses/LICENSE-2.0).
+       |
+       |See the NOTICE file distributed with this work for
+       |additional information regarding copyright ownership.
+       |""".stripMargin
+  )),
+
+  // MiMa auto-configuration
+  mimaPreviousArtifacts ++= {
+    val scalaV = scalaVersion.value
+    val scalaBinaryV = scalaBinaryVersion.value
+    val thisProjectID = projectID.value
+    previousVersion match {
+      case None =>
+        Set.empty
+      case _ if newScalaBinaryVersionsInThisRelease.contains(scalaBinaryV) =>
+        // New in this release, no binary compatibility to comply to
+        Set.empty
+      case Some(prevVersion) =>
+        /* Filter out e:info.apiURL as it expects 1.1.1-SNAPSHOT, whereas the
+         * artifact we're looking for has 1.1.0 (for example).
+         */
+        val prevExtraAttributes =
+          thisProjectID.extraAttributes.filterKeys(_ != "e:info.apiURL")
+        val prevProjectID =
+          (thisProjectID.organization % thisProjectID.name % prevVersion)
+            .cross(thisProjectID.crossVersion)
+            .extra(prevExtraAttributes.toSeq: _*)
+        Set(prevProjectID)
+    }
+  },
+)
+
+lazy val root = project
+  .in(file("."))
+
+lazy val `scalajs-js-envs` = project
+  .in(file("js-envs"))
+  .settings(
+    commonSettings,
+    libraryDependencies ++= Seq(
+      "org.scala-js" %% "scalajs-logging" % "1.1.1",
+      "com.novocode" % "junit-interface" % "0.11" % "test",
+    ),
+  )
+
+lazy val `scalajs-js-envs-test-kit` = project
+  .in(file("js-envs-test-kit"))
+  .settings(
+    commonSettings,
+    libraryDependencies ++= Seq(
+        "com.google.jimfs" % "jimfs" % "1.1",
+        "junit" % "junit" % "4.12",
+        "com.novocode" % "junit-interface" % "0.11" % "test"
+    ),
+  )
+  .dependsOn(`scalajs-js-envs`)
+
+lazy val `scalajs-env-nodejs` = project
+  .in(file("nodejs-env"))
+  .settings(
+    commonSettings,
+    libraryDependencies ++= Seq(
+        "com.google.jimfs" % "jimfs" % "1.1",
+        "com.novocode" % "junit-interface" % "0.11" % "test"
+    ),
+  )
+  .dependsOn(`scalajs-js-envs`, `scalajs-js-envs-test-kit` % "test")

js-envs-test-kit/src/main/scala/org/scalajs/jsenv/test/ComTests.scala

@@ -0,0 +1,151 @@
+/*
+ * Scala.js JS Envs (https://github.com/scala-js/scala-js-js-envs)
+ *
+ * Copyright EPFL.
+ *
+ * Licensed under Apache License 2.0
+ * (https://www.apache.org/licenses/LICENSE-2.0).
+ *
+ * See the NOTICE file distributed with this work for
+ * additional information regarding copyright ownership.
+ */
+
+package org.scalajs.jsenv.test
+
+import org.junit.{Before, Test, AssumptionViolatedException}
+import org.junit.Assume._
+
+import org.scalajs.jsenv._
+import org.scalajs.jsenv.test.kit.TestKit
+
+private[test] class ComTests(config: JSEnvSuiteConfig) {
+  private val kit = new TestKit(config.jsEnv, config.awaitTimeout)
+
+  @Before
+  def before: Unit = {
+    assumeTrue("JSEnv needs com support", config.supportsCom)
+  }
+
+  @Test
+  def basicTest: Unit = {
+    kit.withComRun("""
+      scalajsCom.init(function(msg) { scalajsCom.send("received: " + msg); });
+      scalajsCom.send("Hello World");
+    """) { run =>
+
+      run.expectMsg("Hello World")
+
+      for (i <- 0 to 10) {
+        run
+          .send(i.toString)
+          .expectMsg(s"received: $i")
+      }
+
+      run.expectNoMsgs()
+        .closeRun()
+    }
+  }
+
+  @Test
+  def jsExitsOnMessageTest: Unit = {
+    val exitStat = config.exitJSStatement.getOrElse(
+        throw new AssumptionViolatedException("JSEnv needs exitJSStatement"))
+
+    kit.withComRun(s"""
+      scalajsCom.init(function(msg) { $exitStat });
+      for (var i = 0; i < 10; ++i)
+        scalajsCom.send("msg: " + i);
+      """) { run =>
+
+      for (i <- 0 until 10)
+        run.expectMsg(s"msg: $i")
+
+      run
+        .send("quit")
+        .expectNoMsgs()
+        .succeeds()
+    }
+  }
+
+  @Test
+  def multiEnvTest: Unit = {
+    val n = 10
+    val runs = List.fill(5) {
+      kit.startWithCom("""
+      scalajsCom.init(function(msg) {
+        scalajsCom.send("pong");
+      });
+      """)
+    }
+
+    try {
+      for (_ <- 0 until n) {
+        runs.foreach(_.send("ping"))
+        runs.foreach(_.expectMsg("pong"))
+      }
+
+      runs.foreach {
+        _.expectNoMsgs()
+          .closeRun()
+      }
+    } finally {
+      runs.foreach(_.close())
+    }
+  }
+
+  private def replyTest(msg: String) = {
+    kit.withComRun("scalajsCom.init(scalajsCom.send);") {
+      _.send(msg)
+        .expectMsg(msg)
+        .expectNoMsgs()
+        .closeRun()
+    }
+  }
+
+  @Test
+  def largeMessageTest: Unit = {
+    /* 1MB data.
+     * (i & 0x7f) limits the input to the ASCII repertoire, which will use
+     * exactly 1 byte per Char in UTF-8. This restriction also ensures that we
+     * do not introduce surrogate characters and therefore no invalid UTF-16
+     * strings.
+     */
+    replyTest(new String(Array.tabulate(1024 * 1024)(i => (i & 0x7f).toChar)))
+  }
+
+  @Test
+  def highCharTest: Unit = { // #1536
+    replyTest("\uC421\u8F10\u0112\uFF32")
+  }
+
+  @Test
+  def noInitTest: Unit = {
+    kit.withComRun("") {
+      _.send("Dummy")
+        .expectNoMsgs()
+        .closeRun()
+    }
+  }
+
+  @Test
+  def separateComStdoutTest: Unit = {
+    // Make sure that com and stdout do not interfere with each other.
+    kit.withComRun("""
+      scalajsCom.init(function (msg) {
+        console.log("got: " + msg)
+      });
+      console.log("a");
+      scalajsCom.send("b");
+      scalajsCom.send("c");
+      console.log("d");
+    """) {
+      _.expectOut("a\n")
+        .expectMsg("b")
+        .expectMsg("c")
+        .expectOut("d\n")
+        .send("foo")
+        .expectOut("got: foo\n")
+        .closeRun()
+    }
+  }
+}