ydr-util/libs/typeis.js

util for ydr.me

/*!
 * 判断数据类型
 * @author ydr.me
 * @create 2014-11-15 12:54
 * @update 2014年11月19日10:20:51
 */


'use strict';

var fs = require('fs');
var udf = 'undefined';
var REG_URL = /^https?:\/\/([\w-]+\.)+[a-z]{2,5}(:\d{1,})?(\/|\/[\w#!:.?+=&%@!\-\/]+)?$/i;
var REG_EMAIL = /^\w+[-+.\w]*@([\w-]+\.)+[a-z]{2,5}$/i;
var REG_MOMGODB_ID = /^[\da-z]{24}$/;
var REG_INVALID = /invalid/i;
var fs = require('fs');


/**
 * 判断数据类型，结果全部为小写<br>
 * 原始数据类型：boolean、number、string、undefined、symbol
 * @param {*} object 任何对象
 * @returns {string}
 *
 * @example
 * typeis();
 * // => "undefined"
 *
 * typeis(null);
 * // => "null"
 *
 * typeis(1);
 * // => "number"
 *
 * typeis("1");
 * // => "string"
 *
 * typeis(!1);
 * // => "boolean"
 *
 * typeis({});
 * // => "object"
 *
 * typeis([]);
 * // => "array"
 *
 * typeis(/./);
 * // => "regexp"
 *
 * typeis(window);
 * // => "window"
 *
 * typeis(document);
 * // => "document"
 *
 * typeis(document);
 * // => "document"
 *
 * typeis(NaN);
 * // => "nan"
 *
 * typeis(Infinity);
 * // => "number"
 *
 * typeis(function(){});
 * // => "function"
 *
 * typeis(new Image);
 * // => "element"
 *
 * typeis(new Date);
 * // => "date"
 *
 * typeis(document.links);
 * // => "htmlcollection"
 *
 * typeis(document.body.dataset);
 * // => "domstringmap"
 *
 * typeis(document.body.classList);
 * // => "domtokenlist"
 *
 * typeis(document.body.childNodes);
 * // => "nodelist"
 *
 * typeis(document.createAttribute('abc'));
 * // => "attr"
 *
 * typeis(document.createComment('abc'));
 * // => "comment"
 *
 * typeis(new Event('abc'));
 * // => "event"
 *
 * typeis(document.createExpression());
 * // => "xpathexpression"
 *
 * typeis(document.createRange());
 * // => "range"
 *
 * typeis(document.createTextNode(''));
 * // => "text"
 */
var typeis = function (object) {
    if (typeof object === udf) {
        return udf;
    } else if (typeof window !== udf && object === window) {
        return 'window';
    } else if (typeof global !== udf && object === global) {
        return 'global';
    } else if (typeof document !== udf && object === document) {
        return 'document';
    } else if (object === null) {
        return 'null';
    }

    var ret = Object.prototype.toString.call(object).slice(8, -1).toLowerCase();

    if (/element/.test(ret)) {
        return 'element';
    } else if (isNaN(object) && ret === 'number') {
        return 'nan';
    }

    return ret;
};
var i = 0;
var jud = 'string number function object undefined null nan element regexp boolean array window document global'.split(' ');
var makeStatic = function (tp) {
    /**
     * 快捷判断
     * @name typeis
     * @property string {Function}
     * @property number {Function}
     * @property function {Function}
     * @property object {Function}
     * @property undefined {Function}
     * @property null {Function}
     * @property nan {Function}
     * @property element {Function}
     * @property regexp {Function}
     * @property boolean {Function}
     * @property array {Function}
     * @property window {Function}
     * @property document {Function}
     * @property global {Function}
     * @returns {boolean}
     */
    typeis[tp] = function (obj) {
        return typeis(obj) === tp;
    };
};


/**
 * 复制静态方法
 */
for (; i < jud.length; i++) {
    makeStatic(jud[i]);
}


/**
 * 判断是否为纯对象
 * @param obj {*}
 * @returns {Boolean}
 *
 * @example
 * type.isPlainObject({a:1});
 * // => true
 */
typeis.plainObject = function (obj) {
    return typeis(obj) === 'object' && Object.getPrototypeOf(obj) === Object.prototype;
};


/**
 * 判断是否为空对象
 * @param obj {*}
 */
typeis.emptyObject = function (obj) {
    return typeis.plainObject(obj) && Object.keys(obj).length === 0;
};


/**
 * 判断是否为 URL 格式
 * @param string
 * @returns {Boolean}
 *
 * @example
 * typeis.url('http://123.com/123/456/?a=3#00');
 * // => true
 */
typeis.url = function (string) {
    return typeis(string) === 'string' && REG_URL.test(string);
};


/**
 * 判断是否为 email 格式
 * @param string
 * @returns {Boolean}
 *
 * @example
 * typeis.email('abc@def.com');
 * // => true
 */
typeis.email = function (string) {
    return typeis(string) === 'string' && REG_EMAIL.test(string);
};


/**
 * 判断能否转换为合法Date
 * @param  {*}
 * @return {Boolean}
 * @version 1.0
 * 2014年5月2日21:07:33
 */
typeis.validDate = function (anything) {
    return !REG_INVALID.test(new Date(anything).toString());
};


/**
 * 判断是否为合法的mongodbID
 * @param  {*}
 * @return {Boolean}
 * @version 1.0
 * 2014年5月3日23:11:37
 */
typeis.mongoId = function (anything) {
    return typeof  anything !== udf && typeof anything._bsontype !== udf &&
        anything._bsontype === 'ObjectId' || REG_MOMGODB_ID.test(anything.toString());
};


/**
 * 判断对象是否为空
 * @param  {*}  任何对象
 * @return {Boolean}
 * @version 1.0
 * 2014年5月27日21:33:04
 */
typeis.emptyData = function (any) {
    return any === undefined || any === null || any === '';
};



/**
 * 判断路径是否为目录
 * @param _path
 * @returns {Boolean}
 */
typeis.directory = function (_path) {
    var stat;

    try {
        stat = fs.statSync(_path);
    } catch (err) {
        return !1;
    }

    return stat.isDirectory();
};


/**
 * 判断路径是否为文件
 * @param _path
 * @returns {Boolean}
 */
typeis.file = function (_path) {
    var stat;

    try {
        stat = fs.statSync(_path);
    } catch (err) {
        return !1;
    }

    return stat.isFile();
};


/**
 * @name string
 * @name number
 * @name function
 * @name object
 * @name undefined
 * @name null
 * @name nan
 * @name element
 * @name regexp
 * @name boolean
 * @name array
 * @name window
 * @name document
 * @name global
 * @type {Function}
 */
module.exports = typeis;