Class PaginationBuilder<T>

constructor

• new PaginationBuilder<T>(options: PaginationOptions<T>): PaginationBuilder<T>

  Khởi tạo một instance PaginationBuilder

  Type Parameters

  • T

  Parameters

  • options: PaginationOptions<T>

    Cấu hình pagination

  Returns PaginationBuilder<T>

  Remarks

  Constructor này chịu trách nhiệm:

  • Lưu lại cấu hình (options)
  • Xác định nguồn dữ liệu:
    • Nếu có pages → dùng dữ liệu tĩnh
    • Nếu không → dùng pageLoader + totalPages
  • Thiết lập totalPages ban đầu

  Có 2 cách sử dụng chính:

  1. Dữ liệu tĩnh (pages)

  Khi bạn đã có sẵn toàn bộ dữ liệu:

  • pages sẽ được ưu tiên
  • totalPages được tính tự động từ pages.length

  2. Dữ liệu động (pageLoader)

  Khi dữ liệu đến từ API / database:

  • Phải cung cấp totalPages
  • pageLoader sẽ được gọi khi cần load trang

  ⚠️ Nếu không cung cấp pages và cũng không có pageLoader thì hệ thống sẽ không có nguồn dữ liệu và sẽ throw error khi chạy.

  Example

  // Dùng dữ liệu tĩnh
  const pagination = new PaginationBuilder<string>({
    pages: ["Trang 1", "Trang 2", "Trang 3"],
    renderPage: ({ data }) => ({ content: data })
  });
  Copy

  Example

  // Dùng dữ liệu động (API)
  const pagination = new PaginationBuilder<string[]>({
    totalPages: 10,
    pageLoader: async (page) => {
      const res = await fetch(`/api?page=${page + 1}`);
      const json = await res.json();
      return json.data;
    },
    renderPage: ({ data }) => ({
      content: data.join("\n")
    })
  });
  Copy

  Example

  // Dùng database (Prisma)
  const pagination = new PaginationBuilder<User[]>({
    totalPages: 20,
    pageLoader: async (page) => {
      return prisma.user.findMany({
        skip: page * 10,
        take: 10
      });
    },
    renderPage: ({ data }) => ({
      content: data.map(u => u.username).join("\n")
    })
  });
  Copy

state

clearCache

• clearCache(): void

  Xóa toàn bộ cache của pagination

  Returns void

  void

  Remarks

  Method này sẽ xóa toàn bộ dữ liệu đã cache trong pageCache.

  Cache được sử dụng khi:

  • Dùng pageLoader
  • Tránh gọi lại API nhiều lần cho cùng một page

  Dùng khi:

  • Dữ liệu backend thay đổi
  • Muốn force reload data mới
  • Debug hoặc reset state

  ⚠️ Sau khi gọi:

  • Các lần getPageData tiếp theo sẽ gọi lại pageLoader

  Example

  // Force reload data từ API
  pagination.clearCache();
  await pagination.reload();
  Copy

  Example

  // Sau khi update database
  await updateUser();
  pagination.clearCache();
  Copy

  See

  PaginationBuilder.getPageData

first

• first(
      interaction?:
          | StringSelectMenuInteraction<CacheType>
          | ButtonInteraction<CacheType>,
  ): Promise<void>

  Chuyển đến trang đầu tiên

  Parameters

  • Optionalinteraction: StringSelectMenuInteraction<CacheType> | ButtonInteraction<CacheType>

    Interaction (button hoặc select menu) nếu có

  Returns Promise<void>

  Promise

  Remarks

  Đây là method helper, thực chất gọi: goto(0)

  Dùng khi:

  • Xử lý nút "First"
  • Reset pagination về trang đầu

  Example

  await pagination.first();
  Copy

  Example

  // Reset về trang đầu sau khi filter
  await pagination.first();
  Copy

  See

  PaginationBuilder.goto

getContext

