audioshowkit/src/player/SongPlaylist.js

import PlaylistSong from "./PlaylistSong";

/**
 * A playlist that holds a multitude of songs.
 */
export default class SongPlaylist {

    /**
     * Instantiates a playlist for songs.
     * 
     * @param {string} name The name of the playlist.
     */
    constructor(name) {
        this._list = [];
        this._name = name;
        this._current = 0;
    }

    /**
     * 
     * @returns {string} the name of the string.
     */
    getName() {
        return this._name;
    }

    /**
     * 
     * @param {number} index the index of the song to retrieve.
     * @returns {PlaylistSong} the song at the given index.
     */
    songAtIndex(index) {
        if (index >= this._list.length) {
            return null;
        }
        return this.list[index];
    }

    songsWithName(name) {
        return this._list.filter((item) => item.getDisplayName() == name);
    }

    add(url, name, author) {
        this._list.push(new PlaylistSong(url, name, author, this, this._list.length));
    }

    remove(index) {
        if (index >= this._list.length) {
            return null;
        }
        let removed = this._list.splice(index, 1);
        if (removed.length > 0) {
            return removed[0];
        }
    }

    findSongIndex(name) {
        // TODO: Could probably be optimized.
        return this._list.findIndex((item) => item.getDisplayName() == name);
    }

    /**
     * 
     * @returns {number} total number of songs in this playlist.
     */
    total() {
        return this._list.length;
    }

    /**
     * Unloads the audio data of all songs in this playlist.
     */
    unloadAllAudio() {
        this._list.forEach(playlistSong => {
            playlistSong.unloadAudio();
        });
    }
}