uncouple

Uncouple

Uncouple constructors and classes methods into functions.

Installation

This library is published in the NPM registry and can be installed using any compatible package manager.

npm install uncouple --save

# For Yarn, use the command below.
yarn add uncouple

Installation from CDN

This module has an UMD bundle available through JSDelivr and Unpkg CDNs.

<!-- For UNPKG use the code below. -->
<script src="https://unpkg.com/uncouple"></script>

<!-- For JSDelivr use the code below. -->
<script src="https://cdn.jsdelivr.net/npm/uncouple"></script>

<script>
  // UMD module is exposed through the "uncouple" global function.
  console.log(uncouple);

  var O = uncouple(Object);
  var isFetchDefined = O.hasOwnProperty(window, 'fetch');
</script>

Usage

Module default exports uncouple function.

uncouple receives a constructor or a class as argument and returns an object with its uncoupled methods.

import uncouple from 'uncouple';

const O = uncouple(Object);
// => {
//   hasOwnProperty: ƒ ()
//   isPrototypeOf: ƒ ()
//   propertyIsEnumerable: ƒ ()
//   toLocaleString: ƒ ()
//   toString: ƒ ()
//   valueOf: ƒ ()
// }

const hasFetch = O.hasOwnProperty(window, 'fetch');
// => true

All uncoupled methods receives an instance as first argument followed by method arguments.

const { trim, substr } = uncouple(String);

trim('   Okay    ');
//=> 'Okay'

substr('ABCDEF', -3);
//=> 'CDF'

It also works for Function constructors and classes.

function User(name) {
  this.name = name;
}

User.prototype.getName = function() {
  console.log(this.name);
};

const { getName } = uncouple(User);

getName(new User('João'));
//=> 'João'

class Car {
  speed = 0;

  acelerate(speed) {
    this.speed += speed;
  }
}

const { acelerate } = uncouple(Car);

const uno = new Car();

acelerate(uno, 120);
acelerate(uno, 60);

uno.speed;
//=> 180

Use cases

You can reuse methods with duck types, like Array.prototype.filter in a NodeList.

const { filter } = uncouple(Array);

const anchors = document.getElementsByTagName('a');
//=> NodeListOf<HTMLAnchorElement>

const isLink = anchor => /^https?:\/\//.test(anchor.href);

const links = filter(anchors, isLink);
//=> Array<HTMLAnchorElement>

Compositions and smart pipelines became pretty and readable with uncoupled methods.

const {
  trim,
  replace,
  normalize,
  toLocaleLowerCase
} = uncouple(String);

" Olá, como vai  vocÊ?"
|> normalize(#, 'NFKD')
|> replace(#, /[\u0080-\uF8FF]/g, '')
|> trim
|> replace(#, /\s+/g, ' ')
|> toLocaleLowerCase
//=> 'ola, como vai voce?'

const normalize = compose(
  toLocaleLowerCase,
  (value) => replace(value, /\s+/g, ' '),
  trim,
  (value) => replace(value, /[\u0080-\uF8FF]/g, '')
  (value) => normalize(value, 'NFKD'),
);

normalize(' Meu nome é Vitor   , meus bons')
//=> 'meu nome e vitor, meus bons'

With uncouple you can call Object methods with Object.create(null), which returns an empty object without prototype.

const user = Object.create(null);

user.name = '@VitorLuizC';

user.hasOwnProperty('name');
//=> throws TypeError: user.hasOwnProperty is not a function

const { hasOwnProperty: has } = uncouple(Object);

has(user, 'name');
//=> true

License

Released under MIT License.