> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-HK/llms.txt

# dataset.listVersions()

**新增於：** `@mastra/core@1.4.0`

以分頁方式列出資料集的所有版本。

## 使用範例

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

const { versions, pagination } = await dataset.listVersions({ page: 0, perPage: 10 })

for (const version of versions) {
  console.log(`Version ${version.version} created at ${version.createdAt}`)
}
```

## 參數

**page** (`number`): 頁碼。預設為 0。

**perPage** (`number`): 每頁的版本數目。預設為 20。

## 傳回值

**result** (`Promise<object>`): 分頁版本清單。

**result.versions** (`DatasetVersion[]`): 版本記錄陣列。

**result.versions.id** (`string`): 版本記錄的唯一識別碼。

**result.versions.datasetId** (`string`): 上層資料集的 ID。

**result.versions.version** (`number`): 版本號碼。

**result.versions.createdAt** (`Date`): 此版本的建立時間。

**result.pagination** (`object`): 分頁元資料。

**result.pagination.total** (`number`): 版本總數。

**result.pagination.page** (`number`): 目前頁碼。

**result.pagination.perPage** (`number | false`): 每頁版本數目；如不分頁則為 false。

**result.pagination.hasMore** (`boolean`): 是否仍有更多頁面。