Push Underscore.js and Underscore.string functions to native JavaScript Objects. Yep! You have Sugar JS code styling but with Underscore
npm install underscore.transparent> No one wants to dream about _, most people prefer $.
> -- (c) 2013 André Deudant
If you're too lazy to read, write and dream about _ character.
Underscore.transparent is for you!
Old and boring _. syntax:
``javascript
_.each(['zero', 'one', 'two'], function(element, index) { console.log(index+':'+element); })
=> "0:zero"
"1:one"
"2:two"
_.chain([2, 1, 3, [5, 8, 3, 9], null, false]).flatten().compact().uniq().shuffle().sort().value();
=> [1, 2, 3, 5, 8, 9]
_(" epeli ").trim().capitalize()
=> "Epeli"
`
Becomes syntactic sugar:
`javascript
['zero', 'one', 'two'].each(function(element, index) { console.log(index+':'+element); })
=> "0:zero"
"1:one"
"2:two"
[2, 1, 3, [5, 8, 3, 9], null, false].flatten().compact().uniq().shuffle().sort()
=> [1, 2, 3, 5, 8, 9]
" epeli ".trim().capitalize()
=> "Epeli"
`
> [Underscore.js][u] is a utility-belt library for JavaScript that provides a lot of the functional programming support that you would expect in Prototype.js (or Ruby), but without extending any of the built-in JavaScript objects.
Underscore.transparent.js extends the built-in JavaScript objects with Underscore [_and [Underscore.string.js][u.s]_].
So you can use Object-Oriented style and chaining with all Underscore and Underscore.string functions, without using the _ character (in the same way as [Sugar][s] library).
But modifying native objects... isn't it evil?
* Quick answer: No!
* For a longer answer read this excellent [post][s.n].
[u]: http://underscorejs.org/
[u.s]: http://epeli.github.io/underscore.string/
[s]: http://sugarjs.com/
[s.n]: http://sugarjs.com/native
[n]: http://nodejs.org/
[npm]: https://npmjs.org/
Development version Uncompressed with Comments 14kb*
Production version Minified and Gzipped 1.9kb*
`html
`
bower install underscore.transparent
Or add underscore.transparent to your apps component.json.
` json`
"dependencies": {
"underscore.transparent": "latest"
}
[npm][npm] package
npm install underscore.transparent
Integrate with Underscore.js:
`javascript`
var _ = require('underscore');
//Alias Underscore conflict functions
_.mixin({
encode: _.escape,
decode: _.unescape,
isNaNumber: _.isNaN
});
Optional Underscore.string integration:
`javascript`
// Import Underscore.string to separate object, because there are conflict functions (include, reverse, contains)
_.str = require('underscore.string');
// Mix in non-conflict functions and aliasing conflict functions to Underscore namespace, more info at https://github.com/epeli/underscore.string#readme
_.mixin(_(_.str.exports()).extend({
includeString: _.str.include,
containsString: _.str.contains,
reverseString: _.str.reverse
}));
Last but not least, init Underscore.transparent :
`javascript`
_.transparent();
OMG _ is now transparent !
Any suggestions or bug reports are welcome. Just email me or more preferably open an issue.
#### Problems
Underscore conflict functions with window global object:
* window.escape: Underscore.js doesn't have the same behaviour. You must use window.encode alias function or Object.escape.window.unescape
* : Underscore.js doesn't have the same behaviour. You must use window.decode alias function or Object.unescape.window.isNaN
* : Underscore.js doesn't have the same behaviour _.isNaN function. isNaN(undefined) => true _.isNaN(undefined) => false. You must use window.isNaNumber alias function or Object.isNaN.
Legacy browsers like IE 8 and below don't support correctly defineProperty function, read the last paragraph of [this post][s.n].Object.prototype
To prevent bugs in these browsers, Underscore.transparent don't add properties to by default.Hash
You need to cast your objets to class via Object.toHash or window.toHash or toHash function:
*[IE]: Internet Explorer
`javascript`
var obj1 = toHash({1:'one', 2:'two', 3:'three'});
obj1.each(function(element, index) { console.log(index+':'+element); })
=> "1:one"
"2:two"
"3:three"
Of course you can alias the toHash function to a shorter name:
`javascript
var h = Object.toHash; // alias of toHash function
var obj1 = h({1:'one', 2:'two', 3:'three'});
obj1.each(function(element, index) { console.log(index+':'+element); })
=> "1:one"
"2:two"
"3:three"
`
Inline Integer and Function need parenthesis:
`javascript
(2).times(function(i) { console.log(i + ' times'); });
(function() { console.log("delayed during 1 sec."); }).delay(1000);
`
But generally, in real application code, you do :
`javascript
var n = 2;
//...{some code}...
n.times(function(i) { console.log(i + ' times'); });
var myDelayedFunction = function() { console.log("delayed during 1 sec."); };
//...{some code}...
myDelayedFunction.delay(1000);
`
Due to JavaScript limitations, we lose some things:
* Functions aren't available for undefined and null properties, null.values() trigger: "TypeError: null has no properties 'null.values()'"
You need to use .var s1 = "foobar"; s1.isString()
* Calls like aren't available to prevent unexpected bugs when the s1 variable is null, undefined or with isObject function.Object.isString("foobar")
Instead, you should do or window.isString("foobar") (or isString("foobar") if you don't have any local variable named isString);Array.prototype.[push|pop|shift|unshift]
* Native chaining don't work correctly for JavaScripts functions who don't return the current object (E.g. ). [2,1,3].shuffle().pop().sort(); => [] trigger "TypeError: (intermediate value).shuffle(...).pop(...).sort is not a function".chain
In this case, you need to use and value functions. [2,1,3].chain().shuffle().pop().sort().value(); => [1,2]
If you're application doesn't need to support IE 8 and below you can extend all Hash functions into Object.
`javascript`
_.transparent({extendAll: true});
So you can do:
`javascript`
var obj1 = {1:'one', 2:'two', 3:'three'};
obj1.each(function(element, index) { console.log(index+':'+element); })
=> "1:one"
"2:two"
"3:three"
Otherwise Object functions from examples will be available through Object.myFunction:
`javascript``
var obj1 = {1:'one', 2:'two', 3:'three'};
Object.each(obj1, function(element, index) { console.log(index+':'+element); })
=> "1:one"
"2:two"
"3:three"
* First public release !
* Fork & pull request. Don't forget about tests.
* If you planning add some feature please create issue before.
Otherwise changes will be rejected.
The MIT License
Copyright (c) 2013 Nowhere Man
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.