consent.get

The Commanders Act OnSite API stub has to be installed before using any of the OnSite API functions.
cact('consent.get', function (result) { ... });
The consent.get method takes one callback JavaScript function as an argument that gets called with the Consent Object that is currently stored on the browser. The callback is called once after TrustCommander JavaScript loaded and validated the stored consent.
The OnSite API works asynchronous. In case you need the consent synchronous (e.g. in the <head> of a document for AB Testing or personalisation solutions) it is recommended to cache the object in the localStorage of the browser. In this case it is crucial to implement the consent.onUpdate method to keep the cached consent in sync.
Examples
Executing code based on the consent setting of a category
In this example the Analytics category was configured with the consent category id 2 in TrustCommander.
cact('consent.get', function (result) {
​
   const ANALYTICS_ID = 2;
   const analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
   
   if (analyticsCategory.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});
Executing code based on the consent setting of a category and vendor
In this example the Analytics category was configured with the consent category id 2 and the vendor Google with vendor id 5 in TrustCommander.
cact('consent.get', function (result) {
   
   const ANALYTICS_ID = 2;
   const analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
​
   const GOOGLE_ID = 5;
   const googleVendor = result.consent.vendors[GOOGLE_ID] || {};
   
   if (analyticsCategory.status === 'on' && googleVendor.status === 'on') {
         
      // Consent was provided for the category. 
      
   } else {
      
      // Consent was not provided for the category.
   
   }
        
});
Check if consent was already set by the visitor
cact('consent.get', function (result) {
   
   if (result.consent.status === 'unset') {
         
      // Consent was not yet provided.
      
   } else {
      
      // Consent was accepted or refused.
   
   }
        
});
Checking when the current consent expires
cact('consent.get', function (result) {
​
    const dateExpires = result.meta.dateExpires;
                
});

Onsite API - Previous

Getting Started

Next - Onsite API

consent.update

Last modified 1yr ago

Export as PDF

Copy link

On this page

Examples

Executing code based on the consent setting of a category

Executing code based on the consent setting of a category and vendor

Check if consent was already set by the visitor

Checking when the current consent expires