2016-02-04 18:06:24 +00:00
|
|
|
/*
|
|
|
|
Copyright 2016 OpenMarket Ltd
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
limitations under the License.
|
|
|
|
*/
|
|
|
|
|
2016-07-26 17:15:26 +00:00
|
|
|
/**
|
|
|
|
* 'debounces' a function to only execute every n milliseconds.
|
|
|
|
* Useful when react-sdk gets many, many events but only wants
|
|
|
|
* to update the interface once for all of them.
|
|
|
|
*
|
|
|
|
* Note that the function must not take arguments, since the args
|
|
|
|
* could be different for each invocarion of the function.
|
2016-08-10 12:39:47 +00:00
|
|
|
*
|
|
|
|
* The returned function has a 'cancelPendingCall' property which can be called
|
|
|
|
* on unmount or similar to cancel any pending update.
|
2016-07-26 17:15:26 +00:00
|
|
|
*/
|
2016-02-05 09:51:09 +00:00
|
|
|
module.exports = function(f, minIntervalMs) {
|
2016-02-04 18:06:24 +00:00
|
|
|
this.lastCall = 0;
|
|
|
|
this.scheduledCall = undefined;
|
|
|
|
|
|
|
|
var self = this;
|
2016-08-10 12:39:47 +00:00
|
|
|
var wrapper = function() {
|
2016-02-04 18:06:24 +00:00
|
|
|
var now = Date.now();
|
|
|
|
|
2016-02-05 09:51:09 +00:00
|
|
|
if (self.lastCall < now - minIntervalMs) {
|
2016-07-26 17:15:26 +00:00
|
|
|
f.apply(this);
|
2016-02-04 18:06:24 +00:00
|
|
|
self.lastCall = now;
|
|
|
|
} else if (self.scheduledCall === undefined) {
|
2016-02-05 09:51:09 +00:00
|
|
|
self.scheduledCall = setTimeout(
|
|
|
|
() => {
|
2016-02-04 18:06:24 +00:00
|
|
|
self.scheduledCall = undefined;
|
2016-07-26 17:15:26 +00:00
|
|
|
f.apply(this);
|
2016-02-04 18:06:24 +00:00
|
|
|
self.lastCall = now;
|
|
|
|
},
|
2016-02-05 09:51:09 +00:00
|
|
|
(self.lastCall + minIntervalMs) - now
|
2016-02-04 18:06:24 +00:00
|
|
|
);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2016-08-10 12:39:47 +00:00
|
|
|
// add the cancelPendingCall property
|
|
|
|
wrapper.cancelPendingCall = function() {
|
|
|
|
if (self.scheduledCall) {
|
|
|
|
clearTimeout(self.scheduledCall);
|
|
|
|
self.scheduledCall = undefined;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
// make sure that cancelPendingCall is copied when react rebinds the
|
|
|
|
// wrapper
|
|
|
|
var _bind = wrapper.bind;
|
|
|
|
wrapper.bind = function() {
|
|
|
|
var rebound = _bind.apply(this, arguments);
|
|
|
|
rebound.cancelPendingCall = wrapper.cancelPendingCall;
|
|
|
|
return rebound;
|
|
|
|
};
|
|
|
|
|
|
|
|
return wrapper;
|
|
|
|
};
|