govuk_frontend_toolkit 8.2.0 → 9.0.0

data/app/assets/spec/unit/analytics/download-link-tracker.spec.js

@@ -1,72 +0,0 @@
-/* global describe it expect beforeEach afterEach spyOn */
-
-var $ = window.jQuery
-
-describe('GOVUK.analyticsPlugins.downloadLinkTracker', function () {
-  'use strict'
-  var GOVUK = window.GOVUK
-
-  var $links
-
-  beforeEach(function () {
-    $links = $(
-      '<div class="download-links">' +
-        '<a href="/one.pdf">PDF</a>' +
-        '<a href="/two.xslt">Spreadsheet</a>' +
-        '<a href="/something/uploads/system/three.doc">Document</a>' +
-        '<a href="/an/image/link.png"><img src="/img" /></a>' +
-      '</div>' +
-      '<div class="normal-links">' +
-        '<a href="/normal-link">Normal link</a>' +
-        '<a href="/another-link">Another link</a>' +
-      '</div>'
-    )
-
-    $('html').on('click', function (evt) { evt.preventDefault() })
-    $('body').append($links)
-    GOVUK.analytics = {trackEvent: function () {}}
-    GOVUK.analyticsPlugins.downloadLinkTracker({selector: 'a[href$=".pdf"], a[href$=".xslt"], a[href$=".doc"], a[href$=".png"]'})
-  })
-
-  afterEach(function () {
-    $('html').off()
-    $('body').off()
-    $links.remove()
-    delete GOVUK.analytics
-  })
-
-  it('listens to clicks on links that match the selector', function () {
-    spyOn(GOVUK.analytics, 'trackEvent')
-
-    $('.download-links a').each(function () {
-      $(this).trigger('click')
-      expect(GOVUK.analytics.trackEvent).toHaveBeenCalled()
-      GOVUK.analytics.trackEvent.calls.reset()
-    })
-
-    $('.normal-links a').each(function () {
-      $(this).trigger('click')
-      expect(GOVUK.analytics.trackEvent).not.toHaveBeenCalled()
-      GOVUK.analytics.trackEvent.calls.reset()
-    })
-  })
-
-  it('listens to click events on elements within download links', function () {
-    spyOn(GOVUK.analytics, 'trackEvent')
-
-    $('.download-links a img').trigger('click')
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith('Download Link Clicked', '/an/image/link.png', {transport: 'beacon'})
-  })
-
-  it('tracks a download link as an event with link text as the label', function () {
-    spyOn(GOVUK.analytics, 'trackEvent')
-    $('.download-links a').trigger('click')
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'Download Link Clicked', '/one.pdf', {label: 'PDF', transport: 'beacon'})
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'Download Link Clicked', '/two.xslt', {label: 'Spreadsheet', transport: 'beacon'})
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'Download Link Clicked', '/something/uploads/system/three.doc', {label: 'Document', transport: 'beacon'})
-  })
-})

data/app/assets/spec/unit/analytics/error-tracking.spec.js

@@ -1,65 +0,0 @@
-/* global describe it expect beforeEach afterEach spyOn */
-
-describe('GOVUK.analyticsPlugins.error', function () {
-  'use strict'
-  var GOVUK = window.GOVUK
-
-  GOVUK.analyticsPlugins.error({filenameMustMatch: /gov\.uk/})
-
-  beforeEach(function () {
-    GOVUK.analytics = {trackEvent: function () {}}
-    spyOn(GOVUK.analytics, 'trackEvent')
-  })
-
-  afterEach(function () {
-    delete GOVUK.analytics
-  })
-
-  it('sends errors to Google Analytics', function () {
-    triggerError('https://www.gov.uk/filename.js', 2, 'Error message')
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'JavaScript Error',
-      'Error message',
-      { label: 'https://www.gov.uk/filename.js: 2', value: 1, nonInteraction: true })
-  })
-
-  it('tracks only errors with a matching or blank filename', function () {
-    triggerError('http://www.gov.uk/somefile.js', 2, 'Error message')
-    triggerError('', 2, 'In page error')
-    triggerError('http://www.broken-external-plugin-site.com/horrible.js', 2, 'Error message')
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'JavaScript Error',
-      'Error message',
-      {
-        label: 'http://www.gov.uk/somefile.js: 2',
-        value: 1,
-        nonInteraction: true })
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'JavaScript Error',
-      'In page error',
-      {
-        label: ': 2',
-        value: 1,
-        nonInteraction: true })
-
-    expect(GOVUK.analytics.trackEvent).not.toHaveBeenCalledWith(
-      'JavaScript Error',
-      'Error message',
-      {
-        label: 'http://www.broken-external-plugin-site.com/horrible.js: 2',
-        value: 1,
-        nonInteraction: true })
-  })
-
-  function triggerError (filename, lineno, message) {
-    var event = document.createEvent('Event')
-    event.initEvent('error', true, true)
-    event.filename = filename
-    event.lineno = lineno
-    event.message = message
-    window.dispatchEvent(event)
-  }
-})

