# consent.onReady

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

La `consent.onReady` méthode permettant d’abonner une fonction de callback lorsque le consentement est défini. La fonction de callback 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é donné pour la catégorie. 
    
    } else {
        
        // Le consentement n’a pas été donné 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 %}


---

# 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.onready.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.