• getContext(): Promise<PaginationRenderContext<T>>

  Lấy context hiện tại của pagination

  Returns Promise<PaginationRenderContext<T>>

  Promise<PaginationRenderContext>

  Remarks

  Method này trả về object context giống như khi gọi renderPage.

  Bao gồm:

  • page: trang hiện tại
  • totalPages: tổng số trang
  • data: dữ liệu trang hiện tại
  • pagination: instance hiện tại

  Dùng khi:

  • Cần lấy data + metadata hiện tại
  • Viết logic custom ngoài pagination
  • Debug trạng thái runtime

  Example

  const ctx = await pagination.getContext();
  console.log(ctx.page, ctx.data);
  Copy

  Example

  // Dùng trong custom logic
  const { data } = await pagination.getContext();
  console.log("Current data:", data);
  Copy

  Throws

  Có thể throw nếu:

  • getPageData thất bại

  See

  PaginationRenderContext

getMessage

• getMessage(): Message<boolean>

  Lấy message hiện tại của pagination

  Returns Message<boolean>

  Message Message Discord đã được gửi

  Remarks

  Đây là message được tạo ra khi gọi start().

  ⚠️ Method này chỉ hợp lệ sau khi đã gọi start(). Nếu gọi trước đó có thể trả về undefined hoặc gây lỗi.

  Dùng khi:

  • Cần thao tác trực tiếp với message
  • Edit message ngoài pagination
  • Lấy message ID

  Example

  const msg = pagination.getMessage();
  console.log(msg.id);
  Copy

  Example

  // Edit message thủ công
  const msg = pagination.getMessage();
  await msg.edit({ content: "Updated!" });
  Copy

  Example

  // React vào message
  const msg = pagination.getMessage();
  await msg.react("👍");
  Copy

  Throws

  Có thể xảy ra lỗi nếu message chưa được khởi tạo (chưa gọi start)

  See

  PaginationBuilder.start

getPage

• getPage(): number

  Lấy số trang hiện tại

  Returns number

  number Trang hiện tại (0-based)

  Remarks

  Method này trả về index của trang hiện tại trong pagination.

  ⚠️ Giá trị trả về là 0-based:

  • Trang đầu = 0
  • Trang thứ 2 = 1

  Dùng khi:

  • Hiển thị thông tin trang
  • Logic điều kiện theo trang
  • Debug trạng thái pagination

  Example

  const page = pagination.getPage();
  console.log(`Trang hiện tại: ${page + 1}`);
  Copy

  Example

  // Kiểm tra có phải trang đầu không
  if (pagination.getPage() === 0) {
    console.log("Đang ở trang đầu");
  }
  Copy

  See

  PaginationBuilder.getTotalPages

getPageData

• getPageData(page: number): Promise<T>

  Lấy dữ liệu của một trang cụ thể

  Parameters

  • page: number

    Số trang (0-based index)

  Returns Promise<T>

  Promise Dữ liệu tương ứng với trang

  Remarks

  Đây là method core chịu trách nhiệm truy xuất dữ liệu cho pagination.

  Method này hỗ trợ 2 nguồn dữ liệu:

  • pages: dữ liệu tĩnh (array có sẵn)
  • pageLoader: dữ liệu động (load theo từng page)

  Đồng thời tích hợp cơ chế cache (nếu useCache = true) để tối ưu hiệu năng. Luồng xử lý:

  1. Dữ liệu tĩnh (pages)

  • Kiểm tra phạm vi page
  • Trả về trực tiếp pages[page]

  2. Dữ liệu động (pageLoader)

  • Nếu useCache = true và đã có cache → trả về cache (cache hit)
  • Nếu chưa có → gọi pageLoader(page) (cache miss)
  • Sau khi load xong:
    • Lưu vào cache (nếu bật cache)
    • Trả về dữ liệu

  3. Không có data source

  • Throw error

  ⚠️ Cache sử dụng Collection<number, T> với key là index của page.

  Example

  // Sử dụng dữ liệu tĩnh
  const pagination = new PaginationBuilder<string>({
    pages: ["A", "B", "C"],
    renderPage: ({ data }) => ({ content: data })
  });
  
  await pagination.getPageData(1); // "B"
  Copy

  Example

  // Sử dụng dữ liệu động + cache
  const pagination = new PaginationBuilder<string[]>({
    totalPages: 5,
    useCache: true,
    pageLoader: async (page) => {
      console.log("Loading page:", page);
      return [`Item ${page}`];
    },
    renderPage: ({ data }) => ({
      content: data.join("\n")
    })
  });
  
  await pagination.getPageData(0); // gọi pageLoader
  await pagination.getPageData(0); // dùng cache
  Copy

  Throws

  • "Trang nằm ngoài phạm vi cho phép." nếu page không hợp lệ khi dùng pages
  • "Không có nguồn dữ liệu." nếu không có cả pages và pageLoader

