JavaScript SDK: Speicherreferenz
Jede Methode, die Buckets und Objekte verwaltet, mit ihrer Signatur.
6 Min. gelesen·Ebene Referenz·Überarbeitet am 12.10.2026
Dieser englische Text wurde automatisch aus dem französischen Original generiert und wurde noch nicht überprüft.
Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.
#
Klasse
StorageService
| Methode | Beschreibung |
|---|---|
from(bucketId: string): StorageBucketClient | Gibt einen Client zurück, der auf einen bestimmten Bucket beschränkt ist (DX-Parität Supabase). |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | Listen Sie die Projektbereiche auf. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | Liest einen Bucket anhand seiner Kennung. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Erstellen Sie einen Eimer. public (Standard false) macht seine Objekte ohne Authentifizierung lesbar; fileSizeLimit (in Bytes) und allowedMimeTypes begrenzen die akzeptierten Dateien. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Aktualisiert einen vorhandenen Bucket (TEILWEISE Aktualisierung: nur die bereitgestellten Felder werden gesendet). |
deleteBucket(id: string): Promise<AuraResponse<null>> | Löscht einen Bucket anhand seiner Kennung. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Laden Sie eine Datei in einen Bucket hoch. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Verzögerter Download einer Datei. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Dateien in einem Bucket auflisten. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Löschen Sie eine oder mehrere Dateien aus einem Bucket. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Kopieren Sie eine Datei innerhalb eines Buckets. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Eine Datei innerhalb eines Buckets verschieben/umbenennen. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | Dateimetadaten abrufen. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Generieren Sie eine signierte (temporäre) Download-URL. |
createSignedUrls(bucketId: string, paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Erzeugt mehrere signierte URLs in einem Durchgang (Batch). |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Generieren Sie eine signierte Upload-URL (vorsignierter PUT). |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | Konstruiert eine URL zu einer Datei in einem Bucket. |
#
Klasse
StorageBucketClient
Greifen Sie auf den Client zu, der auf einen bestimmten Bucket beschränkt ist (DX-Parität Supabase).
| Eigentum | Beschreibung |
|---|---|
readonly bucketId: string | Bezeichner des Buckets, mit dem dieser Client verknüpft ist: Alle seine Methoden wirken auf diesen Bucket. |
| Methode | Beschreibung |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Laden Sie eine Datei in diesen Bucket hoch. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Laden Sie eine Datei aus diesem Bucket herunter. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Listen Sie die Dateien in diesem Bucket auf. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Löscht eine oder mehrere Dateien aus diesem Bucket. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Erstellt eine temporäre signierte URL für eine Datei in diesem Bucket. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Erstellt in einem Durchgang mehrere signierte URLs für diesen Bucket. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Erstellt eine vorsignierte Upload-URL (direkter PUT). |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | Gibt die öffentliche URL einer Datei in diesem Bucket zurück. |
#
Klasse
BlobDownloadBuilder
Lazy Download (standardmäßig Blob).
| Methode | Beschreibung |
|---|---|
asStream(): StreamDownloadBuilder | Wechselt zum Streaming-Lesen: Das Ergebnis wird als ReadableStream anstelle eines Blob in den Speicher geladen. |
then<TR1 = AuraResponse<Blob>, TR2 = never>(onfulfilled?: ((v: AuraResponse<Blob>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | Löst den Download aus (faul: die Anfrage startet erst bei await); Das Ergebnis wird gespeichert. |
#
Klasse
StreamDownloadBuilder
Variante Fluss – res.body (ReadableStream).
| Methode | Beschreibung |
|---|---|
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> | Löst einen Streaming-Download aus (verzögerter Download); Das Ergebnis wird gespeichert. |
Generierte Seite
Diese Seite wird aus den Typdeklarationen und Kommentaren des SDK generiert, sodass sie nicht vom veröffentlichten Code abweichen kann. Ausgearbeitete Beispiele finden Sie in den Leitfäden.
Zuletzt aktualisiert · 12.10.2026