---
url: https://docs.moqtail.dev/ts/api/player/functions/defineElement.md
---
# Function: defineElement()

## Call Signature

> **defineElement**<`E`, `P`>(`definition`): [`SourceElementDefinition`](../interfaces/SourceElementDefinition.md)<`E`, `P`>

Checks an element definition and returns it with its types preserved. The instance
`init` returns gets a read-only `definition` property pointing at the returned object.
Invalid definitions throw `TypeError`, since they're programming errors.

### Type Parameters

#### E

`E` *extends* [`SourceElement`](../classes/SourceElement.md)

#### P

`P` *extends* readonly (keyof [`ElementInterfaces`](../interfaces/ElementInterfaces.md))\[] = \[]

### Parameters

#### definition

[`SourceElementDefinition`](../interfaces/SourceElementDefinition.md)<`E`, `P`>

### Returns

[`SourceElementDefinition`](../interfaces/SourceElementDefinition.md)<`E`, `P`>

## Call Signature

> **defineElement**<`E`, `P`>(`definition`): [`TransformElementDefinition`](../interfaces/TransformElementDefinition.md)<`E`, `P`>

Checks an element definition and returns it with its types preserved. The instance
`init` returns gets a read-only `definition` property pointing at the returned object.
Invalid definitions throw `TypeError`, since they're programming errors.

### Type Parameters

#### E

`E` *extends* [`TransformElement`](../classes/TransformElement.md)

#### P

`P` *extends* readonly (keyof [`ElementInterfaces`](../interfaces/ElementInterfaces.md))\[] = \[]

### Parameters

#### definition

[`TransformElementDefinition`](../interfaces/TransformElementDefinition.md)<`E`, `P`>

### Returns

[`TransformElementDefinition`](../interfaces/TransformElementDefinition.md)<`E`, `P`>

## Call Signature

> **defineElement**<`E`, `P`>(`definition`): [`SinkElementDefinition`](../interfaces/SinkElementDefinition.md)<`E`, `P`>

Checks an element definition and returns it with its types preserved. The instance
`init` returns gets a read-only `definition` property pointing at the returned object.
Invalid definitions throw `TypeError`, since they're programming errors.

### Type Parameters

#### E

`E` *extends* [`SinkElement`](../classes/SinkElement.md)

#### P

`P` *extends* readonly (keyof [`ElementInterfaces`](../interfaces/ElementInterfaces.md))\[] = \[]

### Parameters

#### definition

[`SinkElementDefinition`](../interfaces/SinkElementDefinition.md)<`E`, `P`>

### Returns

[`SinkElementDefinition`](../interfaces/SinkElementDefinition.md)<`E`, `P`>
