docs/tests/rendering/events.js

const request = require('supertest')
const nock = require('nock')
const cheerio = require('cheerio')
const app = require('../../lib/app')

describe('POST /events', () => {
  jest.setTimeout(60 * 1000)

  let csrfToken = ''
  let agent

  beforeEach(async () => {
    process.env.AIRTABLE_API_KEY = '$AIRTABLE_API_KEY$'
    process.env.AIRTABLE_BASE_KEY = '$AIRTABLE_BASE_KEY$'
    process.env.HYDRO_SECRET = '$HYDRO_SECRET$'
    process.env.HYDRO_ENDPOINT = 'http://example.com/hydro'
    agent = request.agent(app)
    const csrfRes = await agent.get('/en')
    const $ = cheerio.load(csrfRes.text || '', { xmlMode: true })
    csrfToken = $('meta[name="csrf-token"]').attr('content')
    nock('http://example.com')
      .post('/hydro')
      .reply(200, {})
  })

  afterEach(() => {
    delete process.env.AIRTABLE_API_KEY
    delete process.env.AIRTABLE_BASE_KEY
    delete process.env.HYDRO_SECRET
    delete process.env.HYDRO_ENDPOINT
    csrfToken = ''
  })

  async function checkEvent (data, code) {
    return agent
      .post('/events')
      .send(data)
      .set('Accept', 'application/json')
      .set('csrf-token', csrfToken)
      .expect(code)
  }

  const baseExample = {
    context: {
      // Primitives
      event_id: 'a35d7f88-3f48-4f36-ad89-5e3c8ebc3df7',
      user: '703d32a8-ed0f-45f9-8d78-a913d4dc6f19',
      version: '1.0.0',
      created: '2020-10-02T17:12:18.620Z',

      // Content information
      path: '/github/docs/issues',
      hostname: 'github.com',
      referrer: 'https://github.com/github/docs',
      search: '?q=is%3Aissue+is%3Aopen+example+',
      href: 'https://github.com/github/docs/issues?q=is%3Aissue+is%3Aopen+example+',
      site_language: 'en',

      // Device information
      os: 'linux',
      os_version: '18.04',
      browser: 'chrome',
      browser_version: '85.0.4183.121',
      viewport_width: 1418,
      viewport_height: 501,

      // Location information
      timezone: -7,
      user_language: 'en-US'
    }
  }

  describe('page', () => {
    const pageExample = { ...baseExample, type: 'page' }

    it('should record a page event', () =>
      checkEvent(pageExample, 200)
    )

    it('should require a type', () =>
      checkEvent(baseExample, 400)
    )

    it('should require an event_id in uuid', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          event_id: 'asdfghjkl'
        }
      }, 400)
    )

    it('should require a user in uuid', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          user: 'asdfghjkl'
        }
      }, 400)
    )

    it('should require a version', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          version: undefined
        }
      }, 400)
    )

    it('should require created timestamp', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          timestamp: 1234
        }
      }, 400)
    )

    it('should allow page_event_id', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          page_event_id: baseExample.context.event_id
        }
      }, 200)
    )

    it('should not allow a honeypot token', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          token: 'zxcv'
        }
      }, 400)
    )

    it('should path be uri-reference', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          path: ' '
        }
      }, 400)
    )

    it('should hostname be uri-reference', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          hostname: ' '
        }
      }, 400)
    )

    it('should referrer be uri-reference', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          referrer: ' '
        }
      }, 400)
    )

    it('should search a string', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          search: 1234
        }
      }, 400)
    )

    it('should href be uri', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          href: '/example'
        }
      }, 400)
    )

    it('should site_language is a valid option', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          site_language: 'nl'
        }
      }, 400)
    )

    it('should os a valid os option', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          os: 'ubuntu'
        }
      }, 400)
    )

    it('should os_version a string', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          os_version: 25
        }
      }, 400)
    )

    it('should browser a valid option', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          browser: 'opera'
        }
      }, 400)
    )

    it('should browser_version a string', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          browser_version: 25
        }
      }, 400)
    )

    it('should viewport_width a number', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          viewport_width: -500
        }
      }, 400)
    )

    it('should viewport_height a number', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          viewport_height: '53px'
        }
      }, 400)
    )

    it('should timezone in number', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          timezone: 'GMT-0700'
        }
      }, 400)
    )

    it('should user_language is a string', () =>
      checkEvent({
        ...pageExample,
        context: {
          ...pageExample.context,
          user_language: true
        }
      }, 400)
    )
  })

  describe('exit', () => {
    const exitExample = {
      ...baseExample,
      type: 'exit',
      exit_render_duration: 0.9,
      exit_first_paint: 0.1,
      exit_dom_interactive: 0.2,
      exit_dom_complete: 0.3,
      exit_visit_duration: 5,
      exit_scroll_length: 0.5
    }

    it('should record an exit event', () =>
      checkEvent(exitExample, 200)
    )

    it('should exit_render_duration is a positive number', () =>
      checkEvent({
        ...exitExample,
        exit_render_duration: -0.5
      }, 400)
    )

    it('exit_first_paint is a number', () =>
      checkEvent({ ...exitExample, exit_first_paint: 'afjdkl' }, 400)
    )

    it('exit_dom_interactive is a number', () =>
      checkEvent({ ...exitExample, exit_dom_interactive: '202' }, 400)
    )

    it('exit_visit_duration is a number', () =>
      checkEvent({ ...exitExample, exit_visit_duration: '75' }, 400)
    )

    it('exit_scroll_length is a number between 0 and 1', () =>
      checkEvent({ ...exitExample, exit_scroll_length: 1.1 }, 400)
    )
  })

  describe('link', () => {
    const linkExample = {
      ...baseExample,
      type: 'link',
      link_url: 'https://example.com'
    }

    it('should send a link event', () =>
      checkEvent(linkExample, 200)
    )

    it('link_url is a required uri formatted string', () =>
      checkEvent({ ...linkExample, link_url: 'foo' }, 400)
    )
  })

  describe('search', () => {
    const searchExample = {
      ...baseExample,
      type: 'search',
      search_query: 'github private instances',
      search_context: 'private'
    }

    it('should record a search event', () =>
      checkEvent(searchExample, 200)
    )

    it('search_query is required string', () =>
      checkEvent({ ...searchExample, search_query: undefined }, 400)
    )

    it('search_context is optional string', () =>
      checkEvent({ ...searchExample, search_context: undefined }, 200)
    )
  })

  describe('navigate', () => {
    const navigateExample = {
      ...baseExample,
      type: 'navigate',
      navigate_label: 'drop down'
    }

    it('should record a navigate event', () =>
      checkEvent(navigateExample, 200)
    )

    it('navigate_label is optional string', () =>
      checkEvent({ ...navigateExample, navigate_label: undefined }, 200)
    )
  })

  describe('survey', () => {
    const surveyExample = {
      ...baseExample,
      type: 'survey',
      survey_vote: true,
      survey_comment: 'I love this site.',
      survey_email: 'daisy@example.com'
    }

    it('should record a survey event', () =>
      checkEvent(surveyExample, 200)
    )

    it('survey_vote is boolean', () =>
      checkEvent({ ...surveyExample, survey_vote: undefined }, 400)
    )

    it('survey_comment is string', () => {
      checkEvent({ ...surveyExample, survey_comment: 1234 }, 400)
    })

    it('survey_email is email', () => {
      checkEvent({ ...surveyExample, survey_email: 'daisy' }, 400)
    })
  })

  describe('experiment', () => {
    const experimentExample = {
      ...baseExample,
      type: 'experiment',
      experiment_name: 'change-button-copy',
      experiment_variation: 'treatment',
      experiment_success: true
    }

    it('should record an experiment event', () =>
      checkEvent(experimentExample, 200)
    )

    it('experiment_name is required string', () =>
      checkEvent({ ...experimentExample, experiment_name: undefined }, 400)
    )

    it('experiment_variation is required string', () =>
      checkEvent({ ...experimentExample, experiment_variation: undefined }, 400)
    )

    it('experiment_success is optional boolean', () =>
      checkEvent({ ...experimentExample, experiment_success: undefined }, 200)
    )
  })

  describe('redirect', () => {
    const redirectExample = {
      ...baseExample,
      type: 'redirect',
      redirect_from: 'http://example.com/a',
      redirect_to: 'http://example.com/b'
    }

    it('should record an redirect event', () =>
      checkEvent(redirectExample, 200)
    )

    it('redirect_from is required url', () =>
      checkEvent({ ...redirectExample, redirect_from: ' ' }, 400)
    )

    it('redirect_to is required url', () =>
      checkEvent({ ...redirectExample, redirect_to: undefined }, 400)
    )
  })

  describe('clipboard', () => {
    const clipboardExample = {
      ...baseExample,
      type: 'clipboard',
      clipboard_operation: 'copy'
    }

    it('should record an clipboard event', () =>
      checkEvent(clipboardExample, 200)
    )

    it('clipboard_operation is required copy, paste, cut', () =>
      checkEvent({ ...clipboardExample, clipboard_operation: 'destroy' }, 400)
    )
  })

  describe('print', () => {
    const printExample = {
      ...baseExample,
      type: 'print'
    }

    it('should record a print event', () =>
      checkEvent(printExample, 200)
    )
  })
})