getTotalPages

• getTotalPages(): number

  Lấy tổng số trang

  Returns number

  number Tổng số trang

  Remarks

  Giá trị này được xác định từ:

  • pages.length (nếu dùng dữ liệu tĩnh)
  • options.totalPages (nếu dùng pageLoader)

  Dùng khi:

  • Hiển thị UI (Trang X/Y)
  • Kiểm tra giới hạn pagination
  • Logic điều hướng

  Example

  const total = pagination.getTotalPages();
  console.log(`Tổng số trang: ${total}`);
  Copy

  Example

  // Kiểm tra trang cuối
  if (pagination.getPage() === pagination.getTotalPages() - 1) {
    console.log("Đang ở trang cuối");
  }
  Copy

  See

  PaginationBuilder.getPage

goto

• goto(
      page: number,
      interaction?:
          | StringSelectMenuInteraction<CacheType>
          | ButtonInteraction<CacheType>,
  ): Promise<void>

  Chuyển đến một trang cụ thể và cập nhật message

  Parameters

  • page: number

    Số trang cần chuyển đến (0-based)

  • Optionalinteraction: StringSelectMenuInteraction<CacheType> | ButtonInteraction<CacheType>

    Interaction (button hoặc select menu) nếu có

  Returns Promise<void>

  Promise

  Remarks

  Đây là method trung tâm (core) của hệ thống pagination.

  Hầu hết các hành động điều hướng như:

  • next()
  • prev()
  • first()
  • last()
  • select menu

  đều gọi vào method này.

  Quy trình hoạt động:

  1. Chuẩn hoá page (boundary check)

  • Nếu page < 0 → set về 0
  • Nếu page >= totalPages → set về totalPages - 1

  2. Cập nhật state

  • Lưu lại oldPage
  • Gán this.page = page

  3. Lấy dữ liệu trang mới

  • Gọi getPageData(page)

  4. Render lại nội dung

  • Gọi renderPage
  • Build lại components

  5. Update message

  • Nếu có interaction → dùng interaction.update()
  • Nếu không → dùng message.edit()

  6. Trigger hook

  • Gọi onPageChange (nếu có)

  ⚠️ Method này không tạo collector mới, chỉ update UI.

  Example

  // Chuyển đến trang 2
  await pagination.goto(2);
  Copy

  Example

  // Dùng trong custom button
  onComponent: async ({ interaction, pagination }) => {
    if (interaction.customId === "go:page5") {
      await pagination.goto(4, interaction);
    }
  }
  Copy

  Example

  // Gọi từ nội bộ (next/prev)
  await pagination.next(); // thực chất gọi goto(this.page + 1)
  Copy

  Example

  // Boundary handling
  await pagination.goto(-10); // => page = 0
  await pagination.goto(999); // => page = last
  Copy

  Throws

  Có thể throw nếu:

  • getPageData thất bại (API lỗi, out of bounds,...)
  • renderPage lỗi
  • Discord API update message thất bại

  See

  • PaginationBuilder.next
  • PaginationBuilder.prev
  • PaginationBuilder.first
  • PaginationBuilder.last
  • PaginationOptions.onPageChange

