/** @license * Copyright 2016 - present The Material Motion Authors. All Rights Reserved. * * 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. */ import { getFrame$, } from '../../getFrame$'; import { MotionObservable, } from '../../observables/proxies'; import { Constructor, MotionNextOperable, NextChannel, Observable, ObservableWithMotionOperators, Observer } from '../../types'; export type _DebounceArgs = { pulse$?: Observable, }; export interface MotionDebounceable { _debounce(kwargs?: _DebounceArgs): ObservableWithMotionOperators; } export function withDebounce>>(superclass: S): S & Constructor> { return class extends superclass implements MotionDebounceable { /** * Throttles the upstream subscription to emit its latest value whenever * `pulse$` emits. If more than one value is received whilst awaiting * the pulse, the most recent value is emitted and the intermediaries are * forgotten. * * By default, it will throttle to the framerate using * `requestAnimationFrame`. */ _debounce({ pulse$ = getFrame$() } = {}): ObservableWithMotionOperators { return new MotionObservable( (observer: Observer) => { let awaitingEmit = false; let lastValue: T; const valueSubscription = this.subscribe( (value: T) => { lastValue = value; awaitingEmit = true; } ); const pulseSubscription = pulse$.subscribe( () => { if (awaitingEmit) { awaitingEmit = false; observer.next(lastValue); } } ); return () => { valueSubscription.unsubscribe(); pulseSubscription.unsubscribe(); }; } ); } }; }