data/app/assets/spec/unit/analytics/external-link-tracker.spec.js

@@ -1,109 +0,0 @@
-/* global describe it expect beforeEach afterEach spyOn */
-
-var $ = window.jQuery
-
-describe('GOVUK.analyticsPlugins.externalLinkTracker', function () {
-  'use strict'
-  var GOVUK = window.GOVUK
-
-  var $links
-
-  beforeEach(function () {
-    $links = $(
-      '<div class="external-links">' +
-        '<a href="http://www.nationalarchives.gov.uk"> National Archives </a>' +
-        '<a href="https://www.nationalarchives.gov.uk"></a>' +
-        '<a href="https://www.nationalarchives.gov.uk/one.pdf">National Archives PDF</a>' +
-        '<a href="https://www.nationalarchives.gov.uk/an/image/link.png"><img src="/img" /></a>' +
-      '</div>' +
-      '<div class="internal-links">' +
-        '<a href="/some-path">Local link</a>' +
-        '<a href="http://fake-hostname.com/some-path">Another local link</a>' +
-      '</div>'
-    )
-
-    $('html').on('click', function (evt) { evt.preventDefault() })
-    $('body').append($links)
-    GOVUK.analytics = {
-      trackEvent: function () {},
-      setDimension: function () {}
-    }
-
-    spyOn(GOVUK.analyticsPlugins.externalLinkTracker, 'getHostname').and.returnValue('fake-hostname.com')
-  })
-
-  afterEach(function () {
-    $('html').off()
-    $('body').off()
-    $links.remove()
-    delete GOVUK.analytics
-  })
-
-  it('listens to click events on only external links', function () {
-    GOVUK.analyticsPlugins.externalLinkTracker({externalLinkUploadCustomDimension: 36})
-
-    spyOn(GOVUK.analytics, 'trackEvent')
-
-    $('.external-links a').each(function () {
-      $(this).trigger('click')
-      expect(GOVUK.analytics.trackEvent).toHaveBeenCalled()
-      GOVUK.analytics.trackEvent.calls.reset()
-    })
-
-    $('.internal-links a').each(function () {
-      $(this).trigger('click')
-      expect(GOVUK.analytics.trackEvent).not.toHaveBeenCalled()
-      GOVUK.analytics.trackEvent.calls.reset()
-    })
-  })
-
-  it('listens to click events on elements within external links', function () {
-    GOVUK.analyticsPlugins.externalLinkTracker({externalLinkUploadCustomDimension: 36})
-
-    spyOn(GOVUK.analytics, 'trackEvent')
-
-    $('.external-links a img').trigger('click')
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'https://www.nationalarchives.gov.uk/an/image/link.png', {transport: 'beacon'})
-  })
-
-  it('tracks an external link\'s href and link text', function () {
-    GOVUK.analyticsPlugins.externalLinkTracker({externalLinkUploadCustomDimension: 36})
-
-    spyOn(GOVUK.analytics, 'trackEvent')
-    $('.external-links a').trigger('click')
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'http://www.nationalarchives.gov.uk', {transport: 'beacon', label: 'National Archives'})
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'https://www.nationalarchives.gov.uk', {transport: 'beacon'})
-
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'https://www.nationalarchives.gov.uk/one.pdf', {transport: 'beacon', label: 'National Archives PDF'})
-  })
-
-  it('duplicates the url info in a custom dimension to be used to join with a Google Analytics upload', function () {
-    GOVUK.analyticsPlugins.externalLinkTracker({externalLinkUploadCustomDimension: 36})
-
-    spyOn(GOVUK.analytics, 'setDimension')
-    spyOn(GOVUK.analytics, 'trackEvent')
-    $('.external-links a').trigger('click')
-
-    expect(GOVUK.analytics.setDimension).toHaveBeenCalledWith(36, 'http://www.nationalarchives.gov.uk')
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'http://www.nationalarchives.gov.uk', {transport: 'beacon', label: 'National Archives'})
-  })
-
-  it('does not duplicate the url info if a custom dimension is not provided', function () {
-    GOVUK.analyticsPlugins.externalLinkTracker()
-
-    spyOn(GOVUK.analytics, 'setDimension')
-    spyOn(GOVUK.analytics, 'trackEvent')
-    $('.external-links a').trigger('click')
-
-    expect(GOVUK.analytics.setDimension).not.toHaveBeenCalled()
-    expect(GOVUK.analytics.trackEvent).toHaveBeenCalledWith(
-      'External Link Clicked', 'http://www.nationalarchives.gov.uk', {transport: 'beacon', label: 'National Archives'})
-  })
-})

