Class : Node

Constructor

Node : options

new Magmastream.Node(options: NodeOptions)

Parameter	Type	Description
host	string	The host for the node.
port	number	The port for the node.
password	string	The password for the node.
secure	boolean	Whether the host uses SSL.
identifier	string	The identifier for the node.
retryAmount	number	The retryAmount for the node.
retryDelay	number	The retryDelay for the node.
resumeStatus	boolean	Whether to resume the previous session.
resumeTimeout	number	The time the lavalink server will wait before it removes the player.
requestTimeout	number	The timeout used for api calls.
priority	number	Priority of the node.

Table of contents

Properties	Methods
socket	address()
stats	connected()
manager	connect()
sessionId	createSessionIdsFile()
rest	deleteSponsorBlock()
info	destroy()
	extractSpotifyArtistID()
	extractSpotifyTrackID()
	fetchInfo()
	getSponsorBlock()
	loadSessionIds()
	setSponsorBlock()
	updateSessionId()

Properties

socket

The socket for the node.

Return: WebSocket | null

---

stats

The stats for the node.

Return: nodeStats{}

---

manager

The manager for the node.

Return: Manager

---

sessionId

The node's session ID.

Return: string | null

---

rest

readonly

The REST instance.

Return: Rest

---

info

Actual Lavalink information of the node.

Return: lavalinkInfo{} | null

Methods

address()

get

Returns the address for this node.

Return: string

---

connected()

get

Returns if connected to the Node.

Return: boolean

---

connect()

Connects to the Node.

If the node is already connected, this method will do nothing.
If the node has a session ID, it will be sent in the headers of the WebSocket connection.
If the node has no session ID but the resumeStatus option is true, it will use the session ID
stored in the sessionIds.json file if it exists.

Return: void

---

createSessionIdsFile()

Creates the sessionIds.json file if it doesn't exist. This file is used to store the session IDs for each node. The session IDs are used to identify the node when resuming a session.

Return: void

---

deleteSponsorBlock(player)

Deletes the sponsorblock segments for a player.

Return: Promise<void>

Parameter	Type	Description	Optional
player	Player	The player to delete the sponsorblocks for.

---

destroy()

Destroys the Node and all players connected with it.

This method will:

• Destroy all players connected to the node
• Close the WebSocket connection
• Remove all event listeners on the WebSocket
• Clear the reconnect timeout
• Emit a "nodeDestroy" event with the node as the argument
• Destroy the node from the manager

Return: void

---

extractSpotifyArtistID(url)

Extracts the Spotify artist ID from a URL.

Return: string | null

Parameter	Type	Description	Optional
url	string	The URL to extract the artist ID from.

---

extractSpotifyTrackID(url)

Extracts the Spotify track ID from a URL.

Return: string | null

Parameter	Type	Description	Optional
url	string	The URL to extract the artist ID from.

---

fetchInfo()

Fetches Lavalink node information.

Return: Promise<lavalinkInfo{}>

---

getSponsorBlock(player)

Gets the current sponsorblock segments for a player.

Return: Promise<sponsorBlockSegment[]>

Parameter	Type	Description	Optional
player	Player	The player to get the sponsor blocks for.

---

loadSessionIds()

Loads session IDs from the sessionIds.json file if it exists.

The session IDs are used to resume sessions for each node.

Return: void

---

setSponsorBlock(player, segments)

Sets the sponsorblock segments for a player.

Return: Promise<void>

Parameter	Type	Description	Optional
player	Player	The player to set the sponsor blocks for.
segments	sponsorBlockSegment[]	The sponsorblock segments to set. Defaults to ["sponsor", "selfpromo"] if not provided.

---

updateSessionId()

Updates the session ID in the sessionIds.json file.

This method is called after the session ID has been updated, and it writes the new session ID to the sessionIds.json file.

Return: void