# predefine

> Predefine your Object.defineProperties to create a more human readable API.

Latest version **0.1.3** (published 2022-01-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install predefine
pnpm add predefine
yarn add predefine
bun add predefine
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2022-01-30 |
| First published | 2014-01-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 19.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Arnout Kazemier |
| Maintainers | swaagie, jcrugzz, v1, indexzero, 3rdeden |
| Keywords | predefine, define, object, defineProperties, defineProperties, configurable, writable, get, set, getters, setters, inherit |

## Links

- npm: https://www.npmjs.com/package/predefine
- Repository: https://github.com/bigpipe/predefine
- Homepage: https://github.com/bigpipe/predefine#readme
- Issues: https://github.com/bigpipe/predefine/issues
- npm.io page: https://npm.io/package/predefine

## Dependencies (1)

- [extendible](https://npm.io/package/extendible.md) 0.1.x

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 0.1.3 (latest) — 2022-01-30
- 0.2.0 — 2022-01-30
- 0.1.2 — 2014-10-28
- 0.1.1 — 2014-03-25
- 0.1.0 — 2014-03-25
- 0.0.6 — 2014-03-25
- 0.0.5 — 2014-03-25
- 0.0.3 — 2014-03-18
- 0.0.2 — 2014-02-14
- 0.0.1 — 2014-01-06
- 0.0.0 — 2014-01-04

## README

# predefine

[![Node.js CI](https://github.com/bigpipe/predefine/actions/workflows/ci.yml/badge.svg)](https://github.com/bigpipe/predefine/actions/workflows/ci.yml)

When creating objects or prototypes using `Object.defineProperties` or
`Object.defineProperty` it make your code look really verbose by all the
property descriptions that it needs. Most of the time, they are the same. They
either make your properties writable, readable or prevents them from being
enumerable. So basically:

Predefine makes `Object.defineProperties` your human readable and manageable.

## Installation

```
npm install --save predefine
```

## Getting started

Let's start with a basic example of predefine usage:

```js
var predefine = require('predefine');

function Base() {
  var readable = predefine(this, { configurable: false, enumerable: false })
    , writable = predefine(this, predefine.WRITABLE);

  readable('prop', 'value');
  writable('data', []);
}

Base.writable = predefine(Base.prototype, predefine.WRITABLE);

Base.writable('foo', 'bar');
```

As you can see from the snippet above, it's really easy to see which properties
are made readable and which one's are writable.

### Predefine.extend

This allows you to add `Backbone` inspired `.extend` functionality to your
constructors. This makes inheriting a lot easier and readable. See the
`extendible` module in npm for information.

```js
function Foo() {}
Foo.extend = predefine.extend;

var Bar = Foo.extend({
  method: function () {}
});
```

### Predefine.descriptor

Test if a given object is a valid `Object` description to it can be used with
`Object.defineProperty`, `Object.defineProperties` and `Object.create`.

```js
predefine.descriptor({ foo: 'bar' });                       // false
predefine.descriptor({ value: 'bar' });                     // true
predefine.descriptor({ value: 'bar', enumerable: false });  // true
predefine.descriptor({ value: 'bar', foo: 'bar' });         // false
```

### Predefine.create

This is a simple helper function to create descriptions that can be used within
`Object.create` and `Object.defineProperties`.

```js
var data = Object.create(null, predefine.create('foo', {
  value: 'bar'
}));

var data = Object.create(null, predefine.create('foo', {
  value: 'bar'
}, predefine.READABLE));

var data = Object.create(null, predefine.create('foo', 'bar', predefine.READABLE));
```

### Predefine.remove

Removes all enumerable properties from a given object, with the ability to keep
white listed properties.

```js
var data = { foo: 'bar', bar: 'foo' };

predefine.remove(data);           // The data variable is now an empty object.
predefine.remove(data, ['foo']);  // The foo property is kept.

var readable(data);
readable('baz', 'baz');

predefine.remove(data);           // Only `baz` is left.
```

### Predefine.merge

Merge two objects in to one single object. This supports deep merging.

```js
var result = predefine.merge({ foo: 'bar' }, { bar: 'foo' });
```

### Predefine.mixin

Mixin two Objects, which also transfers properties that are set using
Object.defineProperty.

```js
var result = predefine.mixin({ foo: 'bar' }, { bar: 'foo' });
```

## License

MIT

---
_Source: https://npm.io/package/predefine · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._