---
title: Mettre à jour le statut d'une tâche
slug: oip-next/Kjnb-mettre-a-jour-le-stat
icon: {"lucideIcon":"📘"}
createdAt: 2025-12-02T12:52:47.000Z
---

# Vue d'ensemble

La mise à jour du statut d'une tâche se fait par l'envoi d'un message au processus parent.

# Envoi du message

La communication avec le processus parent se fait via la fonction suivante :

```javascript
process.send(args)
```

Le type du paramètre `args` est :

```javascript
{ action: 'cancel' | 'complete' | 'update'; error?: unknown; metadata?: object }
```

# Effets de la mise à jour

La modification du statut d’une tâche entraîne automatiquement :

- l’enregistrement d’une nouvelle entrée pour la tâche en base de données ;
- la notification de toutes les souscriptions GraphQL associées à cette tâche.

# Exemple

:::CodeblockTabs
my\_task.mjs

```javascript
import { logger } from '../server/logger.mjs';

const run = async ({ taskName, metadata }) => {
  logger.info(`Running task ${taskName} with ${JSON.stringify(metadata)}`);

  /////////
  // Step 1
  /////////
  // Update task state: step 1 has started
  process.send({ action: 'update', metadata: { status: 'step_1_started' } });
  
  // [...]
  
  // Update task state: step 1 has completed
  process.send({ action: 'update', metadata: { status: 'step_1_completed' } });
  /////////
  
  /////////  
  // Step 2
  /////////
  // Update task state: step 2 has started
  process.send({ action: 'update', metadata: { status: 'step_2_started' } });

  // [...]

  // Update task state: step 2 has completed
  process.send({ action: 'update', metadata: { status: 'step_2_completed' } });
  /////////

  /////////  
  // Step 3
  /////////
  // Update task state: the task is done
  process.send({ action: 'complete', metadata: { status: 'completed' } });
};

process.on('message', (args) => {
  run(args);
});
```
:::
