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

# dataset.listExperimentResults()

**Ajouté dans :** `@mastra/core@1.4.0`

Répertorie les résultats de chaque élément pour une expérience précise, avec des filtres et une pagination facultatifs. Les filtres sont appliqués au niveau de la couche de stockage.

## Exemple d'utilisation

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

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

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

const { results, pagination } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  page: 0,
  perPage: 50,
})

// Restrict to results that still need review
const { results: pending } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  status: 'needs-review',
})

// Restrict to results tied to a specific trace
const { results: byTrace } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  traceId: 'trace-abc',
})

for (const result of results) {
  console.log(`Item ${result.itemId}: ${result.error ? 'FAILED' : 'OK'}`)
}
```

## Paramètres

**experimentId** (`string`): Identifiant de l'expérience dont les résultats doivent être répertoriés.

**traceId** (`string`): Limite les résultats à ceux qui sont associés à cet identifiant de Trace.

**status** (`'needs-review' | 'reviewed' | 'complete'`): Limite les résultats à ce statut de vérification individuel.

**filters** (`ExperimentTenancyFilters`): Filtres de portée multilocataire (organizationId, projectId). Transmis à la couche de stockage.

**page** (`number`): Numéro de page. La valeur par défaut est 0.

**perPage** (`number`): Nombre de résultats par page. La valeur par défaut est 20.

## Valeur renvoyée

**result** (`Promise<object>`): Résultats paginés de l'expérience.

**result.results** (`ExperimentResult[]`): Tableau des résultats individuels des éléments.

**result.results.id** (`string`): Identifiant unique du résultat.

**result.results.experimentId** (`string`): Identifiant de l'expérience parente.

**result.results.itemId** (`string`): Identifiant de l'élément du Dataset.

**result.results.itemDatasetVersion** (`number | null`): Version du Dataset de l'élément au moment de l'exécution.

**result.results.input** (`unknown`): Données d'entrée transmises à la cible.

**result.results.output** (`unknown | null`): Sortie de la cible.

**result.results.groundTruth** (`unknown | null`): Sortie attendue.

**result.results.error** (`{ message: string; stack?: string; code?: string } | null`): Erreur structurée en cas d'échec de l'exécution.

**result.results.startedAt** (`Date`): Date et heure du début de l'exécution.

**result.results.completedAt** (`Date`): Date et heure de la fin de l'exécution.

**result.results.retryCount** (`number`): Nombre de nouvelles tentatives.

**result.results.traceId** (`string | null`): Identifiant de Trace pour l'observabilité.

**result.results.createdAt** (`Date`): Date et heure de création de l'enregistrement du résultat.

**result.pagination** (`PaginationInfo`): Métadonnées de pagination contenant total, page, perPage et hasMore.