diff --git a/docs/overview/exclude-browser.md b/docs/overview/exclude-browser.md index 76679e77..349d4c1c 100644 --- a/docs/overview/exclude-browser.md +++ b/docs/overview/exclude-browser.md @@ -1,6 +1,12 @@ # Exclude Participants Based on Browser Features +*Changed in 7.1* Online subjects will use many different kinds of browsers. Depending on the experiment, it may be important to specify a minimum feature set of the browser. -As of v7.1 of jsPsych, the recommended way to do this is using the [browser-check plugin](../plugins/browser-check.md). This plugin can record many features of the subject's browser and exclude subjects who do not meet a defined set of inclusion criteria. Please see the [browser-check plugin documentation](../plugins/browser-check.md) for more details. +As of v7.1 of jsPsych, the recommended way to do this is using the [browser-check plugin](../plugins/browser-check.md). +This plugin can record many features of the subject's browser and exclude subjects who do not meet a defined set of inclusion criteria. +Please see the [browser-check plugin documentation](../plugins/browser-check.md) for more details. + +The prior approach of using the `exclusions` parameter in `initJsPsych()` is deprecated and will be removed in `v8.0`. +You can find the documentation for it in the [7.0 docs](https://www.jspsych.org/7.0/overview/exclude-browser). diff --git a/docs/plugins/browser-check.md b/docs/plugins/browser-check.md index 543ecc82..f4280a04 100644 --- a/docs/plugins/browser-check.md +++ b/docs/plugins/browser-check.md @@ -11,6 +11,7 @@ The plugin currently can record the following features: * Support for the WebAudio API. * Support for the Fullscreen API, e.g., through the [fullscreen plugin](../plugins/fullscreen.md). * The display refresh rate in frames per second. +* Whether the device has a webcam and microphone. Note that this only reveals whether a webcam/microphone exists. The participant still needs to grant permission in order for the experiment to use these devices. !!! warning Features with an * are recorded by parsing the [user agent string](https://developer.mozilla.org/en-US/docs/Web/HTTP/Browser_detection_using_the_user_agent). @@ -31,7 +32,7 @@ In addition to the [parameters available in all plugins](../overview/plugins.md# | Parameter | Type | Default Value | Description | | ------------------------------ | ---------------- | ------------- | ---------------------------------------- | -| features | array of strings | `["width", "height", "webaudio", "browser", "browser_version", "mobile", "os", "fullscreen", "vsync_rate"]` | The list of browser features to record. The default value includes all of the available options. | +| features | array of strings | `["width", "height", "webaudio", "browser", "browser_version", "mobile", "os", "fullscreen", "vsync_rate", "webcam", "microphone"]` | The list of browser features to record. The default value includes all of the available options. | | skip_features | array of strings | `[]` | Any features listed here will be skipped, even if they appear in `features`. Use this when you want to run most of the defaults. | vsync_frame_count | int | 60 | The number of frames to sample when measuring the display refresh rate (`"vsync_rate"`). Increasing the number will potenially improve the stability of the estimate at the cost of increasing the amount of time the plugin takes during this test. On most devices, 60 frames takes about 1 second to measure. | allow_window_resize | bool | true | Whether to allow the participant to resize the browser window if the window is smaller than `minimum_width` and/or `minimum_height`. If `false`, then the `minimum_width` and `minimum_height` parameters are ignored and you can validate the size in the `inclusion_function`. @@ -57,6 +58,8 @@ In addition to the [default data collected by all plugins](../overview/plugins.m | webaudio | bool | Whether the browser supports the WebAudio API. | fullscreen | bool | Whether the browser supports the Fullscreen API. | vsync_rate | number | An estimate of the refresh rate of the screen, in frames per second. +| webcam | bool | Whether there is a webcam device available. Note that the participant still must grant permission to access the device before it can be used. +| microphone | bool | Whether there is an audio input device available. Note that the participant still must grant permission to access the device before it can be used. Note that all of these values are only recorded when the corresponding key is included in the `features` parameter for the trial. diff --git a/docs/reference/jspsych.md b/docs/reference/jspsych.md index 60fed69f..ff293d12 100644 --- a/docs/reference/jspsych.md +++ b/docs/reference/jspsych.md @@ -24,7 +24,7 @@ The settings object can contain several parameters. None of the parameters are r | on_data_update | function | Function to execute every time data is stored using the `jsPsych.data.write` method. All plugins use this method to save data (via a call to `jsPsych.finishTrial`, so this function runs every time a plugin stores new data. | | on_interaction_data_update | function | Function to execute every time a new interaction event occurs. Interaction events include clicking on a different window (blur), returning to the experiment window (focus), entering full screen mode (fullscreenenter), and exiting full screen mode (fullscreenexit). | | on_close | function | Function to execute when the user leaves the page. Can be used, for example, to save data before the page is closed. | -| exclusions | object | Specifies restrictions on the browser the subject can use to complete the experiment. See list of options below. | +| exclusions | object | Specifies restrictions on the browser the subject can use to complete the experiment. See list of options below. *This feature is deprecated as of v7.1 and will be removed in v8.0. The [browser-check plugin](../plugins/browser-check.md) is an improved way to handle exclusions.* | | show_progress_bar | boolean | If `true`, then [a progress bar](../overview/progress-bar.md) is shown at the top of the page. Default is `false`. | | message_progress_bar | string | Message to display next to the progress bar. The default is 'Completion Progress'. | | auto_update_progress_bar | boolean | If true, then the progress bar at the top of the page will automatically update as every top-level timeline or trial is completed. |