Change8

Migrating to Supabase JS v2.105.5-beta.0

Version v2.105.5-beta.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 5/11/2026

2
Breaking Changes
2
Migration Steps
15
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

WebAuthnErrorSupabaseAuthClientOAuthProviderCustomProvidergetItemAsyncPostgrestErrorprocessResponseinsertupsertTimerVsnCHANNEL_ERRORsessionStorageuploadToSignedUrlexists

Breaking Changes

Issue #1

Postgrest: Errors returned from processResponse are now consistently wrapped in a PostgrestError instance. Consumers relying on specific error types thrown directly might need adjustment.

Issue #2

Storage: The exists method no longer throws an error if the file does not exist; it now returns false. Code that previously relied on catching an error for non-existent files must be updated to check the boolean return value.

Migration Steps

  1. 1
    If you relied on the 'exists' method in Storage throwing an error when a file is missing, update your code to check the returned boolean value instead.
  2. 2
    Review error handling in Postgrest operations, as errors from processResponse are now guaranteed to be instances of PostgrestError.

Release Summary

This beta release introduces significant new features, including WebAuthn passkey support in Auth and deferred disconnect in Realtime. It also includes several bug fixes, notably ensuring errors are consistently wrapped as PostgrestError and modifying the Storage 'exists' behavior.

Need More Details?

View the full release notes and all changes for Supabase JS v2.105.5-beta.0.

View Full Changelog