SDK de JavaScript: referencia de almacenamiento
Cada método que gestiona depósitos y objetos, con su firma.
6 min leer·Nivel referencia·Revisado el 12 oct 2026
Este texto en inglés se generó automáticamente a partir del original en francés y aún no ha sido revisado.
Esta página fue traducida automáticamente. La versión en inglés es autorizada.
#
clase
Servicio de almacenamiento
| Método | Descripción |
|---|---|
from(bucketId: string): StorageBucketClient | Devuelve un cliente con ámbito de un depósito específico (paridad DX Supabase). |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | Enumere los depósitos del proyecto. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | Lee un depósito por su identificador. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Crea un cubo. public (predeterminado false) hace que sus objetos sean legibles sin autenticación; fileSizeLimit (en bytes) y allowedMimeTypes limitan los archivos aceptados. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Actualiza un depósito existente (actualización PARCIAL: solo se envían los campos proporcionados). |
deleteBucket(id: string): Promise<AuraResponse<null>> | Elimina un depósito por su identificador. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Sube un archivo a un depósito. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Descarga diferida de un archivo. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Enumere archivos en un depósito. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Elimine uno o más archivos de un depósito. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Copie un archivo dentro de un depósito. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Mover/cambiar el nombre de un archivo dentro de un depósito. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | Obtener metadatos del archivo. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Genere una URL de descarga firmada (temporal). |
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 varias URL firmadas en una sola pasada (por lotes). |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Genere una URL de carga firmada (PUT prefirmada). |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | Construye una URL a un archivo en un depósito. |
#
clase
AlmacenamientoBucketClient
Acceda al cliente con ámbito de un depósito específico (paridad DX Supabase).
| Propiedad | Descripción |
|---|---|
readonly bucketId: string | Identificador del depósito al que está vinculado este cliente: todos sus métodos actúan sobre este depósito. |
| Método | Descripción |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Sube un archivo a este depósito. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Descargue un archivo de este depósito. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Enumere los archivos en este depósito. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Elimina uno o más archivos de este depósito. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Crea una URL firmada temporal para un archivo en este depósito. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Crea varias URL firmadas en una sola pasada para este depósito. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Crea una URL de carga prefirmada (PUT directo). |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | Devuelve la URL pública de un archivo en este depósito. |
#
clase
BlobDownloadBuilder
Descarga diferida (Blob por defecto).
| Método | Descripción |
|---|---|
asStream(): StreamDownloadBuilder | Cambia a lectura en streaming: el resultado se convierte en un ReadableStream en lugar de un Blob cargado en la 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> | Activa la descarga (lenta: la solicitud solo comienza en await); el resultado se memoriza. |
#
clase
StreamDownloadBuilder
Flujo variante: res.body (ReadableStream).
| Método | Descripción |
|---|---|
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> | Activa la descarga de streaming (perezosa); el resultado se memoriza. |
página generada
Esta página se genera a partir de las declaraciones de tipo y los comentarios del SDK, por lo que no puede derivarse del código publicado. Para ver ejemplos resueltos, lea las guías.
Última actualización · 12 oct 2026