add startsWith and url

Author: dtrelogan

README.md

@@ -59,6 +59,8 @@ for details, see the [code](/index.es6). it's very clear i promise.
 - numeric
 - regex
 - required
+- startsWith
+- url
 
 ## aliases
 

content/en-us/default.js

@@ -11,5 +11,7 @@ module.exports = {
   minLength: '%1 must have a minimum length of %2',
   number: '%1 must be a number',
   numeric: '%1 must only contain numbers',
-  required: '%1 is required'
+  required: '%1 is required',
+  startsWith: '%1 must start with %2',
+  url: '%1 must be a url'
 };

index.es6

@@ -43,6 +43,51 @@ export let library = {
   },
   required: function(value) {
     return typeof(value) === 'string' && value.trim() !== '';
+  },
+  startsWith: function(value, searchString) {
+    return library.required(value) && library.exists(searchString) && value.trim().substr(0, searchString.length) === searchString;
+  },
+  url: function(value) {
+    //
+    // https://gist.github.com/dperini/729294
+    //
+    let re_weburl = new RegExp(
+      "^" +
+        // protocol identifier
+        "(?:(?:https?|ftp)://)" +
+        // user:pass authentication
+        "(?:\\S+(?::\\S*)?@)?" +
+        "(?:" +
+          // IP address exclusion
+          // private & local networks
+          "(?!(?:10|127)(?:\\.\\d{1,3}){3})" +
+          "(?!(?:169\\.254|192\\.168)(?:\\.\\d{1,3}){2})" +
+          "(?!172\\.(?:1[6-9]|2\\d|3[0-1])(?:\\.\\d{1,3}){2})" +
+          // IP address dotted notation octets
+          // excludes loopback network 0.0.0.0
+          // excludes reserved space >= 224.0.0.0
+          // excludes network & broacast addresses
+          // (first & last IP address of each class)
+          "(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])" +
+          "(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}" +
+          "(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))" +
+        "|" +
+          // host name
+          "(?:(?:[a-z\\u00a1-\\uffff0-9]-*)*[a-z\\u00a1-\\uffff0-9]+)" +
+          // domain name
+          "(?:\\.(?:[a-z\\u00a1-\\uffff0-9]-*)*[a-z\\u00a1-\\uffff0-9]+)*" +
+          // TLD identifier
+          "(?:\\.(?:[a-z\\u00a1-\\uffff]{2,}))" +
+          // TLD may end with dot
+          "\\.?" +
+        ")" +
+        // port number
+        "(?::\\d{2,5})?" +
+        // resource path
+        "(?:[/?#]\\S*)?" +
+      "$", "i"
+    );
+    return library.regex(value, re_weburl);
   }
 };
 

index.js

@@ -62,6 +62,41 @@ var library = exports.library = {
   },
   required: function required(value) {
     return typeof value === 'string' && value.trim() !== '';
+  },
+  startsWith: function startsWith(value, searchString) {
+    return library.required(value) && library.exists(searchString) && value.trim().substr(0, searchString.length) === searchString;
+  },
+  url: function url(value) {
+    //
+    // https://gist.github.com/dperini/729294
+    //
+    var re_weburl = new RegExp("^" +
+    // protocol identifier
+    "(?:(?:https?|ftp)://)" +
+    // user:pass authentication
+    "(?:\\S+(?::\\S*)?@)?" + "(?:" +
+    // IP address exclusion
+    // private & local networks
+    "(?!(?:10|127)(?:\\.\\d{1,3}){3})" + "(?!(?:169\\.254|192\\.168)(?:\\.\\d{1,3}){2})" + "(?!172\\.(?:1[6-9]|2\\d|3[0-1])(?:\\.\\d{1,3}){2})" +
+    // IP address dotted notation octets
+    // excludes loopback network 0.0.0.0
+    // excludes reserved space >= 224.0.0.0
+    // excludes network & broacast addresses
+    // (first & last IP address of each class)
+    "(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])" + "(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}" + "(?:\\.(?:[1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))" + "|" +
+    // host name
+    '(?:(?:[a-z\\u00a1-\\uffff0-9]-*)*[a-z\\u00a1-\\uffff0-9]+)' +
+    // domain name
+    '(?:\\.(?:[a-z\\u00a1-\\uffff0-9]-*)*[a-z\\u00a1-\\uffff0-9]+)*' +
+    // TLD identifier
+    '(?:\\.(?:[a-z\\u00a1-\\uffff]{2,}))' +
+    // TLD may end with dot
+    "\\.?" + ")" +
+    // port number
+    "(?::\\d{2,5})?" +
+    // resource path
+    "(?:[/?#]\\S*)?" + "$", "i");
+    return library.regex(value, re_weburl);
   }
 };
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-formstate-validation",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "peerDependencies": {
     "react-formstate": ">=0.3.0"
   },

