govuk_frontend_toolkit 7.6.0 → 9.0.1

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,187 +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])
-    })
-  })
-
-  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('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]')
-    })
-  })
-})

data/app/assets/spec/unit/analytics/govuk-tracker.spec.js

@@ -1,171 +0,0 @@
-/* global describe it expect beforeEach spyOn jasmine */
-
-var $ = window.jQuery
-
-describe('GOVUK.GOVUKTracker', function () {
-  'use strict'
-  var GOVUK = window.GOVUK
-
-  var tracker
-
-  function setupFakeGa (clientId) {
-    window.ga = function (cb) {
-      cb({
-        get: function () { return clientId }
-      })
-    }
-  }
-
-  beforeEach(function () {
-    tracker = new GOVUK.GOVUKTracker('http://www.example.com/a.gif')
-  })
-
-  describe('sendData', function () {
-    it('sends the data using AJAX', function () {
-      spyOn($, 'get')
-
-      tracker.sendData({foo: 'bar'})
-      expect($.get).toHaveBeenCalledWith('http://www.example.com/a.gif?foo=bar')
-    })
-  })
-
-  describe('payloadParams', function () {
-    it('adds the event type', function () {
-      var params = tracker.payloadParams('foo', {bar: 'qux'})
-
-      expect(params.eventType).toEqual('foo')
-      expect(params.bar).toEqual('qux')
-    })
-
-    it('adds the GA Client ID', function () {
-      tracker.gaClientId = '123456.789012'
-      var params = tracker.payloadParams('foo')
-
-      expect(params.gaClientId).toEqual('123456.789012')
-    })
-
-    it('adds the referrer', function () {
-      var params = tracker.payloadParams('foo')
-
-      // Can't stub window.referrer so just test that we got a string, not undefined
-      expect(typeof params.referrer).toEqual('string')
-    })
-
-    it('adds performance data', function () {
-      var params = tracker.payloadParams('foo')
-
-      expect(params.navigationType).toEqual('0')
-      expect(params.redirectCount).toEqual('0')
-
-      expect(params.timing_domComplete).toEqual(window.performance.timing.domComplete.toString())
-    })
-
-    it('adds custom dimensions', function () {
-      tracker.setDimension(1, 'foo')
-      tracker.setDimension(10, 'bar')
-      var params = tracker.payloadParams('foo')
-
-      expect(params.dimension1).toEqual('foo')
-      expect(params.dimension10).toEqual('bar')
-    })
-
-    it('adds screen and window measurements', function () {
-      var params = tracker.payloadParams('foo')
-
-      expect(params.screenWidth).toEqual(window.screen.width)
-      expect(params.screenHeight).toEqual(window.screen.height)
-      expect(params.windowWidth).toEqual(window.innerWidth)
-      expect(params.windowHeight).toEqual(window.innerHeight)
-      expect(params.colorDepth).toEqual(window.screen.colorDepth)
-    })
-  })
-
-  describe('sendToTracker', function () {
-    it('sends when the DOM is complete', function () {
-      setupFakeGa('123456.789012')
-
-      spyOn(tracker, 'sendData')
-      tracker.sendToTracker('foo')
-
-      expect(tracker.sendData).toHaveBeenCalledWith(jasmine.any(Object))
-    })
-
-    it('sets the ga Client ID', function () {
-      setupFakeGa('123456.789012')
-
-      spyOn(tracker, 'sendData')
-      tracker.sendToTracker('foo')
-
-      expect(tracker.gaClientId).toEqual('123456.789012')
-    })
-  })
-
-  describe('tracking', function () {
-    beforeEach(function () {
-      spyOn(tracker, 'sendToTracker')
-    })
-
-    describe('when pageviews are tracked', function () {
-      it('sends them to the tracker', function () {
-        tracker.trackPageview()
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual(['pageview'])
-      })
-    })
-
-    describe('when events are tracked', function () {
-      it('sends them to the tracker', function () {
-        tracker.trackEvent('category', 'action', {label: 'label'})
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual(
-          ['event', {eventCategory: 'category', eventAction: 'action', eventLabel: 'label'}]
-        )
-      })
-
-      it('tracks custom dimensions', function () {
-        tracker.trackEvent('category', 'action', {dimension29: 'Home'})
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual(
-          ['event', {eventCategory: 'category', eventAction: 'action', dimension29: 'Home'}]
-        )
-      })
-
-      it('the label is optional', function () {
-        tracker.trackEvent('category', 'action')
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual(
-          ['event', {eventCategory: 'category', eventAction: 'action'}]
-        )
-      })
-
-      it('sends the page if supplied', function () {
-        tracker.trackEvent('category', 'action', {page: '/path/to/page'})
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual(
-          ['event', {eventCategory: 'category', eventAction: 'action', page: '/path/to/page'}]
-        )
-      })
-
-      it('tracks multiple events', function () {
-        tracker.trackEvent('category', 'action', {label: 'foo'})
-        tracker.trackEvent('category', 'action', {label: 'bar'})
-
-        expect(tracker.sendToTracker).toHaveBeenCalledWith(
-          'event', {eventCategory: 'category', eventAction: 'action', eventLabel: 'foo'}
-        )
-        expect(tracker.sendToTracker).toHaveBeenCalledWith(
-          'event', {eventCategory: 'category', eventAction: 'action', eventLabel: 'bar'}
-        )
-      })
-    })
-
-    describe('when social events are tracked', function () {
-      it('sends them to Google Analytics', function () {
-        tracker.trackSocial('network', 'action', 'target')
-        expect(tracker.sendToTracker.calls.mostRecent().args).toEqual([
-          'social',
-          {
-            'socialNetwork': 'network',
-            'socialAction': 'action',
-            'socialTarget': 'target'
-          }
-        ])
-      })
-    })
-  })
-})