prc b6c02717e6 Upload complete no-internet building environment. 1 year ago
..
.jshintrc b6c02717e6 Upload complete no-internet building environment. 1 year ago
.npmignore b6c02717e6 Upload complete no-internet building environment. 1 year ago
.travis.yml b6c02717e6 Upload complete no-internet building environment. 1 year ago
LICENSE.md b6c02717e6 Upload complete no-internet building environment. 1 year ago
README.md b6c02717e6 Upload complete no-internet building environment. 1 year ago
package.json b6c02717e6 Upload complete no-internet building environment. 1 year ago
prr.js b6c02717e6 Upload complete no-internet building environment. 1 year ago
test.js b6c02717e6 Upload complete no-internet building environment. 1 year ago

README.md

prr Build Status

An sensible alternative to Object.defineProperty(). Available in npm and Ender as prr.

Usage

Set the property 'foo' (obj.foo) to have the value 'bar' with default options ('enumerable', 'configurable' and 'writable' are all false):

prr(obj, 'foo', 'bar')

Adjust the default options:

prr(obj, 'foo', 'bar', { enumerable: true, writable: true })

Do the same operation for multiple properties:

prr(obj, { one: 'one', two: 'two' })
// or with options:
prr(obj, { one: 'one', two: 'two' }, { enumerable: true, writable: true })

Simplify!

But obviously, having to write out the full options object makes it nearly as bad as the original Object.defineProperty() so we can simplify.

As an alternative method we can use an options string where each character represents a option: 'e'=='enumerable', 'c'=='configurable' and 'w'=='writable':

prr(obj, 'foo', 'bar', 'ew') // enumerable and writable but not configurable
// muliple properties:
prr(obj, { one: 'one', two: 'two' }, 'ewc') // configurable too

Where can I use it?

Anywhere! For pre-ES5 environments prr will simply fall-back to an object[property] = value so you can get close to what you want.

prr is Ender-compatible so you can include it in your Ender build and $.prr(...) or var prr = require('prr'); prr(...).

Licence

prr is Copyright (c) 2013 Rod Vagg @rvagg and licensed under the MIT licence. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE.md file for more details.