Helpers

Search…
Helpers
A selection of useful helpers.
getLaunchParameters
This gets the launch parameters supplied in the URL. Can be used before initializing.
Example
1
import Cmi5, { LaunchParameters } from "@xapi/cmi5";
2
​
3
const cmi5 = new Cmi5();
4
​
5
const launchParameters: LaunchParameters = cmi5.getLaunchParameters();
Copied!
Returns
This returns a LaunchParameters object.
getLaunchData
This gets the launch data from the LMS. Can not be used before initializing the AU.
Example
1
import Cmi5, { LaunchData } from "@xapi/cmi5";
2
​
3
const cmi5 = new Cmi5();
4
​
5
cmi5.initialize().then(() => {
6
  const launchData: LaunchData = cmi5.getLaunchData();
7
});
Copied!
Returns
This returns a LaunchData object.
getLearnerPreferences
This gets the learner preferences from the LMS. Can not be used before initializing the AU.
Example
1
import Cmi5, { LearnerPreferences } from "@xapi/cmi5";
2
​
3
const cmi5 = new Cmi5();
4
​
5
cmi5.initialize().then(() => {
6
  const learnerPreferences: LearnerPreferences = cmi5.getLearnerPreferences();
7
});
Copied!
Cmi5.isCmiAvailable
This returns true if the environment has all the necessary parameters for initialisation.
Example
1
import Cmi5 from "@xapi/cmi5";
2
​
3
const isCmiAvailable: boolean = Cmi5.isCmiAvailable();
Copied!
Returns
This returns a Boolean.
isAuthenticated
This returns true if the instance constructed successfully.
Example
1
import Cmi5 from "@xapi/cmi5";
2
​
3
const cmi5 = new Cmi5();
4
​
5
cmi5.initialize().then(() => {
6
  const isAuthenticated: boolean = cmi5.isAuthenticated();
7
});
Copied!
Returns
This returns a Boolean.
Cmi5.instance
Creates a new Cmi5 singleton instance, or if already called returns the same singleton Cmi5 instance.
Example
1
import Cmi5 from "@xapi/cmi5";
2
​
3
const cmi5instance: Cmi5 = Cmi5.instance;
Copied!
Returns
This returns a global Cmi5 singleton instance.
Cmi5.clearInstance
Clears the Cmi5 singleton instance.
Example
1
import Cmi5 from "@xapi/cmi5";
2
​
3
const cmi5instance: Cmi5 = Cmi5.instance;
4
​
5
Cmi5.clearInstance();
Copied!
moveOn
Automatically satisfies the AU based upon the Launch Data from the LMS. It will send the "cmi5 defined" statements for:
Pass or fail if a score is provided and the mastery score is configured
complete statement
terminate statement (unless disabled in the options parameter)
Example
1
import Cmi5 from "@xapi/cmi5";
2
​
3
const cmi5 = new Cmi5();
4
​
5
// initialize etc
6
​
7
cmi5.moveOn();
Copied!
Parameters
Parameter
Type
Required
Description
options
​MoveOnOptions​
false
The additional options object.
This returns a Promise containing an array with the resulting statementIds if successful.
Cmi5.xapi
Returns the internal xAPI.js Wrapper library instance. Useful for accessing any xAPI Resources using the Cmi5 authentication. Can only be accessed after successfully calling the initialize method.
Example
1
import Cmi5 from "@xapi/cmi5";
2
import XAPI from "@xapi/xapi"; // For types as a developer dependency, not required but may be useful!
3
​
4
const cmi5: Cmi5 = new Cmi5();
5
await cmi5.initialize();
6
​
7
const xapi: XAPI = cmi5.xapi;
8
xapi.getStatement(...);
Copied!
Returns
This returns the internal XAPI instance, authenticated with the LRS endpoint and authentication token.
cmi5 Profile Library - Previous
"cmi5 allowed" Statement methods
Last modified 1yr ago