isRunning

• isRunning(): boolean

  Kiểm tra trạng thái hoạt động của pagination

  Returns boolean

  boolean true nếu pagination đang chạy, ngược lại false

  Remarks

  Method này dùng để xác định xem InteractionCollector của pagination còn hoạt động hay không.

  Điều kiện để trả về true:

  • collector đã được khởi tạo
  • collector chưa bị kết thúc (ended = false)

  Dùng khi:

  • Cần kiểm tra trước khi thực hiện hành động (update, stop,...)
  • Tránh gọi method khi pagination đã dừng
  • Debug trạng thái runtime

  ⚠️ Method này không đảm bảo message còn tồn tại, chỉ kiểm tra trạng thái collector.

  Example

  if (pagination.isRunning()) {
    console.log("Pagination đang hoạt động");
  }
  Copy

  Example

  // Tránh stop nhiều lần
  if (pagination.isRunning()) {
    await pagination.stop();
  }
  Copy

  Example

  // Debug
  console.log("Running:", pagination.isRunning());
  Copy

  See

  PaginationBuilder.stop

last

• last(
      interaction?:
          | StringSelectMenuInteraction<CacheType>
          | ButtonInteraction<CacheType>,
  ): Promise<void>

  Chuyển đến trang cuối cùng

  Parameters

  • Optionalinteraction: StringSelectMenuInteraction<CacheType> | ButtonInteraction<CacheType>

    Interaction (button hoặc select menu) nếu có

  Returns Promise<void>

  Promise

  Remarks

  Đây là method helper, thực chất gọi: goto(this.totalPages - 1)

  Dùng khi:

  • Xử lý nút "Last"
  • Nhảy nhanh đến trang cuối

  Example

  await pagination.last();
  Copy

  Example

  // Jump đến trang cuối sau khi load data
  await pagination.last();
  Copy

  See

  PaginationBuilder.goto

next

• next(
      interaction?:
          | StringSelectMenuInteraction<CacheType>
          | ButtonInteraction<CacheType>,
  ): Promise<void>

  Chuyển sang trang tiếp theo

  Parameters

  • Optionalinteraction: StringSelectMenuInteraction<CacheType> | ButtonInteraction<CacheType>

    Interaction (button hoặc select menu) nếu có

  Returns Promise<void>

  Promise

  Remarks

  Đây là method helper, thực chất gọi: goto(this.page + 1)

  Dùng khi:

  • Xử lý nút "Next"
  • Điều hướng tiến lên 1 trang

  ⚠️ Nếu đang ở trang cuối:

  • Sẽ tự động giữ nguyên (do goto clamp boundary)

  Example

  await pagination.next();
  Copy

  Example

  // Dùng trong custom button
  onComponent: async ({ interaction, pagination }) => {
    if (interaction.customId === "next") {
      await pagination.next(interaction);
    }
  }
  Copy

  See

  PaginationBuilder.goto

onError

• onError(error: unknown): Promise<any>

  Xử lý lỗi phát sinh trong quá trình thực thi

  Parameters

  • error: unknown

    Đối tượng lỗi nhận được (unknown)

  Returns Promise<any>

  Giá trị trả về từ options.onError nếu được cung cấp, ngược lại sẽ trả về undefined

  Remarks

  Method này đóng vai trò là wrapper để gọi callback onError được truyền vào thông qua options.

  Nếu onError không được định nghĩa, method sẽ không thực hiện bất kỳ xử lý nào và trả về undefined.

  Method không tự xử lý hoặc log lỗi — toàn bộ logic xử lý phụ thuộc vào implementation của options.onError.

  Dùng khi:

  • Chuẩn hoá cách gọi error handler trong class
  • Tách biệt logic xử lý lỗi ra khỏi luồng chính
  • Cho phép inject custom error handler từ bên ngoài

  ⚠️ Không có cơ chế fallback nếu onError không tồn tại. Cần đảm bảo xử lý lỗi ở nơi gọi nếu cần thiết.

  Example

  await pagination.onError(new Error("Something went wrong"));
  Copy

  Example

  const pagination = new PaginationBuilder({
    onError: (err) => console.error(err),
  });
  
  await pagination.onError(new Error("Fail"));
  Copy

  Example

  // Không có onError → không có gì xảy ra
  await pagination.onError("Unknown error");
  Copy

  See

  options.onError

