Skip to content

Files

Latest commit

author
Alvin Huang
Jun 26, 2018
bf3665c · Jun 26, 2018

History

History

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Sep 15, 2017
Jun 26, 2018
Nov 21, 2017

Overview

A lightweight vanilla JavaScript library for judging.https://tonicdev.com/trigkit4/judgejs

npm version bandge

Features

  • 没有任何依赖
  • 支持 AMD & CommonJS
  • 支持typescript
  • 轻量级(10kb)

单元测试:http://hawx1993.github.io/judge/test/

Quick Start

$ npm install  
$ gulp compress  

使用npm安装judgejs

$ npm install judgejs

使用bower 安装judgejs

$ bower install judgejs  

目录

使用方法

var judge = require('judgejs');

judge.version

=>0.9.0

可以用$来代替judge。例如:

require('../judge.js')

$.version;
=> 0.9.0

API

数据类型判断

judge.isArray(value)

judge.isArray(['foo','bar',{'name':'trigkit4'}])

=> true

judge.isInt(num)

var num = 3.14;
judge.isInt(num);

=>false

judge.isError(value)

判断给定值是否是Error

judge.isJson(json)

判断给定值是否是json格式

 var str = '{"name":"jack"}';
 judge.isJson(str);//false
 var json = JSON.parse(str);
 judge.isJson(json);//true

judge.isFunction()

判断给定值是否是函数:

var fn = new Function ();
judge.isFunction(fn);

=>true

judge.isString()

判断一个给定的值是否是字符串,返回布尔值

judge.isObject()

判断一个给定的值是否是对象,返回布尔值;

var obj = Object.create(null);
judge.isObject(obj);//true

judge.isObject(undefined);//false

judge.isObjectLike(value)

判断参数value是否是object-like

judge.isObjectLike([NaN]);

=>true

judge.isObjectLike(null);

=>false

judge.isEmptyObject(obj)

判断是否为空对象

var obj = Object.create(null);
$.isEmptyObject(obj);

judge.type()

判断值的类型,包括:

array,object,number,string,null,undefined,function,boolean,regexp

var arr = new Array;
judge.type(arr);//array

var obj = {};
judge.type(obj);//object

var num = Number(1);
judge.type(num);//number

var str = '123';
judge.type(str);//string

var n = null;
judge.type(n);//null


var u = undefined;
judge.type(u);//undefined

var fn = function () {};
judge.type(fn);//function

var bool = Boolean();
judge.type(bool);//boolean

var proto = Object.prototype;
judge.type(proto);//object

function Person(){}
var p1 = new Person();
judge.type(p1);//object

judge.isEqual()

判断两个给定值是否是严格相等:

var judge = require('judgejs');
var str = Boolean(true);
var str2 = !!true;
var str3 = true;

var obj1 = {};
var obj2 = new Object();
var obj4 = Object.create(null);

var foo = {name:'trigkit4'};
var bar = {age:23};
var baz = Object.assign(foo,bar);
var obj3 = {
    name: 'trigkit4',
    age: 23
};

judge.isEqual(str,str2,str3);//true
judge.isEqual(obj1,obj2,obj4);//false
judge.isEqual(baz,obj3);//false,refer address different

judge.isChar()

判断给定值是否是字符

judge.isRegExp(reg)

判断给定值是否是RegExp对象:

var reg = /^(a,z)/i;
judge.isRegExp(reg);

=> true

judge.isRegExp('/[a-z]/');

=>false

judge.isLength(value)

判断value是否是有效的类数组长度

judge.isLength(Infinity);

=>false

var arr = Number([]);
judge.isLength(arr);

>true

judge.isWindow(obj)

判断是否是window对象。

judge.isDocument()

判断是否是Document对象

judge.isPlainObject(obj)

判断obj是否是纯粹的对象,纯粹的对象是通过{}创建或者通过new Object()创建

judge.isPlainObject(window);

=>false

var arr = Number([]);
judge.isPlainObject(arr);

=>false

judge.isPlainObject(new Date());

=>false

judge.isPlainObject({});//true

judge.isArrayLike(obj)

判断obj是否是类数组对象(类数组对象被限定为拥有非负整数属性的对象,NodeList,arguments,Array等):

judge.isArrayLike(document.body.children);

=>true

var obj = [{name:'null'}];
judge.isArrayLike(obj);

=>true

