Skip to main content

startRecording

Start recording the current browser viewport. Must be followed by a stopRecording action. Only runs when the context app is chrome and headless is false. Supported extensions: [ '.mp4', '.webm', '.gif' ]

Fields

FieldTypeDescriptionDefault
idstringOptional. ID of the step.Generated UUID
descriptionstringOptional. Description of the step.
actionstringRequired. The action to perform.
pathstringOptional. File path of the recording. Supports the .mp4, .webm, and .gif extensions. If not specified, the file name is the ID of the step, and the extension is .mp4.
directorystringOptional. Directory of the file. Attempts to create the directory if it doesn't exist.
overwritebooleanOptional. If true, overwrites the existing file at path if it exists.false

Examples

{
"action": "startRecording"
}
{
"action": "startRecording",
"path": "results.mp4"
}
{
"action": "startRecording",
"path": "results.mp4",
"directory": "static/media",
"overwrite": true
}