SDK JavaScript: riferimento allo spazio di archiviazione
Ogni metodo che gestisce bucket e oggetti, con la propria firma.
6 min letto·Livello riferimento·Revisionato il 12 ott 2026
Questo testo inglese è stato generato automaticamente dall'originale francese e non è stato ancora rivisto.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.
#
Classe
Servizio di archiviazione
| Metodo | Descrizione |
|---|---|
from(bucketId: string): StorageBucketClient | Restituisce un client con ambito a un bucket specifico (parità DX Supabase). |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | Elenca i bucket del progetto. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | Legge un bucket in base al relativo identificatore. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Crea un secchio. public (default false) rende leggibili i suoi oggetti senza autenticazione; fileSizeLimit (in byte) e allowedMimeTypes limitano i file accettati. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Aggiorna un bucket esistente (aggiornamento PARZIALE: vengono inviati solo i campi forniti). |
deleteBucket(id: string): Promise<AuraResponse<null>> | Elimina un bucket in base al relativo identificatore. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Carica un file in un bucket. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Download lento di un file. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Elenca i file in un bucket. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Elimina uno o più file da un bucket. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Copia un file all'interno di un bucket. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Sposta/rinomina un file all'interno di un bucket. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | Ottieni i metadati del file. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Genera un URL di download (temporaneo) firmato. |
createSignedUrls(bucketId: string, paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Genera diversi URL firmati in un unico passaggio (batch). |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Genera un URL di caricamento firmato (PUT prefirmato). |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | Costruisce un URL a un file in un bucket. |
#
Classe
StorageBucketClient
Accedi al client con ambito a un bucket specifico (parità DX Supabase).
| Proprietà | Descrizione |
|---|---|
readonly bucketId: string | Identificatore del bucket a cui è collegato questo client: tutti i suoi metodi agiscono su questo bucket. |
| Metodo | Descrizione |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Carica un file in questo bucket. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Scarica un file da questo bucket. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Elenca i file in questo bucket. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Elimina uno o più file da questo bucket. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Crea un URL firmato temporaneo per un file in questo bucket. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Crea più URL firmati in un unico passaggio per questo bucket. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Crea un URL di caricamento predefinito (PUT diretto). |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | Restituisce l'URL pubblico di un file in questo bucket. |
#
Classe
BlobDownloadBuilder
Download lento (Blob per impostazione predefinita).
| Metodo | Descrizione |
|---|---|
asStream(): StreamDownloadBuilder | Passa alla lettura in streaming: il risultato diventa un ReadableStream invece di un Blob caricato in memoria. |
then<TR1 = AuraResponse<Blob>, TR2 = never>(onfulfilled?: ((v: AuraResponse<Blob>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | Avvia il download (pigro: la richiesta inizia solo da await); il risultato viene memorizzato. |
#
Classe
StreamDownloadBuilder
Flusso variante — res.body (ReadableStream).
| Metodo | Descrizione |
|---|---|
then<TR1 = AuraResponse<ReadableStream<Uint8Array>>, TR2 = never>(onfulfilled?: ((v: AuraResponse<ReadableStream<Uint8Array>>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | Attiva il download in streaming (pigro); il risultato viene memorizzato. |
Pagina generata
Questa pagina viene generata dalle dichiarazioni di tipo e dai commenti dell'SDK, quindi non può derivare dal codice pubblicato. Per esempi pratici, leggi le guide.
Ultimo aggiornamento · 12 ott 2026