Browse Source

add docs

Conduitry 2 years ago
4 changed files with 43 additions and 3 deletions
  1. +3
  2. +1
  3. +38
  4. +1

+ 3
- 0 View File

@ -0,0 +1,3 @@
# v0.1.0
- Initial release

+ 1
- 1

@ -1,6 +1,6 @@
MIT License
Copyright (c) 2018
Copyright (c) 2018 Conduitry
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

+ 38
- 2 View File

@ -1,2 +1,38 @@
# memor
More memoization.
# Memor: More memoization.
[![npm version](](
Memoization, but good. Works with functions of an arbitrary and/or variable number of arguments. For arrays, regexes, dates, buffers, and POJOs, caching is done according to the *value* (and not the *identity*) of the objects. Order of keys in POJOs does not matter. For other non-primitive values, memoization still works, but the caching is done by object identity.
## Requirements
- [Node.js]( 4+
## Usage
import { memoize } from 'memor'
const memoizedFunction = memoize(originalFunction)
memoizedFunction(/* ... */)
`originalFunction` can accept any number or a variable number of arguments. Re-memoizing the same function (i.e., calling `memoize(originalFunction)` elsewhere later) will share the cached values.
Keying of primitives, arrays, regexes, dates, and buffers works according to their values. Any additional custom properties added to the objects will *not* be considered as part of the key. (More specifically, arrays are keyed according to their length and their elements, regexes and buffers are keyed according to their `.toString()`s, and dates are keyed according to their `.getTime()`s.)
Keying of POJOs works according to their (own) enumerable and non-enumerable property names and values, without regard to order. Symbolic keys and their values are not considered, due to the lack of a canonical ordering on symbols.
Other objects (those without a prototype of `Object.prototype`) are simply keyed according to their identity (i.e., `===`).
## Misc
- [changelog](
- [homepage](
## License
Copyright (c) 2018 Conduitry

+ 1
- 0
package.json View File

@ -2,6 +2,7 @@
"name": "memor",
"version": "0.1.0",
"description": "More memoization",
"keywords": ["memoize", "memoization"],
"main": "./dist/index.cjs.js",
"module": "./dist/",
"files": ["dist"],