Travis build: 835 [ci skip]
This commit is contained in:
61
README.md
61
README.md
@ -100,6 +100,7 @@
|
||||
* [`httpsRedirect`](#httpsredirect)
|
||||
* [`onUserInputChange`](#onuserinputchange)
|
||||
* [`redirect`](#redirect)
|
||||
* [`runAsync`](#runasync)
|
||||
* [`scrollToTop`](#scrolltotop)
|
||||
* [`setStyle`](#setstyle)
|
||||
* [`show`](#show)
|
||||
@ -1974,6 +1975,66 @@ redirect('https://google.com');
|
||||
<br>[⬆ Back to top](#table-of-contents)
|
||||
|
||||
|
||||
### runAsync
|
||||
|
||||
Runs a function in a separate thread by using a [Web Worker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers), allowing long running functions to not block the UI.
|
||||
|
||||
Create a new `Worker` using a `Blob` object URL, the contents of which should be the stringified version of the supplied function.
|
||||
Immediately post the return value of calling the function back.
|
||||
Return a promise, listening for `onmessage` and `onerror` events and resolving the data posted back from the worker, or throwing an error.
|
||||
|
||||
```js
|
||||
const runAsync = fn => {
|
||||
const blob = `
|
||||
var fn = ${fn.toString()};
|
||||
this.postMessage(fn());
|
||||
`;
|
||||
const worker = new Worker(
|
||||
URL.createObjectURL(new Blob([blob]), {
|
||||
type: 'application/javascript; charset=utf-8'
|
||||
})
|
||||
);
|
||||
return new Promise((res, rej) => {
|
||||
worker.onmessage = ({ data }) => {
|
||||
res(data), worker.terminate();
|
||||
};
|
||||
worker.onerror = err => {
|
||||
rej(err), worker.terminate();
|
||||
};
|
||||
});
|
||||
};
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>Examples</summary>
|
||||
|
||||
```js
|
||||
const longRunningFunction = () => {
|
||||
let result = 0;
|
||||
for (var i = 0; i < 1000; i++) {
|
||||
for (var j = 0; j < 700; j++) {
|
||||
for (var k = 0; k < 300; k++) {
|
||||
result = result + i + j + k;
|
||||
}
|
||||
}
|
||||
}
|
||||
return result;
|
||||
};
|
||||
|
||||
// NOTE: Since the function is running in a different context, closures are not supported.
|
||||
// The function supplied to `runAsync` gets stringified, so everything becomes literal.
|
||||
// All variables and functions must be defined inside.
|
||||
runAsync(longRunningFunction).then(console.log); // 209685000000
|
||||
runAsync(() => 10 ** 3).then(console.log); // 1000
|
||||
let outsideVariable = 50;
|
||||
runAsync(() => typeof outsideVariable).then(console.log); // 'undefined'
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<br>[⬆ Back to top](#table-of-contents)
|
||||
|
||||
|
||||
### scrollToTop
|
||||
|
||||
Smooth-scrolls to the top of the page.
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user