# generaltranslation: General Translation Core SDK: checkJobStatus
URL: https://generaltranslation.com/es/docs/core/class/methods/translation/check-job-status.mdx
---
title: checkJobStatus
description: Referencia de la API del método checkJobStatus para supervisar el progreso del trabajo
---

## Descripción general

El método `checkJobStatus` consulta el estado actual de uno o más trabajos del proyecto a partir de sus identificadores únicos.
Este método se usa para supervisar el progreso de operaciones asíncronas iniciadas por [`setupProject`](/docs/core/class/methods/translation/setup-project) o [`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>
  Para consultar el estado de un trabajo de configuración, primero debes llamar a [`uploadSourceFiles`](/docs/core/class/methods/translation/upload-source-files) y a [`setupProject`](/docs/core/class/methods/translation/setup-project).
</Callout>

## Referencia

### Parámetros

| Nombre       | Tipo       | Descripción                                                            |
| ------------ | ---------- | ---------------------------------------------------------------------- |
| `jobIds`     | `string[]` | Lista de identificadores únicos de trabajos que se van a comprobar     |
| `timeoutMs?` | `number`   | Tiempo de espera opcional, en milisegundos, para la solicitud a la API |

### Devuelve

`Promise<CheckJobStatusResult>` - Un lista plano de objetos de estado de trabajos.

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

Cada elemento de la lista contiene:

| Propiedad | Tipo                  | Descripción                                      |
| --------- | --------------------- | ------------------------------------------------ |
| `jobId`   | `string`              | El identificador del trabajo que se consultó     |
| `status`  | `JobStatus`           | Estado actual del trabajo                        |
| `error?`  | `{ message: string }` | Información del error si el estado es `'failed'` |

#### JobStatus

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

* `'queued'` - El trabajo está en espera de procesamiento
* `'processing'` - El trabajo se está ejecutando en este momento
* `'completed'` - El trabajo finalizó correctamente
* `'failed'` - El trabajo encontró un error y falló
* `'unknown'` - No se pudo determinar el estado del trabajo

***

## Ejemplo

### Verificación básica del estado

```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]);
```

***

## Notas

* configuración se ejecuta automáticamente cuando faltan elementos de contexto.
* configuración se encarga del análisis del corpus, la generación de contexto, la generación de glosarios, etc.
* Los IDs de trabajo se devuelven mediante [`setupProject`](/docs/core/class/methods/translation/setup-project) o [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) y deben almacenarse para consultar su estado.
* Puedes consultar varios trabajos en una sola llamada para mayor eficiencia.

## Siguientes pasos

* Consulta [`awaitJobs`](/docs/core/class/methods/translation/await-jobs) para usar el sondeo automático en lugar de comprobar el estado manualmente
* Consulta [`setupProject`](/docs/core/class/methods/translation/setup-project) para iniciar los trabajos de configuración
* Consulta [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) para continuar una vez completada la configuración
* Consulta [`getProjectData`](/docs/core/class/methods/translation/get-project-data) para obtener información del proyecto