JavaScript SDK: справочник по хранилищу
Каждый метод, управляющий сегментами и объектами, имеет свою сигнатуру.
6 мин читать·Уровень ссылка·Пересмотрено 12 окт. 2026 г.
Этот текст на английском языке был создан автоматически на основе французского оригинала и еще не проверялся.
Эта страница была переведена автоматически. Английская версия является авторитетной.
#
Сорт
Служба хранения
| Метод | Описание |
|---|---|
from(bucketId: string): StorageBucketClient | Возвращает клиента, привязанного к определенному сегменту (четность DX Supabase). |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | Перечислите сегменты проекта. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | Считывает корзину по ее идентификатору. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Создайте ведро. public (по умолчанию false) делает свои объекты доступными для чтения без аутентификации; fileSizeLimit (в байтах) и allowedMimeTypes ограничивают принимаемые файлы. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | Обновляет существующий сегмент (ЧАСТИЧНОЕ обновление: отправляются только предоставленные поля). |
deleteBucket(id: string): Promise<AuraResponse<null>> | Удаляет корзину по ее идентификатору. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Загрузите файл в корзину. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Ленивая загрузка файла. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Список файлов в корзине. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Удалите один или несколько файлов из корзины. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Скопируйте файл в корзину. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | Переместите/переименуйте файл в корзине. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | Получить метаданные файла. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Создайте подписанный (временный) 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; }>>> | Генерирует несколько подписанных URL-адресов за один проход (пакетный). |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Создайте подписанный URL-адрес загрузки (заранее заданный PUT). |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | Создает URL-адрес файла в корзине. |
#
Сорт
StorageBucketClient
Доступ к клиенту ограничен определенным сегментом (четность DX Supabase).
| Свойство | Описание |
|---|---|
readonly bucketId: string | Идентификатор бакета, к которому привязан этот клиент: все его методы действуют на этот бакет. |
| Метод | Описание |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | Загрузите файл в этот контейнер. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | Загрузите файл из этого ведра. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | Перечислите файлы в этом сегменте. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | Удаляет один или несколько файлов из этого сегмента. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Создает временный подписанный URL-адрес для файла в этом сегменте. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | Создает несколько подписанных URL-адресов за один проход для этого сегмента. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | Создает заранее заданный URL-адрес загрузки (прямой PUT). |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | Возвращает общедоступный URL-адрес файла в этом сегменте. |
#
Сорт
BlobDownloadBuilder
Отложенная загрузка (по умолчанию Blob).
| Метод | Описание |
|---|---|
asStream(): StreamDownloadBuilder | Переключается на потоковое чтение: результатом становится ReadableStream вместо Blob, загруженного в память. |
then<TR1 = AuraResponse<Blob>, TR2 = never>(onfulfilled?: ((v: AuraResponse<Blob>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | Запускает загрузку (ленивая: запрос начинается только с await); результат запоминается. |
#
Сорт
СтримСкачатьBuilder
Вариант потока — res.body (ReadableStream).
| Метод | Описание |
|---|---|
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> | Запускает потоковую (ленивую) загрузку; результат запоминается. |
Сгенерированная страница
Эта страница создается на основе объявлений типов и комментариев SDK, поэтому она не может отличаться от опубликованного кода. Рабочие примеры можно найти в руководствах.
Последнее обновление · 12 окт. 2026 г.