import { JsPsych, JsPsychPlugin, ParameterType, TrialType } from "jspsych"; const info = { name: "html-keyboard-response", parameters: { /** * The HTML string to be displayed */ stimulus: { type: ParameterType.HTML_STRING, pretty_name: "Stimulus", default: undefined, }, /** * The keys the subject is allowed to press to respond to the stimulus. */ choices: { type: ParameterType.KEY, array: true, pretty_name: "Choices", default: "ALL_KEYS", }, /** * Any content here will be displayed below the stimulus. */ prompt: { type: ParameterType.STRING, pretty_name: "Prompt", default: null, }, /** * How long to hide the stimulus. */ stimulus_duration: { type: ParameterType.INT, pretty_name: "Stimulus duration", default: null, }, /** * How long to show trial before it ends. */ trial_duration: { type: ParameterType.INT, pretty_name: "Trial duration", default: null, }, /** * If true, trial will end when subject makes a response. */ response_ends_trial: { type: ParameterType.BOOL, pretty_name: "Response ends trial", default: true, }, }, }; type Info = typeof info; /** * jspsych-html-keyboard-response * Josh de Leeuw * * plugin for displaying a stimulus and getting a keyboard response * * documentation: docs.jspsych.org * **/ class HtmlKeyboardResponsePlugin implements JsPsychPlugin { static info = info; constructor(private jsPsych: JsPsych) {} trial(display_element: HTMLElement, trial: TrialType) { var new_html = '
' + trial.stimulus + "
"; // add prompt if (trial.prompt !== null) { new_html += trial.prompt; } // draw display_element.innerHTML = new_html; // store response var response = { rt: null, key: null, }; // function to end trial when it is time const end_trial = () => { // kill any remaining setTimeout handlers this.jsPsych.pluginAPI.clearAllTimeouts(); // kill keyboard listeners if (typeof keyboardListener !== "undefined") { this.jsPsych.pluginAPI.cancelKeyboardResponse(keyboardListener); } // gather the data to store for the trial var trial_data = { rt: response.rt, stimulus: trial.stimulus, response: response.key, }; // clear the display display_element.innerHTML = ""; // move on to the next trial this.jsPsych.finishTrial(trial_data); }; // function to handle responses by the subject var after_response = function (info) { // after a valid response, the stimulus will have the CSS class 'responded' // which can be used to provide visual feedback that a response was recorded display_element.querySelector("#jspsych-html-keyboard-response-stimulus").className += " responded"; // only record the first response if (response.key == null) { response = info; } if (trial.response_ends_trial) { end_trial(); } }; // start the response listener // @ts-ignore TODO jsPsych.NO_KEYS is not an array, but `array: true` is set for the parameter. // How should we handle this? if (trial.choices != this.jsPsych.NO_KEYS) { var keyboardListener = this.jsPsych.pluginAPI.getKeyboardResponse({ callback_function: after_response, valid_responses: trial.choices, rt_method: "performance", persist: false, allow_held_key: false, }); } // hide stimulus if stimulus_duration is set if (trial.stimulus_duration !== null) { this.jsPsych.pluginAPI.setTimeout(function () { display_element.querySelector( "#jspsych-html-keyboard-response-stimulus" ).style.visibility = "hidden"; }, trial.stimulus_duration); } // end trial if trial_duration is set if (trial.trial_duration !== null) { this.jsPsych.pluginAPI.setTimeout(function () { end_trial(); }, trial.trial_duration); } } } export default HtmlKeyboardResponsePlugin;