---
url: https://docs.moqtail.dev/ts/api/player/classes/BaseElement.md
---
# Abstract Class: BaseElement

Base of every element instance.

## Extends

* [`Emitter`](../../util/classes/Emitter.md)<[`ElementEvents`](../interfaces/ElementEvents.md)>

## Extended by

* [`SourceElement`](SourceElement.md)
* [`TransformElement`](TransformElement.md)
* [`SinkElement`](SinkElement.md)

## Constructors

### Constructor

> **new BaseElement**(`context`): `BaseElement`

Calls `context.attach(this)`, so the player hears everything the instance emits.

#### Parameters

##### context

[`ElementContext`](../interfaces/ElementContext.md)

#### Returns

`BaseElement`

#### Overrides

[`Emitter`](../../util/classes/Emitter.md).[`constructor`](../../util/classes/Emitter.md#constructor)

## Properties

### context

> `protected` `readonly` **context**: [`ElementContext`](../interfaces/ElementContext.md)

***

### definition

> `readonly` **definition**: [`ElementDefinition`](../interfaces/ElementDefinition.md)

Set by `defineElement` once `init` resolves, so it can't be used from a constructor.

***

### pads

> `readonly` **pads**: [`Pad`](Pad.md)\[] = `[]`

## Methods

### createPad()

> `protected` **createPad**(`direction`, `capabilities`): [`Pad`](Pad.md)

Creates a pad and emits `padadded`.

#### Parameters

##### direction

`"sink"` | `"src"`

##### capabilities

[`Capabilities`](../type-aliases/Capabilities.md)

#### Returns

[`Pad`](Pad.md)

***

### destroy()

> **destroy**(): `Promise`<`void`>

Removes the element's pads. The runtime aborts `context.signal` before and releases the
elements this one loaded after. Override for your own cleanup and call `super.destroy()`.

#### Returns

`Promise`<`void`>

***

### emit()

> **emit**<`K`>(`event`, ...`args`): `void`

Calls every listener of `event` with `args`. Allocates nothing when there are none.

#### Type Parameters

##### K

`K` *extends* `"ready"` | `"padadded"` | `"padremoved"` | `"nomorepads"`

#### Parameters

##### event

`K`

##### args

...`Parameters`<[`ElementEvents`](../interfaces/ElementEvents.md)\[`K`]>

#### Returns

`void`

#### Inherited from

[`Emitter`](../../util/classes/Emitter.md).[`emit`](../../util/classes/Emitter.md#emit)

***

### matchesCapabilities()

> `protected` **matchesCapabilities**(`pad`): `boolean`

True if the pad matches one of the definition's `in` capability bundles.

#### Parameters

##### pad

[`Pad`](Pad.md)

#### Returns

`boolean`

***

### off()

> **off**<`K`>(`event`, `listener`): `void`

Removes `listener`, the same function given to `on()`, from `event`.

#### Type Parameters

##### K

`K` *extends* `"ready"` | `"padadded"` | `"padremoved"` | `"nomorepads"`

#### Parameters

##### event

`K`

##### listener

[`ElementEvents`](../interfaces/ElementEvents.md)\[`K`]

#### Returns

`void`

#### Inherited from

[`Emitter`](../../util/classes/Emitter.md).[`off`](../../util/classes/Emitter.md#off)

***

### on()

> **on**<`K`>(`event`, `listener`): `void`

Adds `listener` for `event`. Adding the same function twice has no effect.

#### Type Parameters

##### K

`K` *extends* `"ready"` | `"padadded"` | `"padremoved"` | `"nomorepads"`

#### Parameters

##### event

`K`

##### listener

[`ElementEvents`](../interfaces/ElementEvents.md)\[`K`]

#### Returns

`void`

#### Inherited from

[`Emitter`](../../util/classes/Emitter.md).[`on`](../../util/classes/Emitter.md#on)

***

### removePad()

> `protected` **removePad**(`pad`, `failed?`): `void`

Removes a pad and emits `padremoved`. Pass `failed` when a failure, not a catalog update, lost it.

#### Parameters

##### pad

[`Pad`](Pad.md)

##### failed?

`boolean` = `false`

#### Returns

`void`
