# consent.onUpdate

{% hint style="info" %}
Méthode pour s'abonner aux mises à jour de consentement Commanders Act OnSite via JavaScript. The Commanders Act [Stub OnSite API](https://doc.commandersact.com/fr/fonctionnalites/consent-management/onsite-api/getting-started) 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 avec 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 la bannière Commanders Act ou la `consent.update` méthode de l'API OnSite.

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

| Valeur    | Description                                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `définir` | Le consentement a été défini.                                                                                                        |
| `changed` | Le consentement avait déjà été é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 d'identifiants de cookie. |

{% hint style="info" %}
Lorsque le consentement est révoqué, cela déclenche deux événements : un changed suivi d'un revoked.
{% endhint %}

## Exemples

### Exemple pour réagir aux changements de consentement d'une catégorie spécifique

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

```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é accordé pour la catégorie. 
    
    } else {
        
        // Le consentement n'a pas été accordé pour la catégorie. 
           
    }
    
});
```

### Exemple ne réagissant aux changements de consentement d'une catégorie spécifique qu'après que le consentement initial a été donné

Dans cet exemple, la catégorie Analytics a été configurée avec l'identifiant 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') {
    
        // Consent was provided for the category during an update.
    
    } 
    
});
```