protojs

proto

ES5-compatible object manipulation library for node and modern browsers

Documentation: http://milojs.github.io/proto/

Why not use underscore or lo-dash

1. They do NOT use properties that are non-enumerable when they extend/clone/etc.
2. They DO use enumerable properties from prototypes when they extend/clone/etc.
3. When they clone, they create instances of Object rather than of the same class as cloned object.
4. They implement many methods that are already implemented natively.
5. They don't implement methods for inheritance and extention of prototypes.
6. They create confusion when you read code as you can't clearly differentiate between arrays and objects (maps), e.g. when each function is used.
7. Underscore has clumbersome chaining syntax, chaining in proto is more succinct.

Install

npm install mol-proto --save

To use and develop:

git clone [e-mail]:milojs/proto.git
cd proto
npm link
cd ../<your project>
npm link mol-proto

Use

Node/browserify:

var _ = require('mol-proto');

Browser:

All functions are exported as properties of a global _ object when used with milo, there is no separate proto bundle yet (will be added shortly).

Functions

• Prototype functions

  • extendProto
  • createSubclass
  • makeSubclass
  • newApply

• Object functions

  • extend
  • clone
  • defineProperty
  • defineProperties
  • deepExtend
  • deepClone
  • keys
  • allKeys
  • values
  • keyOf
  • allKeysOf
  • eachKey
  • mapKeys
  • reduceKeys
  • filterKeys
  • someKey
  • everyKey
  • findValue
  • findKey
  • pickKeys
  • omitKeys
  • isEqual

• Array functions

  • find
  • findIndex
  • appendArray
  • prependArray
  • spliceItem
  • toArray
  • object
  • mapToObject
  • unique
  • deepForEach
  • Functions that Array implements natively are also added - they can be used with array-like objects and for chaining (native functions are always called).

• Function functions

  • makeFunction
  • partial
  • partialRight
  • memoize
  • delay
  • defer
  • delayed
  • deferred
  • deferTicks
  • delayMethod
  • deferMethod
  • debounce
  • throttle
  • once
  • waitFor

• String functions

  • firstUpperCase
  • firstLowerCase
  • toRegExp
  • toFunction
  • toDate
  • toQueryString
  • fromQueryString
  • jsonParse
  • hashCode
  • unPrefix
  • format

• Number functions

  • isNumeric

• Utility functions

  • times
  • repeat
  • tap
  • result
  • identity
  • property
  • compareProperty
  • noop