JavaScript SDK: odniesienie do magazynu
Każda metoda zarządzająca segmentami i obiektami wraz z jej sygnaturą.
6 min przeczytane·Poziom odniesienie·Zmieniono 12 paź 2026
Ten tekst w języku angielskim został wygenerowany automatycznie na podstawie francuskiego oryginału i nie był jeszcze recenzowany.
Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.
#
Klasa
Usługa przechowywania
| Metoda | Opis |
|---|---|
from(bucketId: string): StorageBucketClient | Zwraca klienta w zakresie określonego segmentu (parzystość DX Supabase). |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | Wypisz zasobniki projektu. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | Odczytuje segment według jego identyfikatora. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Utwórz wiadro. public (domyślnie false) umożliwia odczytanie obiektów bez uwierzytelniania; fileSizeLimit (w bajtach) i allowedMimeTypes ograniczają akceptowane pliki. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Aktualizuje istniejący zasobnik (aktualizacja CZĘŚCIOWA: wysyłane są tylko podane pola). |
deleteBucket(id: string): Promise<AuraResponse<null>> | Usuwa wiadro według jego identyfikatora. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Prześlij plik do zasobnika. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Leniwe pobieranie pliku. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Lista plików w wiadrze. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Usuń jeden lub więcej plików z zasobnika. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Skopiuj plik w wiadrze. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Przenieś/zmień nazwę pliku w wiadrze. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | Pobierz metadane pliku. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Wygeneruj podpisany (tymczasowy) adres URL pobierania. |
createSignedUrls(bucketId: string, paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Generuje kilka podpisanych adresów URL w jednym przebiegu (wsadowo). |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Wygeneruj podpisany adres URL przesyłania (wcześniej PUT). |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | Konstruuje adres URL pliku w zasobniku. |
#
Klasa
Klient Storage Bucket
Dostęp do klienta w zakresie określonego zasobnika (parzystość DX Supabase).
| Nieruchomość | Opis |
|---|---|
readonly bucketId: string | Identyfikator segmentu, z którym połączony jest ten klient: wszystkie jego metody działają na tym zasobniku. |
| Metoda | Opis |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Prześlij plik do tego zasobnika. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Pobierz plik z tego zasobnika. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Lista plików w tym zasobniku. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Usuwa jeden lub więcej plików z tego segmentu. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Tworzy tymczasowy podpisany adres URL pliku w tym zasobniku. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Tworzy wiele podpisanych adresów URL w jednym przebiegu dla tego segmentu. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Tworzy wcześniej ustalony adres URL przesyłania (bezpośredni PUT). |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | Zwraca publiczny adres URL pliku w tym zasobniku. |
#
Klasa
BlobDownloadBuilder
Leniwe pobieranie (domyślnie obiekt Blob).
| Metoda | Opis |
|---|---|
asStream(): StreamDownloadBuilder | Przełącza na czytanie strumieniowe: wynikiem jest ReadableStream zamiast Blob załadowanego do pamięci. |
then<TR1 = AuraResponse<Blob>, TR2 = never>(onfulfilled?: ((v: AuraResponse<Blob>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | Uruchamia pobieranie (leniwe: żądanie zaczyna się dopiero od await); wynik zostaje zapamiętany. |
#
Klasa
Konstruktor pobierania strumieniowego
Wariant strumienia — res.body (ReadableStream).
| Metoda | Opis |
|---|---|
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> | Uruchamia pobieranie strumieniowe (leniwe); wynik zostaje zapamiętany. |
Wygenerowana strona
Ta strona jest generowana na podstawie deklaracji typów i komentarzy pakietu SDK, więc nie może odbiegać od opublikowanego kodu. Aby poznać sprawdzone przykłady, przeczytaj przewodniki.
Ostatnia aktualizacja · 12 paź 2026