# consent.onReady

{% hint style="info" %}
Méthode pour obtenir le consentement lorsqu'il devient disponible. 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.onReady', function (result) { ... })
```

La `consent.onReady` méthode permettant de s'abonner avec une fonction de rappel lorsque le consentement est défini. La fonction de rappel sera appelée une seule fois, avec l'objet Consent mis à jour. Elle est appelée chaque fois que le consentement est défini via une interaction avec la bannière de consentement ou lorsqu'un cookie de consentement est déjà défini.

Comme dans la commande `consent.onUpdate`, le `consentObject` l'argument sera enrichi avec la propriété `updateEvent`, mais uniquement avec la valeur '`définir`'.

## Exemple

### Exemple pour attendre la disponibilité du consentement et faire quelque chose sur une catégorie spécifique

Dans cet exemple, le code attend l'interaction de l'utilisateur avec la bannière de consentement. La catégorie Analytics a été configurée avec l'id de catégorie de consentement 2 sur la bannière de confidentialité.

```javascript
cact('consent.onReady', 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. 
           
    }
    
});

```

{% hint style="warning" %}
Au niveau du container, consent.onReady ne peut pas fonctionner avec une catégorie bloquée. Les catégories bloquées sont définies dans la bannière. Pour cet usage spécifique, nous recommandons d'utiliser la méthode consent.get
{% endhint %}