util.polyfills

experimental.object.prototype.tap.d.ts

export {}

declare global {
  interface Object {
    /**
     * Yields this to the `interceptor`, and returns this.
     * The primary purpose of this method is to "tap into" a method chain,
     * in order to perform operations on intermediate results within the chain.
     *
     * @returns this
     *
     * @example
     * Chains methods and prints out each step:
     * ```ts
     * [1, 2, 3].tap(console.log)
     *  .map(x => x * 2)
     *  .tap(console.log)
     *  .map(x => x + 1)
     * ```
     *
     * @experimental
     */
    tap<T>(this: T, interceptor: (this: T, obj: T) => void): T
  }
}

experimental.object.prototype.tap.js

(function() {
  'use strict';

  if (!('tap' in Object.prototype)) {
  // eslint-disable-next-line no-extend-native
    Object.defineProperty(Object.prototype, 'tap', {
      value: function(interceptor) {
        interceptor.call(this, this);

        return this;
      }
    });
  }
})();