Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →
types.js - npm Package Compare versions
Comparing version 1.4.2 to 1.4.3
| { | ||
| "name": "types.js", | ||
| "version": "1.4.2", | ||
| "version": "1.4.3", | ||
| "description": "A tiny (1.8kb), essential Javascript type-check library", | ||
@@ -19,5 +19,4 @@ "main": "types.min.js", | ||
| "check", | ||
| "type-checking", | ||
| "checking", | ||
| "force", | ||
| "force-type", | ||
| "is", | ||
@@ -24,0 +23,0 @@ "not", |
133
README.md
@@ -5,16 +5,32 @@ types.js | ||
| A tiny(1.8Kb), essential Javascript type checking library. | ||
| ___ | ||
| types.js has moved!!! | ||
| ===================== | ||
| **types.js is now types-js** | ||
| <br/> | ||
| <br/> | ||
| Check types-js for the latest version. I had to move this because for some reason the npm search engine cannot find types.js, most | ||
| of the time.. | ||
| <br/> | ||
| <br/> | ||
| ___ | ||
| Javascript's type system is broken by design, and that while reliable type checking is so crucial. I had to fix this, even if | ||
| it was just for me. | ||
| - fixes NaN, array, null, etc.. | ||
| - checks one or multiple arguments at once | ||
| - 4 convenience forms: isNumber, notNumber, hasNumber and allNumber (with any type of choice) | ||
| - can force a value to be of some type, with optional value if conversion is not possible | ||
| ___ | ||
| **A few quick examples:** | ||
| ```javascript | ||
| _.typeof( [] ); // 'array' | ||
| _.typeof( null ); // 'null' | ||
| _.typeof( /someregexp/ ); // 'regexp' | ||
| _.typeof( parseInt('Not A Number!') ); // 'nan' | ||
| _.forceString( 123 ); // '123' | ||
| _.allDefined( 'good', false, null ); // true | ||
| _.hasObject( 'not', 'really' ); // false | ||
| // there is much more! see below. | ||
| _.typeof( [] ); // 'array' | ||
| _.typeof( null ); // 'null' | ||
| _.typeof( /someregexp/ ); // 'regexp' | ||
| _.typeof( parseInt('Not A Number!') ); // 'nan' | ||
| _.forceString( 123 ); // '123' | ||
| _.forceNumber( '123mm' ); // 123 | ||
| _.forceNumber( 'use next arg..', 123 ); // 123 | ||
| _.allDefined( 'good', false, 0 ); // true | ||
| _.hasObject( 'not', 'really' ); // false | ||
| // there is much more, see below. | ||
| ``` | ||
@@ -26,14 +42,15 @@ Force! | ||
| A quick example to show how we can safely call a function with forceFunction: | ||
| A quick example to show how we can safely call a function that needs to pass a number argument, first in standard JS, next with | ||
| types.js force methods: | ||
| ```javascript | ||
| var left= '500px'; | ||
| var callback= null; | ||
| // now some 10 lines of code to be save without force: | ||
| if ( typeof left === 'string' ){ | ||
| left= parseInt( left, 10 ); | ||
| } | ||
| // check if parseInt returned NaN.. | ||
| if ( left !== left || typeof left !== 'number' ) | ||
| if ( typeof left !== 'number' ){ | ||
| left= parseInt( left, 10 ); | ||
| } | ||
| // check for parseInt returning NaN.. | ||
| if ( left !== left || typeof left !== 'number' ){ | ||
| left= 100; | ||
| } | ||
| // be safe before calling the function | ||
| if ( typeof callback !== 'function' ){ | ||
@@ -44,3 +61,3 @@ callback= function(){} | ||
| // 2 lines of code with force, and a better read if you ask me: | ||
| // now with force, exactly the same result: | ||
| left= _.forceNumber( left, 100 ); | ||
@@ -76,10 +93,10 @@ _.forceFunction( callback )( left ); | ||
| // initialize a variable and be sure what type it will have in any case: | ||
| x= _.forceString(); // '' (empty String) | ||
| x= _.forceString( null, 'ok' ); // 'ok' (as String) | ||
| x= _.forceString( null, [1, 2, 3] ); // '' (empty String) | ||
| x= _.forceString(33); // '33' (as String) | ||
| x= _.forceNumber('35px'); // 35 (as Number) | ||
| x= _.forceNumber( true, function(){} ); // 0 (as Number) | ||
| x= _.forceBoolean('35px'); // false (as Boolean) | ||
| x= _.forceArray("you'll get an array"); // [] | ||
| _.forceString(); // '' (empty String) | ||
| _.forceString( null, 'ok' ); // 'ok' (as String) | ||
| _.forceString( null, [1, 2, 3] ); // '' (empty String) | ||
| _.forceString(33, 'not used'); // '33' (as String) | ||
| _.forceNumber('35px'); // 35 (as Number) | ||
| _.forceNumber( true, 0 ); // 0 (as Number) | ||
| _.forceBoolean('35px'); // false (as Boolean) | ||
| _.forceArray("you'll get an array!"); // [] | ||
@@ -92,34 +109,34 @@ var func= null; | ||
| // some default type checking: | ||
| x= _.isDefined() // false | ||
| x= _.isString( 'Hello types.js!' ); // true | ||
| x= _.isString( 23456 ); // false | ||
| x= _.isBoolean( false ); // true | ||
| x= _.isArray( [1,2,3] ); // true | ||
| x= _.isObject( [1,2,3] ); // false | ||
| x= _.isObject( /myRegExp/g ); // false | ||
| x= _.isNaN( parseInt('generate NaN') ); // true | ||
| _.isDefined() // false | ||
| _.isString( 'Hello types.js!' ); // true | ||
| _.isString( 23456 ); // false | ||
| _.isBoolean( false ); // true | ||
| _.isArray( [1,2,3] ); // true | ||
| _.isObject( [1,2,3] ); // false | ||
| _.isObject( /myRegExp/g ); // false | ||
| _.isNaN( parseInt('generate NaN') ); // true | ||
| x= _.notNull(''); // true | ||
| x= _.notUndefined( undefined ); // false | ||
| x= _.isDefined( null ); // true | ||
| _.notNull(''); // true | ||
| _.notUndefined( undefined ); // false | ||
| _.isDefined( null ); // true | ||
| // check multiple values in one call: | ||
| x= _.allString( '', " ", 'with text' ); // true | ||
| x= _.allString( '', ' ', 'with text', 123 ); // false | ||
| x= _.allStringOrNumber( '', ' ', 'with text', 123 ); // true | ||
| x= _.allObject( { key: 'nice' }, [], /regexp/ig ); // false | ||
| x= _.allArray( [1,2,3], [{}], new RegExp('stop') ); // false | ||
| x= _.allArray( [1,2,3], [{}], [false, true] ); // true | ||
| _.allString( '', " ", 'with text' ); // true | ||
| _.allString( '', ' ', 'with text', 123 ); // false | ||
| _.allStringOrNumber( '', ' ', 'with text', 123 ); // true | ||
| _.allObject( { key: 'nice' }, [], /regexp/ig ); // false | ||
| _.allArray( [1,2,3], [{}], new RegExp('stop') ); // false | ||
| _.allArray( [1,2,3], [{}], [false, true] ); // true | ||
| x= _.hasString( 123, { value: 'nice' }, ['?'] ); // false | ||
| x= _.hasStringOrNumber( [1,2], /reg/, 'true' ) // true | ||
| x= _.hasFunction( 123, { value: 'nice' }, function(){} ); // true | ||
| x= _.hasUndefined( 'render false!', 123, null ); // false | ||
| x= _.hasUndefined( 'render true!', 123, undefined ); // true | ||
| _.hasString( 123, { value: 'nice' }, ['?'] ); // false | ||
| _.hasStringOrNumber( [1,2], /reg/, 'true' ) // true | ||
| _.hasFunction( 123, { value: 'nice' }, function(){} ); // true | ||
| _.hasUndefined( 'render false!', 123, null ); // false | ||
| _.hasUndefined( 'render true!', 123, undefined ); // true | ||
| // check for a types.js type definition, returns lowercase string: | ||
| x= _.typeof( [1,2,3] ); // 'array' | ||
| x= _.typeof( null ); // 'null' | ||
| x= _.typeof( parseInt('generate NaN') ); // 'nan' | ||
| x= _.typeof( new Date() ); // 'date' | ||
| _.typeof( [1,2,3] ); // 'array' | ||
| _.typeof( null ); // 'null' | ||
| _.typeof( parseInt('generate NaN') ); // 'nan' | ||
| _.typeof( new Date() ); // 'date' | ||
| // etc.. | ||
@@ -138,3 +155,3 @@ ``` | ||
| _.parseIntBase= 0xf; | ||
| // parse from hexadecimal | ||
| // parse from hexadecimal, _.forceNumber will parse character 'a' | ||
| var nr= _.forceNumber( 'a linefeed' ); | ||
@@ -164,2 +181,3 @@ console.log( nr ); | ||
| console.log( assert ); | ||
| // false | ||
| var assert= _.forceBoolean( NaN != NaN ); | ||
@@ -192,3 +210,3 @@ console.log( assert ); | ||
| Example: make a numberFilter for arguments with the new forceNumber: | ||
| Example: make a numberFilter for arguments with forceNumber: | ||
| ```javascript | ||
@@ -230,2 +248,3 @@ function numberFilter(){ | ||
| var func= _.forceFunction( showAuthor ); | ||
| // still the same function? | ||
| console.log( func === showAuthor ); | ||
@@ -333,6 +352,6 @@ // true | ||
| 'nan' | Any value that is NaN | ||
| 'object' | An object literal {} or any instance of Object that is not a native JS object (except for Object) | ||
| 'array' | An array literal [] or any instance of Array | ||
| 'object' | An object literal {}, or any instance of Object that is not a native JS object (except for Object) | ||
| 'array' | An array literal [], or any instance of Array | ||
| 'function' | Any function or instance of Function | ||
| 'regexp' | /Any/ regular expression literal, or any instance of RegExp | ||
| 'regexp' | Any regular expression literal, or any instance of RegExp | ||
| 'date' | Any instance of Date | ||
@@ -339,0 +358,0 @@ |
Sorry, the diff of this file is not supported yet
New alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Fixed alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
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
Improved metrics
- Total package byte prevSize
- increased by0.31%
152115
- Number of lines in readme file
- increased by4.67%
426
- Number of medium supply chain risk alerts
- decreased by-100%
0
No dependency changes