---
title: La Subscription
slug: oip-next/ekbnuooipphb0gidinng
description: Learn how to utilize the onUpdateTaskStateHandler method in the taskHandler.mjs module to efficiently send task updates to users. This comprehensive guide demonstrates the code examples for various scenarios including initiating a start state, efficiently
icon: {"lucideIcon":"📘"}
createdAt: 2023-02-15T09:13:37.000Z
---

\*Le code fourni explique comment utiliser la méthode ****onUpdateTaskStateHandler ****dans le module \*\**taskHandler.mjs \*\*\*pour envoyer des mises à jour aux utilisateurs dans les tâches. La méthode prend un paramètre objet avec des propriétés pour l'état, l'erreur (facultatif) et les métadonnées. Les exemples de code montrent comment utiliser la méthode dans différents scénarios, tels que l'envoi d'un état de démarrage, la gestion des erreurs et l'inclusion de métadonnées supplémentaires.*

Dans vos tâches (tasks), si vous désirez envoyer un nouvel état à vos utilisateurs, vous devez appeler la méthode `onUpdateTaskStateHandler` du module `taskHandler.mjs`.

### Déclaration

```javascript
declare type UpdateStateFunction = ({ state: { status: string; statusCode: number; }; error?: string; metadata: any; }): void;
declare const onUpdateTaskStateHandler: (handler: any): UpdateStateFunction;
```

**Cas nominal :**

```javascript
const runTask = async ({ pm, taskHandler }) => {
  const updateState = onUpdateTaskStateHandler(taskHandler);
  updateState({
    state: {
      status: 'START',
      statusCode: 200,
    },
  });  // votre traitement qui prends un certain temps
  await new Promise(res => setTimeout(res, 1000));
  updateState({
    state: {
      status: 'FINISH',
      statusCode: 200,
    },
  });
};
```

**Si une erreur arrive dans l'un de vos traitement :**

```javascript
const runTask = async ({ pm, taskHandler }) => {
    const updateState = onUpdateTaskStateHandler(taskHandler); 
    updateState({
        state: {
            status: 'START',
            statusCode: 200
        }
    });
    try {
        // votre traitement est en erreur
        await Promise.reject(`Mon erreur`);
    } catch (error) {
        updateState({
            state: {
                status: 'ERROR',
                statusCode: 404,
            },
            error,
        });
    }
};
```

**Vous pouvez également envoyer des metadata supplémentaires :**

```javascript
const runTask = async ({ pm, taskHandler }) => {
  const updateState = onUpdateTaskStateHandler(taskHandler);
  const documentId = 49.3;
  updateState({
    state: {
      status: 'START',
      statusCode: 200,
    },
    metadata: {
      documentId,
    },
  });  // votre traitement qui prends un certain temps
  await new Promise(res => setTimeout(res, 1000));
  updateState({
    state: {
      status: 'FINISH',
      statusCode: 200
    },
    metadata: {
      documentId,
    },
  });
};
```
