Bibliotheekmodules in webextensies
Een bibliotheekmodule is een stuk herbruikbare code die door een extensie wordt geleverd en die wordt uitgegeven in de runtimebibliotheek van de tag in Adobe Experience Platform. Deze bibliotheek wordt vervolgens op de website van de client uitgevoerd. Bijvoorbeeld een gesture gebeurtenistype heeft een bibliotheekmodule die op de website van de client wordt uitgevoerd en gebruikersbewegingen detecteert.
De module Bibliotheek is gestructureerd als een CommonJS-module. Binnen een module CommonJS, zijn de volgende variabelen beschikbaar voor gebruik:
require
A require -functie is beschikbaar voor u:
- Kernmodules geleverd door tags. Deze modules kunnen worden betreden door te gebruiken
require('@adobe/reactor-name-of-module'). Het document is beschikbaar kernmodules voor meer informatie . - Andere modules in uw extensie. Elke module in de extensie is toegankelijk via een relatief pad. Het relatieve pad moet beginnen met
./of../.
Voorbeeld:
var cookie = require('@adobe/reactor-cookie');
cookie.set('foo', 'bar');
module
Een gratis variabele met de naam module is beschikbaar waarmee u de API van de module kunt exporteren.
Voorbeeld:
module.exports = function(…) { … }
exports exports-variable
Een gratis variabele met de naam exports is beschikbaar waarmee u de API van de module kunt exporteren.
Voorbeeld:
exports.sayHello = function(…) { … }
Dit is een alternatief voor module.exports maar heeft een beperkter gebruik. Lees Het begrip module.export en de uitvoer in node.js voor een beter inzicht in de verschillen tussen module.exports en exports en de hiermee samenhangende waarschuwingen bij het gebruik exports. Als u twijfelt, maak dan uw leven makkelijker en gebruik module.exports eerder dan exports.
Uitvoering en caching
Wanneer de tagruntime-bibliotheek wordt uitgevoerd, worden de modules onmiddellijk "geïnstalleerd" en wordt de exportcache van deze modules geplaatst. Uitgaande van de volgende module:
console.log('runs on startup');
module.exports = function(settings) {
console.log('runs when necessary');
}
runs on startup wordt onmiddellijk gelogd, terwijl runs when necessary wordt alleen geregistreerd als de geëxporteerde functie wordt aangeroepen door de tagengine. Hoewel dit niet nodig kan zijn voor het doel van uw specifieke module, kunt u hiervan profiteren door de vereiste instellingen uit te voeren voordat u de functie exporteert.