Recent releases for jsPsych

jsPsych v1.54

2013-10-14T19:02:45+00:00

jsPsych v1.6

2013-11-12T19:08:35+00:00

This version adds a few new features to the core library. - jsPsych.preloadImages() is a built in image pre-loader with callback function options. - jsPsych.dataAsCSV() will return the jsPsych data object as a string of CSV formatted data. - jsPsych.saveCSVdata() will download the CSV formatted data. As of 11/12/2013 this only works in updated versions of Chrome and Firefox. In addition, numerous minor bug fixes and improvements were made over previous release versions.

jsPsych v1.7

2013-12-07T20:09:34+00:00

Two major features are added with this release: - The core library has a new method, jsPsych.turkInfo(), which simplifies some of the coding involved in creating a mechanical turk experiment. See the core library api wiki page for documentation. - The categorize-animation plugin has moved out of the /dev folder and into the main plugins folder, reflecting a set of changes to make the plugin ready for release. A few minor bug fixes as well, including: - The same-different plugin was recording stimulus paths using a_path and b_path as labels. Updated this to the more descriptive names stimulus and stimulus_2. - Problems in the single-stim plugin when continue_after_response was set to false have been resolved. This behavior now works as intended.

jsPsych v1.8

2013-12-10T18:36:22+00:00

The similarity plugin was adjusted to have a number of new options for controlling the flow of the trial.

jsPsych v1.8.1-fix

2014-01-13T23:09:50+00:00

The animation plugin has new options and records additional data. Changes are backwards compatible.

jsPsych v2.0-hotfix.1

2014-01-29T17:53:47+00:00

The main reason this release is version 2 as opposed to v1.+ is to introduce a more consistent version naming scheme for releases. Early on in development I did not follow semantic versioning particularly well, which means that the v1.+ releases are a bit confusing. From here on out, version numbers will be consistent. There are three different issues that were addressed for this release. - timing_post_trial values of 0 will no longer cause unpredictable behavior. Plugins will immediately call `block.next()` (and thus advance to the next trial) as soon as possible when values of 0 are set. - Keyboard responses are now recorded on keydown instead of keyup. This removes some of the variability in RT measures, since people may hold down the key for different lengths of time after making a response. - All CSS classes and IDs are now prefixed with `jspsych-plugin-name` to reduce possible conflicts with other elements on the page.

jsPsych v2.1

2014-02-13T03:04:18+00:00

Adding new plugin: VSL-animate-occlusion. This plugin is for showing sequences of shapes in the same manner as Experiment 1 in Fiser, J., & Aslin, R. N. (2002). Statistical learning of higher-order temporal structure from visual shape sequences. _Journal of Experimental Psychology: Learning, Memory, and Cognition, 28_(3), 458.

jsPsych v2.1.1

2014-02-13T16:42:01+00:00

Fixes an issue where the transition between stimuli could become slightly out of sync with the animation in vsl-animate-occlusion.

jsPsych v2.2

2014-02-23T17:45:21+00:00

