LavalinkNode

Defined in: src/structures/Node.ts:28

Lavalink Node creator class

Constructors

Constructor

new LavalinkNode(options: LavalinkNodeOptions, manager: NodeManager): LavalinkNode;

Defined in: src/structures/Node.ts:171

Create a new Node

Parameters

Parameter	Type	Description
options	LavalinkNodeOptions	Lavalink Node Options
manager	NodeManager	Node Manager

Returns

LavalinkNode

Example

// don't create a node manually, instead use:

client.lavalink.nodeManager.createNode(options)

Properties

Property (defined in)	Type	Default value	Description
calls (src/structures/Node.ts:38)	number	0	The amount of rest calls the node has made.
decode (src/structures/Node.ts:727)	object	undefined	Decode Track or Tracks
decode.multipleTracks (src/structures/Node.ts:759)	(encodeds: string[], requester: unknown) => Promise<Track[]>	undefined	Decodes multiple tracks into their info Example `const encodedBase64_1 = ‘QAACDgMACk5vIERpZ2dpdHkAC0JsYWNrc3RyZWV0AAAAAAAEo4AABjkxNjQ5NgABAB9odHRwczovL2RlZXplci5jb20vdHJhY2svOTE2NDk2AQBpaHR0cHM6Ly…
decode.singleTrack (src/structures/Node.ts:740)	(encoded: string, requester: unknown) => Promise<Track>	undefined	Decode a single track into its info Example `const encodedBase64 = ‘QAACDgMACk5vIERpZ2dpdHkAC0JsYWNrc3RyZWV0AAAAAAAEo4AABjkxNjQ5NgABAB9odHRwczovL2RlZXplci5jb20vdHJhY2svOTE2NDk2AQBpaHR0cHM6Ly9lLWNk…
info (src/structures/Node.ts:77)	LavalinkInfo	null	Actual Lavalink Information of the Node
isAlive (src/structures/Node.ts:34)	boolean	false
lyrics (src/structures/Node.ts:771)	object	undefined
lyrics.get (src/structures/Node.ts:785)	(track: Track, skipTrackSource: boolean) => Promise<LyricsResult>	undefined	Get the lyrics of a track Example const lyrics = await player.node.lyrics.get(track, true); // use it of player instead: // const lyrics = await player.getLyrics(track, true);
lyrics.getCurrent (src/structures/Node.ts:814)	(guildId: string, skipTrackSource: boolean) => Promise<LyricsResult>	undefined	Get the lyrics of the current playing track Example const lyrics = await player.node.lyrics.getCurrent(guildId); // use it of player instead: // const lyrics = await player.getCurrentLyrics();
lyrics.subscribe (src/structures/Node.ts:843)	(guildId: string) => Promise<unknown>	undefined	subscribe to lyrics updates for a guild Example await player.node.lyrics.subscribe(guildId); // use it of player instead: // const lyrics = await player.subscribeLyrics();
lyrics.unsubscribe (src/structures/Node.ts:866)	(guildId: string) => Promise<void>	undefined	unsubscribe from lyrics updates for a guild Example await player.node.lyrics.unsubscribe(guildId); // use it of player instead: // const lyrics = await player.unsubscribeLyrics();
options (src/structures/Node.ts:36)	LavalinkNodeOptions	undefined	The provided Options of the Node
reconnectionState (src/structures/Node.ts:79)	ReconnectionState	ReconnectionState.IDLE	current state of the Reconnections
resuming (src/structures/Node.ts:75)	object	undefined	Whether the node resuming is enabled or not
resuming.enabled (src/structures/Node.ts:75)	boolean	undefined
resuming.timeout (src/structures/Node.ts:75)	number	undefined
routePlannerApi (src/structures/Node.ts:938)	object	undefined	Lavalink’s Route Planner Api
routePlannerApi.getStatus (src/structures/Node.ts:950)	() => Promise<RoutePlanner>	undefined	Get routplanner Info from Lavalink for ip rotation Example `const routePlannerStatus = await player.node.routePlannerApi.getStatus(); const usedBlock = routePlannerStatus.details?.ipBlock; const c…
routePlannerApi.unmarkAllFailedAddresses (src/structures/Node.ts:984)	() => Promise<unknown>	undefined	Release all blacklisted IP addresses into pool of IPs Example await player.node.routePlannerApi.unmarkAllFailedAddresses();
routePlannerApi.unmarkFailedAddress (src/structures/Node.ts:965)	(address: string) => Promise<unknown>	undefined	Release blacklisted IP address into pool of IPs for ip rotation Example await player.node.routePlannerApi.unmarkFailedAddress("ipv6address");
sessionId? (src/structures/Node.ts:73)	string	null	The current sessionId, only present when connected
stats (src/structures/Node.ts:40)	NodeStats	undefined	Stats from lavalink, will be updated via an interval by lavalink.

Accessors

connected

Get Signature

get connected(): boolean;

Defined in: src/structures/Node.ts:136

Returns if connected to the Node.

Example

const isConnected = player.node.connected;
console.log("node is connected: ", isConnected ? "yes" : "no")

Returns

boolean

---

connectionStatus

Get Signature

get connectionStatus(): string;

Defined in: src/structures/Node.ts:153

Returns the current ConnectionStatus

Example

try {
    const statusOfConnection = player.node.connectionStatus;
    console.log("node's connection status is:", statusOfConnection)
} catch (error) {
    console.error("no socket available?", error)
}

Returns

string

---

heartBeatPing

Get Signature

get heartBeatPing(): number;

Defined in: src/structures/Node.ts:101

Returns the Heartbeat Ping of the Node

Returns

number

---

id

Get Signature

get id(): string;

Defined in: src/structures/Node.ts:529

Get the id of the node

Example

const nodeId = player.node.id;
console.log("node id is: ", nodeId)

Returns

string

---

isNodeReconnecting

Get Signature

get isNodeReconnecting(): boolean;

Defined in: src/structures/Node.ts:1078

If already trying to reconnect or pending, return

Returns

boolean

---

reconnectionAttemptCount

Get Signature

get reconnectionAttemptCount(): number;

Defined in: src/structures/Node.ts:1114

Returns

number

Methods

connect()

connect(sessionId?: string): void;

Defined in: src/structures/Node.ts:463

Connect to the Lavalink Node

Parameters

Parameter	Type	Description
sessionId?	string	Provide the Session Id of the previous connection, to resume the node and it’s player(s)

Returns

void

void

Example

player.node.connect(); // if provided on bootup in managerOptions#nodes, this will be called automatically when doing lavalink.init()

// or connect from a resuming session:
player.node.connect("sessionId");

---

deleteSponsorBlock()

deleteSponsorBlock(player: Player): Promise<void>;

Defined in: src/structures/Node.ts:1658

Delete the sponsorblock plugins

Parameters

Parameter	Type	Description
player	Player	passthrough the player

Returns

Promise<void>

void

Example

// use it on the player via player.deleteSponsorBlock();
const sponsorBlockSegments = await player.node.deleteSponsorBlock(player);

---

destroy()

destroy(
   destroyReason?: string,
   deleteNode?: boolean,
   movePlayers?: boolean): void;

Defined in: src/structures/Node.ts:550

Destroys the Node-Connection (Websocket) and all player’s of the node

Parameters

Parameter	Type	Default value	Description
destroyReason?	string	undefined	Destroy Reason to use when destroying the players
deleteNode?	boolean	true	whether to delete the nodte from the nodes list too, if false it will emit a disconnect.
movePlayers?	boolean	false	whether to movePlayers to different eligible connected node. If false players won’t be moved

Returns

void

void

Default

true

Default

false

Example

Destroys node and its players

player.node.destroy("custom Player Destroy Reason", true);

destroys only the node and moves its players to different connected node.

player.node.destroy("custom Player Destroy Reason", true, true);

---

destroyPlayer()

destroyPlayer(guildId: any): Promise<void>;

Defined in: src/structures/Node.ts:444

Destroys the Player on the Lavalink Server

Parameters

Parameter	Type	Description
guildId	any

Returns

Promise<void>

request result

Example

// use player.destroy() instead
player.node.destroyPlayer(player.guildId);

---

disconnect()

disconnect(disconnectReason?: string): void;

Defined in: src/structures/Node.ts:652

Disconnects the Node-Connection (Websocket)

Parameters

Parameter	Type	Description
disconnectReason?	string	Disconnect Reason to use when disconnecting Node

Returns

void

void

Also the node will not get re-connected again.

Example

player.node.disconnect("Forcefully disconnect the connection to the node.");

---

fetchAllPlayers()

fetchAllPlayers(): Promise<
  | LavalinkPlayer[]
| InvalidLavalinkRestRequest>;

Defined in: src/structures/Node.ts:675

Gets all Players of a Node

Returns

Promise< | LavalinkPlayer[] | InvalidLavalinkRestRequest>

array of players inside of lavalink

Example

const node = lavalink.nodes.get("NODEID");
const playersOfLavalink = await node?.fetchAllPlayers();

---

fetchConnectionMetrics()

fetchConnectionMetrics(): Promise<NodeLinkConnectionMetrics>;

Defined in: src/structures/Node.ts:901

Request NodeLink connection metrics. https://nodelink.js.org/docs/differences#connection-metrics

Returns

Promise<NodeLinkConnectionMetrics>

the connection metrics of the node

Example

const connectionMetrics = await player.node.fetchConnectionMetrics();

---

fetchInfo()

fetchInfo(): Promise<LavalinkInfo>;

Defined in: src/structures/Node.ts:931

Request Lavalink information.

Returns

Promise<LavalinkInfo>

lavalink info object

Example

const lavalinkInfo = await player.node.fetchInfo();
const availablePlugins:string[] = lavalinkInfo.plugins.map(plugin => plugin.name);
const availableSources:string[] = lavalinkInfo.sourceManagers;

---

fetchPlayer()

fetchPlayer(guildId: string): Promise<
  | LavalinkPlayer
| InvalidLavalinkRestRequest>;

Defined in: src/structures/Node.ts:690

Gets specific Player Information

Parameters

Parameter	Type
guildId	string

Returns

Promise< | LavalinkPlayer | InvalidLavalinkRestRequest>

lavalink player object if player exists on lavalink

Example

const node = lavalink.nodes.get("NODEID");
const playerInformation = await node?.fetchPlayer("guildId");

---

fetchStats()

fetchStats(): Promise<BaseNodeStats>;

Defined in: src/structures/Node.ts:888

Request Lavalink statistics.

Returns

Promise<BaseNodeStats>

the lavalink node stats

Example

const lavalinkStats = await player.node.fetchStats();

---

fetchVersion()

fetchVersion(): Promise<string>;

Defined in: src/structures/Node.ts:915

Request Lavalink version.

Returns

Promise<string>

the current used lavalink version

Example

const lavalinkVersion = await player.node.fetchVersion();

---

getSponsorBlock()

getSponsorBlock(player: Player): Promise<SponsorBlockSegment[]>;

Defined in: src/structures/Node.ts:1604

Get the current sponsorblocks for the sponsorblock plugin

Parameters

Parameter	Type	Description
player	Player	passthrough the player

Returns

Promise<SponsorBlockSegment[]>

sponsorblock seggment from lavalink

Example

// use it on the player via player.getSponsorBlock();
const sponsorBlockSegments = await player.node.getSponsorBlock(player);

---

lavaSearch()

lavaSearch(
   query: LavaSearchQuery,
   requestUser: unknown,
   throwOnEmpty: boolean): Promise<
  | LavaSearchResponse
| SearchResult>;

Defined in: src/structures/Node.ts:358

Search something using the lavaSearchPlugin (filtered searches by types)

Parameters

Parameter	Type	Default value	Description
query	LavaSearchQuery	undefined	LavaSearchQuery Object
requestUser	unknown	undefined	Request User for creating the player(s)
throwOnEmpty	boolean	false	Whether to throw on an empty result or not

Returns

Promise< | LavaSearchResponse | SearchResult>

LavaSearchresult (SearchResult if link is provided)

Example

// use player.search() instead
player.node.lavaSearch({ types: ["playlist", "album"], query: "Rick Astley", source: "spotify" }, interaction.user);

---

request()

Call Signature

request(
   endpoint: string,
   modify: ModifyRequest,
parseAsText: true): Promise<string>;

Defined in: src/structures/Node.ts:251

Makes an API call to the Node. Should only be used for manual parsing like for not supported plugins

Parameters

Parameter	Type	Description
endpoint	string	The endpoint that we will make the call to
modify	ModifyRequest	Used to modify the request before being sent
parseAsText	true	-

Returns

Promise<string>

The returned data

Example

player.node.request(`/loadtracks?identifier=Never gonna give you up`, (options) => options.method = "GET", false);

Call Signature

request(
   endpoint: string,
   modify?: ModifyRequest,
parseAsText?: false): Promise<any>;

Defined in: src/structures/Node.ts:252

Makes an API call to the Node. Should only be used for manual parsing like for not supported plugins

Parameters

Parameter	Type	Description
endpoint	string	The endpoint that we will make the call to
modify?	ModifyRequest	Used to modify the request before being sent
parseAsText?	false	-

Returns

Promise<any>

The returned data

Example

player.node.request(`/loadtracks?identifier=Never gonna give you up`, (options) => options.method = "GET", false);

---

search()

search(
   query: SearchQuery,
   requestUser: unknown,
throwOnEmpty: boolean): Promise<SearchResult>;

Defined in: src/structures/Node.ts:280

Search something raw on the node, please note only add tracks to players of that node

Parameters

Parameter	Type	Default value	Description
query	SearchQuery	undefined	SearchQuery Object
requestUser	unknown	undefined	Request User for creating the player(s)
throwOnEmpty	boolean	false	Whether to throw on an empty result or not

Returns

Promise<SearchResult>

Searchresult

Example

// use player.search() instead
player.node.search({ query: "Never gonna give you up by Rick Astley", source: "soundcloud" }, interaction.user);
player.node.search({ query: "https://deezer.com/track/123456789" }, interaction.user);

---

setSponsorBlock()

setSponsorBlock(player: Player, segments: SponsorBlockSegment[]): Promise<void>;

Defined in: src/structures/Node.ts:1622

Set the current sponsorblocks for the sponsorblock plugin

Parameters

Parameter	Type	Description
player	Player	passthrough the player
segments	SponsorBlockSegment[]	-

Returns

Promise<void>

void

Example

// use it on the player via player.setSponsorBlock();
const sponsorBlockSegments = await player.node.setSponsorBlock(player, ["sponsor", "selfpromo"]);

---

updatePlayer()

updatePlayer(data: PlayerUpdateInfo): Promise<LavalinkPlayer>;

Defined in: src/structures/Node.ts:403

Update the Player State on the Lavalink Server

Parameters

Parameter	Type	Description
data	PlayerUpdateInfo	data to send to lavalink and sync locally

Returns

Promise<LavalinkPlayer>

result from lavalink

Example

// use player.search() instead
player.node.updatePlayer({ guildId: player.guildId, playerOptions: { paused: true } }); // example to pause it

---

updateSession()

updateSession(resuming?: boolean, timeout?: number): Promise<
  | InvalidLavalinkRestRequest
| Session>;

Defined in: src/structures/Node.ts:707

Updates the session with and enables/disables resuming and timeout

Parameters

Parameter	Type	Description
resuming?	boolean	Whether resuming is enabled for this session or not
timeout?	number	The timeout in seconds (default is 60s)

Returns

Promise< | InvalidLavalinkRestRequest | Session>

the result of the request

Example

const node = player.node || lavalink.nodes.get("NODEID");
await node?.updateSession(true, 180e3); // will enable resuming for 180seconds