import { Operator } from '../Operator'; import { Subscriber } from '../Subscriber'; import { Observable } from '../Observable'; /** * Buffers the source Observable values until the size hits the maximum * `bufferSize` given. * * Collects values from the past as an array, and emits * that array only when its size reaches `bufferSize`. * * * * Buffers a number of values from the source Observable by `bufferSize` then * emits the buffer and clears it, and starts a new buffer each * `startBufferEvery` values. If `startBufferEvery` is not provided or is * `null`, then new buffers are started immediately at the start of the source * and when each buffer closes and is emitted. * * @example Emit the last two click events as an array * var clicks = Rx.Observable.fromEvent(document, 'click'); * var buffered = clicks.bufferCount(2); * buffered.subscribe(x => console.log(x)); * * @example On every click, emit the last two click events as an array * var clicks = Rx.Observable.fromEvent(document, 'click'); * var buffered = clicks.bufferCount(2, 1); * buffered.subscribe(x => console.log(x)); * * @see {@link buffer} * @see {@link bufferTime} * @see {@link bufferToggle} * @see {@link bufferWhen} * @see {@link pairwise} * @see {@link windowCount} * * @param {number} bufferSize The maximum size of the buffer emitted. * @param {number} [startBufferEvery] Interval at which to start a new buffer. * For example if `startBufferEvery` is `2`, then a new buffer will be started * on every other value from the source. A new buffer is started at the * beginning of the source by default. * @return {Observable} An Observable of arrays of buffered values. * @method bufferCount * @owner Observable */ export function bufferCount(this: Observable, bufferSize: number, startBufferEvery: number = null): Observable { return this.lift(new BufferCountOperator(bufferSize, startBufferEvery)); } class BufferCountOperator implements Operator { constructor(private bufferSize: number, private startBufferEvery: number) { } call(subscriber: Subscriber, source: any): any { return source.subscribe(new BufferCountSubscriber(subscriber, this.bufferSize, this.startBufferEvery)); } } /** * We need this JSDoc comment for affecting ESDoc. * @ignore * @extends {Ignored} */ class BufferCountSubscriber extends Subscriber { private buffers: Array = []; private count: number = 0; constructor(destination: Subscriber, private bufferSize: number, private startBufferEvery: number) { super(destination); } protected _next(value: T) { const count = this.count++; const { destination, bufferSize, startBufferEvery, buffers } = this; const startOn = (startBufferEvery == null) ? bufferSize : startBufferEvery; if (count % startOn === 0) { buffers.push([]); } for (let i = buffers.length; i--; ) { const buffer = buffers[i]; buffer.push(value); if (buffer.length === bufferSize) { buffers.splice(i, 1); destination.next(buffer); } } } protected _complete() { const destination = this.destination; const buffers = this.buffers; while (buffers.length > 0) { let buffer = buffers.shift(); if (buffer.length > 0) { destination.next(buffer); } } super._complete(); } }