# generaltranslation: General Translation Core SDK: checkJobStatus
URL: https://generaltranslation.com/fr/docs/core/class/methods/translation/check-job-status.mdx
---
title: checkJobStatus
description: Référence d’API pour la méthode checkJobStatus permettant de suivre l’avancement de la tâche
---

## Vue d’ensemble

La méthode `checkJobStatus` vérifie l’état actuel d’une ou de plusieurs tâches de projet à partir de leurs identifiants uniques.
Cette méthode sert à surveiller la progression des opérations asynchrones lancées par [`setupProject`](/docs/core/class/methods/translation/setup-project) ou [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files).

```typescript
const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });

const statuses = await gt.checkJobStatus(['job-123', 'job-456']);
statuses.forEach(job => console.log(`${job.jobId}: ${job.status}`));
```

<Callout>
  Pour vérifier l&#39;état d&#39;une tâche de Setup, vous devez d&#39;abord appeler les deux méthodes [`uploadSourceFiles`](/docs/core/class/methods/translation/upload-source-files) et [`setupProject`](/docs/core/class/methods/translation/setup-project).
</Callout>

## Référence

### Paramètres

| Nom          | Type       | Description                                                            |
| ------------ | ---------- | ---------------------------------------------------------------------- |
| `jobIds`     | `string[]` | Tableau des identifiants uniques des tâches à vérifier                 |
| `timeoutMs?` | `number`   | Délai d’expiration facultatif, en millisecondes, pour la requête d’API |

### Valeur de retour

`Promise<CheckJobStatusResult>` - Un tableau simple d’objets d’état de tâche.

```typescript
type CheckJobStatusResult = {
  jobId: string;
  status: JobStatus;
  error?: { message: string };
}[];
```

Chaque élément du tableau contient :

| Propriété | Type                  | Description                                              |
| --------- | --------------------- | -------------------------------------------------------- |
| `jobId`   | `string`              | L&#39;identifiant de la tâche vérifiée                   |
| `status`  | `JobStatus`           | État actuel de la tâche                                  |
| `error?`  | `{ message: string }` | Informations sur l&#39;erreur si l’état est `'failed'` |

#### JobStatus

```typescript
type JobStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'unknown';
```

* `'queued'` - La tâche est en attente de traitement
* `'processing'` - La tâche est en cours d’exécution
* `'completed'` - La tâche s’est terminée avec succès
* `'failed'` - La tâche a échoué en raison d’une erreur
* `'unknown'` - L’état de la tâche n’a pas pu être déterminé

***

## Exemple

### Vérification simple de l’état

```typescript copy
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});


const fileRefs = [
  {
    fileId: 'file-123',
    versionId: 'version-456',
    branchId: 'branch-789',
    fileName: 'app.json',
    fileFormat: 'JSON'
  },
  {
    fileId: 'file-789',
    versionId: 'version-012',
    branchId: 'branch-789',
    fileName: 'content.md',
    fileFormat: 'MD'
  }
];

const setupResult = await gt.setupProject(fileRefs);

async function pollJobStatus(jobIds: string[]) {
  const status = await gt.checkJobStatus(jobIds);

  status.forEach(job => {
    console.log(`Job ${job.jobId}:`);
    console.log(`  Status: ${job.status}`);

    if (job.error) {
      console.log(`  Error: ${job.error.message}`);
    }
  });

  return status;
}

const jobStatus = await pollJobStatus([setupResult.jobId]);
```

***

## Remarques

* Setup s’exécute automatiquement lorsqu’il manque des éléments de contexte.
* Setup se charge de l’analyse du corpus, de la génération du contexte, de la génération du glossaire, etc.
* Les identifiants de tâche sont renvoyés par [`setupProject`](/docs/core/class/methods/translation/setup-project) ou [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) et doivent être conservés pour vérifier leur état
* Vous pouvez vérifier plusieurs tâches en un seul appel, pour plus d’efficacité

## Étapes suivantes

* Voir [`awaitJobs`](/docs/core/class/methods/translation/await-jobs) pour utiliser l’interrogation automatique plutôt que des vérifications manuelles de l’état
* Voir [`setupProject`](/docs/core/class/methods/translation/setup-project) pour lancer les tâches de setup
* Voir [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) pour continuer une fois le setup terminé
* Voir [`getProjectData`](/docs/core/class/methods/translation/get-project-data) pour obtenir les informations du projet