v0.0.3

1. Add isChineseIdCard method
2. Update README

Author: SFantasy

README.md

@@ -3,6 +3,17 @@ node-validator
 
 String validator for more.
 
+[![NPM version][npm-image]][npm-url]
+[![build status][travis-image]][travis-url]
+[![David deps][david-image]][david-url]
+
+[npm-image]: https://img.shields.io/npm/v/is-valid.svg?style=flat
+[npm-url]: https://npmjs.org/package/is-valid
+[travis-image]: https://img.shields.io/travis/SFantasy/node-validator.svg?style=flat
+[travis-url]: https://travis-ci.org/SFantasy/node-validator
+[david-image]: https://img.shields.io/david/SFantasy/node-validator.svg?style=flat
+[david-url]: https://david-dm.org/SFantasy/node-validator
+
 ## Install
 
 ```
@@ -24,6 +35,7 @@ validator.isEmail('abc@gmail.com'); // => true
 - isAllEnglish(str): check if it is a string only contains English characters
 - isAllDigit(str): check if it is a string only contains digits
 - isChineseTel(str): check if it is a Chinese cell-phone number
+- isChineseIdCard(str): check if it is a 18-digit Chinese ID card number
 
 ## License
 

bin/is-valid

@@ -21,3 +21,6 @@ console.log(validator.isAllEnglish('test'));
 
 // isAllDigit
 console.log(validator.isAllDigit('12345'));
+
+// isChineseIdCard
+console.log(validator.isChineseIdCard('330682199110273013'));

example/example.js

@@ -10,24 +10,91 @@
 
 module.exports = {
 
+  /**
+   * check if it is an Email string
+   * @param str
+   * @returns {boolean}
+   */
   isEmail: function (str) {
     return /^[a-z0-9!#$%&'*+\/=?^_`{|}~.-]+@[a-z0-9-]+(\.[a-z0-9-]+)*$/i.test(str);
   },
 
+  /**
+   * check if it is a string only contains Chinese characters
+   * @param str
+   * @returns {boolean}
+   */
   isAllChinese: function (str) {
     return !/[^\u4e00-\u9fa5]/.test(str);
   },
 
+  /**
+   * check if it is a string only contains English characters
+   * @param str
+   * @returns {boolean}
+   */
   isAllEnglish: function (str) {
     return /^[a-zA-Z]+$/.test(str);
   },
 
+  /**
+   * check if it is a string only contains digits
+   * @param str
+   * @returns {boolean}
+   */
   isAllDigit: function (str) {
     return /^[0-9]+$/.test(str);
   },
 
+  /**
+   * check if it is a Chinese cell-phone number
+   * @param str
+   * @returns {boolean}
+   */
   isChineseTel: function (str) {
     return /^1[34578]\d{9}$/.test(str);
+  },
+
+  /**
+   * check if it is a 18-digit Chinese ID card number
+   * @param str
+   * @returns {boolean}
+   */
+  isChineseIdCard: function (str) {
+
+    if (!(str.length === 18)) {
+      return false;
+    } else {
+      return isBirthValid(str) && isCodeValid(str);
+    }
+
+    function isBirthValid (num) {
+      var year = num.substring(6, 10);
+      var month = num.substring(10, 12);
+      var day = num.substring(12, 14);
+      var temp = new Date(year, parseInt(month, 10), parseInt(day, 10));
+
+      return (temp.getFullYear() === parseInt(year, 10) &&
+          temp.getMonth() === parseInt(month, 10) &&
+          temp.getDate() === parseInt(day, 10));
+    }
+
+    function isCodeValid (num) {
+      var wc = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2, 1];
+      var validCodeArr = [1, 0, 10, 9, 8, 7, 6, 5, 4, 3, 2];
+      var sum = 0;
+      var temp = num.split('');
+
+      if (temp[17].toLowerCase() === 'x') {
+        temp[17] = 10;
+      }
+
+      for (var i = 0; i < temp.length; i++) {
+        sum += wc[i] * temp[i];
+      }
+
+      return temp[17] === validCodeArr[sum % 11];
+    }
   }
 
 };

lib/index.js

@@ -1,6 +1,6 @@
 {
   "name": "is-valid",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "String validator for more",
   "main": "index.js",
   "scripts": {