data/app/assets/spec/unit/analytics/google-analytics-universal-tracker.spec.js

@@ -1,221 +0,0 @@
-/* global describe it expect beforeEach spyOn jasmine */
-
-var $ = window.jQuery
-
-describe('GOVUK.GoogleAnalyticsUniversalTracker', function () {
-  'use strict'
-  var GOVUK = window.GOVUK
-
-  function addGoogleAnalyticsSpy () {
-    window.ga = function () {}
-    spyOn(window, 'ga')
-  }
-
-  var universal
-  var setupArguments
-
-  beforeEach(function () {
-    addGoogleAnalyticsSpy()
-
-    universal = new GOVUK.GoogleAnalyticsUniversalTracker('id', {
-      cookieDomain: 'cookie-domain.com',
-      siteSpeedSampleRate: 100
-    })
-  })
-
-  it('can load the libraries needed to run universal Google Analytics', function () {
-    delete window.ga
-    $('[src="https://www.google-analytics.com/analytics.js"]').remove()
-    GOVUK.GoogleAnalyticsUniversalTracker.load()
-    expect($('script[async][src="https://www.google-analytics.com/analytics.js"]').length).toBe(1)
-    expect(typeof window.ga).toBe('function')
-
-    window.ga('send message')
-    expect(window.ga.q[0]).toEqual(jasmine.any(Object))
-  })
-
-  describe('when created', function () {
-    beforeEach(function () {
-      setupArguments = window.ga.calls.allArgs()
-    })
-
-    it('configures a Google tracker using the provided profile ID and config', function () {
-      expect(setupArguments[0]).toEqual(['create', 'id', {cookieDomain: 'cookie-domain.com', siteSpeedSampleRate: 100}])
-    })
-
-    it('anonymises the IP', function () {
-      expect(setupArguments[1]).toEqual(['set', 'anonymizeIp', true])
-    })
-
-    it('disables Ad features', function () {
-      expect(setupArguments[3]).toEqual(['set', 'allowAdFeatures', false])
-    })
-  })
-
-  describe('when created (with legacy non-object syntax)', function () {
-    beforeEach(function () {
-      addGoogleAnalyticsSpy()
-
-      universal = new GOVUK.GoogleAnalyticsUniversalTracker('id', 'cookie-domain.com')
-      setupArguments = window.ga.calls.allArgs()
-    })
-
-    it('configures a Google tracker using the provided profile ID and cookie domain', function () {
-      expect(setupArguments[0]).toEqual(['create', 'id', {cookieDomain: 'cookie-domain.com'}])
-    })
-  })
-
-  describe('when pageviews are tracked', function () {
-    it('sends them to Google Analytics', function () {
-      universal.trackPageview()
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', 'pageview'])
-    })
-
-    it('sends them to Google Analytics, forcing a new session', function () {
-      universal.trackPageview(undefined, undefined, { sessionControl: 'start' })
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', 'pageview', {sessionControl: 'start'}])
-    })
-
-    it('can track a virtual pageview', function () {
-      universal.trackPageview('/nicholas-page')
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', 'pageview', {page: '/nicholas-page'}])
-    })
-
-    it('can track a virtual pageview with a custom title', function () {
-      universal.trackPageview('/nicholas-page', 'Nicholas Page')
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', 'pageview', {page: '/nicholas-page', title: 'Nicholas Page'}])
-    })
-
-    it('can set the transport method on a pageview', function () {
-      universal.trackPageview('/t', 'T', {transport: 'beacon'})
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', 'pageview', {page: '/t', title: 'T', transport: 'beacon'}])
-    })
-  })
-
-  describe('when events are tracked', function () {
-    function eventObjectFromSpy () {
-      return window.ga.calls.mostRecent().args[1]
-    }
-
-    it('sends them to Google Analytics', function () {
-      universal.trackEvent('category', 'action', {label: 'label'})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {hitType: 'event', eventCategory: 'category', eventAction: 'action', eventLabel: 'label'}]
-      )
-    })
-
-    it('tracks custom dimensions', function () {
-      universal.trackEvent('category', 'action', {dimension29: 'Home'})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {hitType: 'event', eventCategory: 'category', eventAction: 'action', dimension29: 'Home'}]
-      )
-    })
-
-    it('the label is optional', function () {
-      universal.trackEvent('category', 'action')
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {hitType: 'event', eventCategory: 'category', eventAction: 'action'}]
-      )
-    })
-
-    it('the option trackerName overrides the default tracker', function () {
-      universal.trackEvent('category', 'action', {trackerName: 'testTracker'})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['testTracker.send', {hitType: 'event', eventCategory: 'category', eventAction: 'action'}]
-      )
-    })
-
-    it('only sends values if they are parseable as numbers', function () {
-      universal.trackEvent('category', 'action', {label: 'label', value: '10'})
-      expect(eventObjectFromSpy()['eventValue']).toEqual(10)
-
-      universal.trackEvent('category', 'action', {label: 'label', value: 10})
-      expect(eventObjectFromSpy()['eventValue']).toEqual(10)
-
-      universal.trackEvent('category', 'action', {label: 'label', value: 'not a number'})
-      expect(eventObjectFromSpy()['eventValue']).toEqual(undefined)
-    })
-
-    it('can mark an event as non interactive', function () {
-      universal.trackEvent('category', 'action', {label: 'label', value: 0, nonInteraction: true})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {
-          hitType: 'event',
-          eventCategory: 'category',
-          eventAction: 'action',
-          eventLabel: 'label',
-          eventValue: 0,
-          nonInteraction: 1
-        }]
-      )
-    })
-
-    it('sends the page if supplied', function () {
-      universal.trackEvent('category', 'action', {page: '/path/to/page'})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {hitType: 'event', eventCategory: 'category', eventAction: 'action', page: '/path/to/page'}]
-      )
-    })
-
-    it('can set the transport method on an event', function () {
-      universal.trackEvent('category', 'action', {transport: 'beacon'})
-      expect(window.ga.calls.mostRecent().args).toEqual(
-        ['send', {hitType: 'event', eventCategory: 'category', eventAction: 'action', transport: 'beacon'}]
-      )
-    })
-  })
-
-  describe('when social events are tracked', function () {
-    it('sends them to Google Analytics', function () {
-      universal.trackSocial('network', 'action', 'target')
-      expect(window.ga.calls.mostRecent().args).toEqual(['send', {
-        'hitType': 'social',
-        'socialNetwork': 'network',
-        'socialAction': 'action',
-        'socialTarget': 'target'
-      }])
-    })
-  })
-
-  describe('when setting a custom dimension', function () {
-    it('sends the dimension to Google Analytics with the specified index and value', function () {
-      universal.setDimension(1, 'value')
-      expect(window.ga.calls.mostRecent().args).toEqual(['set', 'dimension1', 'value'])
-    })
-
-    it('coerces the value to a string', function () {
-      universal.setDimension(1, 10)
-      expect(window.ga.calls.mostRecent().args).toEqual(['set', 'dimension1', '10'])
-    })
-  })
-
-  describe('when tracking all events', function () {
-    window.history.replaceState(null, null, '?address=an.email@digital.cabinet-office.gov.uk')
-    it('removes any email address from the location', function () {
-      expect(window.ga.calls.mostRecent().args[2]).toContain('address=[email]')
-    })
-  })
-
-  describe('adding a linked tracker', function () {
-    var callIndex
-
-    beforeEach(function () {
-      callIndex = window.ga.calls.count()
-      universal.addLinkedTrackerDomain('UA-123456', 'testTracker', 'some.service.gov.uk')
-    })
-    it('creates a tracker for the ID', function () {
-      expect(window.ga.calls.argsFor(callIndex)).toEqual(['create', 'UA-123456', 'auto', Object({ name: 'testTracker' })])
-    })
-    it('requires and configures the linker plugin', function () {
-      expect(window.ga.calls.argsFor(callIndex + 1)).toEqual(['require', 'linker'])
-      expect(window.ga.calls.argsFor(callIndex + 2)).toEqual(['testTracker.require', 'linker'])
-    })
-    it('sends a pageview', function () {
-      expect(window.ga.calls.mostRecent().args).toEqual(['testTracker.send', 'pageview'])
-    })
-    it('can omit sending a pageview', function () {
-      universal.addLinkedTrackerDomain('UA-123456', 'testTracker', 'some.service.gov.uk', false)
-      expect(window.ga.calls.mostRecent().args).not.toEqual(['testTracker.send', 'pageview'])
-    })
-  })
-})