Class BasePagination<T>Abstract

Base pagination class that works with collector and it's events.

Type Parameters

  • T extends ReplyMessageOptions | MessageOptions | InteractionReplyOptions

Hierarchy

Constructors

constructor

Properties

_messageOptions

Accessors

afterSending buttons collector collectorOptions currentPage embeds filterOptions isActive messageOptions onStop time

Methods

_buildActionRows _collected _disableButton _formCollector _formFilter _getActionRows _getPageNumber _setActive _setCollector _setCurrentPage _setTime _setupData _stop getButtonByCustomId insertEmbeds removeEmbeds send setAfterSendingAction setButtons setCollectorOptions setEmbeds setFilterOptions setMessageOptions setOnStopAction setTime

Constructors

Protected constructor

Properties

Private _messageOptions

_messageOptions: T

Accessors

afterSending

  • get afterSending(): null | AfterSending

  • Action that will be completed after the pagination was sent.

    Returns null | AfterSending

buttons

  • get buttons(): null | ButtonData[]

  • The buttons of this pagination. By default is an empty array.

    Returns null | ButtonData[]

collector

  • get collector(): null | InteractionCollector<ButtonInteraction<CacheType>>

  • Collector that collects button interactions.

    Returns null | InteractionCollector<ButtonInteraction<CacheType>>

collectorOptions

  • get collectorOptions(): null | CollectorOptions

  • Options for collecting button interactions.

    Returns null | CollectorOptions

currentPage

  • get currentPage(): number

  • Current page number. Zero-based. By default is zero.

    Returns number

embeds

  • get embeds(): null | MessageEmbed[]

  • Embeds of this pagination. By default is an empty array.

    Returns null | MessageEmbed[]

filterOptions

  • get filterOptions(): null | FilterOptions

  • Options for filtering button interactions. By default singleUserAccess and noAccessReply are true. And noAccessReplyContent is "You're disallowed to use this very pagination!".

    Returns null | FilterOptions

isActive

  • get isActive(): boolean

  • Indicates whether this pagination sent or not. By default is false.

    Returns boolean

messageOptions

  • get messageOptions(): null | T

  • Options for sending out message.

    Returns null | T

onStop

  • get onStop(): null | OnStop

  • Action that will be completed after the pagination was stopped.

    Returns null | OnStop

time

  • get time(): null | number

  • How long the pagination will exist (in milliseconds). By default is zero.

    Returns null | number

Methods

Private _buildActionRows

  • _buildActionRows(disableButtons?: boolean): MessageActionRow<MessageButton, MessageActionRowComponentResolvable, APIActionRowComponent<APIMessageActionRowComponent>>[]

  • Builds array of action rows and disables or enables every button.

    Returns

    Array of action rows.

    Parameters

    • disableButtons: boolean = false

      Disable or enable all buttons.

    Returns MessageActionRow<MessageButton, MessageActionRowComponentResolvable, APIActionRowComponent<APIMessageActionRowComponent>>[]

Protected _collected

  • _collected(interaction: ButtonInteraction<CacheType>): Promise<void>

  • Method that handles collect event.

    Returns

    Updates pagination.

    Parameters

    • interaction: ButtonInteraction<CacheType>

      Interaction that the collector got.

    Returns Promise<void>

Private _disableButton

  • _disableButton(button: MessageButton, page: number): Promise<void>

  • Disables button if needed for the specified page.

    Returns

    Updates button style.

    Parameters

    • button: MessageButton

      Button style.

    • page: number

      Page number.

    Returns Promise<void>

Protected _formCollector

  • _formCollector(message: Message<boolean>, user?: User): InteractionCollector<ButtonInteraction<CacheType>>

  • Forms collector.

    Returns

    Interaction Collector.

    Parameters

    • message: Message<boolean>

      Message that collector should stick to.

    • Optional user: User

      Used only if singleUserAccess is true. Needed only if only one user should be able to use pagination.

    Returns InteractionCollector<ButtonInteraction<CacheType>>

