Add cross-platform CI (#6670)

* Linux and Windows CI with GitHub Actions
* Add karma-edge-launcher
* Add edge configuration to karma.conf.js
* Support --browsers on the command line for karma tests
* Add macOS CI builds
* Add karma-safari-private-launcher
* Document browser specification for tests

Author: Edward Thomson

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+      fail-fast: false
+
+    steps:
+    - uses: actions/checkout@v1
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+    - name: Setup xvfb
+      run: |
+        Xvfb :99 -screen 0 1024x768x24 &
+        echo "::set-env name=DISPLAY:::99.0"
+      if: runner.os == 'Linux'
+    - name: Install gulp
+      run: npm install --global gulp
+      if: runner.os == 'macOS'
+    - name: Install chrome
+      run: |
+        brew update
+        brew cask install google-chrome
+      if: runner.os == 'macOS'
+    - name: Select browsers
+      run: |
+        if [ "${{ runner.os }}" == "macOS" ]; then
+          echo "::set-env name=BROWSERS::--browsers chrome"
+        fi
+      shell: bash
+    - name: Build and Test
+      run: |
+        npm install
+        gulp build
+        gulp test --coverage ${BROWSERS}
+    - name: Package
+      run: |
+        gulp docs
+        gulp package
+        gulp bower
+    - name: Publish Test Results
+      run: cat ./coverage/lcov.info | ./node_modules/.bin/coveralls
+      continue-on-error: true

docs/developers/contributing.md

@@ -36,6 +36,7 @@ The following commands are now available from the repository root:
 > gulp unittest --coverage  // run tests and generate coverage reports in ./coverage
 > gulp lint                 // perform code linting (ESLint)
 > gulp test                 // perform code linting and run unit tests
+> gulp test --browsers ...  // test with specified browsers (comma-separated)
 > gulp docs                 // build the documentation in ./dist/docs
 > gulp docs --watch         // starts the gitbook live reloaded server
 ```

gulpfile.js

@@ -145,6 +145,7 @@ function unittestTask(done) {
     args: {
       coverage: !!argv.coverage,
       inputs: (argv.inputs || 'test/specs/**/*.js').split(';'),
+      browsers: (argv.browsers || 'chrome,firefox').split(','),
       watch: argv.watch
     }
   },

karma.conf.js

@@ -22,7 +22,7 @@ module.exports = function(karma) {
 	karma.set({
 		frameworks: ['jasmine'],
 		reporters: ['progress', 'kjhtml'],
-		browsers: ['chrome', 'firefox'],
+		browsers: args.browsers,
 		logLevel: karma.LOG_WARN,
 
 		// Explicitly disable hardware acceleration to make image
@@ -40,6 +40,12 @@ module.exports = function(karma) {
 				prefs: {
 					'layers.acceleration.disabled': true
 				}
+			},
+			safari: {
+				base: 'SafariPrivate'
+			},
+			edge: {
+				base: 'Edge'
 			}
 		},
 

package-lock.json

@@ -53,10 +53,12 @@
     "karma": "^4.0.0",
     "karma-chrome-launcher": "^3.0.0",
     "karma-coverage": "^2.0.0",
+    "karma-edge-launcher": "^0.4.2",
     "karma-firefox-launcher": "^1.0.1",
     "karma-jasmine": "^2.0.1",
     "karma-jasmine-html-reporter": "^1.4.0",
     "karma-rollup-preprocessor": "^7.0.0",
+    "karma-safari-private-launcher": "^1.0.0",
     "merge-stream": "^1.0.1",
     "pixelmatch": "^5.0.0",
     "rollup": "^1.0.0",