Ad Tag Finder
Node.js module to identify HTTP requests made by advertising and analytics tags
Using Ad Tag Finder in conjunction with your existing browser tests lets you:
- make sure that front end changes don't break your advertising or analytics tracking
- ensure that automated browsers tests aren't artificially inflating your metrics
- be certain that no unexpected tags are making requests when your pages load
Ad Tag Finder can also help in any case where you need to identify or filter all or a subset of advertising tags.
Examples
Coming soon!Live demo
Coming soonContents
Installation
npm install @obscurity/adtagfinder
Ad Tag Finder supports and is tested on the following Node.js runtime versions:
- Current Release (9)
- Active LTS (8)
Usage
Ad Tag Finder can be used with your browser automation tool of choice. In this example, we use Puppeteer() to drive Chrome.const puppeteer = require("puppeteer");
const adtagfinder = require("@obscurity/adtagfinder");
(async () => {
const browser = await puppeteer.launch(
process.env.DEBUG ? { headless: false, slowMo: 100 } : {}
);
const page = await browser.newPage();
page.on("request", request => {
let tag = adtagfinder.identifyUrl(request.url());
if (tag) console.log(tag.name);
});
await page.goto("https://www.obscurity.ie", { waitUntil: "networkidle2" });
browser.close();
})();
API
Ad Tag Finder is very simple, and exposes three functions:identifyUrl (url)
findTagDefinition (expectedTag)
findTag (expectedTag, urls)