jspsych 7.2.3 → 7.3.0

package/dist/index.cjs

@@ -71,7 +71,7 @@ var autoBind = (self, {include, exclude} = {}) => {
 	return self;
 };
 
-var version = "7.2.3";
+var version = "7.3.0";
 
 class MigrationError extends Error {
     constructor(message = "The global `jsPsych` variable is no longer available in jsPsych v7.") {
@@ -843,8 +843,13 @@ class MediaAPI {
         this.img_cache = {};
         this.preloadMap = new Map();
         this.microphone_recorder = null;
+        this.camera_stream = null;
+        this.camera_recorder = null;
     }
     getVideoBuffer(videoID) {
+        if (videoID.startsWith("blob:")) {
+            this.video_buffers[videoID] = videoID;
+        }
         return this.video_buffers[videoID];
     }
     initAudio() {
@@ -1086,6 +1091,17 @@ class MediaAPI {
     getMicrophoneRecorder() {
         return this.microphone_recorder;
     }
+    initializeCameraRecorder(stream, opts) {
+        this.camera_stream = stream;
+        const recorder = new MediaRecorder(stream, opts);
+        this.camera_recorder = recorder;
+    }
+    getCameraStream() {
+        return this.camera_stream;
+    }
+    getCameraRecorder() {
+        return this.camera_recorder;
+    }
 }
 
 class SimulationAPI {
@@ -2410,7 +2426,11 @@ class TimelineNode {
     // recursive downward search for active trial to extract timeline variable
     timelineVariable(variable_name) {
         if (typeof this.timeline_parameters == "undefined") {
-            return this.findTimelineVariable(variable_name);
+            const val = this.findTimelineVariable(variable_name);
+            if (typeof val === "undefined") {
+                console.warn("Timeline variable " + variable_name + " not found.");
+            }
+            return val;
         }
         else {
             // if progress.current_location is -1, then the timeline variable is being evaluated
@@ -2425,7 +2445,11 @@ class TimelineNode {
                 loc = loc - 1;
             }
             // now find the variable
-            return this.timeline_parameters.timeline[loc].timelineVariable(variable_name);
+            const val = this.timeline_parameters.timeline[loc].timelineVariable(variable_name);
+            if (typeof val === "undefined") {
+                console.warn("Timeline variable " + variable_name + " not found.");
+            }
+            return val;
         }
     }
     // recursively get all the timeline variables for this trial
@@ -2703,6 +2727,7 @@ class JsPsych {
         return this.DOM_container;
     }
     finishTrial(data = {}) {
+        var _a;
         if (this.current_trial_finished) {
             return;
         }
@@ -2743,46 +2768,58 @@ class JsPsych {
             }
         }
         // handle extension callbacks
-        if (Array.isArray(current_trial.extensions)) {
-            for (const extension of current_trial.extensions) {
-                const ext_data_values = this.extensions[extension.type.info.name].on_finish(extension.params);
-                Object.assign(trial_data_values, ext_data_values);
+        const extensionCallbackResults = ((_a = current_trial.extensions) !== null && _a !== void 0 ? _a : []).map((extension) => this.extensions[extension.type.info.name].on_finish(extension.params));
+        const onExtensionCallbacksFinished = () => {
+            // about to execute lots of callbacks, so switch context.
+            this.internal.call_immediate = true;
+            // handle callback at plugin level
+            if (typeof current_trial.on_finish === "function") {
+                current_trial.on_finish(trial_data_values);
+            }
+            // handle callback at whole-experiment level
+            this.opts.on_trial_finish(trial_data_values);
+            // after the above callbacks are complete, then the data should be finalized
+            // for this trial. call the on_data_update handler, passing in the same
+            // data object that just went through the trial's finish handlers.
+            this.opts.on_data_update(trial_data_values);
+            // done with callbacks
+            this.internal.call_immediate = false;
+            // wait for iti
+            if (this.simulation_mode === "data-only") {
+                this.nextTrial();
             }
-        }
-        // about to execute lots of callbacks, so switch context.
-        this.internal.call_immediate = true;
-        // handle callback at plugin level
-        if (typeof current_trial.on_finish === "function") {
-            current_trial.on_finish(trial_data_values);
-        }
-        // handle callback at whole-experiment level
-        this.opts.on_trial_finish(trial_data_values);
-        // after the above callbacks are complete, then the data should be finalized
-        // for this trial. call the on_data_update handler, passing in the same
-        // data object that just went through the trial's finish handlers.
-        this.opts.on_data_update(trial_data_values);
-        // done with callbacks
-        this.internal.call_immediate = false;
-        // wait for iti
-        if (this.simulation_mode === "data-only") {
-            this.nextTrial();
-        }
-        else if (typeof current_trial.post_trial_gap === null ||
-            typeof current_trial.post_trial_gap === "undefined") {
-            if (this.opts.default_iti > 0) {
-                setTimeout(this.nextTrial, this.opts.default_iti);
+            else if (typeof current_trial.post_trial_gap === null ||
+                typeof current_trial.post_trial_gap === "undefined") {
+                if (this.opts.default_iti > 0) {
+                    setTimeout(this.nextTrial, this.opts.default_iti);
+                }
+                else {
+                    this.nextTrial();
+                }
             }
             else {
-                this.nextTrial();
+                if (current_trial.post_trial_gap > 0) {
+                    setTimeout(this.nextTrial, current_trial.post_trial_gap);
+                }
+                else {
+                    this.nextTrial();
+                }
             }
+        };
+        // Strictly using Promise.resolve to turn all values into promises would be cleaner here, but it
+        // would require user test code to make the event loop tick after every simulated key press even
+        // if there are no async `on_finish` methods. Hence, in order to avoid a breaking change, we
+        // only rely on the event loop if at least one `on_finish` method returns a promise.
+        if (extensionCallbackResults.some((result) => typeof result.then === "function")) {
+            Promise.all(extensionCallbackResults.map((result) => Promise.resolve(result).then((ext_data_values) => {
+                Object.assign(trial_data_values, ext_data_values);
+            }))).then(onExtensionCallbacksFinished);
         }
         else {
-            if (current_trial.post_trial_gap > 0) {
-                setTimeout(this.nextTrial, current_trial.post_trial_gap);
-            }
-            else {
-                this.nextTrial();
+            for (const values of extensionCallbackResults) {
+                Object.assign(trial_data_values, values);
             }
+            onExtensionCallbacksFinished();
         }
     }
     endExperiment(end_message = "", data = {}) {
@@ -3070,16 +3107,16 @@ class JsPsych {
     }
     evaluateTimelineVariables(trial) {
         for (const key of Object.keys(trial)) {
-            // timeline variables on the root level
             if (typeof trial[key] === "object" &&
                 trial[key] !== null &&
                 typeof trial[key].timelineVariablePlaceholder !== "undefined") {
-                /*trial[key].toString().replace(/\s/g, "") ==
-                  "function(){returntimeline.timelineVariable(varname);}"
-              )*/ trial[key] = trial[key].timelineVariableFunction();
+                trial[key] = trial[key].timelineVariableFunction();
             }
             // timeline variables that are nested in objects
-            if (typeof trial[key] === "object" && trial[key] !== null) {
+            if (typeof trial[key] === "object" &&
+                trial[key] !== null &&
+                key !== "timeline" &&
+                key !== "timeline_variables") {
                 this.evaluateTimelineVariables(trial[key]);
             }
         }
@@ -3122,9 +3159,11 @@ class JsPsych {
         else if (typeof obj === "object") {
             if (info === null || !info.nested) {
                 for (const key of Object.keys(obj)) {
-                    if (key === "type") {
+                    if (key === "type" || key === "timeline" || key === "timeline_variables") {
                         // Ignore the object's `type` field because it contains a plugin and we do not want to
-                        // call plugin functions
+                        // call plugin functions. Also ignore `timeline` and `timeline_variables` because they
+                        // are used in the `trials` parameter of the preload plugin and we don't want to actually
+                        // evaluate those in that context.
                         continue;
                     }
                     obj[key] = this.replaceFunctionsWithValues(obj[key], null);