bbonf/jspsych-uil-utils
A small set of utilities that can be reused throughout jsPsych style experiments.
jspsych-uil-utils
A small set of utilities that can be reused throughout jsPsych style experiments.
Introduction
In the lab we are moving research online. We use javascript in combination with
the jsPsych library: https://www.jspsych.org/ . jsPsych offers great functions
to present stimuli to the participant at their web capable device.
This library intends to add some small utility functions that can be used
throughout multiple experiments. For example in order to use the best sound
library with jsPsych we can add a function that uses the best api given the
protocol used inside of the browser file:// vs https:// or http:// .
All functions are inside a "namespace" called 'uil'. In such way that we can
directly see that it comes from our library.
For the students using our this library it might be convenient to test their
experiment using the file:// protocol, since most if not all jsPscych
documentation uses this in examples. So we choose old style modularization
instead of:
<script type="module"/>
Usage
the main file jspsych-uil-utils.js should be included after jsPsych, since
it might depend on variables defined in jsPsych.
The next example is taken from the uilots visual lexical descision with visual
prime boiler plate :
<html>
<head>
<title>My experiment title</title>
<script src="https://web-experiments.lab.hum.uu.nl/jspsych/6.1.0/jspsych.js"></script>
<script src="https://web-experiments.lab.hum.uu.nl/jspsych/6.1.0/plugins/jspsych-html-keyboard-response.js"></script>
<script src="https://web-experiments.lab.hum.uu.nl/jspsych/6.1.0/plugins/jspsych-html-button-response.js"></script>
<link href="https://web-experiments.lab.hum.uu.nl/jspsych/6.1.0/css/jspsych.css" rel="stylesheet" type="text/css"/>
<!-- Uil OTS libraries -->
<script src="https://web-experiments.lab.hum.uu.nl/jspsych-uil-utils/jspsych-uil-utils.js"></script>
<!-- Uil OTS scripts -->
<script src="stimuli.js"></script>
<script src="globals.js"></script>
<script src="instructions.js"></script>
</head>
<body>
</body>
<script>
/* Create timeline */
jsPsych.init(
{
timeline: timeline,
on_finish : function () {
uil.saveData(ACCESS_KEY);
// or to save to the acceptation server:
// uil.saveData(ACCESS_KEY, true);
}
);
</script>
</html>