This release adds a new plugin, [jspsych-vsl-grid-scene](https://github.com/jodeleeuw/jsPsych/wiki/jspsych-vsl-grid-scene). This plugin is currently unique in that it provides both a new trial type, and also a means for creating a particular kind of stimulus. This design pattern will be adopted by other plugins that create unique stimuli in the future.

jsPsych v2.3

2014-05-01T18:07:21+00:00

Several changes: - The barely-used jspsych-utils.js file was removed, and functions contained within were migrated to other parts of the code. In particular, instead of including stimulus generation methods within the utils file, they are now contained within the relevant plugin. This means that some plugins, jspsych-palmer and jspsych-vsl-grid-scene, can be used solely for generating stimuli. - Fixed a few bugs related to element IDs. - Trial parameters for most plugins can now be passed in as functions. See [this wiki page](https://github.com/jodeleeuw/jsPsych/wiki/Functions-as-Trial-Parameters) for more information. - Citation info was added in the README file. - The vsl-animate-occlusion plugin can now collect responses while the animation is playing.

jsPsych v2.3.1

2014-05-14T16:52:40+00:00

- Fixed a bug in the html plugin where the check function would get called at the start of the trial as opposed to the end of the trial. - The preloadImages method in the core library will now accept nested arrays for image paths, and auto-flatten them for preloading.

jsPsych v2.3.2

2014-05-15T18:32:25+00:00

- Updated the normalizeTrialVariables method in the core library to allow for some variables to be protected, and thus preserve their status as functions. This was crucial for the HTML plugin, which needs a function parameter to check if the consent form has been correctly filled out. This change is only relevant for developing plugins (it provides more options on how to treat trial parameters) and for people who are using the HTML plugin in v2.3 and v2.3.1

jsPsych v2.4

2014-05-23T15:24:45+00:00

- Removed /dev folder from plugins directory. All /dev content can be found on the plugin-dev-old branch. As plugins from the /dev folder are updated and tested, they will be merged into the main repository branch. - Added enforceArray method to the core library, to handle cases where blocks have a single trial and therefore the array specification for certain trial parameters is tedious. Currently, only the text plugin has been modified to take advantage of this method. Other plugins will be updated soon. - The variables parameter was removed from the text plugin, since passing the parameter value as a function can achieve the same purpose and is easier to understand.

jsPsych v3.0

2014-07-09T16:10:29+00:00

This is a major update that changes the API of the core library, adds several new features, and contains bug fixes. - Functions in the core library have been organized into modules. All functions that are critical for running an experiment are still scoped to the base jsPsych object, i.e. `jsPsych.init()`, while plugins that offer optional features have been moved into modules off the base object. The four modules are: `jsPsych.dataAPI`, `jsPsych.pluginAPI`, `jsPsych.randomization`, and `jsPsych.turk`. Several new functions were added. More information on the functions contained within the modules is available on the project wiki. - A basic style sheet has been added to the project. Adding this CSS file will add minimal styling to make jsPsych experiments look polished without any additional style rules. - A new plugin, jspsych-visual-search-circle, has been added. This plugin can be used for running simple visual search experiments where the stimuli are presented equidistant from a fixation point.

jsPsych v3.1-hotfix.2

2014-07-16T17:49:18+00:00

- Adds the jsPsych.dataAPI.displayData method, which is a simple way to view data in the browser for testing purposes. - A few assorted bug fixes related to the introduction of modules in the core library with v3.0

jsPsych v4.0

2014-10-21T17:53:27+00:00

jsPsych version 4.0 This is a major update that contains a number of new features, updates, and bug fixes. - A new documentation site has been built, at [http://docs.jspsych.org](http://docs.jspsych.org). Documentation files are now included in the GitHub repository, in the docs directory. - Looping and conditional designs are now possible, using the new chunk structure. See the documentation for more details. - A progress bar can be automatically generated for an experiment and displayed at the top of the page. See the documentation for more details. - Callback functions can be specified at the block level. - Added support for randomizing and repeating trials within a block. - The dataAPI module has been renamed data and several new functions were added. See the documentation for more details. - Improvements were made to the process of creating plugins, by centralizing some of the parameters that are used in all plugins, and removing un-necessary parameters to the plugin.trial method. - A set of default data is now collected for every plugin. - Many minor changes were made to plugins to fix various bugs and make improvements.

jsPsych v4.0.1

2014-11-10T14:18:03+00:00

This is a minor update that fixes a few bugs identified in version 4.0. - The jsPsych.data.dataAsCSV method and other CSV related functions were broken after the 4.0 update. This fixes those issues. - The default value for the `choices` parameter in the single-stim plugin has been fixed - There was an error in saving responses in the single-stim plugin under certain configurations of the parameters. This release also adds a new plugin, multi-stim-multi-response. This plugin is a more general version of the single-stim plugin. It allows for displaying multiple stimuli in a trial and collecting more than one response per trial.

jsPsych v4.1

2015-02-19T17:42:49+00:00

### Major changes - There is now a plugin for playing audio files: jspsych-single-audio. The plugin uses the WebAudio API, which allows for relatively precise control over the timing. To support this plugin, several changes and additions were made to the main jspsych.js library. Audio files are automatically preloaded when used with this plugin. - All raphael.js dependencies have been migrated to the snap.svg library. - A new plugin, jspsych-reconstruction, was added. This plugin allows subjects to interact with a dynamic stimulus to adjust a parameter value. - A folder called tests&examples was added to the repository. It contains simple examples for each of the plugins for both testing and instructional purposes. - A new method called jsPsych.randomization.sample was added to allow for sampling with and without replacement from an array. ### Minor changes - The same-different, xab, and similarity plugins were modified so that they record the stimulus in a single field in the data. - The dataAsCSV() function was fixed after being broken in version 4.0. - The displayData() function will no longer render HTML content on the screen. - The survey-text and survey-likert plugins now support a parameter called 'preamble' which allows for additional content to be shown at the top of the page. - The single-stim plugin now allows for the choices parameter to be set to 'none', which disables responding. - The check_fn parameter in the HTML plugin now has a default value that always returns true. - Bug fixes in the categorize, categorize-animation, and visual-search-circle plugins.

jsPsych v4.2-hotfix.4

2015-06-08T16:40:52+00:00

## Major Changes - There is a new plugin for displaying instructions to subjects. The plugin allows subjects to navigate forward and backward through multi-page instructions, using the keyboard or a mouse. - Data can now be appended to multiple trials at the chunk level - The on_finish parameter for trials now receives data from the trial as a parameter - Two methods added for navigating through the experiment: endExperiment ends an experiment immediately; endCurrentChunk ends the current chunk immediately. - Additional documentation added about data parameters, creating a new plugin, and default data collected by plugins - New method jsPsych.data.addProperties allows for data to be added to all trials, such as a subject ID or condition assignment. - New method to get data from a particular trial by trial index. - Internal handling of data and timing_post_trial parameters has been centralized, so plugin development no longer needs to worry about implementing those parameters. ## Minor Changes - pluginAPI.normalizeTrialVariables renamed to pluginAPI.evaluateFunctionParameters - rt value in single-audio plugin is now reported in ms instead of seconds. - multiple uses of the same audio file will no longer cause the audio file to be loaded multiple times. - bug in which localSave method didn't work with JSON formatted data is fixed - More informative error messages for some common mistakes - continue_after_response parameter has been renamed to response_ends_trial in all plugins that use it

jsPsych v4.3

2015-06-27T00:56:46+00:00

# Changes - jsPsych.pluginAPI.getKeyboardResponse has been redesigned to enable prevention of held down keys if desired. Plugins have been adjusted to take advantage of this new feature. The parameters for the method have been changed, and plugin developers should consult the documentation. - New method jsPsych.data.addDataToLastTrial allows data to be added to the most recently recorded trial. - New method jsPsych.randomization.shuffleNoRepeats shuffles an array with the constraint the neighboring items cannot be identical. - Extra parameters added to jspsych-categorize to implement a timeout if subject takes too long to respond. - New parameters for survey-text to allow for control over the size of the text fields. - Miscellaneous bug fixes

jsPsych v5.0

2016-01-07T22:09:06+00:00

This is a significant update to the library. If you are a veteran jspsych user, you will need to reacquaint yourself with some of the new syntax, which is conceptually similar but simplified for the ease of new users. Old experiments from v4.x will not work with v5.0. ## Major changes - Completely overhauled the system for constructing trials, blocks, and chunks. All trials are now declared through a common system: the timeline. The timeline can contain nested timelines, replicating the features of blocks and chunks, while simplifying the syntax and improving the flexibility. Conditional and looping timelines are much easier to build. For more information, read [the docs page on the new timeline](http://docs.jspsych.org/features/timeline/). - Greatly simplified plugin files. There is no longer a need to define a .create method in the plugin file. Parameters are passed directly from the timeline into the .trial method. - New button-response plugin for showing a stimulus and getting a response via a button press. Buttons are highly customizable. - Automatic preloading. Most image and audio files will now automatically preload at the start of the experiment. - New survey-multi-choice plugin for answering multiple choice questions. - Option to run the experiment in fullscreen mode. ## Minor changes - Greater flexibility in options for multi-stim-multi-response plugin. - Mouse responses are valid for single-stim plugin. - Improved CSS styling of buttons in general. - Audio playback works in Safari. - New function to generate a random subject ID. - Option to display a message when using endExperiment to terminate the experiment early. - New function to recover URL string variables. - Plugin files now live in the jsPsych.plugins namespace to provide better organization. - New .dataAsJSON method. - Option to override the DOM target for jsPsych at the trial level. - Fixed many small bugs throughout the library.

jsPsych v5.0.1

2016-01-15T20:26:47+00:00

Fixes two broken example files from v5.0.

jsPsych v5.0.2

2016-01-26T02:42:26+00:00

- Fixes a critical bug with pre-loading audio files. If more than one audio file was required, the pre-loading would fail. This is now fixed. - The parameter `randomize_order` for timelines was being incorrectly applied to timelines that were nested under the randomized timeline. This is now fixed; `randomize_order` will only apply to the timeline that it is set on.

jsPsych v5.0.3

2016-01-31T16:28:07+00:00

Fixes example files that did not work with v5.x

jsPsych v6.0

2018-01-03T21:39:55+00:00

This is a major update to jsPsych that reflects more than [100 changes](https://github.com/jspsych/jsPsych/issues?utf8=%E2%9C%93&q=milestone%3A6.0) to the library. Given the scope of the update, this document focuses only on high-level changes to the library. Note that many of the changes to the library break backwards compatibility with any prior jsPsych version. # New features * **[Timeline Variables](http://www.jspsych.org/overview/timeline/#timeline-variables)** are a powerful new tool for writing efficient code. They allow you to define parameters on a timeline that are replaced by variables. The variables can be grouped so that a value for one parameter is always paired with a value for another parameter. There are many new features built on top of the timeline variables system, including methods for randomly sampling sets of variables. * The data module has been entirely overhauled to provide **[an API for interacting with jsPsych data](http://www.jspsych.org/overview/data/#aggregating-and-manipulating-jspsych-data)**. This makes it easier to aggregate and analyze data during the experiment, allowing the experiment to be responsive to the data that is generated. * **[User interactions](http://www.jspsych.org/overview/record-browser-interactions/)** are now automatically recorded by jsPsych, allowing experimenters to know when subjects clicked away from an experiment or exited full screen mode. * Subjects can now be **[excluded if their browser does not meet certain technical requirements](http://www.jspsych.org/overview/exclude-browser/)**. Currently this features supports checking for minimum screen size and audio support. * **Many new plugins**, including plugins for the [implicit association test](http://www.jspsych.org/plugins/jspsych-iat-html/), a plugin that can [calibrate the size of the subject's display](http://www.jspsych.org/plugins/jspsych-resize/), and a plugin for the [serial reaction time task](http://www.jspsych.org/plugins/jspsych-serial-reaction-time/). Many plugins have also been renamed to improve clarity. * **A progress bar** will now display while experiment resources are preloaded. * **Automatic vertical and horizontal centering** of jsPsych content by default. * New event handlers for when [trials start](http://www.jspsych.org/overview/callbacks/#on_start-trial) and when [trials have finished loading](http://www.jspsych.org/overview/callbacks/#on_load). # Technical changes This update also features a large number of technical changes to the jsPsych library. These changes are designed to improve the compatibility of jsPsych with other web frameworks and support our ongoing development efforts towards a graphical experiment builder for jsPsych. * The **jQuery dependency has been removed**. All jsPsych code uses standard JavaScript with no dependencies. This change means that plugins now need to make changes to a standard `HTMLElement` to adjust the display, rather than a jQuery collection. * Plugins now require **an .info property**, which specifies the parameters of the plugin and what their default values and types are. We use this information to automate some of the tasks that plugins used to have to complete, such as evaluating function parameters and replacing default values. We mostly use the parameter type information as part of the graphical experiment builder engine, but we do check if the type is a function within jsPsych to handle cases where parameters should not be evaluated before the trial runs. * A **testing suite** has been written using Jest to facilitate community development on the project as it grows in scope. The suite has partial coverage right now, and remains an active area of work. # Other changes Many other smaller changes can be discovered on our updated documentation site at [www.jspsych.org](http://www.jspsych.org)

jsPsych v6.0.1

2018-01-11T15:43:28+00:00

This update fixes a bug that occurred when trial parameters were set to `null`. For example, this code caused undesired behavior: ```js var trial = { type: 'html-keyboard-response', stimulus: 'oops.', post_trial_gap: null } ```

jsPsych v6.0.2

2018-04-18T13:15:44+00:00

This release patches a few bugs in 6.0.1 and adds two small features. New features * If preloading content fails, jsPsych will retry each failed file up to a specified number of times. The default behavior is 10 attempts. This can be overriden by setting `max_preload_attempts` in `jsPsych.init()` * Use of the WebAudio API is now optional. It can be disabled by setting `use_webaudio` in `jsPsych.init()` to `false`. HTML5 Audio is now automatically used as a backup when WebAudio is not available. Bug fixes * The survey-text plugin now works when `rows` and/or `columns` is unspecified. Thanks @VorontsovIE ! * jsPsych would attempt to create a new AudioContext on every jsPsych.init() call. This is now corrected and jsPsych uses a single AudioContext even if there are multiple inits on the same page. * The `start` and `stop` options for jspsych-video now work in Microsoft Edge. * The vertical scrollbar only appears if the experiment is too tall to fit in the window. * Various errors in the documentation and tutorials were corrected. Thanks @hans and @yulkang !

jsPsych v6.0.3

2018-05-15T02:37:20+00:00

This update mainly addresses the [Chrome 66+ audio autoplay issue](https://github.com/jspsych/jsPsych/issues/518). Briefly: Chrome 66+ no longer allows audio to autoplay until after the user has taken one action on the page. jsPsych creates the audio context when jspsych.js is loaded, and this is usually before the user takes an action. This updates modifies the way that jsPsych uses the audio context so that it is automatically unblocked after the first action that the user takes. This update also modifies the survey-text plugin so that the first text field is auto focused.

jsPsych v6.0.4

2018-06-26T02:24:31+00:00

## New features * Added plugin for Random Dot Kinematograms by @vrsivananda. Thanks for this major contribution! * Added the ability to display page numbers in the instructions plugin. Thanks @mjaquiery! * External scripts can now be optionally executed in the external-html plugin. Thanks @onkeltom! ## Documentation updates * The PHP script example in the documentation for saving files to a server is fixed for recent versions of PHP. Thanks @akochari! * localSave() for data collections works in recent versions of Safari. Thanks @spencerking! * Audio examples are updated to reflect the Chrome 66+ restrictions on playing audio. Thanks @mpezzo! ## Bug fixes * The free-sort plugin now properly records the final locations of the images. * The instructions plugin handles custom key assignments when allow_backwards is false. Thanks @pfeyz! * In some older browsers, the display element would lose focus when a button was clicked. By default, the display element is automatically focused at the start of every trial. Thanks @akochari!

jsPsych v6.0.5

2018-10-04T20:04:58+00:00

# New Features * The `call-function` plugin can now wait for asynchronous functions to execute a callback before continuing to the next trial. (#552). * The `RDK` plugin now accepts character codes for selecting keys (#564). Thanks @vrsivananda ! * The content element will automatically scroll to the top on a new trial, which fixes some issues where long surveys were stuck at the bottom of the page on a new trial. * Default key behavior (like space causing the page to scroll) is now prevented when the key is expected as input for a plugin that uses `getKeyboardResponse` to capture input. # Bug Fixes * The Open Sans font now correctly imports in the stylesheet. Thanks @guydav ! * In some cases the backwards button in the `instructions` plugin would not work properly. Thanks for reporting, @kushinm ! (#553) * In some cases, image preloading would fail because values of `null`, `0`, or `false` would be added to the list of images to load. (#557). * A bug in the `external-html` plugin caused a keyboard event handler to persist when it should have been cleared. Thanks @tbrotherm ! * Two minor bugs were resolved in the `RDK` plugin (#565). Thanks @vrsivananda ! * The `-slider-response` plugins had the wrong parameter type for the `labels` parameter, causing issues in the GUI. (#571). * Automatically putting the focus on the jsPsych content div was failing due to targeting the wrong element. (#563).

jsPsych v6.1.0

2019-07-16T15:42:01+00:00

# New Features - Added an option to specify an event handler for `on_close` in `jsPsych.init()`. This event is triggered when the user leaves the page. It can be used to save the data and/or state of the experiment just before the window is closed and the data is lost (#324). - Added `jsPsych.getProgressBarCompleted()`, which returns the current value of the progress bar. Works for automated and manual control mode of the progress bar (#538). - Video files will now preload. Thanks @andytwoods ! (#408, #535). - The survey-text plugin now supports a `required` parameter. (#460). - Individual data values in the `data` parameter can now be functions that are evaluated at the start of the trial (#562). - Created three new plugins for video stimulus with different response options: `video-keyboard-response`, `video-button-response`, and `video-slider-response`. Thanks @designatednerd ! (#636; #622). - The video plugins now supports setting the playback rate. Thanks @r-b-g-b ! (#590). - Added cloze test plugin. Thanks @sprengholz ! (#555). - A custom label can be specified for the automatic progress bar. Thanks @retowyss ! (#609). - All survey plugins now support `randomize_question_order` parameter, which randomly reorders all questions (#305). - The various `image-` plugins now allow for setting the height and width of the image by the parameters `stimulus_height` and `stimulus_width`. The parameter `maintain_aspect_ratio` can be used to automatically resize one dimension when specifying the other (#560). - The slider plugins now support a parameter called `require_movement`. When set to true, the continue button is disabled until the slider has been moved (#573). - The slider plugins now have a parameter called `slider_width` which can be used to set the width of the slider in pixels (#631). - Added a new plugin that supports a more versatile set of html form elements, survey-html-form. Thanks @jansim ! (#602). - Added `jsPsych.randomization.shuffleAlternateGroups()` which allows for shuffling based on a group membership, ensuring that items from each group are spaced evenly and in a consistent group order (#528). - Added `alternate-groups` option to sampling methods for timeline variables (#528). - Added a parameter to jsPsych.init to control the width of the experiment display, `experiment_width` (#635). - The survey-likert plugin now has a parameter `scale_width` to specify the width of the likert scales in pixels (#633). - All the survey plugins now support a `name` parameter in the `questions` array. This parameter controls the name of the response in the data, replacing the default of `Q0`, `Q1`, etc. (#608). # Changes - Dropped support for `Date.now()` as a method for measuring RT. Browser support for `performance.now()` is now widespread (#492). - `.variance()` and `.sd()` now calculate sample variance and standard deviation instead of population variance and standard deviation (#601). - In nested timeline structures, `data` properties that do not conflict between a nested node and their parent node will now both be added to the data structure. Previously, only the nested node's data was added, even if the data properties were not in conflict (#391). - Added more informative error messages for some functions in the randomization module (#389). - The `value` parameter for the survey-text plugin has been replaced with `placeholder` and the text is now used as a proper placeholder attribute (#627). - The survey-multi-select plugin `required` parameter is now specified at the question level to be consistent with other survey plugins. Proper HTML5 form validation is used to display the error message (#629). - The jspsych-RDK plugin was renamed to jspsych-rdk to be consistent with other plugins. Thanks @vrsivananda ! (#630; #575). - Various documentation improvements and updates (#607, #524). # Bug Fixes - Div IDs were incorrectly generated in the survey-text plugin (#576). - The survey-text plugin was reloading the page on form submission in Safari and Edge. Thanks @nabsul ! (#610; #613). - The survey-text plugin has proper auto focus on the first input element (#580). - Full screen event data is now properly recorded in recent versions of Firefox (#597). - The loading progress bar should no longer be larger than expected (#603). - Default values were not properly used when the plugin had a nested parameter (e.g., the `questions` parameter in the various `survey-*` plugins). Defaults are now used as expected (#628). - The default_iti parameter in jsPsych.init() is working as intended (#632).

jsPsych v6.2.0

2020-12-09T00:16:42+00:00

*Note from @jodeleeuw*: 6.2 is our first release that is made possible by support from a grant by [Mozilla Open Source Support (MOSS)](https://www.mozilla.org/en-US/moss/). This award has allowed @becky-gilbert to join the team, and she has been essential to all of the work reflected here. So: thanks Mozilla, and thanks @becky-gilbert! # New Features * The instructions plugin now has a `page_label` parameter that allows you to change the default "Page" text when showing the page number/total. This provides better support for non-English languages. Thanks @GEJ1! (#1081, #1082) * By default, the survey-* plugins now turn off the autocomplete/autofill feature, so that participants won't see a list of their previous responses in text entry fields. This feature can be turned back on with the new `autocomplete` parameter. Thanks @chrisbrickhouse! (#1064, #1073) * The survey-html-form plugin now includes the `autofocus` parameter that allows you to specify the ID of the form field that you want the page to focus on when the trial loads. Thanks @chrisbrickhouse and @grocio! (#1072, #1062, #669, #671) * In a survey-likert trial, you can now select a response by clicking on the label text. Thanks @kurokida! (#701) * You can now set a minimum valid keyboard response time in your experiment using the new `minimum_valid_rt` parameter in `jsPsych.init`. This is useful for automatically ignoring key presses that are unreasonably fast. Thanks @andytwoods! (#1139, #546, #542) * All audio-\*/video-\* plugins now include the `response_allowed_while_playing` parameter. If false, the participant will not be able to respond until the media has finished playing. Before then, keyboard responses will be ignored, and buttons/sliders will be visible but disabled. (#1137, #1145) * New canvas-* plugins allow you to use a function to draw the stimulus on a HTML canvas element, and collect a keyboard, button, or slider response. A canvas stimulus can be useful for displaying dynamic, parametrically-defined graphics, and for controlling the positioning of multiple graphical elements (shapes, text, images). Thanks @cjungerius! (#700) * New maxdiff plugin displays a set of options to be selected as one of two mutually-exclusive categories, typically 'most' or 'least' on some criteria, e.g. importance, preference, similarity. The same option cannot be selected for both categories simultaneously. Thanks @awhug! (#1136) * The free-sort plugin now has new parameters to control: sort area shape (square or circle), initial item positioning (inside or outside the sort area), border/background colors indicating when items are in/out of the area, magnification of items while dragging, and text indicating whether and how many items are left to be placed inside. Thanks @pjkohler! (#1018, #1203) * The image-*, animation, and categorize-animation plugins now include a `render_on_canvas` parameter to fix the problem with brief blank screens (white flashes) between consecutive images/trials in Firefox and Edge. Setting `render_on_canvas` to true fixes this problem, and setting it to false presents the image(s) in an img element, as before. (#891 #969, #1174) * New documentation pages in the Overview section on the jsPsych website: [Browser and Device Support](https://www.jspsych.org/overview/browser-device-support/) and [Running Experiments](https://www.jspsych.org/overview/running-experiments/). * New 'safe mode' feature automatically prevents CORS errors when running experiments offline (e.g. by double-clicking the HTML file). This can be overridden with the new `override_safe_mode` parameter in `jsPsych.init`. For more info about CORS errors and safe mode, see https://www.jspsych.org/overview/running-experiments/#offline. # Changes * The *-slider-response plugins now automatically save the stimulus and slider start position in the data, and they return an integer rather than string as the response. Thanks @kupiqu! (#736, #689, #1058). * In the *-slider-response plugins, the slider starting value parameter is now called `slider_start` (for consistency with video-slider-response plugin, where `start` refers to the video start time). The slider's starting value is now stored in the trial data, which is useful if the researcher is randomizing the slider's starting value. (#1060, #736) * When `require_movement` is `true` in the *-slider-response plugins, the user will be allowed to continue after clicking on the cursor (rather than having to move the cursor and release it). This makes the sliders more user-friendly, especially when using a discrete/sparse scale, and when the participant wants to respond with the slider's starting position. Thanks @kupiqu! (#696) * In the same-different-html and same-different-image plugins, the default values for `first_stim_duration` and `second_stim_duration` were changed from 1000 ms to `null`. This fixes a bug that prevented these parameters from being set to `null`. Thanks @dschreij! (#755) * In all *-button-response plugins, the "button_pressed" data is now saved as an integer rather than a string, which is now consistent with the documentation. Thanks @vijaymarupudi! (#682) * By default, the image-*, animation, and categorize-animation plugins now draw the images on a canvas element, to fix a problem with brief blank screens (white flashes) between consecutive images in Firefox and Edge. Setting `render_on_canvas` to false will present the image(s) in an img element, as in previous versions of these plugins. (#891 #969, #1174) * In the video-* plugins, the parameter for specifying the video file(s) is now called `stimulus` rather than `sources`, for consistency with other plugins. (#1261, #1171) # Bug Fixes * The rdk plugin now appropriately changes the fixation cross color based on the `fixation_cross_color` parameter. Thanks @cthorey and @lukasshannon! (#643 #1217) * Incorrect error message no longer displayed when using `jsPsych.randomization.shuffleNoRepeats()` (#659) * `jsPsych.randomization.repeat()` now fails gracefully when the `items` and `repetitions` parameters are ambiguous. Thanks @hrcn ! (#667) * The `start` and `slider_start` parameters now work as expected in the video-slider-response plugin. Thanks @vijaymarupudi! (#713, #714) * The website's tutorials and the library's example HTML files no longer include the unnecessary closing link tag (``) after loading the default CSS file. Thanks @vijaymarupudi! (#721) * The labels and radio buttons/checkboxes in survey-multi-choice and survey-multi-select plugins are now properly formatted. Thanks @dillonplunkett! (#676) * We've fixed several documentation errors, such as out-of-date parameter names and broken links. Thanks @akochari, @CarolynBuck-Gengler, @dschreij, @alisdt, and @gorkang! (#677, #1096, #827, #755, #668, #1225) * The rdk plugin no longer shows scroll bars on the page. Thanks @wsr017 and @vijaymarupudi! (#881, #787) * `jsPsych.addNodeToEndOfTimeline` no longer produces an error when the optional callback function is omitted. Thanks @oliveralonzo, @bjmeagher, and @vijaymarupudi! (#688, #918, #690) * Data collection `.first` and `.last` functions now handle the case where the `n` argument is greater than the total number of trials in the collection, and they throw a descriptive error when `n` is zero or negative. Thanks @aridyckovsky! (#976, #751) * The image-button-response and image-keyboard-response plugins now produce a console warning when the trial might be deadlocked because a response does not end the trial (`response_ends_trial: false`) and no trial duration is set (`trial_duration: null`). Thanks @chrisbrickhouse and @celstark! (#1014, #1028) * Incorrect error message "Uncaught TypeError: Cannot read property 'style' of null at update_loading_progress_bar" no longer displayed when playing HTML5 audio. (#648, #1115) * Fixed out-of-date Github URLs in package.json file to improve `npm install` compatibility. Thanks @aridyckovsky! (#971) * Added a more informative error message when the `timeline` parameter is empty in `jsPsych.init()` (#853) * In the case of a timeline with a loop function nested inside a timeline with timeline variables, the timeline variables can now be referenced inside the loop function. (#664) * The serial-response-time-mouse plugin now works properly when a prompt is added to the screen. Thanks @takat0-ch (#840, #837) * Fixed a bug where an error was thrown if the Array.prototype had been extended and parameters with COMPLEX types were used in plugins. Thanks @egaudrain! (#989, #990) * `jsPsych.init()` will now delay execution until the document is fully loaded (#948). This fixes an issue where jsPsych would create two sets of `` tags on the document if none existed in the markup (#316). Thanks @bjoluc! * Fixed bug on touchscreen-only devices (phones/tablets) that caused the last button that was touched to remain highlighted on successive *-button-response trials. (#977) * The preloading progress bar correctly centers when the `experiment_width` property is set in `jsPsych.init()`. (#1160) * For all video-* plugins in Firefox, if a non-zero video `start` time is specified, then the first frame of the video is no longer briefly visible when the trial first loads. (#712, #1162) * Fixed alignment problems between slider positions and labels in all *-slider-response plugins. (#1193, #695) * In the image-* plugins, the `maintain_aspect_ratio` parameter now works as intended: when only one image dimension is specified and `maintain_aspect_ratio` is false, the unspecified dimension will be the image's original dimension, and the image will stretch or compress accordingly. (#1174, #1172) * Fixed a bug in video-* plugins that was preventing videos from automatically preloading. Thanks @mgorenstein! (#1171) * Fixed a bug in audio-button-response that was producing an "undefined startTime" error. Thanks @esolitos! (#1194) * The audio-button-response plugin now calculates RTs based on the WebAudio clock when WebAudio is used, which is consistent with the other audio-* plugins.

jsPsych v6.3.0

2021-02-21T23:20:01+00:00

# New Features - Added the concept of `extensions` to the jsPsych architecture. Extensions are code modules that are designed to extend the functionality of any plugin. Eye tracking is an example of a feature best supported via an extension. The extension is responsible for gathering gaze data and adding the data to the trial. The advantage of using an extension is that the feature can then be added on top of any existing plugin. See the new [extensions documentation](https://www.jspsych.org/extensions/extensions/) for more information (#1123, #1516). - Eye tracking is now available via an extension that utilizes the 3rd party [WebGazer](https://webgazer.cs.brown.edu/) library. See the new [eye tracking overview](https://www.jspsych.org/overview/eye-tracking/) in the documentation, plus example experiments in the `/examples` folder (#1516). - Three new plugins to support eye tracking. `jspsych-webgazer-init-camera` will initialize the camera for eye tracking, `jspsych-webgazer-calibrate` performs calibration, and `jspsych-webgazer-validate` performs validation and report data about the accuracy and sampling rate of the eye tracking (#1516). - Added the `virtual-chinrest` plugin, an implementation of the procedure described by [Li, Joo, Yeatman, and Reinecke (2020)](https://doi.org/10.1038/s41598-019-57204-1) for measuring the distance between the participant and the monitor. This plugin also merges in features from the `resize` plugin to allow for scaling of the display to known dimensions, e.g., ensuring that 200px = 2cm. Thanks @GEJ1 and @pjkohler! (#1442) - New `css_classes` parameter available in all plugins. This allows you to add one or more custom CSS classes to the display element on that trial, which makes it easier to change style/formatting across trials. For more information, see the new [Controlling Visual Appearance](https://www.jspsych.org/overview/style) documentation page and the "css_classes_parameter.html" example file (#832, #1378) - New `save_trial_parameters` parameter available in all plugins. This allows you to override the plugin's default trial data, by saving additional parameter values that are not normally saved, or not saving parameter values that normally are saved. For more information, see the [parameters available in all plugins](https://www.jspsych.org/overview/plugins/#parameters-available-in-all-plugins) page and the "save_trial_parameters.html" example file (#823, #1555) - `jsPsych.version()` returns the version of `jspsych.js` as a string (#1472). - `jsPsych.allTimelineVariables()` returns all the timeline variables and their values at that moment in the experiment (#1237, #1493) - It's now possible to use dynamic parameters (functions as parameters) in _nested_ trial parameters. For instance, in the `questions` parameter in survey-* plugins, you can use a function for any of the individual parameters in each question object, like the `prompt`. See the updated documentation on [dynamic parameters](https://www.jspsych.org/overview/dynamic-parameters). (#988, #1497) - The new `preload` plugin now handles all media preloading. This makes preloading more customizable, and it makes it easy to preload files at any point during an experiment. This plugin contains new options for things error messanges and handling file loading success/failure. For more details, see the [preload plugin](https://www.jspsych.org/plugins/jspsych-preload) documentation. Thanks @javidalpe! (#1234, #1351). - The `freesort` plugin now works on mobile devices, and includes a new `column_spread_factor` parameter to control the spread of image columns to the right and left sides of the sort area. Thanks @kurokida! (#1228, #1546) - Added and updated documentation on the jsPsych website (#1374), including new pages about: * [dynamic parameters](https://www.jspsych.org/overview/dynamic-parameters) * using and creating [plugins](https://www.jspsych.org/overview/plugins) * links to [tutorial videos](https://www.jspsych.org/tutorials/video-tutorials) * [integrating with Prolific](https://www.jspsych.org/overview/prolific/) * [controlling the visual appearance](https://www.jspsych.org/overview/style) of your experiment - `on_timeline_start` and `on_timeline_finish` callbacks allow you to run arbitrary code at the start/end of at timeline node (including timeline variables, conditional/loop nodes, etc.). See the [Timeline](https://www.jspsych.org/overview/timeline/) and [Event-related callback functions](https://www.jspsych.org/overview/callbacks/) pages for info and examples. (#585, #1512) # Changes - Keys must be given as strings in trial parameters (e.g. `choices: ['a']`) and are saved as strings in the data (e.g. `response: 'a'`). *Numeric keycodes are no longer accepted* and *numeric keycodes are no longer used in the data output*. This change was made because [numeric keycodes are deprecated](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/keyCode) and future browsers could drop support, so key responses are now recorded using the event's `.key` property. Key strings are also easier to work with and produce more readable data. - Because `.key` based responses distinguish between upper and lower case input, a new flag was added to `jsPsych.init` called `case_sensitive_responses`. This setting is `false` by default, but you can set this flag to `true` if you want case sensitivity for your key choice parameters and participants' keyboard responses. This setting does not affect responses that are typed into text boxes. For a full summary of the changes related to this shift, see #1465 and the [jsPsych.init documentation](https://www.jspsych.org/core_library/jspsych-core/#jspsychinit). (#396, #1465). - We now recommend using `jsPsych.pluginAPI.compareKeys` to compare keys in all plugin and experiment code, rather than using something like `if (response == 'j')...`. Using this `compareKeys` function will ensure that your key comparisons work appropriately based on the experiment's `case_sensitive_responses` setting. See the [`compareKeys` documentation](https://www.jspsych.org/core_library/jspsych-pluginAPI/#jspsychpluginapicomparekeys) for more information. - Media preloading is no longer done through `jsPsych.init`, so the preloading-related parameters in `jsPsych.init` are no longer supported (`show_preload_progress_bar`, `preload_audio`, `preload_images`, `preload_video`, `max_load_time`, `max_preload_attempts`). Please use the new `preload` plugin instead. - jsPsych plugins can now store complex trial data as JavaScript objects and arrays, instead of JSON-encoded strings. This fixes problems with parsing jsPsych JSON data that were caused by nested JSON strings. This also means you no longer need to use `JSON.parse` during an experiment to access data that is stored in objects/arrays (e.g. responses to survey-* questions), and plugins should not use `JSON.stringify` when saving trial data. (#670, #1523) - In an effort to standardize the response variable names across plugins, many data property names have been changed to `response`. Examples of data properties that have changed include `key_press` (\*-keyboard-response trials), `button_pressed` (\*-button-response trials), and `responses` (survey-\* trials). In some cases, the data structure has changed so that response information can be stored in a single `response` property (e.g. maxdiff and serial-reaction-time-mouse plugins). These changes were made in order to reduce the number of different columns and empty cells that are generated when jsPsych data is stored in tabular format, such as CSV. For more information, see the documentation for specific plugins, and [this list](https://github.com/jspsych/jsPsych/issues/638#issuecomment-780956531) of all data property name/structure changes across plugins. (#638, #1529) - You can now use the `jsPsych.timelineVariable` function without second the `true` argument. This function will determine whether or not it should return the timeline variable value immediately, based on the context in which it's called. Thanks @vijaymarupudi! (#883, #1376) - `jsPsych.pluginAPI.getAudioBuffer()` will now attempt to load audio files that haven't been preloaded. This means that preloading audio files is no longer strictly necessary, though of course it is still *highly* recommended. In order to make this feature possible, `getAudioBuffer()` now returns a `Promise` and plugins that use this method have been updated. (#1527, #1543) # Bug Fixes - Fixed problem that was causing the `response_allowed_while_playing` parameter not to work in the audio-button-response and video-button-response plugins when custom `button_html` was used. (#1380, #1384) - Fixed bug in image-* plugins that was causing images not to be displayed when images were not preloaded and when `render_on_canvas` was `true` (the default). (#1305, #1375) - Improved documentation and fixed various documentation errors. Thanks @pablobernabeu and @alexanderrobertson! (#1413, #1401, #672) - The fullscreen plugin now checks to see if fullscreen mode is active before trying to exit fullscreen. Thanks @klanderson! (#1354)

jsPsych v6.3.1

2021-04-10T20:53:00+00:00

This minor release is focused on improvements to the eye tracking features added in version 6.3.0. # New Features - We have [forked WebGazer](https://github.com/jspsych/WebGazer) to make some minor changes to improve compatibility with jsPsych. These changes allow jsPsych to sample eye movements at a faster rate without disrupting jsPsych's display timing. Thanks to @moltaire for identifying this issue (#1700). - WebGazer no longer initializes automatically when the page loads. Instead, the `webgazer-init-camera` plugin will initialize WebGazer and ask for camera access permissions. Added an `auto_initialize` parameter to the WebGazer extension to allow users to initialize on page load if desired. - The sampling interval can be set in the WebGazer extension. By default the extension aims for 30Hz. Faster intervals are probably not possible until browsers provide better interfaces to synchronize processing with video feeds. - Improved the timing measurements reported by WebGazer by ~30 milliseconds. Timing is now based on an estimate of when the video frame was recorded, instead of when WebGazer finished computational work on the video frame. - `jsPsych.pluginAPI.compareKeys` can now handle `null` values: it will return `true` if both key arguments are `null`, and return `false` if one key is `null` and the other is a key code or key character. This means that this function can be used to check for a correct non-response. (#1577) # Changes - Minor formatting and text updates to the `webgazer-init-camera` plugin to center the camera view. - The `webgazer-validate` plugin now records the coordinates of the validation points. - The `webgazer-init-camera` plugin now records the load time for WebGazer to initialize. - Added a `point_size` parameter to calibration and validation plugins, and set the default to a larger value. # Bug Fixes - Fixed an issue where `webgazer_targets` did not record the bounding box of content on the screen if the content was loaded after the trial began. - Fixed problem with the `minimum_valid_rt` parameter in `jsPsych.init` not working when the WebAudio clock is used to measure keyboard RTs (i.e. `rt_method: 'audio'` in `jsPsych.pluginAPI.getKeyboardResponse`). Thanks @kinleyid! (#1675) - Fixed various documentation errors and formatting problems. (#1642, #1641, #1594)

jsPsych jspsych@7.3.4

2023-11-15T19:26:39+00:00

### Patch Changes - [#3184](https://github.com/jspsych/jsPsych/pull/3184) [`9acfa29c`](https://github.com/jspsych/jsPsych/commit/9acfa29c8db1d7a8816c53ac49651f15493f2cf4) Thanks [@bjoluc](https://github.com/bjoluc)! - Point to source maps via canonical unpkg URLs in NPM-published browser builds. This prevents 404 errors when using redirecting CDN URLs (as described in #3043).

jsPsych @jspsych/plugin-initialize-camera@1.0.2

2023-11-15T19:27:54+00:00

jsPsych @jspsych/plugin-instructions@1.1.4

2023-11-15T19:27:57+00:00

jsPsych @jspsych/plugin-initialize-microphone@1.0.3

2023-11-15T19:28:00+00:00

jsPsych @jspsych/plugin-maxdiff@1.1.3

2023-11-15T19:28:03+00:00

jsPsych @jspsych/plugin-mirror-camera@1.0.2

2023-11-15T19:28:06+00:00

jsPsych @jspsych/plugin-reconstruction@1.1.3

2023-11-15T19:28:09+00:00

jsPsych @jspsych/plugin-preload@1.1.3

2023-11-15T19:28:12+00:00

jsPsych @jspsych/plugin-same-different-html@1.1.3

2023-11-15T19:28:15+00:00

jsPsych @jspsych/plugin-resize@1.0.3

2023-11-15T19:28:18+00:00

jsPsych @jspsych/plugin-serial-reaction-time@1.1.4

2023-11-15T19:28:21+00:00

jsPsych @jspsych/plugin-same-different-image@1.1.3

2023-11-15T19:28:24+00:00

jsPsych @jspsych/plugin-serial-reaction-time-mouse@1.1.3

2023-11-15T19:28:27+00:00

jsPsych @jspsych/plugin-sketchpad@1.0.4

2023-11-15T19:28:30+00:00

jsPsych @jspsych/plugin-survey@0.2.2

2023-11-15T19:28:33+00:00

jsPsych @jspsych/plugin-survey-likert@1.1.3

2023-11-15T19:28:36+00:00

jsPsych @jspsych/plugin-survey-html-form@1.0.3

2023-11-15T19:28:39+00:00

jsPsych @jspsych/plugin-survey-multi-choice@1.1.3

2023-11-15T19:28:42+00:00

jsPsych @jspsych/plugin-survey-multi-select@1.1.3

2023-11-15T19:28:45+00:00

jsPsych @jspsych/plugin-survey-text@1.1.3

2023-11-15T19:28:48+00:00

jsPsych @jspsych/plugin-video-button-response@1.1.3

2023-11-15T19:28:51+00:00

jsPsych @jspsych/plugin-video-keyboard-response@1.1.3

2023-11-15T19:28:54+00:00

jsPsych @jspsych/plugin-video-slider-response@1.1.3

2023-11-15T19:28:57+00:00

jsPsych @jspsych/plugin-virtual-chinrest@2.0.3

2023-11-15T19:29:00+00:00

jsPsych @jspsych/plugin-visual-search-circle@1.1.3

2023-11-15T19:29:03+00:00

jsPsych @jspsych/plugin-webgazer-calibrate@1.0.3

2023-11-15T19:29:06+00:00

jsPsych @jspsych/plugin-webgazer-init-camera@1.0.3

2023-11-15T19:29:09+00:00

jsPsych @jspsych/plugin-webgazer-validate@1.0.3

2023-11-15T19:29:12+00:00

jsPsych @jspsych/plugin-visual-search-circle@1.2.0

2024-01-14T18:11:10+00:00

### Minor Changes - [#3211](https://github.com/jspsych/jsPsych/pull/3211) [`37430e13`](https://github.com/jspsych/jsPsych/commit/37430e13e9645d90e853471010bee0c95c895954) Thanks [@jodeleeuw](https://github.com/jodeleeuw)! - Adds response_ends_trial parameter, with a default value of `true`

jsPsych @jspsych/plugin-visual-search-circle@1.2.1

2024-01-14T19:41:01+00:00

### Patch Changes - [#3213](https://github.com/jspsych/jsPsych/pull/3213) [`7b797727`](https://github.com/jspsych/jsPsych/commit/7b797727fa3b2b384ef964eb53d74f474ec902ef) Thanks [@jodeleeuw](https://github.com/jodeleeuw)! - Fix display clearing problem introduced with version 1.2.0