prev

• prev(
      interaction?:
          | StringSelectMenuInteraction<CacheType>
          | ButtonInteraction<CacheType>,
  ): Promise<void>

  Quay lại trang trước

  Parameters

  • Optionalinteraction: StringSelectMenuInteraction<CacheType> | ButtonInteraction<CacheType>

    Interaction (button hoặc select menu) nếu có

  Returns Promise<void>

  Promise

  Remarks

  Đây là method helper, thực chất gọi: goto(this.page - 1)

  Dùng khi:

  • Xử lý nút "Previous"
  • Điều hướng lùi 1 trang

  ⚠️ Nếu đang ở trang đầu:

  • Sẽ tự động giữ nguyên (do goto clamp boundary)

  Example

  await pagination.prev();
  Copy

  Example

  // Dùng trong custom button
  onComponent: async ({ interaction, pagination }) => {
    if (interaction.customId === "prev") {
      await pagination.prev(interaction);
    }
  }
  Copy

  See

  PaginationBuilder.goto

refreshComponents

• refreshComponents(): Promise<void>

  Chỉ cập nhật lại components (buttons, select menu) của message hiện tại.

  Returns Promise<void>

  Remarks

  Wrapper của reloadPartial với { components: true }.

  Method này:

  • Lấy lại data của page hiện tại
  • Build lại components
  • Gọi message.edit chỉ với components

  Không gọi renderPage, nên:

  • Content / embed giữ nguyên
  • Chỉ thay đổi UI tương tác

  Phù hợp khi:

  • Enable/disable button
  • Thay đổi label / style
  • State nội bộ ảnh hưởng UI

  Example

  pagination.state.enabled = !pagination.state.enabled;
  await pagination.refreshComponents();
  Copy

  Throws

  Khi:

  • getPageData thất bại
  • buildComponents lỗi
  • message.edit thất bại

  See

  • reloadPartial
  • reload

reload

• reload(): Promise<void>

  Re-render toàn bộ message (content + components) của trang hiện tại.

  Returns Promise<void>

  Remarks

  Wrapper của reloadPartial với { content: true, components: true }.

  Method này sẽ:

  • Lấy lại data của page hiện tại
  • Render lại nội dung (renderPage)
  • Build lại components
  • Update message thông qua message.edit

  Không thay đổi page hay trạng thái pagination.

  Example

  // Reload sau khi clear cache
  pagination.clearCache();
  await pagination.reload();
  Copy

  Example

  // Data thay đổi nhưng vẫn ở cùng page
  await updateDatabase();
  await pagination.reload();
  Copy

  Throws

  Khi:

  • getPageData thất bại
  • renderPage lỗi
  • buildComponents lỗi
  • message.edit thất bại

  See

  • reloadPartial
  • refreshComponents
  • reloadContent

reloadContent

• reloadContent(): Promise<void>

  Re-render lại nội dung (content / embed) của message hiện tại.

  Returns Promise<void>

  Remarks

  Wrapper của reloadPartial với { content: true }.

  Method này:

  • Lấy lại data của page hiện tại
  • Render lại nội dung qua renderPage
  • Update message (không bao gồm components)

  Không thay đổi:

  • Page
  • Components hiện tại

  Phù hợp khi:

  • Data thay đổi
  • Cần cập nhật nội dung nhưng giữ nguyên UI

  Example

  await pagination.reloadContent();
  Copy

  Example

  pagination.page = 1;
  await pagination.reloadContent();
  Copy

  Throws

  Khi:

  • getPageData thất bại
  • renderPage lỗi
  • message.edit thất bại

  See

  • reloadPartial
  • reload

reloadPartial

• reloadPartial(
      options: { components?: boolean; content?: boolean },
  ): Promise<void>

  Cập nhật một phần message (content và/hoặc components)

  Parameters

  • options: { components?: boolean; content?: boolean }

    Cấu hình phần cần update

    • Optionalcomponents?: boolean

      Cập nhật components (buildComponents)

    • Optionalcontent?: boolean

      Cập nhật nội dung (renderPage)

  Returns Promise<void>

  Promise

  Remarks

  Method này cho phép update riêng lẻ hoặc đồng thời:

  • Nội dung message (content)
  • Components (buttons, select menu,...)

  Flow thực thi:

  1. Nếu không có gì cần update → return sớm
  2. Lấy data hiện tại qua getPageData
  3. Thực thi song song:
     • renderPage (nếu cần content)
     • buildComponents (nếu cần components)
  4. Merge payload hợp lệ
  5. Gọi message.edit để apply thay đổi

  Khi update content:

  • Field components từ renderPage sẽ bị loại bỏ
  • Tránh conflict với components được build riêng

  Dùng khi:

  • Chỉ cần update UI một phần (tối ưu hiệu năng)
  • Tách biệt logic render content và components
  • Tránh re-render toàn bộ message không cần thiết

  ⚠️ Lưu ý:

  • Nếu cả hai option đều false hoặc không truyền → không làm gì
  • renderPage và buildComponents phải trả về dữ liệu hợp lệ
  • message phải còn tồn tại và editable

  Example

  // Chỉ update nội dung
  await pagination.reloadPartial({ content: true });
  Copy

  Example

  // Chỉ update components
  await pagination.reloadPartial({ components: true });
  Copy

  Example

  // Update cả hai (chạy song song)
  await pagination.reloadPartial({ content: true, components: true });
  Copy

  See

  • PaginationBuilder.reloadContent
  • PaginationBuilder.buildComponents

start

• start(
      source: Message<boolean> | ChatInputCommandInteraction<CacheType>,
  ): Promise<void>

  Khởi động hệ thống pagination và gửi message ban đầu

  Parameters

  • source: Message<boolean> | ChatInputCommandInteraction<CacheType>

    Message hoặc ChatInputCommandInteraction dùng để reply

  Returns Promise<void>

  Promise

  Remarks

  Đây là method entry point (điểm bắt đầu) của toàn bộ PaginationBuilder.

  Khi gọi method này, hệ thống sẽ:

  1. Lấy dữ liệu của trang đầu tiên (page = 0)
  2. Gọi renderPage để tạo nội dung message
  3. Build components (buttons, select menu,...)
  4. Gửi message (reply)
  5. Tạo InteractionCollector để lắng nghe interaction
  6. Gọi hook onStart (nếu có)

  Method này phải được gọi sau khi bạn đã cấu hình đầy đủ:

  • renderPage (bắt buộc)
  • pages hoặc pageLoader

  Nó hỗ trợ 2 nguồn gọi:

  • Message: dùng trong message command
  • ChatInputCommandInteraction: dùng trong slash command

  ⚠️ Sau khi gọi start, pagination sẽ bắt đầu hoạt động và người dùng có thể tương tác ngay lập tức.

  Example

  // Dùng với message command
  await pagination.start(message);
  Copy

  Example

  // Dùng với slash command
  await pagination.start(interaction);
  Copy

  Example

  // Ví dụ đầy đủ
  const pagination = new PaginationBuilder<string[]>({
    totalPages: 5,
    pageLoader: async (page) => {
      return Array.from({ length: 5 }, (_, i) => `Item ${page}-${i}`);
    },
    renderPage: ({ data, page, totalPages }) => ({
      content: `Trang ${page + 1}/${totalPages}\n\n` + data.join("\n")
    }),
    onStart: ({ message }) => {
      console.log("Pagination started:", message.id);
    }
  });
  
  await pagination.start(interaction);
  Copy

  Throws

  Có thể throw nếu:

  • Không có data source (pages hoặc pageLoader)
  • renderPage bị lỗi
  • Gửi message thất bại

