---
url: https://docs.moqtail.dev/ts/api/model/classes/FullTrackName.md
---
# Class: FullTrackName

Fully-qualified track identifier = hierarchical namespace (tuple) + leaf name bytes.

Constraints enforced (throws [TrackNameError](TrackNameError.md)):

* Namespace tuple field count: 0 .. [MAX_NAMESPACE_TUPLE_COUNT](../variables/MAX_NAMESPACE_TUPLE_COUNT.md) (an empty namespace is legal).
* Total serialized length (namespace tuple + raw name bytes) less than or equals [MAX_FULL_TRACK_NAME_LENGTH](../variables/MAX_FULL_TRACK_NAME_LENGTH.md) bytes.

Namespace input may be:

* `string` path with segments separated by `/` (converted via [Tuple.fromUtf8Path](Tuple.md#fromutf8path)). Empty segments are dropped,
  so `''` and `'/'` both yield a zero-element namespace.
* Existing [Tuple](Tuple.md) instance.

Name input may be:

* UTF-8 string (encoded)
* Raw `Uint8Array` (used directly)

Instances are created via [FullTrackName.tryNew](#trynew) (validates) or [FullTrackName.deserialize](#deserialize).
Use [FullTrackName.serialize](#serialize) for wire encoding and [FullTrackName.toString](#tostring) for a human friendly
diagnostic format: `namespace/segments:hexname` (name rendered as lowercase hex, no 0x prefix).

The string form is intended for logs/debug only; do not parse it for protocol operations.

## Properties

### name

> `readonly` **name**: `Uint8Array`

***

### namespace

> `readonly` **namespace**: [`Tuple`](Tuple.md)

## Methods

### serialize()

> **serialize**(): [`FrozenByteBuffer`](FrozenByteBuffer.md)

Serialize to a frozen buffer: tuple (namespace) followed by length‑prefixed name bytes.
Consumers needing raw bytes should call `.toUint8Array()` on the returned [FrozenByteBuffer](FrozenByteBuffer.md).

#### Returns

[`FrozenByteBuffer`](FrozenByteBuffer.md)

***

### toString()

> **toString**(): `string`

Human-readable representation: `\<namespace path joined by '/'\>:\<name as lowercase hex\>`.
If the underlying [Tuple](Tuple.md) exposes `toUtf8Path`, it's used; otherwise the raw fields are joined.
This is lossy only in the sense that name bytes are hex encoded; round-tripping requires serialization.

#### Returns

`string`

***

### deserialize()

> `static` **deserialize**(`buf`): `FullTrackName`

Parse a serialized full track name. Performs the same validations as [FullTrackName.tryNew](#trynew).
The provided buffer's read cursor advances accordingly.

#### Parameters

##### buf

[`BaseByteBuffer`](BaseByteBuffer.md)

#### Returns

`FullTrackName`

#### Throws

:[TrackNameError](TrackNameError.md) if constraints are violated.

***

### tryNew()

> `static` **tryNew**(`namespace`, `name`): `FullTrackName`

Construct a validated full track name.

Validation steps:

1. Convert namespace string -> [Tuple](Tuple.md) (split on '/') if needed.
2. Reject if namespace tuple field count is > [MAX_NAMESPACE_TUPLE_COUNT](../variables/MAX_NAMESPACE_TUPLE_COUNT.md).
3. Encode name string to UTF-8 if needed.
4. Reject if total serialized length (namespace tuple + name bytes) > [MAX_FULL_TRACK_NAME_LENGTH](../variables/MAX_FULL_TRACK_NAME_LENGTH.md).

#### Parameters

##### namespace

`string` | [`Tuple`](Tuple.md)

##### name

`string` | `Uint8Array`<`ArrayBufferLike`>

#### Returns

`FullTrackName`

#### Throws

:[TrackNameError](TrackNameError.md) on any constraint violation.

#### Example

```ts
const full = FullTrackName.tryNew('media/video', 'keyframe')
console.log(full.toString()) // media/video:6b65796672616d65
```
