new ATInternet.Tracker.Plugins.Storage(tag)
This plugin allows the storage of elements such as strings, tables or objects.
It uses serialization. For that reason the values must be JSON compatible.
| Name | Type | Description |
|---|---|---|
tag |
object | Instance of the Tag used |
Methods
-
cacheInvalidation()
-
Clear the cache
-
del(key)
-
Delete a data or its property
Name Type Description keystring | Array If a string, name the element you wan to create/update, if an array the first element is the data's name and the second is its property -
delPrivate(key)
-
Same as the 'del' method but for a private data linked to the current numsite
Name Type Description keystring | Array -
get(key, byPassCache){*}
-
Retrieve a stored data or a its property.
Name Type Description keystring | Array If a string, the data's name, if an array the first element is the data's name and the second is the property's name byPassCacheboolean optional If true, the value will be directly retrieved from storage Returns:
null if the element does not exist
-
getAll(){Object}
-
Retrieve all stored data.
-
getPrivate(key, byPassCache){*}
-
Same as the 'get' method but for a private stored data linked to the current numsite.
Name Type Description keystring | Array If a string, the data's name, if an array the first element is the data's name and the second is the property's name byPassCacheboolean optional If true, the value will be directly retrieved from cookie or local storage Returns:
null if the element does not exist
-
set(key, val, options, force){boolean|null}
-
Create, update or erase a stored data or its property.
Name Type Description keystring | Array If a string, name the element you want to create/update, if an array the first element is the data's name and the second is its property val* Value to save optionsobject Object which contains options. Useless if you create or update a property. forceboolean Force cookie writing when "consent page mode" is activated Returns:
true if the data has been set
Example
set('cookie', 'value', {end: '3600', domain: '.site.com', path: '/', secure: true}); set('cookie', [1, 2, 3], {end: '3600'}); set('cookie', {'myvar1': 1, 'myvar2': 2}, {session: '3600'}); set(['cookie', 'myvar2'], 3); var date = new Date; date.setMinutes(date.getMinutes() + 30); set('cookie', 'value', {end: date.getMinutes() + 30}); -
setPrivate(){boolean|null}
-
Same as the 'set' method but for a private data linked to the current numsite
Returns:
true if the data has been set
