Bibliotheksmodule in Web-Erweiterungen

Ein Bibliotheksmodul ist ein Teil des wiederverwendbaren Codes, der von einer Erweiterung bereitgestellt wird, die innerhalb der Tag-Laufzeitbibliothek in Adobe Experience Platform ausgegeben wird. Diese Bibliothek wird dann auf der Website des Kunden ausgeführt. Beispielsweise verfügt der Ereignistyp gesture über ein Bibliotheksmodul, das auf der Website des Client ausgeführt wird und Benutzergesten erkennt.

Das Bibliotheksmodul hat die Struktur eines CommonJS-Moduls. In einem CommonJS-Modul stehen die folgenden Variablen zur Verwendung zur Verfügung:

require

Die Funktion require ist verfügbar zum Zugriff auf:

1. Hauptmodule, die von Tags bereitgestellt werden. Auf diese Module kann mit require('@adobe/reactor-name-of-module') zugegriffen werden. Weitere Informationen finden Sie im Dokument zu verfügbaren Hauptmodulen.
2. Andere Module in Ihrer Erweiterung. Über einen relativen Pfad kann auf jedes Modul in Ihrer Erweiterung zugegriffen werden. Der relative Pfad muss mit ./ oder ../ beginnen.

Beispiel:

var cookie = require('@adobe/reactor-cookie');
cookie.set('foo', 'bar');

module

Es ist eine freie Variable namens module verfügbar, mit der Sie die API des Moduls exportieren können.

Beispiel:

module.exports = function(…) { … }

exports

Es ist eine freie Variable namens exports verfügbar, mit der Sie die API des Moduls exportieren können.

Beispiel:

exports.sayHello = function(…) { … }

Dies ist eine Alternative zu module.exports, die in ihrer Verwendung jedoch eingeschränkter ist. Lesen Sie Understanding module.exports and exports in node.js, um die Unterschiede zwischen module.exports und exports sowie die mit der Verwendung von exports verbundenen Vorbehalte besser zu verstehen. Im Zweifelsfall verwenden Sie module.exports statt exports, da dies einfacher ist.

Ausführung und Caching

Wenn die Tag-Laufzeitbibliothek ausgeführt wird, werden die Module sofort „installiert“ und ihre Exporte zwischengespeichert. Angenommen, Sie haben folgendes Modul:

console.log('runs on startup');

module.exports = function(settings) {
  console.log('runs when necessary');
}

runs on startup wird sofort protokolliert, während runs when necessary erst protokolliert wird, wenn die exportierte Funktion von der Tag-Engine aufgerufen wird. Obwohl dies für die Zwecke Ihres speziellen Moduls möglicherweise nicht erforderlich ist, können Sie es nutzen, indem Sie vor dem Exportieren der Funktion alle erforderlichen Einstellungen vornehmen.