@adv-ui/boros-tcf-stub

Adevinta GDPR - Transparency and Consent Framework - Stub for Boros TCF

Usage no npm install needed!

<script type="module">
  import advUiBorosTcfStub from 'https://cdn.skypack.dev/@adv-ui/boros-tcf-stub';
</script>

README

Boros TCF Stub

Build status codecov GitHub license npm version

Table of Contents

About

The Boros TCF stub implements the standard TCF v2 stub

Features

  • Registers the __tcfapiLocator frame

  • Stubs the window.__tcfapi responding immediately to the commands

  • Initializes the cross-framee communication via postMessagee, see usage details

Usage

As an importable module

Use it this way if you're generating your own initialization

Install

npm i @adv-ui/boros-tcf-stub --save

Register the Stub

import registerStub from '../main'

// do your magic
registerStub()

Register the Stub with an onReady callback

This allows creating additional commands that can have access to the Boros TCF API facade.

import registerStub from '../main'

const onReady = api => initializeCustomCommands(api)
 
registerStub({onReady})

The onReady callback will be called after Boros TCF initializes the window.__tcfapi and before processing any pending command in the stub's queue.

Remember that the Stub must be registered before any script depending on the TCF is loaded

As a standalone script

Add it to the head tag

<script
  src="https://c.dcdn.es/borostcf/stub/BorosTcfStub.pro.js"
  async="false" 
/>

This does not accept registering an onReady callback. Import the registerStub and generate your own script if it's a need.

License

Boros TCF Stub is MIT licensed.