YouTube.js
Guide
Discord
❤️ Sponsor
GitHub
Guide
Discord
❤️ Sponsor
GitHub

youtubei.js / YTNodes / MacroMarkersListEntity

Class: MacroMarkersListEntity

Defined in: src/parser/classes/MacroMarkersListEntity.ts:13

Represents a list of markers for a video. Can contain different types of markers:

  • MARKER_TYPE_HEATMAP: Heat map markers showing audience engagement data
  • Other marker types may exist but are not currently handled

Extends

  • YTNode

Constructors

Constructor

new MacroMarkersListEntity(data): MacroMarkersListEntity

Defined in: src/parser/classes/MacroMarkersListEntity.ts:30

Parameters

data

RawNode

Returns

MacroMarkersListEntity

Overrides

YTNode.constructor

Properties

external_video_id

external_video_id: string

Defined in: src/parser/classes/MacroMarkersListEntity.ts:17


marker_entity_key

marker_entity_key: string

Defined in: src/parser/classes/MacroMarkersListEntity.ts:16


marker_type

marker_type: string

Defined in: src/parser/classes/MacroMarkersListEntity.ts:19

The type of markers in this entity (e.g., 'MARKER_TYPE_HEATMAP')


markers

markers: ObservedArray<HeatMarker>

Defined in: src/parser/classes/MacroMarkersListEntity.ts:20


max_height_dp

max_height_dp: number

Defined in: src/parser/classes/MacroMarkersListEntity.ts:21


min_height_dp

min_height_dp: number

Defined in: src/parser/classes/MacroMarkersListEntity.ts:22


show_hide_animation_duration_millis

show_hide_animation_duration_millis: number

Defined in: src/parser/classes/MacroMarkersListEntity.ts:23


timed_marker_decorations

timed_marker_decorations: ObservedArray<TimedMarkerDecoration>

Defined in: src/parser/classes/MacroMarkersListEntity.ts:24


type

readonly type: string

Defined in: src/parser/helpers.ts:8

Inherited from

YTNode.type


type

static type: string = 'MacroMarkersListEntity'

Defined in: src/parser/classes/MacroMarkersListEntity.ts:14

Overrides

YTNode.type

Methods

as()

as<T, K>(...types): InstanceType<K[number]>

Defined in: src/parser/helpers.ts:29

Cast to one of the given types.

Type Parameters

T

T extends YTNode

K

K extends YTNodeConstructor<T>[]

Parameters

types

...K

The types to cast to

Returns

InstanceType<K[number]>

The node cast to one of the given types

Throws

If the node is not of the given type

Inherited from

YTNode.as


hasKey()

hasKey<T, R>(key): this is MacroMarkersListEntity & { [k in string]: R }

Defined in: src/parser/helpers.ts:41

Check for a key without asserting the type.

Type Parameters

T

T extends string

R

R = any

Parameters

key

T

The key to check

Returns

this is MacroMarkersListEntity & { [k in string]: R }

Whether the node has the key

Inherited from

YTNode.hasKey


is()

is<T, K>(...types): this is InstanceType<K[number]>

Defined in: src/parser/helpers.ts:19

Check if the node is of the given type.

Type Parameters

T

T extends YTNode

K

K extends YTNodeConstructor<T>[]

Parameters

types

...K

The type to check

Returns

this is InstanceType<K[number]>

whether the node is of the given type

Inherited from

YTNode.is


isHeatmap()

isHeatmap(): boolean

Defined in: src/parser/classes/MacroMarkersListEntity.ts:65

Checks if this MacroMarkersListEntity represents heatmap data. Only heatmap markers can be converted to Heatmap objects.

Returns

boolean


key()

key<T, R>(key): Maybe

Defined in: src/parser/helpers.ts:51

Assert that the node has the given key and return it.

Type Parameters

T

T extends string

R

R = any

Parameters

key

T

The key to check

Returns

Maybe

The value of the key wrapped in a Maybe

Throws

If the node does not have the key

Inherited from

YTNode.key


toHeatmap()

toHeatmap(): Heatmap | null

Defined in: src/parser/classes/MacroMarkersListEntity.ts:74

Converts this MacroMarkersListEntity to a Heatmap object for compatibility with existing code. Only works for heatmap markers.

Returns

Heatmap | null

Heatmap object if this entity contains heatmap data, null otherwise

Edit this page
Last Updated: 10/12/25, 3:23 PM