jasmine/src/core/Spec.js

jasmine.Spec = function(attrs) {
  this.encounteredExpectations = false;
  this.expectationFactory = attrs.expectationFactory;
  this.resultCallback = attrs.resultCallback || function() {};
  this.id = attrs.id;
  this.description = attrs.description || '';
  this.fn = attrs.fn;
  this.beforeFns = attrs.beforeFns || function() {};
  this.afterFns = attrs.afterFns || function() {};
  this.catchingExceptions = attrs.catchingExceptions;
  this.onStart = attrs.onStart || function() {};
  this.exceptionFormatter = attrs.exceptionFormatter || function() {};
  this.getSpecName = attrs.getSpecName || function() { return ''; };
  this.expectationResultFactory = attrs.expectationResultFactory || function() {};
  this.queueRunner = attrs.queueRunner || { execute: function() {}};
  this.catchingExceptions = attrs.catchingExceptions || function() { return true; };

  this.result = {
    id: this.id,
    description: this.description,
    fullName: this.getFullName(),
    status: this.status(),
    failedExpectations: []
  };
};

jasmine.Spec.prototype.addExpectationResult = function(passed, data) {
  this.encounteredExpectations = true;
  if (!passed) {
    this.result.failedExpectations.push(data);
  }
};

jasmine.Spec.prototype.expect = function(actual) {
  return this.expectationFactory(actual, this);
};

jasmine.Spec.prototype.execute = function(onComplete) {
  var self = this;

  if (this.disabled) {
    complete();
    return;
  }

  var befores = this.beforeFns() || [],
    afters = this.afterFns() || [];
  var allFns = befores.concat(this.fn).concat(afters);

  this.onStart(this);
  this.queueRunner({
    fns: allFns,
    onException: function(e) {
      self.addExpectationResult(false, self.expectationResultFactory({
        matcherName: "",
        passed: false,
        expected: "",
        actual: "",
        message: self.exceptionFormatter(e),
        trace: e
      }));
    },
    onComplete: complete
  });

  function complete() {
    self.result.status = self.status();
    self.resultCallback(self.result);

    if (onComplete) {
      onComplete();
    }
  }
};

jasmine.Spec.prototype.disable = function() {
  this.disabled = true;
};

jasmine.Spec.prototype.status = function() {
  if (this.disabled) {
    return 'disabled';
  }

  if (!this.encounteredExpectations) {
    return null;
  }

  if (this.result.failedExpectations.length > 0) {
    return 'failed';
  } else {
    return 'passed';
  }
};

jasmine.Spec.prototype.getFullName = function() {
  return this.getSpecName(this);
}