Private _formFilter

  • _formFilter(message: Message<boolean>, user?: User): ((interaction: ButtonInteraction<CacheType>) => Promise<boolean>)

  • Forms filter for InteractionCollector.

    Returns

    Function that filters out interactions.

    Parameters

    • message: Message<boolean>

      Message that collector should stick to.

    • Optional user: User

      Needed only if one user should be able to use pagination and filterOptions onlyOneUser is true.

    Returns ((interaction: ButtonInteraction<CacheType>) => Promise<boolean>)

      • (interaction: ButtonInteraction<CacheType>): Promise<boolean>

      • Forms filter for InteractionCollector.

        Returns

        Function that filters out interactions.

        Parameters

        • interaction: ButtonInteraction<CacheType>

        Returns Promise<boolean>

Protected _getActionRows

  • _getActionRows(page: number): Promise<MessageActionRow<MessageButton, MessageActionRowComponentResolvable, APIActionRowComponent<APIMessageActionRowComponent>>[]>

  • Gets array of action rows for the page with specified number.

    Returns

    Array of action rows.

    Parameters

    • page: number

      Number of page.

    Returns Promise<MessageActionRow<MessageButton, MessageActionRowComponentResolvable, APIActionRowComponent<APIMessageActionRowComponent>>[]>

Private _getPageNumber

  • _getPageNumber(customId: string): Promise<number>

  • Gets page number from customId of button that was pressed.

    Returns

    Number of page.

    Parameters

    • customId: string

      CustomId of button that was pressed.

    Returns Promise<number>

Protected _setActive

  • _setActive(active?: boolean): boolean

  • Sets active state.

    Returns

    Active state.

    Parameters

    • active: boolean = true

      Whether to set pagination as active.

    Returns boolean

Protected _setCollector

  • _setCollector(collector: InteractionCollector<ButtonInteraction<CacheType>>): InteractionCollector<ButtonInteraction<CacheType>>

  • Sets collector of the pagination.

    Returns

    Collector that collects button interactions.

    Parameters

    • collector: InteractionCollector<ButtonInteraction<CacheType>>

      Collector that collects button interactions.

    Returns InteractionCollector<ButtonInteraction<CacheType>>

Protected _setCurrentPage

  • _setCurrentPage(page?: number): number

  • Sets current page number.

    Returns

    Number of the current page.

    Parameters

    • page: number = 0

      Number of the page.

    Returns number

Protected _setTime

  • _setTime(time: number): number

  • Sets life-time of pagination.

    Returns

    Time in milliseconds.

    Parameters

    • time: number

      Time in milliseconds.

    Returns number

Private _setupData

  • _setupData(data: BasePagination<T>): void

  • Setups data from another base pagination.

    Returns

    Parameters

    Returns void

Protected _stop

  • _stop(reason: string, message: Message<boolean> | Interaction<CacheType>): Promise<void>

  • Method that handles stop event.

    Returns

    Updates pagination.

    Parameters

    • reason: string

      Reason of collector's stop event.

    • message: Message<boolean> | Interaction<CacheType>

      Message that was sent or Interaction that was replied.

    Returns Promise<void>

getButtonByCustomId

insertEmbeds

  • Inserts embeds.

    Returns

    Pagination.

    Parameters

    • embeds: MessageEmbed | MessageEmbed[]

      Embed(-s) that is/are meant to be inserted.

    • Optional index: number

      Zero-based location in the array there the embed(-s) should be inserted.

    Returns BasePagination<T>

removeEmbeds

  • Removes embed(-s) by it's/theirs index(-es) in the array of embeds.

    Returns

    Pagination.

    Parameters

    • index: number

      Zero-based location in the array from which to start removing embeds.

    • count: number = 1

      Quantity of embeds to remove.

    Returns BasePagination<T>

Abstract send

  • Parameters

    • sendTo: unknown
    • Optional user: User

    Returns Promise<void>

setAfterSendingAction

setButtons

setCollectorOptions

setEmbeds

  • Sets embed(-s). Overrides current embed(-s).

    Returns

    Pagination.

    Parameters

    • embeds: MessageEmbed | MessageEmbed[]

      Embed(-s) that is/are meant to be set.

    Returns BasePagination<T>

setFilterOptions

setMessageOptions

  • Sets options for sending out message.

    Returns

    Pagination.

    Parameters

    • options: T

      Options for sending out message.

    Returns BasePagination<T>

setOnStopAction

setTime

  • Sets pagination active phase duration.

    Returns

    Pagination.

    Parameters

    • time: number

      Time in milliseconds.

    • Optional bypassLibraryLimits: boolean

      Should the time bypass library limit or not.

    Returns BasePagination<T>

Settings

Member Visibility

Theme

Generated using TypeDoc