Zoom Developer Forum

Resolving Web SDK local recording errors

Updated at:
October 16, 2025
Written By:
Aydin Schwartz

Question

People commonly ask on the Zoom Developer Forum:

When joining a meeting with the Web Meeting SDK (v4.0.7), I intermittently get “Cannot read properties of undefined (reading ‘caps’)” at lM.getLocalRecordingPermissionUserList. Sometimes the meeting still works after dismissing the error. What causes this and how can I fix it?

Answer

This is a known Web SDK behavior on the local-recording permission path: the error can occur when the host isn’t in the meeting yet or meeting metadata isn’t ready. It’s often seen when join-before-host is enabled and a participant/bot joins first.

Recommended steps:

  • If you’re not doing recording, remove or skip any local-recording permission helpers. The Web Meeting SDK does not support local recording.

  • If you need the compliance prompt, only call mediaCapturePermission after you are fully in-meeting and the host is present.

  • Add guards for undefined state before accessing capability fields (e.g., check objects exist before reading .caps).

  • If possible, have the host join first or delay permission-related logic until host presence/metadata is confirmed to avoid the undefined caps state.


Zoom Developer Forum Examples

Some examples of this question are:

Written By:
Aydin Schwartz