feat: 添加新功能

- 新增 isInRange()
- 新增 isEmptyString()

Author: yanhaijing

CHANGELOG.md

@@ -1,5 +1,10 @@
 # 变更日志
 
+## 0.7.0 / 2018-9-29
+
+- 新增 isInRange()
+- 新增 isEmptyString()
+
 ## 0.6.0 / 2018-9-28
 
 - isInt -> isInteger
@@ -24,11 +29,11 @@
 
 ## 0.1.0 / 2018-3-17
 
-- 实现 isNumber
-- 实现 isBoolean
-- 实现 isString
-- 实现 isNull
-- 实现 isUndefined
-- 实现 isObject
-- 实现 isFunction
-- 实现 isArray
+- 新增 isNumber()
+- 新增 isBoolean()
+- 新增 isString()
+- 新增 isNull()
+- 新增 isUndefined()
+- 新增 isObject()
+- 新增 isFunction()
+- 新增 isArray()

doc/api.md

@@ -1,6 +1,22 @@
 # 文档
 一组类型判断函数，解决80%类型判断问题
 
+## isInRange
+判断指定的数字，是否在指定的范围内
+
+- @param {number} x 要判断的参数，如果不为数字，将返回false
+- @param {number} [min] 最小值，包含min，缺省则不会校验
+- @param {number} [max] 最大值，包含max，缺省则不会校验
+- @return {boolean} 是否包含
+
+举个例子：
+
+```js
+isInRange(1, 0, 2) // true
+isInRange(1, 1, 2) // true
+isInRange(1, 2, 3) // false
+```
+
 ## isNumber
 判断是否为数字，参数和返回值如下：
 
@@ -29,6 +45,11 @@
 ## isString
 判断是否为字符串类型，参数和返回值同上
 
+## isEmptyString
+判断指定参数是否是空字符串，会去掉首尾的空白字符（空格、tab、回车、换行等）
+
+参数和返回值同上
+
 ## isNull
 判断是否为null类型，参数和返回值同上
 

src/index.js

@@ -1,20 +1,23 @@
 import { type } from '@jsmini/type';
 
-export function isNumber(x, min, max) {
+export function isInRange(x, min, max) {
+    x = +x;
     min = +min;
     max = +max;
 
-    return type(x) === 'number'
-        && (!isNaN(min) ? x >= min : true)
-        && (!isNaN(max) ? x <= max : true);
+    // x 不是数字，则返回false
+    if (isNaN(x)) return false;
+
+    // min 或 max 不传，则认为不设置下限或上限
+    return (!isNaN(min) ? x >= min : true) && (!isNaN(max) ? x <= max : true);
+}
+
+export function isNumber(x, min, max) {
+    return type(x) === 'number' && isInRange(x, min, max);
 }
 
 export function isInteger(x, min, max) {
-    min = +min;
-    max = +max;
-    return parseInt(x, 10) === x
-        && (!isNaN(min) ? x >= min : true)
-        && (!isNaN(max) ? x <= max : true);
+    return parseInt(x, 10) === x  && isInRange(x, min, max);
 }
 
 export function isInt(x) {
@@ -30,6 +33,12 @@ export function isString(x) {
     return type(x) === 'string';
 }
 
+export function isEmptyString(x) {
+    if (!isString(x)) return false;
+
+    return x.replace(/(^\s*|\s*$)/g, '') === '';
+}
+
 export function isNull(x) {
     return type(x) === 'null';
 }

test/test.js

@@ -16,6 +16,18 @@ describe('单元测试', function() {
             expect(is.isFunction(function () {})).to.equal(true);
         });
 
+        it('isInRange', function() {
+            expect(is.isInRange(1)).to.equal(true);
+            expect(is.isInRange('abc')).to.equal(false);
+
+            expect(is.isInRange(1, 1)).to.equal(true);
+            expect(is.isInRange(1, 2)).to.equal(false);
+
+            expect(is.isInRange(1, undefined, 1)).to.equal(true);
+            expect(is.isInRange(1, 0, 2)).to.equal(true);
+            expect(is.isInRange(1, 0, 0)).to.equal(false);
+        });
+
         it('isNumber', function() {
             expect(is.isNumber(1)).to.equal(true);
             expect(is.isNumber(1.1)).to.equal(true);
@@ -41,5 +53,13 @@ describe('单元测试', function() {
             expect(is.isInt(2147483647)).to.equal(true);
             expect(is.isInt(2147483648)).to.equal(false);
         });
+
+        it('isEmptyString', function() {
+            expect(is.isEmptyString(123)).to.equal(false);
+            expect(is.isEmptyString('')).to.equal(true);
+            expect(is.isEmptyString(' ')).to.equal(true);
+            expect(is.isEmptyString('   ')).to.equal(true);
+            expect(is.isEmptyString(' a ')).to.equal(false);
+        });
     });
 });