Method storage.from(bucket).exists missing on front-end

[EskelCz]

Bug report

I'm trying to use the await supabase.storage.from(bucket).exists(path) that you have tests for, but no documentation. It doesn't exist when called from the front-end supabase bundle.
Can you please fix it and document the feature? It's a pretty basic thing to be able to check existence of a file without triggering a fetch error.

• I confirm this is a bug with Supabase, not with my own application.
• I confirm I have searched the Docs, GitHub Discussions, and Discord.

Describe the bug

It's an inconsistency between node and browser APIs.

To Reproduce

Run this from a browser bundle:

const supabase = createBrowserClient(PUBLIC_SUPABASE_URL, PUBLIC_SUPABASE_PUBLISHABLE_KEY)
await supabase.storage.from(bucket).exists()

This triggers an error TypeError: supabase.storage.from(...).exists is not a function

Expected behavior

Expected to receive a boolean response.
Thanks.

System information

• OS: macOS
• supabase-js: 2.41.0

[SumitKumar-17]

Bug Fix Report

I have successfully identified and fixed the bug reported in the
issue. Here's what I found and resolved:

The Issue

The bug report was partially correct. The exists method was indeed
present in both browser and Node.js builds (I confirmed it existed
in the compiled output), but there was an error handling bug that
made it appear to not work properly in certain cases.

The Root Cause

The problem was in the error handling logic of the exists method in
src/packages/StorageFileApi.ts. When a file doesn't exist
(resulting in a 404 HTTP status), the method would return { data: false, error: StorageError } instead of { data: false, error: null }.
This was incorrect behavior because:

1. The operation (checking for existence) was successful
2. Getting a 404 simply means the file doesn't exist, not that the
   operation failed
3. The user should receive { data: false, error: null } to indicate
   "file doesn't exist, but the check was successful"

The Fix

I updated the exists method to properly handle both
StorageApiError (which contains the status code directly) and
StorageUnknownError (which contains the original error object),
and return { data: false, error: null } when the error status is
400 or 404.

Changes Made

1. Fixed error handling in the exists method to properly return { data: false, error: null } when a file doesn't exist
2. Added proper TypeScript imports for StorageApiError
3. Updated README documentation with an example of how to use the
   exists method

Verification

• The project builds successfully with the fix
• The method is available in all builds (main, module, UMD)
• The fix aligns with the existing test expectations
• Proper TypeScript types are maintained

[EskelCz]

Thanks for looking into it. The method was present in a newer version than I had. With the latest version of storage-js (2.12.2) I see the method present, but when I run it, I get this error:

StorageUnknownError: {}
    at fetch.ts:39:12
    at Generator.next (<anonymous>)
    at fulfilled (helpers.ts:59:1)

I assume that is what was reportedly fixed here, so I'll try again once it's merged. Thanks.