> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/consent-management/onsite-api/consent.onready.md).

# consent.onReady

{% hint style="info" %}
Méthode pour obtenir le consentement lorsqu’il devient disponible. The Commanders Act [stub de l'API OnSite](/fr/fonctionnalites/consent-management/onsite-api/getting-started.md) doit être installé avant d'utiliser l'une des fonctions de l'API OnSite.
{% endhint %}

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

Le `consent.onReady` La méthode permet de s’abonner à une fonction de rappel lorsque le consentement est défini. La fonction de rappel sera appelée une seule fois, avec le Consent Object 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 '`set`'.

## Exemple

### Exemple pour attendre que le consentement soit disponible 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.