@enact/dev-utils/plugins/SnapshotPlugin/snapshot-helper.js

A collection of development utilities for Enact apps.

/* eslint no-var: off */
/*
 *  snapshot-helper.js
 *
 *  An exposed utility function to update the javascript environment to the active window to account for any
 *  launch-time issues when using code created in a snapshot blob.
 */

var mockWindow = require('./mock-window');
var ExecutionEnvironment = require('fbjs/lib/ExecutionEnvironment');

function handleException(e) {
	// We allow 'Cannot find module' errors, which throw when the libraries are not used in the app.
	// @enact/i18n and @enact/moonstone are considered optional dependencies.
	if(!e.code || e.code!=='MODULE_NOT_FOUND') {
		throw e;
	}
}

global.updateEnvironment = function() {
	// Update fbjs to have the correct execution environment for the active window.
	var canUseDOM = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
	ExecutionEnvironment.canUseDOM = canUseDOM;
	ExecutionEnvironment.canUseWorkers = typeof Worker !== 'undefined';
	ExecutionEnvironment.canUseEventListeners = canUseDOM && !!(window.addEventListener || window.attachEvent);
	ExecutionEnvironment.canUseViewport = canUseDOM && !!window.screen;
	ExecutionEnvironment.isInWorker = !canUseDOM; // For now, this is true - might change in the future.
	mockWindow.attachListeners(ExecutionEnvironment.canUseEventListeners && window)

	try {
		// Mark the iLib localestorage cache as needing re-validation.
		var ilib = require('@enact/i18n/ilib/lib/ilib');
		if (ilib && ilib._load) {
			ilib._load._cacheValidated = false;
		}

		// Clear the active resBundle and string cache.
		var resBundle = require('@enact/i18n/src/resBundle');
		resBundle.clearResBundle();
		try {
			var moonstoneBundle = require('@enact/moonstone/internal/$L');
			moonstoneBundle.clearResBundle();
		} catch(e2) {
			handleException(e2);
		}

		// Update the iLib/Enact locale to the active window's locale.
		var locale = require('@enact/i18n/locale');
		locale.updateLocale();
	} catch(e1) {
		handleException(e1);
	}
};

if(typeof window == 'undefined'
		&& (!global.process || !global.process.versions || !global.process.versions.node)) {
	mockWindow.activate();
	ExecutionEnvironment.canUseDOM = true;
	ExecutionEnvironment.canUseWorkers = false;
	ExecutionEnvironment.canUseEventListeners = true;
	ExecutionEnvironment.canUseViewport = true;
	ExecutionEnvironment.isInWorker = false;
	module.exports = global.ReactDOM = require('react-dom');
	mockWindow.deactivate();
} else {
	module.exports = global.ReactDOM = require('react-dom');
}