stop

• stop(): Promise<void>

  Dừng pagination và vô hiệu hóa toàn bộ interaction

  Returns Promise<void>

  Promise

  Remarks

  Method này dùng để kết thúc vòng đời của pagination.

  Nó sẽ:

  • Dừng InteractionCollector (ngừng nhận interaction)
  • Xóa toàn bộ components khỏi message (disable UI)
  • Gọi hook onStop (nếu có)

  Dùng khi:

  • Không muốn người dùng tiếp tục tương tác
  • Command đã hoàn tất
  • Cleanup tài nguyên (collector, UI)

  ⚠️ Sau khi gọi stop():

  • Người dùng không thể click button/select menu nữa
  • Pagination được coi là "đã kết thúc"

  Hành vi lỗi

  • Nếu message.edit thất bại → sẽ được catch và chuyển sang onError
  • Không throw ra ngoài (fail-safe)

  Example

  // Dừng pagination thủ công
  await pagination.stop();
  Copy

  Example

  // Dừng sau một hành động custom
  onComponent: async ({ interaction, pagination }) => {
    if (interaction.customId === "confirm") {
      await interaction.reply("Đã xác nhận!");
      await pagination.stop();
    }
  }
  Copy

  Example

  // Auto stop sau timeout custom
  setTimeout(() => {
    pagination.stop();
  }, 30000);
  Copy

  Example

  // Hook onStop
  const pagination = new PaginationBuilder({
    ...options,
    onStop: ({ message }) => {
      console.log("Pagination stopped:", message.id);
    }
  });
  Copy

  Throws

  Method này không throw lỗi ra ngoài. Mọi lỗi sẽ được chuyển vào onError.

  See

  PaginationOptions.onError

updatePages

• updatePages(pages: T[]): Promise<void>

  Cập nhật lại toàn bộ danh sách pages (dữ liệu tĩnh) và render lại pagination

  Parameters

  • pages: T[]

    Mảng dữ liệu mới cho từng trang

  Returns Promise<void>

  Promise

  Remarks

  Method này dùng để thay thế hoàn toàn dữ liệu hiện tại (pages) và đồng bộ lại toàn bộ trạng thái pagination.

  Nó sẽ:

  • Xóa cache hiện tại (clearCache)
  • Gán lại pages
  • Cập nhật totalPages
  • Điều chỉnh lại page nếu vượt giới hạn
  • Gọi reload() để render lại message

  Dùng khi:

  • Dữ liệu thay đổi hoàn toàn (refetch, filter, search,...)
  • Chuyển từ dataset cũ sang dataset mới
  • Muốn reset pagination theo data mới

  ⚠️ Method này chỉ áp dụng cho mode pages (data tĩnh). Nếu bạn đang dùng pageLoader, nên xử lý logic ở backend hoặc dùng state + reload.

  Hành vi đặc biệt

  • Nếu page hiện tại >= totalPages mới → tự động set về trang cuối (totalPages - 1)

  Example

  // Cập nhật dữ liệu mới
  await pagination.updatePages(["A", "B", "C"]);
  Copy

  Example

  // Sau khi filter dữ liệu
  const filtered = allItems.filter(i => i.includes("test"));
  await pagination.updatePages(filtered);
  Copy

  Example

  // Reset data khi search
  pagination.state.keyword = "discord";
  const result = await fetchSearchData();
  await pagination.updatePages(result);
  Copy

  Example

  // Khi data giảm số lượng trang
  // page hiện tại = 5
  // pages mới chỉ có 2 trang
  await pagination.updatePages(["A", "B"]);
  // => page sẽ tự động về 1 (trang cuối)
  Copy

  Throws

  Có thể throw nếu:

  • reload() thất bại (renderPage lỗi, Discord API lỗi,...)

  See

  • PaginationBuilder.reload
  • PaginationBuilder.clearCache