Fixing Errors When Uploading Puppeteer Login Recording Files

This article explains common issues that can cause errors when uploading Puppeteer login recording files and how to clean them. These errors often arise from unnecessary or invalid actions captured during recording, which can prevent the Scan-Based Login (SBL) feature from working correctly.

Cleaning Up Puppeteer Login Recording Files

If you encounter issues while uploading a Puppeteer login recording file or during scan execution, follow the steps below to remove problematic content.

Step 1: Open the File for Review

1. Download the login recording file you attempted to upload.

2. Open it in a text editor or code editor (e.g., VS Code, Sublime Text).

Step 2: Remove Invalid Entries

1. Remove Browser-Internal Pages

Delete any entries like:

"url": "chrome://new-tab-page/"

These are internal browser pages and should not be included in the recording.

2. Remove Meta Key Events

Delete any keyDown or keyUp events for the Meta key:

{
  "type": "keyDown",
  "key": "Meta"
}

{
  "type": "keyUp",
  "key": "Meta"
}

Meta key events are unnecessary for the scan and can cause issues.

3. Remove assertedEvents from the Last Step

In the last step of the recording, remove only the assertedEvents array:

"assertedEvents": [
  ...
]

Do not delete the entire step — only the assertedEvents section.

Step 3: Save and Re-upload

1. Save the file after making the changes.

2. Go back to your dashboard and re-upload the cleaned login recording file.