# consent.onUpdate

{% hint style="info" %}
Méthode pour s’abonner aux mises à jour de consentement Commanders Act OnSite via JavaScript. Le Commanders Act [stub OnSite API](/fr/fonctionnalites/consent-management/onsite-api/getting-started.md) doit être installé avant d’utiliser l’une des fonctions OnSite API.
{% endhint %}

```javascript
cact('consent.onUpdate', function (result) { ... })
```

La `consent.onUpdate` la méthode permet de s’abonner à une fonction de rappel pour les mises à jour de consentement. La fonction de rappel sera appelée avec l’objet Consent mis à jour. Elle est appelée chaque fois que le consentement est modifié via une interaction avec une bannière Commanders Act ou la `consent.update` méthode de l’API OnSite.

La `consentObject` argument sera également enrichi avec une propriété supplémentaire `updateEvent` pour indiquer comment la mise à jour s’est produite. Elle peut prendre les valeurs suivantes :

| Value     | Description                                                                                                                         |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `définir` | Le consentement a été défini.                                                                                                       |
| `changed` | Le consentement était déjà établi puis a été modifié.                                                                               |
| `revoked` | Le consentement a été révoqué par l’utilisateur. Utilisé pour des tâches de nettoyage comme la suppression des identifiants cookie. |

{% hint style="info" %}
Lorsque le consentement est révoqué, deux événements sont déclenchés : un changed suivi d’un revoked.
{% endhint %}

## Exemples

### Exemple pour réagir aux modifications de consentement d’une catégorie spécifique

Dans cet exemple, la catégorie Analytics a été configurée avec l’ID de catégorie de consentement 2 dans les paramètres de consentement de Commanders Act.

```javascript
cact('consent.onUpdate', function (result) { 
    
    var ANALYTICS_ID = 2;
    var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
     
    if (analyticsCategory.status === 'on') {
    
        // Le consentement a été donné pour la catégorie. 
    
    } else {
        
        // Le consentement n’a pas été donné pour la catégorie. 
           
    }
    
});
```

### Exemple : réagir uniquement aux modifications de consentement d’une catégorie spécifique après que le consentement initial a été donné

Dans cet exemple, la catégorie Analytics a été configurée avec l’ID de catégorie de consentement 2 dans TrustCommander.

```javascript
cact('consent.onUpdate', function (result) { 

    var ANALYTICS_ID = 2;
    var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};

    if (result.updateEvent === "changed" && analyticsCategory.status === 'on') {
    
        // Le consentement a été fourni pour la catégorie pendant une mise à jour.
    
    } 
    
});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/consent-management/onsite-api/consent.onupdate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.