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}); }); }); });