390 lines
11 KiB
JavaScript
390 lines
11 KiB
JavaScript
import {expect, assert} from 'chai';
|
|
import {describe, it, beforeEach, afterEach} from 'mocha';
|
|
import Scorm12API from '../../src/Scorm12API';
|
|
import {scorm12_constants} from '../../src/constants/api_constants';
|
|
import {scorm12_error_codes} from '../../src/constants/error_codes';
|
|
|
|
let API;
|
|
|
|
const checkFieldConstraintSize = ({fieldName, limit, expectedValue = ''}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should be able to read from ${fieldName}`, () => {
|
|
expect(eval(`API.${fieldName}`)).to.equal(expectedValue);
|
|
});
|
|
|
|
it(`Should be able to write upto ${limit} characters to ${fieldName}`,
|
|
() => {
|
|
eval(`API.${fieldName} = 'x'.repeat(${limit})`);
|
|
expect(0).to.equal(API.lastErrorCode);
|
|
});
|
|
|
|
it(`Should fail to write more than ${limit} characters to ${fieldName}`,
|
|
() => {
|
|
eval(`API.${fieldName} = 'x'.repeat(${limit + 1})`);
|
|
expect(scorm12_error_codes.TYPE_MISMATCH + '').
|
|
to.
|
|
equal(API.lastErrorCode);
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkInvalidSet = ({fieldName, expectedValue = ''}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should be able to read from ${fieldName}`, () => {
|
|
expect(eval(`API.${fieldName}`)).to.equal(expectedValue);
|
|
});
|
|
|
|
it(`Should fail to write to ${fieldName}`, () => {
|
|
eval(`API.${fieldName} = 'xxx'`);
|
|
expect(API.lastErrorCode).
|
|
to.
|
|
equal(scorm12_error_codes.INVALID_SET_VALUE + '');
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkReadOnly = ({fieldName, expectedValue = ''}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should be able to read from ${fieldName}`, () => {
|
|
expect(eval(`API.${fieldName}`)).to.equal(expectedValue);
|
|
});
|
|
|
|
it(`Should fail to write to ${fieldName}`, () => {
|
|
eval(`API.${fieldName} = 'xxx'`);
|
|
expect(API.lastErrorCode).
|
|
to.
|
|
equal(scorm12_error_codes.READ_ONLY_ELEMENT + '');
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkRead = ({fieldName, expectedValue = ''}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should be able to read from ${fieldName}`, () => {
|
|
expect(eval(`API.${fieldName}`)).to.equal(expectedValue);
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkWriteOnly = ({fieldName, valueToTest = 'xxx'}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should fail to read from ${fieldName}`, () => {
|
|
eval(`API.${fieldName}`);
|
|
expect(API.lastErrorCode).
|
|
to.
|
|
equal(scorm12_error_codes.WRITE_ONLY_ELEMENT + '');
|
|
});
|
|
|
|
it(`Should successfully write to ${fieldName}`, () => {
|
|
eval(`API.${fieldName} = '${valueToTest}'`);
|
|
expect(API.lastErrorCode).to.equal(0);
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkWrite = ({fieldName, valueToTest = 'xxx'}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
it(`Should successfully write to ${fieldName}`, () => {
|
|
eval(`API.${fieldName} = '${valueToTest}'`);
|
|
expect(API.lastErrorCode).to.equal(0);
|
|
});
|
|
});
|
|
};
|
|
|
|
const checkValidValues = ({fieldName, expectedError, validValues, invalidValues}) => {
|
|
describe(`Field: ${fieldName}`, () => {
|
|
for (const idx in validValues) {
|
|
if ({}.hasOwnProperty.call(validValues, idx)) {
|
|
it(`Should successfully write '${validValues[idx]}' to ${fieldName}`,
|
|
() => {
|
|
eval(`API.${fieldName} = '${validValues[idx]}'`);
|
|
expect(API.lastErrorCode).to.equal(0);
|
|
});
|
|
}
|
|
}
|
|
|
|
for (const idx in invalidValues) {
|
|
if ({}.hasOwnProperty.call(invalidValues, idx)) {
|
|
it(`Should fail to write '${invalidValues[idx]}' to ${fieldName}`,
|
|
() => {
|
|
eval(`API.${fieldName} = '${invalidValues[idx]}'`);
|
|
expect(API.lastErrorCode).to.equal(expectedError + '');
|
|
});
|
|
}
|
|
}
|
|
});
|
|
};
|
|
|
|
describe('SCORM 1.2 API Tests', () => {
|
|
describe('CMI Spec Tests', () => {
|
|
describe('Post-lmsInitialize Tests', () => {
|
|
beforeEach('Create the API object', () => {
|
|
API = new Scorm12API();
|
|
API.lmsInitialize();
|
|
});
|
|
afterEach('Destroy API object', () => {
|
|
API = null;
|
|
});
|
|
|
|
it('lmsInitialize should create CMI object', () => {
|
|
assert(API.cmi !== undefined, 'CMI object is created');
|
|
});
|
|
|
|
it('Exporting CMI to JSON produces proper Object', () => {
|
|
expect(
|
|
JSON.parse(API.renderCMIToJSON()).cmi?.core !== undefined,
|
|
).to.be.true;
|
|
});
|
|
|
|
/**
|
|
* Base CMI Properties
|
|
*/
|
|
checkInvalidSet({fieldName: 'cmi._version', expectedValue: '3.4'});
|
|
checkInvalidSet({
|
|
fieldName: 'cmi._children',
|
|
expectedValue: scorm12_constants.cmi_children,
|
|
});
|
|
checkFieldConstraintSize({fieldName: 'cmi.suspend_data', limit: 4096});
|
|
checkReadOnly({fieldName: 'cmi.launch_data'});
|
|
checkFieldConstraintSize({fieldName: 'cmi.comments', limit: 4096});
|
|
checkReadOnly({fieldName: 'cmi.comments_from_lms'});
|
|
|
|
/**
|
|
* cmi.core Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.core._children',
|
|
expectedValue: scorm12_constants.core_children,
|
|
});
|
|
checkReadOnly({fieldName: 'cmi.core.student_id'});
|
|
checkReadOnly({fieldName: 'cmi.core.student_name'});
|
|
checkFieldConstraintSize({
|
|
fieldName: 'cmi.core.lesson_location',
|
|
limit: 255,
|
|
});
|
|
checkReadOnly({fieldName: 'cmi.core.credit'});
|
|
checkRead({fieldName: 'cmi.core.lesson_status'});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.lesson_status',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'passed',
|
|
'completed',
|
|
'failed',
|
|
'incomplete',
|
|
'browsed',
|
|
],
|
|
invalidValues: [
|
|
'Passed',
|
|
'P',
|
|
'F',
|
|
'p',
|
|
'true',
|
|
'false',
|
|
'complete',
|
|
],
|
|
});
|
|
checkReadOnly({fieldName: 'cmi.core.entry'});
|
|
checkReadOnly({fieldName: 'cmi.core.total_time'});
|
|
checkReadOnly(
|
|
{fieldName: 'cmi.core.lesson_mode', expectedValue: 'normal'});
|
|
checkWrite({fieldName: 'cmi.core.exit', valueToTest: 'suspend'});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.exit',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'time-out',
|
|
'suspend',
|
|
'logout',
|
|
], invalidValues: [
|
|
'complete',
|
|
'exit',
|
|
],
|
|
});
|
|
checkWriteOnly({
|
|
fieldName: 'cmi.core.session_time',
|
|
valueToTest: '00:00:00',
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.session_time',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'10:06:57',
|
|
'00:00:01.56',
|
|
'23:59:59',
|
|
'47:59:59',
|
|
],
|
|
invalidValues: [
|
|
'06:5:13',
|
|
'23:59:59.123',
|
|
'P1DT23H59M59S',
|
|
],
|
|
});
|
|
|
|
/**
|
|
* cmi.core.score Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.core.score._children',
|
|
expectedValue: scorm12_constants.score_children,
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.score.raw',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [
|
|
'0',
|
|
'25.1',
|
|
'50.5',
|
|
'75',
|
|
'100',
|
|
],
|
|
invalidValues: [
|
|
'-1',
|
|
'101',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.score.min',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [
|
|
'0',
|
|
'25.1',
|
|
'50.5',
|
|
'75',
|
|
'100',
|
|
],
|
|
invalidValues: [
|
|
'-1',
|
|
'101',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.core.score.max',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [
|
|
'0',
|
|
'25.1',
|
|
'50.5',
|
|
'75',
|
|
'100',
|
|
],
|
|
invalidValues: [
|
|
'-1',
|
|
'101',
|
|
],
|
|
});
|
|
|
|
/**
|
|
* cmi.objectives Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.objectives._children',
|
|
expectedValue: scorm12_constants.objectives_children,
|
|
});
|
|
checkInvalidSet({fieldName: 'cmi.objectives._count', expectedValue: 0});
|
|
|
|
/**
|
|
* cmi.student_data Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.student_data._children',
|
|
expectedValue: scorm12_constants.student_data_children,
|
|
});
|
|
checkReadOnly({fieldName: 'cmi.student_data.mastery_score'});
|
|
checkReadOnly({fieldName: 'cmi.student_data.max_time_allowed'});
|
|
checkReadOnly({fieldName: 'cmi.student_data.time_limit_action'});
|
|
|
|
/**
|
|
* cmi.student_preference Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.student_preference._children',
|
|
expectedValue: scorm12_constants.student_preference_children,
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.audio',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'1',
|
|
'-1',
|
|
'50',
|
|
'100',
|
|
],
|
|
invalidValues: [
|
|
'invalid',
|
|
'a100',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.audio',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [],
|
|
invalidValues: [
|
|
'101',
|
|
'5000000',
|
|
'-500',
|
|
],
|
|
});
|
|
checkFieldConstraintSize({
|
|
fieldName: 'cmi.student_preference.language',
|
|
limit: 255,
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.speed',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'1',
|
|
'-100',
|
|
'50',
|
|
'100',
|
|
],
|
|
invalidValues: [
|
|
'invalid',
|
|
'a100',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.speed',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [],
|
|
invalidValues: [
|
|
'101',
|
|
'-101',
|
|
'5000000',
|
|
'-500',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.text',
|
|
expectedError: scorm12_error_codes.TYPE_MISMATCH,
|
|
validValues: [
|
|
'1',
|
|
'-1',
|
|
],
|
|
invalidValues: [
|
|
'invalid',
|
|
'a100',
|
|
],
|
|
});
|
|
checkValidValues({
|
|
fieldName: 'cmi.student_preference.text',
|
|
expectedError: scorm12_error_codes.VALUE_OUT_OF_RANGE,
|
|
validValues: [],
|
|
invalidValues: [
|
|
'2',
|
|
'-2',
|
|
],
|
|
});
|
|
|
|
/**
|
|
* cmi.interactions Properties
|
|
*/
|
|
checkInvalidSet({
|
|
fieldName: 'cmi.interactions._children',
|
|
expectedValue: scorm12_constants.interactions_children,
|
|
});
|
|
checkInvalidSet({fieldName: 'cmi.interactions._count', expectedValue: 0});
|
|
});
|
|
});
|
|
});
|