What is unherit?
The `unherit` npm package is designed to create a factory for customizable classes. It allows you to inherit from a class and then further customize the subclass. This can be particularly useful in scenarios where you want to extend or modify the behavior of existing classes without directly modifying their source code. It's commonly used in the context of creating customizable components or plugins.
What are unherit's main functionalities?
Creating a customizable subclass
This feature allows you to create a subclass from a superclass and then customize that subclass. It's useful for extending existing classes in a modular and reusable way.
const unherit = require('unherit');
const Super = require('./some-super-class');
const Custom = unherit(Super);
// Now, `Custom` can be further extended or modified without affecting `Super`.
Other packages similar to unherit
class-extend
Similar to `unherit`, `class-extend` allows you to extend classes in Node.js. It provides a simple way to inherit from existing classes and add or override methods. The main difference is in the API and the way you use it to extend classes.
extendable
This package offers functionality to extend classes as well, but with a focus on creating extendable constructors. It's similar to `unherit` in its goal to facilitate class extension and customization, but differs in its approach and specific use cases.
unherit
![Size](https://img.shields.io/bundlephobia/minzip/unherit.svg)
Create a subclass that can be modified without affecting the super class.
Contents
What is this?
This is a tiny package lets you create a subclass, that can be modified,
without affecting the super class.
When should I use this?
Not often!
You might have some weird cases though.
Install
This package is ESM only.
In Node.js (version 14.14+, 16.0+), install with npm:
npm install unherit
In Deno with esm.sh
:
import {unherit} from 'https://esm.sh/unherit@3'
In browsers with esm.sh
:
<script type="module">
import {unherit} from 'https://esm.sh/unherit@3?bundle'
</script>
Use
import {EventEmitter} from 'node:events'
import {unherit} from 'unherit'
const Emitter = unherit(EventEmitter)
Emitter.prototype.defaultMaxListeners = 0
new Emitter().defaultMaxListeners === 0
new EventEmitter().defaultMaxListeners === undefined
new Emitter() instanceof EventEmitter
API
This package exports the identifier unherit
.
There is no default export.
unherit(Super)
Subclass Super
.
Types
This package is fully typed with TypeScript.
It exports no additional types.
Compatibility
This package is at least compatible with all maintained versions of Node.js.
As of now, that is Node.js 14.14+ and 16.0+.
It also works in Deno and modern browsers.
Contribute
Yes please!
See How to Contribute to Open Source.
Security
This package is safe.
License
MIT © Titus Wormer