judge.isArrayLike(null);

=>false

judge.isArrayLikeObject(value)

judge.isArrayLike类似,但isArrayLikeObject会检测value是否是对象

judge.isArrayLikeObject('abcd');//false
judge.isArrayLikeObject(document.body.children);//true

judge.isArguments(value)

判断参数value是否是一个arguments对象:

judge.isArguments(function(){ return arguments;}())

=>true

judge.isSet(value)

判断给定值是否不为nullundefined

judge.idNumber(id)

判断你的身份证号码是否符合规范,其中X不区分大小写:

var id = '35050019970323505x';
judge.idNumber(id);

=> true

judge.isOdd(num)

判断给定值是否是奇数,返回布尔值

judge.min(a,b)

判断给定的数值中谁是最小值,并返回最小值

judge.min(0,-1);
=>-1

judge.isEven(num)

判断一个给定的值是否是偶数,返回布尔值

$.isEven(null);

=>false

judge.isNull(value)

judge.isNull(void 0);

=>true

judge.isNull(null);

=>true

judge.isUndefined(value)

judge.isUndefined(null);

=>false

judge.isUndefined(void 0);

=>true

judge.isNumber(num)

judge.isNumber(Infinity);

=>true

平台判断

judge.kernel()

用于检测当前浏览器的内核(排版引擎),可以检测的类型如下:

webkit,gecko,trident,edge,opera 浏览器的内核分别用于检测Chrome浏览器,Firefox浏览器,IE浏览器,Edge浏览器和Opera浏览器

if(judge.kernel() == 'webkit'){...} //引号处不能出现空格等不规范写法

judge.platform()

检测用户当前设备,可以检测的类型如下:

android,iPad,ios,windowsPhone,mac,windows,linux,blackBerrytablet,androidTablet

if(judge.platform() == "androidTablet"){...}

参数也如上所示,千万不能写错,不然检测就会出现错误。参数采用驼峰命名法

judge.isElectron()

judge current user is in Electron app or not

judge.isElectron()

judge.iosVersion()

判断iOS 系统版本号,返回数字形式的版本号:

judge.iosVersion();

=>9.0.2

judge.androidVersion()

同上

judge.isChromium()

判断用户的浏览器是否是套着chrome内核的浏览器,返回布尔值

设备判断

judge.isMobile()

判断用户设备是否是移动设备(ipad,iphone,ipod,android)

judge.isPc()

判断用户设备是否是PC

judge.iosDevice()

检测iPhone手机设备类型,可以检测如下类型的iPhone手机:

iphone4(s) ,iphone5(s), iphone6(s),iphone6(s)Plus

if(judge.iosDevice=='iphone6Plus'){...}

参数为:iphone4,iphone5,iphone6,iphone6Plus

$.iosDevice();//if your ios device is iphone6

=>iphone6

judge.isTouchDevice()

判断用户当前设备是否是触屏设备,返回布尔值Boolean

存在性和信息校验

judge.isExist(value)

var str =  null;
judge.isExist(str)
=>false

var str = '';
judge.isExist(str)
=>false

judge.lt(val1,val2)

判断val1是否小于val2:

judge.lt(1,-2);

=>false

judge.inArray(val,arr)

判断参数val是否存在arr数组内:

var val = [{'name':'huang'},123],
    arr = [val,456];
judge.inArray(val,arr);

=>true

judge.email(em)

判断是否符合Email规范:

var email = 'hwx.trigkit4@163.com';
judge.email(email);

=>true

var email2 = 'hwx.trigkit.@gmail.com';
judge.email(email2);
=>false

judge.hasLowerCase()

判断是否含有小写字母:

var str ='trigkit4';
judge.hasLowerCase(str);

judge.hasNumber()

判断给定值是否含有数字:

var num ='trigkit4';
judge.hasNumber(num);

=>true

judge.hasCapital()

判断是否含有大写字母:

var str ='trigkit4';
judge.hasCapital(str);

judge.isBrowser()

判断当前客户端是否是浏览器,返回布尔值

judge.size(val)

判断给定值的大小,返回数值:

var val = '琅琊榜lyb';
judge.size(val);

=>6

judge.isHttps()

判断当前站点是否是HTTPS,返回布尔值

judge.isUnique()

判断一个给定数组的元素的值是否唯一:

