0.3.1 • Published 6 years ago

internal-data v0.3.1

Weekly downloads
3
License
MIT
Repository
github
Last release
6 years ago

internal-data

Description

Private properties implementation using WeakMap as described on MDN - Private Properties.

Synopsis

TypeScript with WeakMap

Actually this library does nothing more than exporting an interface for TypeScript. This interface just extends WeakMap by overriding its get() method to return I instead of I | undefined, because data should already be set in constructor.

There is no need to do type assertion in every method to get internal data.

import { InternalDataInterface } from 'internal-data';

const internalData: InternalDataInterface<MyClass, Internal> = new WeakMap();

type Internal = { password: string };

class MyClass {
  name: string;

  constructor(name: string, password: string) {
    const internal: Internal = { password };
    internalData.set(this, internal);
    this.name = name;
  }

  checkPassword(password: string): boolean {
    const internal = internalData.get(this);
    return internal.password === password;
  }
}

const object = new MyClass('George', '1234');

const name     = object.name;                  // -> George
const password = object.password;              // -> TYPESCRIPT ERROR
const isValid  = object.checkPassword('1234'); // -> true

JavaScript with Function Interface

import InternalData from 'internal-data';

const getInternal = InternalData.getFunction();

class MyClass {
  constructor(name, password) {
    const internal = getInternal(this);
    this.name = name;
    internal.password = password;
  }

  checkPassword(password) {
    const internal = getInternal(this);
    return internal.password === password;
  }
}

const object = new MyClass('George', '1234');

const name     = object.name;                  // -> George
const password = object.password;              // -> Undefined
const isValid  = object.checkPassword('1234'); // -> true

JavaScript with Object Interface

import InternalData from 'internal-data';

const internalData = new InternalData(); // eslint-disable-line no-use-before-define

class MyClass {
  constructor(name, password) {
    const internal = internalData.get(this);
    this.name = name;
    internal.password = password;
  }

  checkPassword(password) {
    const internal = internalData.get(this);
    return internal.password === password;
  }
}

const object = new MyClass('George', '1234');

const name     = object.name;                  // -> George
const password = object.password;              // -> undefined
const isValid  = object.checkPassword('1234'); // -> true

Details

To access private properties of the object use getInternal(this) method. It returns an object to store private attributes of given object (In this case it is It is this)

API

InternalData

Kind: global class
Hideconstructor:

new InternalData()

internalData.get(object) ⇒ Object

Kind: instance method of InternalData
Returns: Object - Private data of given object.

ParamTypeDescription
objectObjectObject to get private data for.

InternalData.getFunction() ⇒ GetInternalFn

Kind: static method of InternalData
Returns: GetInternalFn -

0.3.1

6 years ago

0.3.0

6 years ago

0.2.0

6 years ago

0.1.2

6 years ago

0.1.1

6 years ago

0.1.0

6 years ago

0.0.8

7 years ago

0.0.7

7 years ago

0.0.5

7 years ago

0.0.4

7 years ago

0.0.3

7 years ago

0.0.2

7 years ago

0.0.1

7 years ago