# 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
---

## Resumen

El método `checkJobStatus` comprueba el estado actual de uno o más trabajos de un proyecto mediante sus identificadores únicos.
Este método se usa para supervisar el progreso de las 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 status = await gt.checkJobStatus(['job-123', 'job-456']);
console.log(`Job status: ${status.status}`);
```

<Callout>
  Para comprobar 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[]` | array de ID únicos de trabajo para comprobar                         |
| `timeoutMs?` | `number`   | Tiempo de espera opcional en milisegundos para la solicitud a la API |

### Devuelve

`Promise<CheckJobStatusResult>` - Contiene el estado actual del trabajo y la información asociada.

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

| Propiedad       | Tipo                  | Descripción                                      |
| --------------- | --------------------- | ------------------------------------------------ |
| `jobs`          | `object[]`            | array de objetos con el estado de los trabajos   |
| `jobs[].jobId`  | `string`              | Identificador del trabajo que se comprobó        |
| `jobs[].status` | `JobStatus`           | Estado actual del trabajo                        |
| `jobs[].error?` | `{ message: string }` | Información del error si el estado es `'failed'` |


#### JobStatus

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

* `'queued'` - El trabajo está en espera de procesamiento
* `'processing'` - El trabajo se está ejecutando
* `'completed'` - El trabajo finalizó correctamente
* `'failed'` - El trabajo encontró un error y no se completó

***


## Ejemplo

### Comprobació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.jobs.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

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

## Próximos pasos

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