@reduct/registry
v1.0.1
Published
Defines a set of objects and exposes methods to operate on that
Downloads
1
Readme
@reduct/registry
Defines a set of objects and exposes methods to operate on that
Install
With npm, use the familiar syntax e.g.:
npm install @reduct/registry --save
once the registry package is installed, just require it in your application file.
const registry = require('@reduct/registry');
This package also supports AMD/RequireJS. Aren't using AMD or CommonJS? Just grab a release, include the Dist/Registry.min.js
and access the registry via the following global:
const registry = window.reduct.registry;
API
registry.register();
Type: Function
Argument item
: *
Argument alias
: String
Returns: Registry
The registry itself (for enabling method chaining)
Registers a single item in the registry. If no alias is provided, it tries to guess the name of the item, which basically means, that if you're passing a function, it'll use the function name as the alias. Since es2015 classes are just sugar for functions acting as constructors, this applies for classes too.
registry.registerAll();
Type: Function
Argument itemMap
: Object
Returns: Registry
The registry itself (for enabling method chaining)
Registers multiple items at once. The object keys of itemMap
will act as aliases and the values as items.
registry.get();
Type: Function
Argument alias
: String
Returns: *
Retrieves the item with the given alias from the registry. An error will be thrown, if the item doesn't exist.
registry.getAll();
Type: Function
Argument aliases
: Array
Returns: Array
Retrieves multiple items with the given aliases from the registry. An error will be thrown, if any of these items doesn't exist.
registry.await();
Type: Function
Argument alias
: String
Returns: Promise
Returns a Promise that will resolve as soon as an item gets registered under the given alias.
registry.awaitAll();
Type: Function
Argument aliases
: Array
Returns: Promise
Returns a Promise that will resolve as soon as all items identified by an array of aliases are getting registered.
registry.expect();
Type: Function
Argument alias
: String
Argument timeout
: Number
Returns: Promise
Returns a Promise that will resolve as soon as an item gets registered under the given alias. The Promise will be rejected after timeout
milliseconds, if until then no item got registered.
registry.expectAll();
Type: Function
Argument aliases
: Array
Argument timeout
: Number
Returns: Promise
Returns a Promise that will resolve as soon as all items identified by an array of aliases are getting registered. The Promise will be rejected after timeout
milliseconds, if until then no item got registered.
registry.namespace();
Type: Function
Argument: namespace
: String
Returns: Object
Returns a namespaced version of the registry API. All items will be registered and retrieved with namespace
automatically prefixed to their identifiers. A trailing slash is automatically added to namespace
.
registry.use();
Type: Function
Argument: namespace
: String
Argument: callback
: Function
Returns: Object
Calls callback
with a namespaced version of the registry API as its first argument. All items will be registered and retrieved with namespace
automatically prefixed to their identifiers. A trailing slash is automatically added to namespace
.
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style.
License
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.