test(e2e): Two e2e tests were added (and outms-test was removed)

Apart from End-to-End test, a lot of configurations were changed.

Author: mirismaili

.travis.yml

@@ -1,8 +1,6 @@
 language: node_js
 
-cache:
-  directories:
-    - ~/.npm
+cache: npm
 
 jobs:
   include:
@@ -20,9 +18,10 @@ jobs:
 
     - stage: "Release"
       name: "Build and Release"
-      if: type == push && tag !~ ^v\d+\.\d+\.\d+ && branch == master && commit_message =~ /^(feat|fix|refactor|pref|build|revert)\(/
+      if: type == push && tag !~ ^v\d+\.\d+\.\d+ && branch == master &&
+        commit_message =~ /^((feat|fix|refactor|pref|build|revert)\(|test\((?i)[\s\S]*?\b(E2E|END-TO-END|END2END)\b)/ # https://regex101.com/r/XWKT5J/1/
       script: npm run build:prod
-      after_success: npm run test:outms
+      after_success: npm run test:e2e
       node_js: lts/*
       deploy:
         provider: script

babel.config.js

@@ -0,0 +1,45 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/1 (2019/5/22).
+ */
+'use strict'
+
+const path = require('path')
+const Page = require('puppeteer')
+const Browser = require('puppeteer')
+const PORT = require('./config/options.js').listenPort
+
+const mockPagePath = path.relative(process.cwd(), path.resolve(__dirname, 'mock', 'index.html'))
+		.replace(/\\/g, '/')
+const mockPageUrl = `http://127.0.0.1:${PORT}/${mockPagePath}`
+
+const timeout = 5000
+
+describe(`Browser environment: "bundle.umd.js" & "bundle.esm.js" (at: ${mockPageUrl})`, () => {
+	let browser: Browser
+	let page: Page
+	let pageTitle: string
+	let errors = []
+	
+	beforeAll(async () => {
+		// noinspection JSUnresolvedVariable
+		browser = global.__BROWSER__
+		
+		page = (await browser.pages())[0];
+		
+		const handler = err => errors.push(err)
+		
+		page.on('requestfailed', handler)
+		page.on('pageerror', handler)
+		page.on('error', handler)
+		
+		await page.goto(mockPageUrl)
+		
+		pageTitle = await page.title()
+	}, timeout)
+	
+	it('Should load without error', () => {
+		expect(pageTitle).toBe('Mock HTML')
+		expect(errors).toStrictEqual([])
+	})
+}, timeout)

jest.outms.config.json

@@ -0,0 +1,11 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/2 (2019/5/23).
+ */
+'use strict'
+
+module.exports = require('babel-jest').createTransformer({
+	presets: [
+		["@babel/preset-flow", {"targets": {"node": "current"}}],
+	]
+})

jest.unit.config.js

@@ -0,0 +1,20 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/2 (2019/5/23).
+ */
+'use strict'
+
+const path = require('path')
+const parentPath = path.resolve(__dirname, '..').replace(/\\/g, '/')
+
+module.exports = {
+	rootDir: path.relative(__dirname, process.cwd()),
+	moduleFileExtensions: ['js', 'flow'],
+	testRegex: `${parentPath}/(?!config|mock).+?\\.js(\\.flow)?$`,
+	globalSetup: `${__dirname}/setup.js`,
+	globalTeardown: `${__dirname}/teardown.js`,
+	testEnvironment: `${__dirname}/puppeteer_environment.js`,
+	transform: {
+		'.+\\.js\\.flow$': `${__dirname}/jestPreprocess.js`
+	},
+}

jest/e2e/browser.js.flow

@@ -0,0 +1,11 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/3 (2019/5/24).
+ */
+'use strict'
+
+const os = require('os')
+const path = require('path')
+
+module.exports.listenPort = 3000
+module.exports.tmpDir = path.join(os.tmpdir(), 'jest_puppeteer_global_setup')

jest/e2e/config/jestPreprocess.js

@@ -0,0 +1,44 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/1 (2019/5/22).
+ */
+'use strict'
+
+const NodeEnvironment = require('jest-environment-node')
+const fs = require('fs')
+const path = require('path')
+const puppeteer = require('puppeteer')
+const os = require('os')
+
+const DIR = path.join(os.tmpdir(), 'jest_puppeteer_global_setup')
+
+class PuppeteerEnvironment extends NodeEnvironment {
+	constructor(config) {
+		super(config)
+	}
+	
+	async setup() {
+		await super.setup();
+		// get the wsEndpoint
+		const wsEndpoint = fs.readFileSync(path.join(DIR, 'wsEndpoint'), 'utf8')
+		if (!wsEndpoint) {
+			throw new Error('wsEndpoint not found');
+		}
+		
+		// connect to puppeteer
+		// noinspection JSUndefinedPropertyAssignment
+		this.global.__BROWSER__ = await puppeteer.connect({
+			browserWSEndpoint: wsEndpoint,
+		})
+	}
+	
+	async teardown() {
+		await super.teardown()
+	}
+	
+	runScript(script) {
+		return super.runScript(script)
+	}
+}
+
+module.exports = PuppeteerEnvironment

jest/e2e/config/main.js

@@ -0,0 +1,96 @@
+/**
+ * @author [S. Mahdi Mir-Ismaili](https://mirismaili.github.io)
+ * Created on 1398/3/1 (2019/5/22).
+ */
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const url = require('url')
+const http = require('http')
+
+const puppeteer = require('puppeteer')
+const mkdirp = require('mkdirp')
+
+const PORT = require('./options.js').listenPort
+const TMP_DIR = require('./options.js').tmpDir
+
+const staticServerPromise = new Promise((resolve, reject) => {
+	const staticServer = http.createServer((req, res) => {
+		// console.debug(req.method + ' ' + req.url);
+		
+		try {
+			const uri = url.parse(req.url).pathname
+			let filePath = path.join(process.cwd(), uri)
+			
+			e404:{
+				if (!fs.existsSync(filePath)) break e404
+				
+				if (fs.statSync(filePath).isDirectory()) filePath = path.join(filePath, 'index.html')
+				
+				if (!fs.existsSync(filePath)) break e404
+				
+				const contentTypesByExtension = {
+					'.html': 'text/html',
+					'.css': 'text/css',
+					'.js': 'text/javascript'
+				}
+				
+				const data = fs.readFileSync(filePath, 'binary')
+				
+				const headers = {}
+				const contentType = contentTypesByExtension[path.extname(filePath)]
+				if (contentType) headers['Content-Type'] = contentType
+				res.writeHead(200, headers)
+				res.write(data, 'binary')
+				res.end()
+				
+				return
+			}
+			//----------------------------------------------------------/e404:
+			// noinspection UnreachableCodeJS
+			console.error(`File not found: "${filePath}"`)
+			res.writeHead(404, {'Content-Type': 'text/plain'})
+			res.write('404/ Not Found\n')
+			res.end()
+		} catch (exeption) {
+			console.error(e.stack)
+			res.writeHead(500, {'Content-Type': 'text/plain'})
+			res.write(e.toString())
+			res.end()
+		}
+	})
+	
+	staticServer.on('error', reject)
+	
+	staticServer.listen(PORT, () => {
+		// noinspection JSUndefinedPropertyAssignment
+		global.__STATIC_SERVER__ = staticServer
+		
+		console.info(`Static file server running on: http://127.0.0.1:${PORT}`)
+		resolve()
+	})
+})
+
+const launchPuppeteerPromise = new Promise((resolve, reject) => {
+	puppeteer.launch(
+			// {
+			// 	headless: false,
+			// 	// slowMo: 500,
+			// 	devtools: true,
+			// }
+	).then(browser => {
+		// store the browser instance so we can teardown it later
+		// this global is only available in the teardown but not in TestEnvironments
+		// noinspection JSUndefinedPropertyAssignment
+		global.__BROWSER_GLOBAL__ = browser
+		
+		// use the file system to expose the wsEndpoint for TestEnvironments
+		mkdirp.sync(TMP_DIR)
+		fs.writeFileSync(path.join(TMP_DIR, 'wsEndpoint'), browser.wsEndpoint())
+	}, reject).then(resolve, reject)
+})
+
+// noinspection JSCheckFunctionSignatures
+module.exports = async () => await Promise.all([staticServerPromise, launchPuppeteerPromise])
+