var a = [1,2];
var arr = [1,2,3,4,a];//[1,2,3,4,[1,2]];
judge.isUnique(arr);//true

var arary = ['1',1];
judge.isUnique(array);//true

judge.hasClass()

判断给定值是否有class

judge.qqNumber()

判断给定值是否符合QQ号规范,返回布尔值:

var qq = 345812345;
judge.qqNumber(qq);

=>true

judge.phoneNumber

判断给定值是否符合手机号规范:

var num = 17755503789;
judge.phoneNumber(num);

=>true

judge.includeChinese

判断给定值是否含有中文字符:

var ch = 'js脚本';
judge.includeChinese(ch);

=> true

judge.onlyChinese(ch)

判断给定字符是否仅有中文字符:

var ch = 'zh中国';
judge.onlyChinese(ch);

=>false

$.isLetter(str)

判断给定字符是否全是英文字母

$.isAlpha(str)

判断输入字符是否仅由字母或数字或下划线组成

judge.onlyNumber()

判断给定值是否只含有数字:

var s = '233';
judge.onlyNumber(s);

=>true

judge.isElement(element)

判断给定元素是否是DOM元素,返回布尔值

var div = document.createElement('div');
judge.isElement(div);

=>true

judge.assert(value,desc)

你可以使用judge.assert 去断言你想要断言的值,如果该值通过断言,描述不符将变为绿色,否则变为红色;

function add(a,b){
    return a + b;
}
var a = 1,b=2;

judge.assert(add(1,2) === 3,'true');
judge.assert(add(2,3) === 6,'false');

在参数desc 部分去填写你的测试描述

judge.hasHash(url)

判断一个给定的url是否有哈希值

var url = 'www.baidu.com#w';
judge.hasHash(url);

=> true

judge.has(obj,key)

判断obj是否有包含给定的键(key)

var obj ={
    name:'trigkit4'
};
judge.has(obj,'name');

=>true

judge.zipCode(code)

判断给定值是否符合邮编规范:

var zipcode = 362014;
judge.zipCode(zipcode);

=>true

judge.include(str,substr)

var str =  'microsoft';
var substr = 'soft';
judge.include(str,substr);

=>true

judge.isOnline()

可用于判断设备是否联网,判断断网可用judge.isOnline==false,返回true,即断网

judge.hasSpecialChar()

判断是否含有特殊字符,除了大小写字母、数字和汉字以外的字符都被视为特殊字符

var char = 'a!@#$%';
judge.hasSpecialChar(char);

=>true

judge.isEmpty()

判断给定值是否为空,nullundefined被视为空, 数字0被视为非空

var arr = [];//judge.isEmpty(arr); => true
var n = null;//judge.isEmpty(n); => true
var u = undefined;//judge.isEmpty(u); => true
var num = 0;//judge.isEmpty(num); => false
var obj = Object.create(null);//judge.isEmpty(obj); => true
var str = '';//judge.isEmpty(str); => true

judge.position(element,parent)

判断DOM元素位置,若只传入element参数,则返回其距离浏览器窗口的位置; 若传入parent参数,则返回其距离父元素的位置。兼容IE浏览器

@{param}:parent 可选

judge.position(element).top ;//判断元素距离顶部位置
judge.position(element,parent).left;//判断元素距离父元素左边的位置

judge.isNativeFn(fn)

判断fn是否是原生方法,不能有括号

judge.isNativeFn(Object.assign);

=>true


var fn = new Function();
judge.isNativeFn(fn);

=>false


judge.isNativeFn(Array.prototype.filter)

=>true

var obj = {
        fn: function () {}
 };

judge.isNativeFn(obj.fn)

=>false

judge.strLength(str)

判断字符长度,返回数字。一个中文字符被视为2,一个英文字符为视为1:

judge.strLength('你好China');//9

judge.isLeapYear(year)

判断是否是闰年

judge.isDate(val)

判断是否是日期

judge.isUrl(str)

判断URL合法性,不是很严格的判断,主要匹配url是否带有协议头等,比如http/https等

judge.isNumberic

判断数字

将忽略字符串,可以判断数字,小数,带字符串的数字

$.isNumberic(123);//true
$.isNumberic('1.2');//true
$.isNumberic(-.2);//true

judge.isPositiveInteger

判断是否是正整数

judge.isInteger

判断是否是整数

judge.isUptoAdecimal

判断最多是否只有一位小数