jspsych-attention-check v2.2.0

jspsych-attention-check

A jsPsych plugin for creating attention-check questions.

Note: This package is NOT compatible with jsPsych versions >= 7.0.

To install this package compatible with jsPsych v6.3 or earlier:

$ npm install jspsych-attention-check@2.2.0

or,

$ yarn add jspsych-attention-check@2.2.0

!WARNING Version 2.2.0 introduces breaking changes to the jsPsych parameters. Review the Parameters section carefully!

Overview

This plugin allows two styles of attention-check questions to be displayed, while supporting keyboard input schemes for the radio button display style. Additional features include an input timeout, rich feedback capabilities, and the ability to ask the participant for confirmation before submitting their response.

The plugin makes use of React and the Grommet UI library, an accessibility-first library that provides a number of useful components. Given that jsPsych experiments may not use React, the plugin will clean up after itself to ensure there are no issues mixing a React-based component with a non-React experiment.

Parameters

Data

Three data points are collected: attentionRT, attentionSelected, attentionCorrect:

• attentionRT (number): a float representing the time taken by the participant to select an option once input is permitted. Measured in milliseconds.
• attentionSelected (string): a string containing the value of the response selected by the participant.
• attentionCorrect (boolean): a boolean representing the correctness of the participant's response.

Example Usage

You can add an attention-check to your jsPsych timeline like any other timeline node. The following example displays responses as a radio button group, and uses keyboard input only.

timeline.push({
  type: "attention-check",
  prompt:
    "In this task, who will be choosing the points you and your partner get?",
  style: "radio",
  responses: ["A lottery", "Me", "My partner"],
  correct: 1,
  feedback: {
    correct: "Correct!",
    incorrect: "Incorrect!",
  },
  input_timeout: 2000,
  input_schema: {
    select: "3",
    next: "2",
    previous: "1",
  },
  confirm_continue: true,
});

The following example displays responses as a drop-down, does not use keyboard input, and does not require confirmation.

timeline.push({
  type: "attention-check",
  prompt:
    "In this task, who will be choosing the points you and your partner get?",
  style: "default",
  responses: ["A lottery", "Me", "My partner"],
  correct: 1,
  feedback: {
    correct: "Correct!",
    incorrect: "Incorrect!",
  },
  input_timeout: 2000,
  input_schema: {
    select: null,
    next: null,
    previous: null,
  },
  confirm_continue: false,
});