{"version":3,"file":"createTaskProcessorWorker.js","sources":["../../../../Source/Core/formatError.js","../../../../Source/WorkersES6/createTaskProcessorWorker.js"],"sourcesContent":["import defined from \"./defined.js\";\n\n/**\n * Formats an error object into a String.  If available, uses name, message, and stack\n * properties, otherwise, falls back on toString().\n *\n * @function\n *\n * @param {*} object The item to find in the array.\n * @returns {String} A string containing the formatted error.\n */\nfunction formatError(object) {\n  let result;\n\n  const name = object.name;\n  const message = object.message;\n  if (defined(name) && defined(message)) {\n    result = `${name}: ${message}`;\n  } else {\n    result = object.toString();\n  }\n\n  const stack = object.stack;\n  if (defined(stack)) {\n    result += `\\n${stack}`;\n  }\n\n  return result;\n}\nexport default formatError;\n","import defaultValue from \"../Core/defaultValue.js\";\nimport defined from \"../Core/defined.js\";\nimport formatError from \"../Core/formatError.js\";\nimport when from \"../ThirdParty/when.js\";\n\n// createXXXGeometry functions may return Geometry or a Promise that resolves to Geometry\n// if the function requires access to ApproximateTerrainHeights.\n// For fully synchronous functions, just wrapping the function call in a `when` Promise doesn't\n// handle errors correctly, hence try-catch\nfunction callAndWrap(workerFunction, parameters, transferableObjects) {\n  let resultOrPromise;\n  try {\n    resultOrPromise = workerFunction(parameters, transferableObjects);\n    return resultOrPromise; // errors handled by Promise\n  } catch (e) {\n    return when.reject(e);\n  }\n}\n\n/**\n * Creates an adapter function to allow a calculation function to operate as a Web Worker,\n * paired with TaskProcessor, to receive tasks and return results.\n *\n * @function createTaskProcessorWorker\n *\n * @param {createTaskProcessorWorker.WorkerFunction} workerFunction The calculation function,\n *        which takes parameters and returns a result.\n * @returns {createTaskProcessorWorker.TaskProcessorWorkerFunction} A function that adapts the\n *          calculation function to work as a Web Worker onmessage listener with TaskProcessor.\n *\n *\n * @example\n * function doCalculation(parameters, transferableObjects) {\n *   // calculate some result using the inputs in parameters\n *   return result;\n * }\n *\n * return Cesium.createTaskProcessorWorker(doCalculation);\n * // the resulting function is compatible with TaskProcessor\n *\n * @see TaskProcessor\n * @see {@link http://www.w3.org/TR/workers/|Web Workers}\n * @see {@link http://www.w3.org/TR/html5/common-dom-interfaces.html#transferable-objects|Transferable objects}\n */\nfunction createTaskProcessorWorker(workerFunction) {\n  let postMessage;\n\n  return function (event) {\n    const data = event.data;\n\n    const transferableObjects = [];\n    const responseMessage = {\n      id: data.id,\n      result: undefined,\n      error: undefined,\n    };\n\n    return when(\n      callAndWrap(workerFunction, data.parameters, transferableObjects)\n    )\n      .then(function (result) {\n        responseMessage.result = result;\n      })\n      .otherwise(function (e) {\n        if (e instanceof Error) {\n          // Errors can't be posted in a message, copy the properties\n          responseMessage.error = {\n            name: e.name,\n            message: e.message,\n            stack: e.stack,\n          };\n        } else {\n          responseMessage.error = e;\n        }\n      })\n      .always(function () {\n        if (!defined(postMessage)) {\n          postMessage = defaultValue(self.webkitPostMessage, self.postMessage);\n        }\n\n        if (!data.canTransferArrayBuffer) {\n          transferableObjects.length = 0;\n        }\n\n        try {\n          postMessage(responseMessage, transferableObjects);\n        } catch (e) {\n          // something went wrong trying to post the message, post a simpler\n          // error that we can be sure will be cloneable\n          responseMessage.result = undefined;\n          responseMessage.error = `postMessage failed with error: ${formatError(\n            e\n          )}\\n  with responseMessage: ${JSON.stringify(responseMessage)}`;\n          postMessage(responseMessage);\n        }\n      });\n  };\n}\n\n/**\n * A function that performs a calculation in a Web Worker.\n * @callback createTaskProcessorWorker.WorkerFunction\n *\n * @param {Object} parameters Parameters to the calculation.\n * @param {Array} transferableObjects An array that should be filled with references to objects inside\n *        the result that should be transferred back to the main document instead of copied.\n * @returns {Object} The result of the calculation.\n *\n * @example\n * function calculate(parameters, transferableObjects) {\n *   // perform whatever calculation is necessary.\n *   const typedArray = new Float32Array(0);\n *\n *   // typed arrays are transferable\n *   transferableObjects.push(typedArray)\n *\n *   return {\n *      typedArray : typedArray\n *   };\n * }\n */\n\n/**\n * A Web Worker message event handler function that handles the interaction with TaskProcessor,\n * specifically, task ID management and posting a response message containing the result.\n * @callback createTaskProcessorWorker.TaskProcessorWorkerFunction\n *\n * @param {Object} event The onmessage event object.\n */\nexport default createTaskProcessorWorker;\n"],"names":["defined","when","defaultValue"],"mappings":"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"}