fullcalendar/tests/automated/globals.js

// Jasmine Enhancements
// ---------------------------------------------------------------------------------------------------------------------

// like `it`, but with the ability to return a promise
window.pit = function(description, runFunc) {
  it(description, function(done) {
    runFunc().then(done)
  })
}


// Setup / Teardown
// ---------------------------------------------------------------------------------------------------------------------

window.optionsStack = null
window.currentCalendar = null


beforeEach(function() {
  window.optionsStack = []
})

afterEach(function() {
  window.optionsStack = null
  if (window.currentCalendar) {
    window.currentCalendar.destroy()
    window.currentCalendar = null
  }
  $('#calendar').remove()
})


// Calendar Options and Initialization
// ---------------------------------------------------------------------------------------------------------------------

window.pushOptions = function(options) {
  beforeEach(function() {
    return window.optionsStack.push(options)
  })
}

// called within an `it`
window.spyOnCalendarCallback = function(name, func) {
  var options = {}

  options[name] = func
  spyOn(options, name).and.callThrough()

  window.optionsStack.push(options)

  return options[name]
}

window.initCalendar = function(options, el) {
  var Calendar = $.fullCalendar.Calendar
  var $el

  if (options) {
    window.optionsStack.push(options)
  }

  if (el) {
    $el = $(el)
  } else {
    $el = $('<div id="calendar">').appendTo('body')
  }

  window.currentCalendar = new Calendar($el, getCurrentOptions()) // set the global

  return window.currentCalendar.render()
}

window.getCurrentOptions = function() {
  return $.extend.apply($, [ {} ].concat(window.optionsStack))
}


// Categorizing Tests
// ---------------------------------------------------------------------------------------------------------------------

/*
describeOptions(optionName, descriptionAndValueHash, callback)
describeOptions(descriptionAndOptionsHash, callback)
 */
window.describeOptions = function(optName, hash, callback) {
  if ($.type(optName) === 'object') {
    callback = hash
    hash = optName
    optName = null
  }

  $.each(hash, function(desc, val) {
    var opts

    if (optName) {
      opts = {}
      opts[optName] = val
    } else {
      opts = val
    }
    opts = $.extend(true, {}, opts)

    describe(desc, function() {
      pushOptions(opts)
      callback(val)
    })
  })
}

window.describeValues = function(hash, callback) {
  $.each(hash, function(desc, val) {
    describe(desc, function() {
      callback(val)
    })
  })
}


// Timezone Tests (needed?)
// ---------------------------------------------------------------------------------------------------------------------

const timezoneScenarios = {
  none: {
    description: 'when no timezone',
    value: null,
    moment: function(str) {
      return $.fullCalendar.moment.parseZone(str)
    }
  },
  local: {
    description: 'when local timezone',
    value: 'local',
    moment: function(str) {
      return moment(str)
    }
  },
  UTC: {
    description: 'when UTC timezone',
    value: 'UTC',
    moment: function(str) {
      return moment.utc(str)
    }
  }
}

window.describeTimezones = function(callback) {
  $.each(timezoneScenarios, function(name, scenario) {
    describe(scenario.description, function() {
      pushOptions({
        timezone: name
      })
      callback(scenario)
    })
  })
}

window.describeTimezone = function(name, callback) {
  var scenario = timezoneScenarios[name]

  describe(scenario.description, function() {
    pushOptions({
      timezone: name
    })
    callback(scenario)
  })
}


// Misc
// ---------------------------------------------------------------------------------------------------------------------

window.oneCall = function(func) {
  var called
  called = false
  return function() {
    if (!called) {
      called = true
      return func.apply(this, arguments)
    }
  }
}

window.spyOnMethod = function(Class, methodName, dontCallThrough) {
  var origMethod = Class.prototype.hasOwnProperty(methodName)
    ? Class.prototype[methodName]
    : null

  var spy = spyOn(Class.prototype, methodName)

  if (!dontCallThrough) {
    spy = spy.and.callThrough()
  }

  spy.restore = function() {
    if (origMethod) {
      Class.prototype[methodName] = origMethod
    } else {
      delete Class.prototype[methodName]
    }
  }

  return spy
}

// wraps an existing function in a spy, calling through to the function
window.spyCall = function(func) {
  func = func || function() {}
  const obj = { func }
  spyOn(obj, 'func').and.callThrough()
  return obj.func
}