Galao
This Node.js package provides a ActiveSupport-flavoured Javascript core object extensions. A detailed list of features can be found below.
This project is work in progress and will grow in size continually when I feel the need to add certain functions. See "Contributing" if you miss any functionality, I'm always happy to merge your enhancements in!
Usage
Node.JS
Simple require galao in your application and it will be accessible from anywhere in your app:
require 'galao'
Browser
There is a browser version in the lib directory. Download the file from Github or require locally from your node_modules directory.
Caveats: The browser treats numbers differently than Node.JS. A number directly followed by a dot is interpreted as a decimal number without a decimal value and thus results in an exception. To avoid this exception and still use the number functions, bracket the number:
5minutes=> Exception 5minutes=> All good!
Methods
Array::compact()
Returns a new array without any null or undefined elements.
coffee> 123nullcompact 123 coffee> 123undefinedcompact 123
Array::find()
Returns the first element of the array matching the callback condition.
coffee> foo:1foo:2foo:3find elemfoo==2 foo: 2 coffee> foo:1foo:2foo:3find elemfoo==20null
Number::seconds()
Interpret given number as seconds and return value in milliseconds.
coffee> 10seconds10000
This function (and its related functions minutes(), hours(), etc.) becomes very useful for specifying timeouts and intervals:
setTimeout -> consolelog 'Timeout ended'5seconds
There is also a singular version of this method simply for syntactical sugar.
Instead of writing 1.minutes()
, which is syntactically incorrect, one can also
write 1.minute()
.
Number::minutes()
Interpret given number as minutes and return value in milliseconds.
coffee> 2minutes120000
Number::hours()
Interpret given number as hours and return value in milliseconds.
coffee> 2hours7200000
Number::days()
Interpret given number as days and return value in milliseconds.
coffee> 2days172800000
Number::even()
Checks whether the number is even or not.
coffee> 5evenfalsecoffee> 6eventrue
Number::odd()
Checks whether the number is odd or not.
coffee> 5oddtruecoffee> 6oddfalse
String::capitalize()
Capitalize first letter in string, remaining letters will stay untouched.
coffee> "test"capitalize'Test'coffee> "tesT"capitalize'TesT'
String::startsWith(prefix)
Returns true
if the string starts with the given prefix.
coffee> "foo"startsWith 'f'truecoffee> "foo"startsWith 'b'false
String::endsWith(prefix)
Returns true
if the string ends with the given prefix.
coffee> "foo"endsWith 'o'truecoffee> "foo"endsWith 'f'false
String::repeat(n)
Repeats the string n
times.
coffee> "foo"repeat 2'foofoo'
Contributing
Feel free to send me pull requests on Github, contributions are always welcome!