Skip to content

Recovery guide needed when browser freezes #10

@williamsharkey

Description

@williamsharkey

Problem

When the browser becomes unresponsive (due to long async operations, infinite loops, etc.), there's no documented recovery process.

Symptoms

  • Eye commands timeout
  • Eye CLI shows "Handshake failed"
  • Browser appears frozen or stuck

Recovery Steps (to document)

  1. Refresh browser - F5 or Cmd+R on the FunctionServer tab
  2. Reload Studio - After refresh, run: getFileFromDisk('~/studio.js').then(code => runApp(code, 'studio.js'))
  3. Check saved work - Files saved with Lens.save() persist on disk
  4. Avoid re-running problematic code - Fix the issue before running again

Prevention

  • Avoid long blocking operations in apps
  • Use Promise.all() for parallel async calls instead of sequential
  • Add timeout handling to _exec calls
  • Test apps with small data sets first

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions