foop/deps/is/instanceOf.js

interfaces that describe their intentions.

const curry = require('../fp/curry')
const isNil = require('./nullOrUndefined')

/**
 * @desc check instanceof
 * @since 5.0.0-beta.4
 * @memberOf is
 * @curried 2
 *
 * @param  {Object} instanceToCheckAgainst check the second arg against this
 * @param  {Object} isThisInstanceOfThat check this against first arg
 * @return {boolean} arg2 instanceof arg1
 *
 * @see http://documentcloud.github.io/underscore-contrib/#isinstanceof
 * @see https://github.com/lodash/lodash/issues/620
 * @see https://github.com/ramda/ramda/commit/9d4cb895595aca3d83ce0a4b10416ae7302bd8ac
 * @see https://github.com/ramda/ramda/blob/v0.24.1/src/is.js
 *
 * @example
 *
 *  const isObjInstance = instanceOf(Object)
 *  isObjInstance({})
 *  //=> true
 *
 *  const isArrInstance = instanceOf(Array)
 *  isArrInstance({})
 *  //=> false
 *
 *  isArrInstance(new Array)
 *  //=> true
 *
 */
function instanceOf(instanceToCheckAgainst, isThisInstanceOfThat) {
  return !isNil(instanceToCheckAgainst) &&
    !isNil(isThisInstanceOfThat) &&
    isThisInstanceOfThat instanceof instanceToCheckAgainst
  // || arg1.constructor === arg2
}

module.exports = curry(2, instanceOf)