test/test.js

@@ -16,6 +16,7 @@ describe('validation library', function() {
     it('multiple dots', function() { assert.equal(true, lib.email('[email protected]')); });
     it('multiple @s', function() { assert.equal(true, lib.email('a@[email protected]')); });
     it('numbers', function() { assert.equal(true, lib.email('[email protected]')); });
+    it('null', function() { assert.equal(false, lib.email(null)); });
   });
   describe('equals', function() {
     it('value', function() { assert.equal(true, lib.equals('3', '3')); });
@@ -150,6 +151,28 @@ describe('validation library', function() {
     it('{}', function() { assert.equal(false, lib.required({})); });
     it('boolean true', function() { assert.equal(false, lib.required({})); });
   });
+  describe('startsWith', function() {
+    it('normal case', function() { assert.equal(true, lib.startsWith('kilgore trout','kilg')); });
+    it('no match', function() { assert.equal(false, lib.startsWith('kilgore trout','a')); });
+    it('spaces', function() { assert.equal(true, lib.startsWith('kilgore trout','kilgore ')); });
+    it('null', function() { assert.equal(false, lib.startsWith(null)); });
+    it('null searchString', function() { assert.equal(false, lib.startsWith('kilgore trout', null)); });
+    it('non-string searchString', function() { assert.equal(false, lib.startsWith('kilgore trout', 3)); });
+    it('trims value', function() { assert.equal(true, lib.startsWith('   kilgore trout','kilg')); });
+    it('does not trim searchString', function() { assert.equal(false, lib.startsWith('kilgore trout',' kilg')); });
+    it('does not trim searchString2', function() { assert.equal(false, lib.startsWith(' kilgore trout',' kilg')); });
+    it('empty string', function() { assert.equal(false, lib.startsWith('','kilgore ')); });
+  });
+  describe('url', function() {
+    it('matches http', function() { assert.equal(true, lib.url('http://react-formstate-validation.test')); });
+    it('matches https', function() { assert.equal(true, lib.url('https://react-formstate-validation.test')); });
+    it('matches ftp', function() { assert.equal(true, lib.url('ftp://react-formstate-validation.test')); });
+    it('does not match relative', function() { assert.equal(false, lib.url('/react-formstate-validation.test')); });
+    it('does not match schema relative', function() { assert.equal(false, lib.url('//react-formstate-validation.test')); });
+    it('does not match site relative', function() { assert.equal(false, lib.url('~/react-formstate-validation.test')); });
+    it('does not match gopher', function() { assert.equal(false, lib.url('gopher://react-formstate-validation.test')); });
+    it('does not crash', function() { assert.equal(false, lib.url(null)); });
+  });
 });
 
 function mock(validations) {
@@ -304,6 +327,22 @@ describe('Messages', function() {
       assert.equal(undefined, v['required']('46','Field'));
     });
   });
+  describe('#startsWith', function() {
+    it('has a message', function() {
+      assert.equal('Field must start with f', v['startsWith']('','Field','f'));
+    });
+    it('might not return a message', function() {
+      assert.equal(undefined, v['startsWith']('f','Field','f'));
+    });
+  });
+  describe('#url', function() {
+    it('has a message', function() {
+      assert.equal('Field must be a url', v['url']('','Field'));
+    });
+    it('might not return a message', function() {
+      assert.equal(undefined, v['url']('http://test.test','Field'));
+    });
+  });
 });