valid-url
Advanced tools
Comparing version 1.0.6 to 1.0.7
@@ -11,3 +11,3 @@ { | ||
], | ||
"version": "1.0.6", | ||
"version": "1.0.7", | ||
"repository": { | ||
@@ -14,0 +14,0 @@ "url": "git://github.com/ogt/valid-url.git" |
107
README.md
@@ -20,3 +20,3 @@ URI validation functions | ||
http://search.cpan.org/~sonnen/Data-Validate-URI-0.01/lib/Data/Validate/URI.pm [full code here](http://anonscm.debian.org/gitweb/?p=users/dom/libdata-validate-uri-perl.git) | ||
into a nodejs module. Initially translated practically line by line from perl. Subsequently rewritten to leverage [url](http://nodejs.org/api/url.html). | ||
into a nodejs module. Translated practically line by line from perl. | ||
It passes all the original tests. | ||
@@ -41,25 +41,90 @@ | ||
## Methods | ||
```javascript | ||
/* | ||
* @Function isUri(value) | ||
* | ||
* @Synopsis is the value a well-formed uri? | ||
* @Description | ||
Returns the untainted URI if the test value appears to be well-formed. Note that | ||
you may really want one of the more practical methods like is_http_uri or is_https_uri, | ||
since the URI standard (RFC 3986) allows a lot of things you probably don't want. | ||
* @Arguments | ||
* value The potential URI to test. | ||
* | ||
* @Returns The untainted RFC 3986 URI on success, undefined on failure. | ||
* @Notes | ||
This function does not make any attempt to check whether the URI is accessible | ||
or 'makes sense' in any meaningful way. It just checks that it is formatted | ||
correctly. | ||
* | ||
*/ | ||
` | ||
isUri(value) | ||
` | ||
**accepts** value as string to be checked as any protocol url | ||
**returns** undefined if is not url, returns RFC 3986 url if valid | ||
` | ||
isHttpUri(value, allowHttps) | ||
` | ||
**accepts** *value* as string to be checked as HTTP url, *allowHttps* as boolean to include https urls *(optional)* | ||
**returns** undefined if is not url, returns RFC 3986 url if valid | ||
/* | ||
* @Function isHttpUri(value) | ||
* @Synopsis is the value a well-formed HTTP uri? | ||
* @Description | ||
Specialized version of isUri() that only likes http:// urls. As a result, it can | ||
also do a much more thorough job validating. Also, unlike isUri() it is more | ||
concerned with only allowing real-world URIs through. Things like relative | ||
hostnames are allowed by the standards, but probably aren't wise. Conversely, | ||
null paths aren't allowed per RFC 2616 (should be '/' instead), but are allowed | ||
by this function. | ||
This function only works for fully-qualified URIs. /bob.html won't work. | ||
See RFC 3986 for the appropriate method to turn a relative URI into an absolute | ||
one given its context. | ||
Returns the untainted URI if the test value appears to be well-formed. | ||
Note that you probably want to either call this in combo with is_https_uri(). i.e. | ||
if(isHttpUri(uri) || isHttpsUri(uri)) console.log('Good'); | ||
or use the convenience method isWebUri which is equivalent. | ||
` | ||
isHttpsUri(value) | ||
` | ||
**accepts** value as string to be checked as HTTPS url | ||
**returns** undefined if is not url, returns RFC 3986 url if valid | ||
* @Arguments | ||
* value The potential URI to test. | ||
* | ||
* @Returns The untainted RFC 3986 URI on success, undefined on failure. | ||
* @Notes | ||
This function does not make any attempt to check whether the URI is accessible | ||
or 'makes sense' in any meaningful way. It just checks that it is formatted | ||
correctly. | ||
*/ | ||
` | ||
isWebUri(value) | ||
` | ||
**accepts** value as string to be checked as HTTP or HTTPS url | ||
**returns** undefined if is not url, returns RFC 3986 url if valid | ||
/* | ||
* @Function isHttpsUri(value) | ||
* @Synopsis is the value a well-formed HTTPS uri? | ||
* @Description | ||
See is_http_uri() for details. This version only likes the https URI scheme. | ||
Otherwise it's identical to is_http_uri() | ||
* @Arguments | ||
* value The potential URI to test. | ||
* | ||
* @Returns The untainted RFC 3986 URI on success, undefined on failure. | ||
* @Notes | ||
This function does not make any attempt to check whether the URI is accessible | ||
or 'makes sense' in any meaningful way. It just checks that it is formatted | ||
correctly. | ||
*/ | ||
/* | ||
* @Function isWebUri(value) | ||
* @Synopsis is the value a well-formed HTTP or HTTPS uri? | ||
* @Description | ||
This is just a convenience method that combines isHttpUri and isHttpsUri | ||
to accept most common real-world URLs. | ||
* @Arguments | ||
* value The potential URI to test. | ||
* | ||
* @Returns The untainted RFC 3986 URI on success, undefined on failure. | ||
* @Notes | ||
This function does not make any attempt to check whether the URI is accessible | ||
or 'makes sense' in any meaningful way. It just checks that it is formatted | ||
correctly. | ||
*/ | ||
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
17103
129
0