# hypergiant

> Hypergiant is a small and simple signal-like event emitter for Node.js and the browser.

Latest version **3.1.0** (published 2020-09-06) · MIT license · 0 weekly downloads

## Install

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

## Health

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

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.1.0 |
| Published | 2020-09-06 |
| First published | 2018-09-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 77.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Robert Corponoi |
| Maintainers | robertcorponoi |
| Keywords | signal, signals, event, events, emit, emitter |

## Links

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

## Dependencies (1)

- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.11.2

## Alternatives

- [async-exit-hook](https://npm.io/package/async-exit-hook.md) — 3.7M weekly downloads
- [evnty](https://npm.io/package/evnty.md) — 7.2K weekly downloads
- [eleventy-plugin-asciidoc](https://npm.io/package/eleventy-plugin-asciidoc.md) — 3.5K weekly downloads
- [@jswork/next-get2get](https://npm.io/package/@jswork/next-get2get.md) — 945 weekly downloads
- [@dashersw/axon](https://npm.io/package/@dashersw/axon.md) — 934 weekly downloads

## Recent versions

- 3.1.0 (latest) — 2020-09-06
- 3.0.6 — 2020-04-19
- 3.0.5 — 2020-02-24
- 3.0.4 — 2020-01-28
- 3.0.3 — 2020-01-28
- 3.0.1 — 2019-11-19
- 3.0.0 — 2019-11-19
- 2.5.3 — 2019-11-19
- 2.5.2 — 2019-10-27
- 2.5.0 — 2019-09-23
- 2.4.2 — 2019-09-23
- 2.4.0 — 2019-06-09
- 2.3.1 — 2019-06-09
- 2.3.0 — 2019-04-20
- 2.2.0 — 2019-03-12
- … 5 more at https://npm.io/package/hypergiant/versions

## README

<p align="center">
  <img width="250" height="250" src="https://github.com/robertcorponoi/graphics/blob/master/hypergiant/hypergiant-logo.png?raw=true">
</p>

<h1 align="center">Hypergiant</h1>

<p align="center">Hypergiant is a small and simple signal-like event system for Node.js and the browser.<p>

<div align="center">

[![NPM version](https://img.shields.io/npm/v/hypergiant.svg?style=flat)](https://www.npmjs.com/package/hypergiant)
[![Known Vulnerabilities](https://snyk.io/test/github/robertcorponoi/hypergiant/badge.svg)](https://snyk.io/test/github/robertcorponoi/hypergiant)
![npm](https://img.shields.io/npm/dt/hypergiant)
[![NPM downloads](https://img.shields.io/npm/dm/hypergiant.svg?style=flat)](https://www.npmjs.com/package/hypergiant)
<a href="https://badge.fury.io/js/hypergiant"><img src="https://img.shields.io/github/issues/robertcorponoi/hypergiant.svg" alt="issues" height="18"></a>
<a href="https://badge.fury.io/js/hypergiant"><img src="https://img.shields.io/github/license/robertcorponoi/hypergiant.svg" alt="license" height="18"></a>
[![Gitter](https://badges.gitter.im/gitterHQ/gitter.svg)](https://gitter.im/robertcorponoi)

</div>

**Table of Contents**

- [Installation](#installation)
- [Basic Usage](#basic-usage)
- [Properties](#properties)
  - [tasks](#tasks)
  - [numTasks](#numTasks)
- [API](#api)
  - [add](#add)
  - [dispatch](#dispatch)
  - [remove](#remove)
  - [removeAll](#removeAll)
  - [noop](#noop)

## **Installation**

To download Hypergiant through NPM, simply use:

```
$ npm install --save hypergiant
```

and use it in your Node environment as so:

```js
const Hypergiant = require('hypergiant');
```

or import it browser side as an ES6 module:

```js
import Hypergiant from './node_modules/hypergiant/hypergiant.js';
```

## **Basic Usage**

Hypergiant is a signal-like event emitter for Node.JS and the browser.

Hypergiant is very minimal and fast but also very powerful. It is comparable to events in native JavaScript except
that Hypergiant events are emitted after the action has occurred and it doesn't rely on the events being referenced
by string which can lead to misspellings.

Creating a new signal is as simple as:

```js
const appStarted = new Hypergiant();
```

Any variable or property can be made into a signal.

Now a signal isn't very useful if there isn't a response to the event when it happens. To add a task that will run
whenever the event is dispatched, use the `add` method on the created signal:

```js
appStarted.add(hello);

function hello(name) {
  console.log(`Hello ${name}!`);
}
```

You can add as many methods as you would like to respond to a signal.

Lastly, it's time to dispatch the signal with the `dispatch` method:

```js
appStarted.dispatch('Bob');

// The console will display the following message:
// => Hello Bob!
```

Any parameters passed with `dispatch` will also be passed to the tesk functions attached to it.

## **Properties**

### **tasks**

Returns all of the tasks that have been created for this signal:

**exmple:**

```js
const sol = new Hypergiant();

// Tasks...
sol.add(blah);
// More tasks...

const tasks = sol.tasks;
```

### **numTasks**

Returns the number of tasks currently assigned to this signal.

**example:**

```js
const sol = new Hypergiant();

sol.add(blah);
sol.add(blah);

const numTasks = sol.numTasks; // 2
```

## **API**

### **add**

Add takes in a function and an optional parameter named `once` that can be set to true if you would like this task to be called only once and then be deleted.

| param | type     | description                                                                                | default |
|-------|----------|--------------------------------------------------------------------------------------------|---------|
| fn    | Function | The function to be called when the signal is dispatched.                                   |         |
| once  | false    | Indicates whether this task should happen only once and then be automatically deleted.     | false   |

**example:**

```js
const sol = new Hypergiant();

// When sol is dispatched, the `sayHello` function will be called once and then deleted from the signal's task list.
sol.add(sayHello, true);

function sayHello(name1, name2) {
  console.log(`Hello ${name1} and ${name2}!`);
}
```

### **dispatch**

Dispatch sends out the signal and any attached tasks will be called.

This method can take any number of parameters which will act as data sent to the tasks.

| param   | type    | description                                              | default |
|---------|---------|----------------------------------------------------------|---------|
| ...data | any     | Any data that you want to pass to the tasks              |         |

**example:**

```js
const sol = new Hypergiant();

// When sol is dispatched, the `sayHello` function will be called once and then deleted from the signal's task list.
sol.add(sayHello, true);

function sayHello(name1, name2) {
  console.log(`Hello ${name1} and ${name2}!`);
}

// At some other point in your application...
// This will dispatch the Hypergiant event and any attached tasks will be called with 'Bob' and 'John' as parameter values.
sol.disaptch('Bob', 'John');

// In this case the `sayHello` function will log:
// => Hello Bob and John!
```

### **remove**

Deletes a task from the signal

| param | type     | description                                                                                | default |
|-------|----------|--------------------------------------------------------------------------------------------|---------|
| fn    | Function | The function to delete                                                                     |         |

**example:**

```js
const sol = new Hypergiant();

sol.add(hello);
sol.remove(hello);

function hello() {
  return 'Hello World!';
}
```

### **removeAll**

Deletes all tasks from the signal.

**example:**

```js
const sol = new Hypergiant();

sol.add(hello);
sol.removeAll();

function hello() {
  return 'Hello World!';
}
```

### **noop**

Makes a task a noop function

| param | type     | description                                                                                | default |
|-------|----------|--------------------------------------------------------------------------------------------|---------|
| fn    | Function | The function to make a noop function                                                       |         |

**example:**

```js
const sol = new Hypergiant();

sol.add(hello);
sol.noop(hello);

function hello() {
  return 'Hello World!';
}
```

## **Tests**

To run the tests available use:

```bash
$ npm run test
```

## **License**

MIT

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